微信小程序支付及退款流程詳解【上】
首先說明一下，微信小程序支付的主要邏輯集中在后端，前端只需攜帶支付所需的數據請求后端接口然后根據返回結果做相應成功失敗處理即可。我在后端使用的是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 方法發送到 微信支付統一下單接口 https://api.mch.weixin.qq.com/pay/unifiedorder 。
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; }} |
以上就是微信支付的相關流程。在理清思路后，流程還是比較清晰和簡單的。重點在于需要注意一些細節問題，例如數據格式，加密方法等。
