前阵子做了几个第三方支付接口,写下来跟大家分享下,我用的是yii1框架做的。
1:from表单,提交商户给银行的数据,通过$this->createUrl('Payment/tenpay')?>" 跳转
<!-- 财付通支付页面 --> <form name=tenpayment action="<?php echo $this->createUrl('Payment/tenpay')?>" method=post target="_blank"> <div style="display: none;"><input size="30" name="WIDseller_email" value="xxxx.com" /> <input size="30" name="order_no" value="<?php echo @$OrderInfo['PayNumber']?>" /> <input size="30" name="product_name" value="<?php echo @XUtils::cutstr($OrderInfo['OrderName'],30)?>" /> <input size="30" name="order_price" value="<?php echo @$OrderInfo['TotalMoney']?>" /> <input size="30" name="trade_mode" value="1"/> <input size="30" name="remarkexplain" /></div> <li> <div class="pay_boxin pay_curr"> <span class="left"><img src="<?php echo Yii::app()->request->baseUrl ?>/assets/default/images/tenpay.png" height="30px"></span> <span class="pay_money right"> <p>支付<strong><?php echo @sprintf('%0.2f',$OrderInfo['TotalMoney'])?></strong>元</p> </span> </div> <input type="submit" style="220px; height:50px; border:0px; margin:30px 0 0 500px; background: url(<?php echo Yii::app()->request->baseUrl ?>/assets/default/images/pay_quite.png) center no-repeat; cursor:pointer;" value="" > <div class="pay_disno" style="margin:30px 0 0 500px;"><img src="<?php echo Yii::app()->request->baseUrl ?>/assets/default/images/pay_quite.png"></div> </li> </form>
2:跳转页面 通过控制器跳转
3:tenpay.php页面 验证商户提交的数据 并进行加密处理
<?php //--------------------------------------------------------- //财付通即时到帐支付请求示例,商户按照此文档进行开发即可 //--------------------------------------------------------- require_once ("classes/RequestHandler.class.php"); require_once ("tenpay_config.php"); /* 获取提交的订单号 */ $out_trade_no = $_REQUEST["order_no"]; /* 获取提交的商品名称 */ $product_name = $_REQUEST["product_name"]; /* 获取提交的商品价格 */ $order_price = $_REQUEST["order_price"]; /* 获取提交的备注信息 */ $remarkexplain = $_REQUEST["remarkexplain"]; /* 支付方式 */ $trade_mode=$_REQUEST["trade_mode"]; $strDate = date("Ymd"); $strTime = date("His"); /* 商品价格(包含运费),以分为单位 */ $total_fee = $order_price*100; /* 商品名称 */ $desc = "商品:".$product_name.",备注:".$remarkexplain; /* 创建支付请求对象 */ $reqHandler = new RequestHandler(); $reqHandler->init(); $reqHandler->setKey($key); $reqHandler->setGateUrl("https://gw.tenpay.com/gateway/pay.htm"); //---------------------------------------- //设置支付参数 //---------------------------------------- $reqHandler->setParameter("partner", $partner); $reqHandler->setParameter("out_trade_no", $out_trade_no); $reqHandler->setParameter("total_fee", $total_fee); //总金额 $reqHandler->setParameter("return_url", $return_url); $reqHandler->setParameter("notify_url", $notify_url); $reqHandler->setParameter("body", $desc); $reqHandler->setParameter("bank_type", "DEFAULT"); //银行类型,默认为财付通 //用户ip $reqHandler->setParameter("spbill_create_ip", $_SERVER['REMOTE_ADDR']);//客户端IP $reqHandler->setParameter("fee_type", "1"); //币种 $reqHandler->setParameter("subject",$desc); //商品名称,(中介交易时必填) //系统可选参数 $reqHandler->setParameter("sign_type", "MD5"); //签名方式,默认为MD5,可选RSA $reqHandler->setParameter("service_version", "1.0"); //接口版本号 $reqHandler->setParameter("input_charset", "utf-8"); //字符集 $reqHandler->setParameter("sign_key_index", "1"); //密钥序号 //业务可选参数 $reqHandler->setParameter("attach", ""); //附件数据,原样返回就可以了 $reqHandler->setParameter("product_fee", ""); //商品费用 $reqHandler->setParameter("transport_fee", "0"); //物流费用 $reqHandler->setParameter("time_start", date("YmdHis")); //订单生成时间 $reqHandler->setParameter("time_expire", ""); //订单失效时间 $reqHandler->setParameter("buyer_id", ""); //买方财付通帐号 $reqHandler->setParameter("goods_tag", ""); //商品标记 $reqHandler->setParameter("trade_mode",$trade_mode); //交易模式(1.即时到帐模式,2.中介担保模式,3.后台选择(卖家进入支付中心列表选择)) $reqHandler->setParameter("transport_desc",""); //物流说明 $reqHandler->setParameter("trans_type","1"); //交易类型 $reqHandler->setParameter("agentid",""); //平台ID $reqHandler->setParameter("agent_type",""); //代理模式(0.无代理,1.表示卡易售模式,2.表示网店模式) $reqHandler->setParameter("seller_id",""); //卖家的商户号 //请求的URL $reqUrl = $reqHandler->getRequestURL(); //获取debug信息,建议把请求和debug信息写入日志,方便定位问题 /**/ //$debugInfo = $reqHandler->getDebugInfo(); //echo "<br/>" . $reqUrl . "<br/>"; //var_dump($reqUrl);die; ?> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <title>财付通即时到帐交易接口</title> </head> <body> <br/><!--a href="<?php echo $reqUrl ?>" target="_blank">财付通支付</a--> <form action="<?php echo $reqHandler->getGateUrl() ?>" method="post"> <?php $params = $reqHandler->getAllParameters(); foreach($params as $k => $v) { echo "<input type="hidden" name="{$k}" value="{$v}" /> "; } ?> <input type="submit" id="submitPay" value="财付通支付" style="display:none"> <script type="text/javascript"> document.getElementById("submitPay").click(); </script> </form> </body> </html>
4:payNotifyUrl.php 后台回调页面 显示用户支付的结果信息 银行通过秘钥与商户进行签名 确认商户信息
<META http-equiv=Content-Type content="text/html; charset=utf-8"> <?php //--------------------------------------------------------- //财付通即时到帐支付后台回调示例,商户按照此文档进行开发即可 //--------------------------------------------------------- require ("classes/ResponseHandler.class.php"); require ("classes/RequestHandler.class.php"); require ("classes/client/ClientResponseHandler.class.php"); require ("classes/client/TenpayHttpClient.class.php"); require ("./classes/function.php"); require_once ("./tenpay_config.php"); log_result("进入后台回调页面"); /* 创建支付应答对象 */ $resHandler = new ResponseHandler(); $resHandler->setKey($key); //判断签名 if($resHandler->isTenpaySign()) { //通知id $notify_id = $resHandler->getParameter("notify_id"); //通过通知ID查询,确保通知来至财付通 //创建查询请求 $queryReq = new RequestHandler(); $queryReq->init(); $queryReq->setKey($key); $queryReq->setGateUrl("https://gw.tenpay.com/gateway/simpleverifynotifyid.xml"); $queryReq->setParameter("partner", $partner); $queryReq->setParameter("notify_id", $notify_id); //通信对象 $httpClient = new TenpayHttpClient(); $httpClient->setTimeOut(5); //设置请求内容 $httpClient->setReqContent($queryReq->getRequestURL()); //后台调用 if($httpClient->call()) { //设置结果参数 $queryRes = new ClientResponseHandler(); $queryRes->setContent($httpClient->getResContent()); $queryRes->setKey($key); if($resHandler->getParameter("trade_mode") == "1"){ //判断签名及结果(即时到帐) //只有签名正确,retcode为0,trade_state为0才是支付成功 if($queryRes->isTenpaySign() && $queryRes->getParameter("retcode") == "0" && $resHandler->getParameter("trade_state") == "0") { log_result("即时到帐验签ID成功"); //取结果参数做业务处理 $out_trade_no = $resHandler->getParameter("out_trade_no"); //财付通订单号 $transaction_id = $resHandler->getParameter("transaction_id"); //金额,以分为单位 $total_fee = $resHandler->getParameter("total_fee"); //如果有使用折扣券,discount有值,total_fee+discount=原请求的total_fee $discount = $resHandler->getParameter("discount"); //------------------------------ //处理业务开始 //------------------------------ //处理数据库逻辑 //注意交易单不要重复处理 //注意判断返回金额 //------------------------------ //处理业务完毕 //------------------------------ log_result("即时到帐后台回调成功"); echo "success"; } else { //错误时,返回结果可能没有签名,写日志trade_state、retcode、retmsg看失败详情。 //echo "验证签名失败 或 业务错误信息:trade_state=" . $resHandler->getParameter("trade_state") . ",retcode=" . $queryRes-> getParameter("retcode"). ",retmsg=" . $queryRes->getParameter("retmsg") . "<br/>" ; log_result("即时到帐后台回调失败"); echo "fail"; } }elseif ($resHandler->getParameter("trade_mode") == "2") { //判断签名及结果(中介担保) //只有签名正确,retcode为0,trade_state为0才是支付成功 if($queryRes->isTenpaySign() && $queryRes->getParameter("retcode") == "0" ) { log_result("中介担保验签ID成功"); //取结果参数做业务处理 $out_trade_no = $resHandler->getParameter("out_trade_no"); //财付通订单号 $transaction_id = $resHandler->getParameter("transaction_id"); //------------------------------ //处理业务开始 //------------------------------ //处理数据库逻辑 //注意交易单不要重复处理 //注意判断返回金额 log_result("中介担保后台回调,trade_state=".$resHandler->getParameter("trade_state")); switch ($resHandler->getParameter("trade_state")) { case "0": //付款成功 break; case "1": //交易创建 break; case "2": //收获地址填写完毕 break; case "4": //卖家发货成功 break; case "5": //买家收货确认,交易成功 break; case "6": //交易关闭,未完成超时关闭 break; case "7": //修改交易价格成功 break; case "8": //买家发起退款 break; case "9": //退款成功 break; case "10": //退款关闭 break; default: //nothing to do break; } //------------------------------ //处理业务完毕 //------------------------------ echo "success"; } else { //错误时,返回结果可能没有签名,写日志trade_state、retcode、retmsg看失败详情。 //echo "验证签名失败 或 业务错误信息:trade_state=" . $resHandler->getParameter("trade_state") . ",retcode=" . $queryRes-> getParameter("retcode"). ",retmsg=" . $queryRes->getParameter("retmsg") . "<br/>" ; log_result("中介担保后台回调失败"); echo "fail"; } } //获取查询的debug信息,建议把请求、应答内容、debug信息,通信返回码写入日志,方便定位问题 /* echo "<br>------------------------------------------------------<br>"; echo "http res:" . $httpClient->getResponseCode() . "," . $httpClient->getErrInfo() . "<br>"; echo "query req:" . htmlentities($queryReq->getRequestURL(), ENT_NOQUOTES, "GB2312") . "<br><br>"; echo "query res:" . htmlentities($queryRes->getContent(), ENT_NOQUOTES, "GB2312") . "<br><br>"; echo "query reqdebug:" . $queryReq->getDebugInfo() . "<br><br>" ; echo "query resdebug:" . $queryRes->getDebugInfo() . "<br><br>"; */ }else { //通信失败 echo "fail"; //后台调用通信失败,写日志,方便定位问题 echo "<br>call err:" . $httpClient->getResponseCode() ."," . $httpClient->getErrInfo() . "<br>"; } } else { echo "<br/>" . "认证签名失败" . "<br/>"; echo $resHandler->getDebugInfo() . "<br>"; } ?>
5:payReturnUrl.php 前台回调页面 银行回调信息给商户
<META http-equiv=Content-Type content="text/html; charset=utf-8"> <?php //--------------------------------------------------------- //财付通即时到帐支付页面回调示例,商户按照此文档进行开发即可 //--------------------------------------------------------- require_once ("classes/ResponseHandler.class.php"); require_once ("classes/function.php"); require_once ("tenpay_config.php"); log_result("进入前台回调页面"); /* 创建支付应答对象 */ $resHandler = new ResponseHandler(); $resHandler->setKey($key); //判断签名 if($resHandler->isTenpaySign()) { //通知id $notify_id = $resHandler->getParameter("notify_id"); //商户订单号 $out_trade_no = $resHandler->getParameter("out_trade_no"); //财付通订单号 $transaction_id = $resHandler->getParameter("transaction_id"); //金额,以分为单位 $total_fee = $resHandler->getParameter("total_fee"); //如果有使用折扣券,discount有值,total_fee+discount=原请求的total_fee $discount = $resHandler->getParameter("discount"); //支付结果 $trade_state = $resHandler->getParameter("trade_state"); //交易模式,1即时到账 $trade_mode = $resHandler->getParameter("trade_mode"); if($out_trade_no){ $this->actionSetPayN($out_trade_no,2); $this->redirect(array('/UserCenter')); } if("1" == $trade_mode ) { if( "0" == $trade_state){ echo "<br/>" . "即时到帐支付成功" . "<br/>"; } else { //当做不成功处理 echo "<br/>" . "即时到帐支付失败" . "<br/>"; } }elseif( "2" == $trade_mode ) { if( "0" == $trade_state) { echo "<br/>" . "中介担保支付成功" . "<br/>"; } else { //当做不成功处理 echo "<br/>" . "中介担保支付失败" . "<br/>"; } } } else { echo "<br/>" . "认证签名失败" . "<br/>"; echo $resHandler->getDebugInfo() . "<br>"; } ?>
6:设置页面 设置商户信息,以及商户秘钥和商户账号
<?php $spname="财付通双接口测试"; $partner = ""; //财付通商户号 $key = ""; //财付通密钥 $return_url = "http://www.xxx.com".$this->createUrl('Payment/Returns'); //显示支付结果页面,*替换成payReturnUrl.php所在路径 $notify_url = "http://www.xxx.com".$this->createUrl('Payment/payNotifyUrl'); //支付完成后的回调处理页面,*替换成payNotifyUrl.php所在路径 ?>