PHP微信支付與退款功能實(shí)現(xiàn)流程詳解
微信小程序支付的主要邏輯集中在后端,前端只需攜帶支付所需的數(shù)據(jù)請(qǐng)求后端接口然后根據(jù)返回結(jié)果做相應(yīng)成功失敗處理即可。
一、微信支付
支付主要分為幾個(gè)步驟:
前端攜帶支付需要的數(shù)據(jù)(商品id,購(gòu)買數(shù)量等)發(fā)起支付請(qǐng)求
后端在接收到支付請(qǐng)求后,處理支付數(shù)據(jù),然后攜帶處理后的數(shù)據(jù)請(qǐng)求 微信服務(wù)器 的 支付統(tǒng)一下單接口
后端接收到上一步請(qǐng)求微信服務(wù)器的返回?cái)?shù)據(jù),再次處理,然后返回前端讓前端可以開始支付。
前端進(jìn)行支付動(dòng)作
前端支付完成后,微信服務(wù)器會(huì)向后端發(fā)送支付通知(也就是微信要告訴你客戶已經(jīng)付過錢了),后端根據(jù)這個(gè)通知確定支付完成,然后就去做支付完成后的相應(yīng)動(dòng)作,比如修改訂單狀態(tài),添加交易日志啊等等。
從這幾個(gè)步驟可以看出,后端主要的作用就是將支付需要的數(shù)據(jù)傳給微信服務(wù)器,再根據(jù)微信服務(wù)器的響應(yīng)確定支付是否完成。
這個(gè)流程還是蠻容易理解的。形象的說,前端就是個(gè)顧客,后端就是店家,微信服務(wù)器的統(tǒng)一下單接口就像收銀員。顧客跟店家說,我是誰誰誰,現(xiàn)在我要付多少多少錢給你買什么什么。店家就跟收銀員說,那個(gè)誰誰誰要付多少錢,你準(zhǔn)備收錢吧。收銀員收到錢后,就去告訴店家,我已經(jīng)收到錢了,你給他東西吧。
下面就詳細(xì)的說明一下各個(gè)步驟的具體實(shí)現(xiàn)。
1. 前端請(qǐng)求支付
前端請(qǐng)求支付,就是簡(jiǎn)單的攜帶支付需要的數(shù)據(jù),例如用戶標(biāo)識(shí),支付金額,支付訂單 ID 等等跟 **你的業(yè)務(wù)邏輯有關(guān)** 或者跟 **下一步請(qǐng)求微信服務(wù)器支付統(tǒng)一下單接口需要的數(shù)據(jù)有關(guān)** 的相關(guān)數(shù)據(jù),使用微信小程序的 wx.request( ) 去請(qǐng)求后端的支付接口。
2. 后端請(qǐng)求微信服務(wù)器
后端接收到前端發(fā)送的支付請(qǐng)求后,可以進(jìn)行一下相關(guān)驗(yàn)證,例如判斷一下用戶有沒有問題,支付金額對(duì)不對(duì)等等。
在驗(yàn)證沒什么問題,可以向微信服務(wù)器申請(qǐng)支付之后,后端需要使用 微信規(guī)定的數(shù)據(jù)格式 去請(qǐng)求微信的支付統(tǒng)一下單接口。
微信規(guī)定的請(qǐng)求數(shù)據(jù):
這需要較多代碼實(shí)現(xiàn)。因?yàn)樾枰臄?shù)據(jù)個(gè)數(shù)較多,而且還需要加密并以 XML 格式發(fā)送。
首先,有以下數(shù)據(jù)是使用小程序支付必須提供給微信服務(wù)器的參數(shù)。
小程序 appid。寫小程序的大概沒有不知道這個(gè)的。。。
用戶標(biāo)識(shí) openid。也就是用戶的小程序標(biāo)識(shí),在我上篇博客中說明了如何獲取。
商戶號(hào) mch_id 。申請(qǐng)開通微信支付商戶認(rèn)證成功后微信發(fā)給你的郵件里有
商戶訂單號(hào) out_trade_no 。商戶為這次支付生成的訂單號(hào)
總金額 total_fee 。訂單總金額,很重要的一點(diǎn)是單位是分,要特別注意。
微信服務(wù)器回調(diào)通知接口地址 notify_url。微信確認(rèn)錢已經(jīng)到賬后,會(huì)往這個(gè)地址多次發(fā)送消息,告訴你顧客已經(jīng)付完錢了,你需要返回消息給微信表示你已經(jīng)收到了通知。。這個(gè)地址不能有端口號(hào),同時(shí)要能直接接受POST方法請(qǐng)求。
交易類型 trade_type 。微信小程序支付此值統(tǒng)一為 JSAPI
商品信息 Body。類似"騰訊-游戲"這種格式
終端IP地址 spbill_create_ip 。終端地址IP,也就是請(qǐng)求支付的 IP 地址。
隨機(jī)字符串 nonce_str 。需要后端隨機(jī)生成的字符串用于保證數(shù)據(jù)安全。微信要求不長(zhǎng)于32位。
簽名 sign 。使用上面的所有參數(shù)進(jìn)行相應(yīng)處理加密生成簽名。(具體處理方式可見下文代碼,可直接復(fù)用。)
在處理好以上所有數(shù)據(jù)后,將這些數(shù)據(jù)以 XML 格式整理并以 POST 方法發(fā)送到 微信支付統(tǒng)一下單接口
3.后端接受微信服務(wù)器返回?cái)?shù)據(jù)
微信服務(wù)器在接收到支付數(shù)據(jù)之后,如果數(shù)據(jù)沒有問題,其會(huì)返回用于支付的相應(yīng)數(shù)據(jù),其中非常重要的是 名稱為 prepay_id 的數(shù)據(jù)字段,需要將此數(shù)據(jù)返回前端,前端才能繼續(xù)支付。
因此,在后端接收到微信服務(wù)器的返回?cái)?shù)據(jù)后,需要進(jìn)行相應(yīng)的處理,最終返回到前端如下數(shù)據(jù):
appid 不需多說
timeStamp 當(dāng)前時(shí)間戳
nonceStr 隨機(jī)字符串
package 就是上面提到的 prepay_id,不過切記格式如 “prepay_id= prepay_id_item“。否則會(huì)導(dǎo)致錯(cuò)誤。
signType 加密方式,一般應(yīng)該是 MD5
paySign 對(duì)以上數(shù)據(jù)進(jìn)行相應(yīng)處理并加密。
到這里,后端的支付接口已經(jīng)完成了接收前端支付請(qǐng)求,并返回了前端支付所需數(shù)據(jù)的功能。
4. 前端發(fā)起支付
前端在接收到返回?cái)?shù)據(jù)后,使用 wx.requestPayment() 來請(qǐng)求發(fā)起支付。此 API 需要的對(duì)象參數(shù)各項(xiàng)值就是我們上一步返回的各個(gè)數(shù)據(jù)。
5.后端接受微信服務(wù)器回調(diào)
前端完成支付后,微信服務(wù)器確認(rèn)支付已經(jīng)完成。就會(huì)向第一步中設(shè)置的回調(diào)地址發(fā)送通知。后端的接收回調(diào)接口在接收到通知后,就可以判斷支付是否完成,從而決定后續(xù)動(dòng)作。
需要注意的是,在接收到微信服務(wù)器的回調(diào)通知后,根據(jù)通知的result_code字段判斷支付是否成功。在接受到成功的通知后,后端需要返回success數(shù)據(jù)向微信服務(wù)器告知已得到回調(diào)通知。否則微信服務(wù)器會(huì)不停的向后端發(fā)送消息。另外微信的通知是以XML格式發(fā)送的,在接受處理時(shí)需要注意。
微信的大概支付流程就是這樣。以下是PHP語(yǔ)法的微信支付類,可以比照上面的步驟介紹,加深理解。在需要支付時(shí),直接傳入?yún)?shù)實(shí)例化此類再調(diào)用類的 pay 方法即可。
//微信支付類 class WeiXinPay{ //=======【基本信息設(shè)置】===================================== //微信公眾號(hào)身份的唯一標(biāo)識(shí) protected $APPID = appid;//填寫您的appid。微信公眾平臺(tái)里的 protected $APPSECRET = secret; //受理商ID,身份標(biāo)識(shí) protected $MCHID = '11111111';//商戶id //商戶支付密鑰Key protected $KEY = '192006250b4c09247ec02edce69f6a2d'; //回調(diào)通知接口 protected $APPURL = 'https://smart.afei.com/receivesuc'; //交易類型 protected $TRADETYPE = 'JSAPI'; //商品類型信息 protected $BODY = 'wx/book'; //微信支付類的構(gòu)造函數(shù) function __construct($openid,$outTradeNo,$totalFee){ $this->openid = $openid; //用戶唯一標(biāo)識(shí) $this->outTradeNo = $outTradeNo; //商品編號(hào) $this->totalFee = $totalFee; //總價(jià) } //微信支付類向外暴露的支付接口 public function pay(){ $result = $this->weixinapp(); return $result; } //對(duì)微信統(tǒng)一下單接口返回的支付相關(guān)數(shù)據(jù)進(jìn)行處理 private function weixinapp(){ $unifiedorder=$this->unifiedorder(); $parameters=array( 'appId'=>$this->APPID,//小程序ID 'timeStamp'=>''.time().'',//時(shí)間戳 'nonceStr'=>$this->createNoncestr(),//隨機(jī)串 'package'=>'prepay_id='.$unifiedorder['prepay_id'],//數(shù)據(jù)包 'signType'=>'MD5'//簽名方式 ); $parameters['paySign']=$this->getSign($parameters); return $parameters; } /* *請(qǐng)求微信統(tǒng)一下單接口 */ 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(),//隨機(jī)字符串 'out_trade_no'=>$this->outTradeNo,//商戶訂單編號(hào) '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; } //數(shù)組轉(zhuǎn)字符串方法 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; } //發(fā)送xml請(qǐng)求方法 private static function postXmlCurl($xml, $url, $second = 30) { $ch = curl_init(); //設(shè)置超時(shí) 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); //嚴(yán)格校驗(yàn) //設(shè)置header curl_setopt($ch, CURLOPT_HEADER, FALSE); //要求結(jié)果為字符串且輸出到屏幕上 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); //運(yùn)行curl $data = curl_exec($ch); //返回結(jié)果 if ($data) { curl_close($ch); return $data; } else { $error = curl_errno($ch); curl_close($ch); throw new WxPayException("curl出錯(cuò),錯(cuò)誤碼:$error"); } } /* * 對(duì)要發(fā)送到微信統(tǒng)一下單接口的數(shù)據(jù)進(jìn)行簽名 */ protected function getSign($Obj){ foreach ($Obj as $k => $v){ $Parameters[$k] = $v; } //簽名步驟一:按字典序排序參數(shù) ksort($Parameters); $String = $this->formatBizQueryParaMap($Parameters, false); //簽名步驟二:在string后加入KEY $String = $String."&key=".$this->KEY; //簽名步驟三:MD5加密 $String = md5($String); //簽名步驟四:所有字符轉(zhuǎn)為大寫 $result_ = strtoupper($String); return $result_; } /* *排序并格式化參數(shù)方法,簽名時(shí)需要使用 */ 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; } /* * 生成隨機(jī)字符串方法 */ 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; } }
以上就是微信支付的相關(guān)流程。在理清思路后,流程還是比較清晰和簡(jiǎn)單的。重點(diǎn)在于需要注意一些細(xì)節(jié)問題,例如數(shù)據(jù)格式,加密方法等。
下面說一下微信小程序退款的具體實(shí)現(xiàn)
二、微信退款
小程序退款的流程和付款相似,但有一些細(xì)節(jié)上的不同。
首先退款的步驟通常如下:
用戶前端點(diǎn)擊退款按鈕后,后端接收到用戶的退款請(qǐng)求通過商城后臺(tái)呈現(xiàn)給商戶,商戶確定允許退款后,后端再發(fā)起向微信退款接口的請(qǐng)求來請(qǐng)求退款。
后端向微信退款接口發(fā)送請(qǐng)求后,得到響應(yīng)信息,確定退款是否完成,根據(jù)退款是否完成再去進(jìn)行改變訂單狀態(tài)等業(yè)務(wù)邏輯。
退款的步驟相對(duì)微信支付來說比較簡(jiǎn)單。
值得注意的有以下兩點(diǎn):
1.向微信退款接口請(qǐng)求退款后,根據(jù)得到的響應(yīng)是可以直接確定退款是否完成的。不再需要設(shè)置專門的回調(diào)接口等待微信通知。當(dāng)然如果需要也是可以在微信商戶平臺(tái)設(shè)置回調(diào)接口接受從而接受微信回調(diào)的,但并不是必須的。
2.退款請(qǐng)求需要在請(qǐng)求服務(wù)器安裝微信提供的安全證書,也就是說,發(fā)起退款請(qǐng)求相比較支付請(qǐng)求在請(qǐng)求時(shí)請(qǐng)求方法不能復(fù)用,因?yàn)槲⑿磐丝钚枰獢y帶證書的請(qǐng)求,此證書可在申請(qǐng)微信商戶號(hào)成功后從微信商戶平臺(tái)自行下載,Linux下的PHP開發(fā)環(huán)境的證書只需要放在網(wǎng)站根目錄的cert文件夾中即可。其他開發(fā)環(huán)境可能需要導(dǎo)入操作。
下面講解一下退款的具體步驟
一. 用戶發(fā)起退款請(qǐng)求
用戶在前端發(fā)起退款請(qǐng)求,后端接收到退款請(qǐng)求,將相應(yīng)訂單標(biāo)記為申請(qǐng)退款,展示在后臺(tái).商戶查看后,如果同意退款再進(jìn)行相應(yīng)操作.此后才進(jìn)入真正的退款流程.
二. 商戶發(fā)起退款請(qǐng)求
商戶同意退款后,后端即向微信提供的退款 API 發(fā)起請(qǐng)求.
同請(qǐng)求微信支付API一樣.退款請(qǐng)求也需要將需要的參數(shù)進(jìn)行簽名后以XML發(fā)送到微信的退款A(yù)PI
退款請(qǐng)求需要的參數(shù)如下(多個(gè)參數(shù)在支付API請(qǐng)求時(shí)也有使用):
參數(shù):
appid
mch_id 商戶號(hào)。申請(qǐng)開通微信支付商戶認(rèn)證成功后微信發(fā)給你的郵件里有
out_trade_no 商戶訂單號(hào)。退款訂單在支付時(shí)生成的訂單號(hào)
out_refund_no 退款訂單號(hào)。由后端生成的退款單號(hào),需要保證唯一,因?yàn)槎鄠€(gè)同樣的退款單號(hào)只會(huì)退款一次。
total_fee 總金額。訂單總金額,單位為分。
refund_fee 退款金額。 需要退款的金額,單位同樣為分
op_user_id 操作員。與商戶號(hào)相同即可
nonce_str 隨機(jī)字符串。同支付請(qǐng)求
簽名 sign 。使用上面的所有參數(shù)進(jìn)行相應(yīng)處理加密生成簽名。(具體處理方式與支付相同,可直接復(fù)用。)
注:我就是因?yàn)樵趯?shí)例化的時(shí)候沒有傳入key(秘鑰)參數(shù),一直報(bào)錯(cuò)簽名錯(cuò)誤。
三、退款完成
在發(fā)起退款請(qǐng)求后,就可以直接根據(jù)請(qǐng)求的響應(yīng)XML中的 result_code字段來判斷退款是否成功,從而對(duì)訂單狀態(tài)進(jìn)行處理和后續(xù)操作。不需要像支付那樣等待另一個(gè)接口的通知來確定請(qǐng)求狀態(tài)。當(dāng)然如上文所說,如果需要微信服務(wù)器發(fā)送通知到后端的話,可以到微信商戶平臺(tái)進(jìn)行設(shè)置。
退款因?yàn)榱鞒膛c支付大同小異,因此退款的PHP類我選擇了直接繼承支付類,
代碼如下,注意區(qū)分退款請(qǐng)求方法postXmlSSLCurl和支付請(qǐng)求方法postXmlCurl的區(qū)別,這也就是上文提到的退款需要的雙向證書的使用。
class WinXinRefund extends WeiXinPay{ protected \$SSLCERT_PATH = 'cert/apiclient_cert.pem';//證書路徑 protected \$SSLKEY_PATH = 'cert/apiclient_key.pem';//證書路徑 protected \$opUserId = '1234567899';//商戶號(hào) 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(){ //對(duì)外暴露的退款接口 $result = $this->wxrefundapi(); return $result; } private function wxrefundapi(){ //通過微信api進(jìn)行退款流程 $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; } //需要使用證書的請(qǐng)求 function postXmlSSLCurl($xml,$url,$second=30) { $ch = curl_init(); //超時(shí)時(shí)間 curl_setopt($ch,CURLOPT_TIMEOUT,$second); //這里設(shè)置代理,如果有的話 //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); //設(shè)置header curl_setopt($ch,CURLOPT_HEADER,FALSE); //要求結(jié)果為字符串且輸出到屏幕上 curl_setopt($ch,CURLOPT_RETURNTRANSFER,TRUE); //設(shè)置證書 //使用證書:cert 與 key 分別屬于兩個(gè).pem文件 //默認(rèn)格式為PEM,可以注釋 curl_setopt($ch,CURLOPT_SSLCERTTYPE,'PEM'); curl_setopt($ch,CURLOPT_SSLCERT, $this->SSLCERT_PATH); //默認(rèn)格式為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); //返回結(jié)果 if($data){ curl_close($ch); return $data; } else { $error = curl_errno($ch); echo "curl出錯(cuò),錯(cuò)誤碼:$error"."<br>"; curl_close($ch); return false; } }}
到此這篇關(guān)于PHP微信支付與退款功能實(shí)現(xiàn)流程詳解的文章就介紹到這了,更多相關(guān)PHP微信支付內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
PHP讀取并輸出XML文件數(shù)據(jù)的簡(jiǎn)單實(shí)現(xiàn)方法
這篇文章主要介紹了PHP讀取并輸出XML文件數(shù)據(jù)的簡(jiǎn)單實(shí)現(xiàn)方法,涉及php針對(duì)xml格式文件數(shù)據(jù)的載入、遍歷、讀取、輸出等相關(guān)操作技巧,需要的朋友可以參考下2017-12-12php實(shí)現(xiàn)的RSS生成類實(shí)例
這篇文章主要介紹了php實(shí)現(xiàn)的RSS生成類,實(shí)例分析了RSS生成類的原理、定義與使用技巧,非常具有實(shí)用價(jià)值,需要的朋友可以參考下2015-04-04php5.2的curl-bug 服務(wù)器被php進(jìn)程卡死問題排查
這篇文章主要介紹了php5.2的curl-bug 服務(wù)器被php進(jìn)程卡死問題排查,需要的朋友可以參考下2016-09-09PHP關(guān)聯(lián)數(shù)組的10個(gè)操作技巧
數(shù)組中的元素都有自己的ID,因此可以方便地訪問它們;關(guān)聯(lián)數(shù)組,它的每個(gè)ID 鍵都關(guān)聯(lián)一個(gè)值;這篇文章將介紹10個(gè)操作PHP關(guān)聯(lián)數(shù)組的技巧,熟練運(yùn)用能幫助你提高開發(fā)效率2013-01-01PHP imagecreatefrombmp 從BMP文件或URL新建一圖像
大家都知道php GD庫(kù)可方便的從URL新建一圖像, GD中有imagecreatefromjpeg(),imagecreatefromPNG()....等2012-07-07