下面以PHP語言為例,對微信支付的開發流程進行一下說明。
1.擷取訂單資訊
2.根據訂單資訊和支付相關的帳號產生sign,並且產生支付參數
3.將支付參數資訊POST到微信伺服器,擷取返回資訊
4.根據返回資訊產生相應的支付代碼(微信內部)或是支付二維碼(非微信內),完成支付。
下面分步驟的講一下:
1.微信支付中相關的必須的訂單參數有三個,分別是:body(商品名或訂單描述),out_trade_no(一般為訂單號)和total_fee(訂單金額,單位“分”,要注意單位問題),在不同的應用中,首先要做的就是擷取訂單中的相關資訊,為支付參數產生做準備。
2.其他必須的支付參數有 appid(微信appid),mch_id(申請成功後告知),device_info(web端和微信端該參數都是統一的,為大寫的”WEB“),trade_type(根據使用情境不同,該值也是不同的,微信外部為”NATIVE“,微信內部為”JSAPI“),nonce_str(32位隨機字串),spbill_create_ip(發起支付的終端IP,即伺服器IP),notify_url(支付回調地址,微信伺服器通知網站支付完成與否,修改訂單狀態),sign(簽名),還有一個需要說明的地方,如果trade_type為JSAPI的話,openid為必填的參數。
簽名演算法是比較容易出錯的地方,在於簽名步驟繁瑣,其實很關鍵的是,sign不參與簽名
A:將1、2中提到的除sign外的參數賦值,放到一個數組array裡面,按照字典順序排序,其實就是索引值按照A—Z的順序進行排序。
B:將數群組轉換成字串string,格式為 k1=v1&k2=v2&...kN=vN
C:在此string後加上KEY值(在微信支付商戶後台使用者自己設定的)現在string = k1=v1&k2=v2&...kN=vN&key=KEY。
D:string = md5(string)
E: sign = strtoupper(string)
至此,sign產生完畢。
將sign添加到array數組裡面產生新的數組。將該數群組轉換為XML。至此,微信支付的參數準備工作完成。
3.將2中產生的XML,使用POST的方式發送請求到微信(https://api.mch.weixin.qq.com/pay/unifiedorder),擷取返回的XML資訊,將該資訊轉換成數組格式方便操作。返回的XML資訊如下:
<xml> <return_code><![CDATA[SUCCESS]]></return_code> <return_msg><![CDATA[OK]]></return_msg> <appid><![CDATA[wx2421b1c4370ec43b]]></appid> <mch_id><![CDATA[10000100]]></mch_id> <nonce_str><![CDATA[IITRi8Iabbblz1Jc]]></nonce_str> <sign><![CDATA[7921E432F65EB8ED0CE9755F0E86D72F]]></sign> <result_code><![CDATA[SUCCESS]]></result_code> <prepay_id><![CDATA[wx201411101639507cbf6ffd8b0779950874]]></prepay_id> <trade_type><![CDATA[JSAPI]]></trade_type></xml>
如果是trade_type==native支付的話,還會多一個參數code_url,該URL為微信掃碼支付的地址。
4.下面就是支付的過程了。
如果trade_type==native,那麼使用一些方式將code_url轉換成二維碼,使用微信掃碼就可以了,如果是微信內部點擊支付的話,需要調用微信js-sdk中的相關東西,這一步中最關鍵是產生一個json格式的字串。
首先要產生轉換json字串的數組array_jsapi。
A:該數組的參數包括:appId,timeStamp,nonceStr,package,signType(預設為”MD5“),要注意大小寫和上面的數組裡面是不一樣的。
B:使用該數組產生paySign參數,簽名方式同上。
C:將paySign參數追加到array_jsapi數組中。
D:將該數組使用json_encode格式化為字串js_string。
完成上面的工作,就可以在微信內部進行支付了。
下面為相關支付的範例程式碼:
<script type='text/javascript'> function jsApiCall() { WeixinJSBridge.invoke( 'getBrandWCPayRequest', $js_string, function(res){ WeixinJSBridge.log(res.err_msg); if(res.err_msg=='get_brand_wcpay_request:ok') { alert('支付成功'); } else { alert('支付失敗'); } } ); } function callpay() { if (typeof WeixinJSBridge == 'undefined'){ if( document.addEventListener ){ document.addEventListener('WeixinJSBridgeReady', jsApiCall, false); }else if (document.attachEvent){ document.attachEvent('WeixinJSBridgeReady', jsApiCall); document.attachEvent('onWeixinJSBridgeReady', jsApiCall); } }else{ jsApiCall(); } } </script>
代碼中js_string即為我們產生的字串。
HTML代碼中調用callpay()函數發起支付。
這樣微信支付的支付工作就完成了。
下面是回調工作,該功能確保訂單支付成功後,有正確的狀態顯示給使用者。
支付完成後,微信使用POST請求,將支付結果反饋給網站伺服器,網站伺服器擷取POST資訊,根據支付成功與否,來確定是否修改訂單資訊。
A:將POST參數中的sign去除,並且記錄下來該值。
B:對剩餘的參數進行簽名
C:將簽名結果和POST中的sign進行比對,相同說明簽名正確,根據支付結果修改訂單狀態。
E:返回XML資訊給微信,確保微信知道網站已經收到該通知,避免微信再次推送POST,樣本如下:
<xml> <return_code><![CDATA[SUCCESS]]></return_code> <return_msg><![CDATA[OK]]></return_msg></xml>
如果失敗,則返回
<xml> <return_code><![CDATA[FAIL]]></return_code> <return_msg><![CDATA[失敗原因]]></return_msg></xml>
至此,微信支付的整個開發介紹完畢。