? PHP实现微信支付及退款流程的实例详解
PHP实现微信支付及退款流程实例
微信小程序支付的主要逻辑集中在后端,前端只需携带支付所需的数据恳求后端接口然后按照返回结果做响应成功失败处置即可。本篇文章后端使用的是php,侧重于整个支付的流程和一些细节方面的东西。所以使用其他后端说话的伴侣有需要也是可以看一下的。许多时候开发的需求和响应问题的解决真的要跳出说话语法层面,去从系统和流程的角度思考。
一、微信支付
支付主要分为几个步骤:
前端携带支付需要的数据(商品id,购置数目等)发起支付恳求
后端在接收到支付恳求后,处置支付数据,然后携带处置后的数据恳求 微佩服务器 的 支付统一下单接口
后端接收到上一步恳求微佩服务器的返回数据,再次处置,然后返回前端让前端可以开端支付。
前端停止支付动作
前端支付完成后,微佩服务器会向后端发送支付通知(也就是微信要告诉你客户已经付过钱了),后端按照这个通知肯定支付完成,然后就去做支付完成后的响应动作,比方修改订单状态,增加交易日志啊等等。
从这几个步骤可以看出,后端主要的作用就是将支付需要的数据传给微佩服务器,再按照微佩服务器的响应肯定支付可否完成。
这个流程还是蛮容易懂得的。形象的说,前端就是个顾客,后端就是店家,微佩服务器的统一下单接口就像收银员。顾客跟店家说,我是谁谁谁,此刻我要付多少多少钱给你买什么什么。店家就跟收银员说,阿谁谁谁谁要付多少钱,你预备收钱吧。收银员收到钱后,就去告诉店家,我已经收到钱了,你给他东西吧。
下面就具体的说明一下各个步骤的详细实现。
1. 前端恳求支付
前端恳求支付,就是简便的携带支付需要的数据,例如会员标识,支付金额,支付订单 ID 等等跟 **你的业务逻辑有关** 或者跟 **下一步恳求微佩服务器支付统一下单接口需要的数据有关** 的相关数据,使用微信小程序的 wx.request( ) 去恳求后端的支付接口。
2. 后端恳求微佩服务器
后端接收到前端发送的支付恳求后,可以停止一下相关验证,例如推断一下会员有没有问题,支付金额对不合错误等等。
在验证没什么问题,可以向微佩服务器申请支付之后,后端需要使用 微信规定的数据格局 去恳求微信的支付统一下单接口。
微信规定的恳求数据:
这需要较多代码实现。由于需要的数据个数较多,并且还需要加密并以 XML 格局发送。
第一,有以下数据是使用小程序支付必需供给给微佩服务器的参数。
小程序 appid。写小程序的大约没有不知道这个的。。。
会员标识 openid。也就是会员的小程序标识,在我上篇博客中说明了怎样猎取。
商户号 mch_id 。申请开通微信支付商户认证成功后微信发给你的邮件里有
商户订单号 out_trade_no 。商户为这次支付生成的订单号
总金额 total_fee 。订单总金额,很重要的一点是单位是分,要特殊留意。
微佩服务器回调通知接口地址 notify_url。微信确定钱已经到账后,会往这个地址屡次发送新闻,告诉你顾客已经付完钱了,你需要返回新闻给微信表示你已经收到了通知。。这个地址不克不及有端标语,同时要能直接接受POST办法恳求。
交易类型 trade_type 。微信小程序支付此值统一为 JSAPI
商品信息 Body。相似"腾讯-游戏"这种格局
终端IP地址 spbill_create_ip 。终端地址IP,也就是恳求支付的 IP 地址。
随机字符串 nonce_str 。需要后端随机生成的字符串用于包管数据平安。微信要求不长于32位。
签名 sign 。使用上面的所有参数停止响应处置加密生成签名。(详细处置方式可见下文代码,可直接复用。)
在处置好以上所有数据后,将这些数据以 XML 格局整理并以 POST 办法发送到 微信支付统一下单接口
3.后端接受微佩服务器返回数据
微佩服务器在接收到支付数据之后,假如数据没有问题,其会返回用于支付的响应数据,其中非常重要的是 名称为 prepay_id 的数据字段,需要将此数据返回前端,前端才能连续支付。
因此,在后端接收到微佩服务器的返回数据后,需要停止响应的处置,终究返回到前端如下数据:
appid 不需多说
timeStamp 当前时间戳
nonceStr 随机字符串
package 就是上面提到的 prepay_id,不外牢记格局如 “prepay_id= prepay_id_item“。不然会致使错误。
signType 加密方式,一样应当是 MD5
paySign 对以上数据停止响应处置并加密。
到这里,后端的支付接口已经完成了接收前端支付恳求,并返回了前端支付所需数据的功效。
4. 前端发起支付
前端在接收到返回数据后,使用 wx.requestPayment() 来恳求发起支付。此 API 需要的对象参数各项值就是我们上一步返回的各个数据。
5.后端接受微佩服务器回调
前端完成支付后,微佩服务器确定支付已经完成。就会向第一步中设定的回调地址发送通知。后端的接收回调接口在接收到通知后,就可以推断支付可否完成,从而决议后续动作。
需要留意的是,在接收到微佩服务器的回调通知后,按照通知的result_code字段推断支付可否成功。在接受到成功的通知后,后端需要返回success数据向微佩服务器告知已得到回调通知。不然微佩服务器会不断的向后端发送新闻。别的微信的通知是以XML格局发送的,在接受处置时需要留意。
微信的大约支付流程就是这样。以下是PHP语法的微信支付类,可以比照上面的步骤介绍,加深懂得。在需要支付时,直接传入参数实例化此类再调取类的 pay 办法即可。
//微信支付类
class WeiXinPay{ //=======【根本信息设定】===================================== //微信公众号身份的独一标识 protected $APPID = appid;//填写您的appid。微信公众平台里的 protected $APPSECRET = secret; //受理商ID,身份标识 protected $MCHID = '11111111';//商户id //商户支付密钥Key protected $KEY = '192006250b4c09247ec02edce69f6a2d'; //回调通知接口 protected $APPURL = 'https://smart.afei.com/receivesuc'; //交易类型 protected $TRADETYPE = 'JSAPI'; //商品类型信息 protected $BODY = 'wx/book'; //微信支付类的结构函数 function __construct($openid,$outTradeNo,$totalFee){ $this->openid = $openid; //会员独一标识 $this->outTradeNo = $outTradeNo; //商品编号 $this->totalFee = $totalFee; //总价 } //微信支付类向外显露的支付接口 public function pay(){ $result = $this->weixinapp(); return $result; } //对微信统一下单接口返回的支付相关数据停止处置 private function weixinapp(){ $unifiedorder=$this->unifiedorder(); $parameters=array( 'appId'=>$this->APPID,//小程序ID 'timeStamp'=>''.time().'',//时间戳 'nonceStr'=>$this->createNoncestr(),//随机串 'package'=>'prepay_id='.$unifiedorder['prepay_id'],//数据包 'signType'=>'MD5'//签名方式 ); $parameters['paySign']=$this->getSign($parameters); return $parameters; } /* *恳求微信统一下单接口 */ private function unifiedorder(){ $parameters = array( 'appid' => $this->APPID,//小程序id 'mch_id'=> $this->MCHID,//商户id 'spbill_create_ip'=>$_SERVER['REMOTE_ADDR'],//终端ip 'notify_url'=>$this->APPURL, //通知地址 'nonce_str'=> $this->createNoncestr(),//随机字符串 'out_trade_no'=>$this->outTradeNo,//商户订单编号 'total_fee'=>floatval($this->totalFee), //总金额 'open_id'=>$this->openid,//会员openid 'trade_type'=>$this->TRADETYPE,//交易类型 'body' =>$this->BODY, //商品信息 ); $parameters['sign'] = $this->getSign($parameters); $xmlData = $this->arrayToXml($parameters); $xml_result = $this->postXmlCurl($xmlData,'https://api.mch.weixin.qq.com/pay/unifiedorder',60); $result = $this->xmlToArray($xml_result); return $result; } //数组转字符串办法 protected function arrayToXml($arr){ $xml = "<xml>"; foreach ($arr as $key=>$val) { if (is_numeric($val)){ $xml.="<".$key.">".$val."</".$key.">"; }else{ $xml.="<".$key."><![CDATA[".$val."]]></".$key.">"; } } $xml.="</xml>"; return $xml; } protected function xmlToArray($xml){ $array_data = json_decode(json_encode(simplexml_load_string($xml, 'SimpleXMLElement', LIBXML_NOCDATA)), true); return $array_data; } //发送xml恳求办法 private static function postXmlCurl($xml, $url, $second = 30) { $ch = curl_init(); //设定超时 curl_setopt($ch, CURLOPT_TIMEOUT, $second); curl_setopt($ch, CURLOPT_URL, $url); curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE); curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE); //严厉校验 //设定header curl_setopt($ch, CURLOPT_HEADER, FALSE); //要求结果为字符串且输出到屏幕上 curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE); //post提交方式 curl_setopt($ch, CURLOPT_POST, TRUE); curl_setopt($ch, CURLOPT_POSTFIELDS, $xml); curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 20); curl_setopt($ch, CURLOPT_TIMEOUT, 40); set_time_limit(0); //运转curl $data = curl_exec($ch); //返回结果 if ($data) { curl_close($ch); return $data; } else { $error = curl_errno($ch); curl_close($ch); throw new WxPayException("curl出错,错误码:$error"); } } /* * 对要发送到微信统一下单接口的数据停止签名 */ protected function getSign($Obj){ foreach ($Obj as $k => $v){ $Parameters[$k] = $v; } //签名步骤一:按字典序排序参数 ksort($Parameters); $String = $this->formatBizQueryParaMap($Parameters, false); //签名步骤二:在string后参加KEY $String = $String."&key=".$this->KEY; //签名步骤三:MD5加密 $String = md5($String); //签名步骤四:所有字符转为大写 $result_ = strtoupper($String); return $result_; } /* *排序并格局化参数办法,签名时需要使用 */ protected function formatBizQueryParaMap($paraMap, $urlencode) { $buff = ""; ksort($paraMap); foreach ($paraMap as $k => $v) { if($urlencode) { $v = urlencode($v); } //$buff .= strtolower($k) . "=" . $v . "&"; $buff .= $k . "=" . $v . "&"; } $reqPar; if (strlen($buff) > 0) { $reqPar = substr($buff, 0, strlen($buff)-1); } return $reqPar; } /* * 生成随机字符串办法 */ protected function createNoncestr($length = 32 ){ $chars = "abcdefghijklmnopqrstuvwxyz0123456789"; $str =""; for ( $i = 0; $i < $length; $i++ ) { $str.= substr($chars, mt_rand(0, strlen($chars)-1), 1); } return $str; } }
以上就是微信支付的相关流程。在理清思绪后,流程还是比力清楚和简便的。重点在于需要留意一些细节问题,例如数据格局,加密办法等。
下面说一下微信小程序退款的详细实现
二、微信退款
小程序退款的流程和付款类似,但有一些细节上的不一样。
第一退款的步骤平常如下:
会员前端点击退款按钮后,后端接收到会员的退款恳求通过商城后台显现给商户,商户肯定同意退款后,后端再发起向微信退款接口的恳求来恳求退款。
后端向微信退款接口发送恳求后,得到响应信息,肯定退款可否完成,按照退款可否完成再去停止改动订单状态等业务逻辑。
退款的步骤相对微信支付来说比力简便。
值得留意的有以下两点:
1.向微信退款接口恳求退款后,按照得到的响应是可以直接肯定退款可否完成的。不再需要设定专门的回调接口等候微信通知。当然假如需要也是可以在微信商户平台设定回调接口接受从而接受微信回调的,但并不是必需的。
2.退款恳求需要在恳求效劳器安置微信供给的平安证书,也就是说,发起退款恳求比拟较支付恳求在恳求时恳求办法不克不及复用,由于微信退款需要携带证书的恳求,此证书可在申请微信商户号成功后从微信商户平台自行下载,Linux下的PHP开发环境的证书只需要放在网站根名目的cert文件夹中即可。其他开发环境大概需要导入操纵。
下面讲解一下退款的详细步骤
一. 会员发起退款恳求
会员在前端发起退款恳求,后端接收到退款恳求,将响应订单标志为申请退款,展现在后台.商户查看后,假如赞成退款再停止响应操纵.此后才进入真正的退款流程.
二. 商户发起退款恳求
商户赞成退款后,后端即向微信供给的退款 API 发起恳求.
同恳求微信支付API一样.退款恳求也需要将需要的参数停止签名后以XML发送到微信的退款API
退款恳求需要的参数如下(多个参数在支付API恳求时也有使用):
参数:
appid
mch_id 商户号。申请开通微信支付商户认证成功后微信发给你的邮件里有
out_trade_no 商户订单号。退款订单在支付时生成的订单号
out_refund_no 退款订单号。由后端生成的退款单号,需要包管独一,由于多个一样的退款单号只会退款一次。
total_fee 总金额。订单总金额,单位为分。
refund_fee 退款金额。 需要退款的金额,单位一样为分
op_user_id 操纵员。与商户号雷同即可
nonce_str 随机字符串。同支付恳求
签名 sign 。使用上面的所有参数停止响应处置加密生成签名。(详细处置方式与支付雷同,可直接复用。)
注:我就是由于在实例化的时候没有传入key(秘钥)参数,不断报错签名错误。
三. 退款完成
在发起退款恳求后,就可以直接按照恳求的响应XML中的 result_code字段来推断退款可否成功,从而对订单状态停止处置和后续操纵。不需要像支付那样等候另一个接口的通知来肯定恳求状态。当然如上文所说,假如需要微佩服务器发送通知到后端的话,可以到微信商户平台停止设定。
退款由于流程与支付大同小异,因此退款的PHP类我选中了直接继承支付类,
代码如下,留意区分退款恳求办法postXmlSSLCurl和支付恳求办法postXmlCurl的不同,这也就是上文提到的退款需要的双向证书的使用。
class WinXinRefund extends WeiXinPay{ protected \$SSLCERT_PATH = 'cert/apiclient_cert.pem';//证书途径 protected \$SSLKEY_PATH = 'cert/apiclient_key.pem';//证书途径 protected \$opUserId = '1234567899';//商户号 function __construct($openid,$outTradeNo,$totalFee,$outRefundNo,$refundFee){ //初始化退款类需要的变量 $this->openid = $openid; $this->outTradeNo = $outTradeNo; $this->totalFee = $totalFee; $this->outRefundNo = $outRefundNo; $this->refundFee = $refundFee; } public function refund(){ //对外显露的退款接口 $result = $this->wxrefundapi(); return $result; } private function wxrefundapi(){ //通过微信api停止退款流程 $parma = array( 'appid'=> $this->APPID, 'mch_id'=> $this->MCHID, 'nonce_str'=> $this->createNoncestr(), 'out_refund_no'=> $this->outRefundNo, 'out_trade_no'=> $this->outTradeNo, 'total_fee'=> $this->totalFee, 'refund_fee'=> $this->refundFee, 'op_user_id' => $this->opUserId, ); $parma['sign'] = $this->getSign($parma); $xmldata = $this->arrayToXml($parma); $xmlresult = $this->postXmlSSLCurl($xmldata,'https://api.mch.weixin.qq.com/secapi/pay/refund'); $result = $this->xmlToArray($xmlresult); return $result; } //需要使用证书的恳求 function postXmlSSLCurl($xml,$url,$second=30) { $ch = curl_init(); //超不时间 curl_setopt($ch,CURLOPT_TIMEOUT,$second); //这里设定代理,假如有的话 //curl_setopt($ch,CURLOPT_PROXY, '8.8.8.8'); //curl_setopt($ch,CURLOPT_PROXYPORT, 8080); curl_setopt($ch,CURLOPT_URL, $url); curl_setopt($ch,CURLOPT_SSL_VERIFYPEER,FALSE); curl_setopt($ch,CURLOPT_SSL_VERIFYHOST,FALSE); //设定header curl_setopt($ch,CURLOPT_HEADER,FALSE); //要求结果为字符串且输出到屏幕上 curl_setopt($ch,CURLOPT_RETURNTRANSFER,TRUE); //设定证书 //使用证书:cert 与 key 离别属于两个.pem文件 //默许格局为PEM,可以注释 curl_setopt($ch,CURLOPT_SSLCERTTYPE,'PEM'); curl_setopt($ch,CURLOPT_SSLCERT, $this->SSLCERT_PATH); //默许格局为PEM,可以注释 curl_setopt($ch,CURLOPT_SSLKEYTYPE,'PEM'); curl_setopt($ch,CURLOPT_SSLKEY, $this->SSLKEY_PATH); //post提交方式 curl_setopt($ch,CURLOPT_POST, true); curl_setopt($ch,CURLOPT_POSTFIELDS,$xml); $data = curl_exec($ch); //返回结果 if($data){ curl_close($ch); return $data; } else { $error = curl_errno($ch); echo "curl出错,错误码:$error"."<br>"; curl_close($ch); return false; } }}
三. 总结
以上就是关于微信支付和退款的流程及相关知识的介绍。文中的 PHP类 均封装直接可用。
由于微信支付和退款触及的东西较为冗杂,许多人直接看官方文档大概会一头雾水,所以看过此文理解流程和要点后,再去看微信官方文档。一方面可以更清楚的理解小程序的支付和退款流程。另一方面,本文由于篇幅有限及作者能力有限,必定有无暇顾及或有所纰漏之处。为求稳妥,还是需要多看看官方开发文档。究竟事涉支付,出个BUG可不是小事。
引荐教程:《PHP视频教程》
以上就是? PHP实现微信支付及退款流程的实例详解的具体内容,更多请关注百分百源码网其它相关文章!