在 H5 頁面裡接入微信支付,流程本身不複雜,但環節多、錯誤訊息又含糊,第一次做很容易卡在「錢扣了卻說失敗」或「一律調不起支付視窗」。這裡把整個流程與常見的失敗點整理成一份清單。
先申請公眾號並開通支付功能,然後到微信公眾平台的「微信支付」頁面完成三項設定:支付授權目錄、測試授權目錄、測試白名單。接著在「開發者中心」取得 AppID 與 AppSecret,再到商戶平台取得商戶號,並自行設定一個商戶支付密鑰。
這是最多人搞錯的地方。第一次簽名(用 AppID、AppSecret、商戶號、商戶密鑰等參數做 MD5)是為了向 API 換取 prepay_id;第二次簽名則是用 prepay_id 加上時間戳、隨機字串與 package 等參數再簽一次,這一次的結果才是前端要用的 paySign。兩次用的參數完全不同,混用必然失敗。
$.get('/xxx', function(data){
if (data && data !== "") {
var _data = $.parseJSON(data)[0];
if (parseInt(_data.userAgent) < 5) {
alert('您的微信版本低於 5.0,無法使用微信支付!');
return false;
}
WeixinJSBridge.invoke('getBrandWCPayRequest', {
'appId': _data.appId,
'timeStamp': _data.timeStamp,
'nonceStr': _data.nonceStr,
'package': 'prepay_id=' + _data.packageOne,
'signType': _data.signType,
'paySign': _data.paySign
}, function(res){
if (res.err_msg === 'get_brand_wcpay_request:ok') {
alert('支付成功,返回訂單列表!');
} else if (res.err_msg === 'get_brand_wcpay_request:cancel') {
alert('取消支付!');
}
});
}
});
一、支付目錄不匹配。你在公眾平台設定的授權目錄,必須是發起支付的那個頁面的上層目錄,路徑結尾還要有斜線。這個設定錯了,什麼都調不起來。
二、簽名混淆。如前面所述,前端要的是第二次簽名,而且參數傳遞的順序與名稱一個都不能錯。
三、body 裡有中文沒編碼。商品名稱含中文時必須先做 URL 編碼再參與簽名,否則後端簽出來的結果和微信端計算的不一致。
四、只處理成功與取消。實際上還有其他分支,例如使用者關閉、支付失敗、網路異常,都要有對應的處理,否則畫面會卡住。
如果使用者在支付視窗停留很久,可能在你的網站上訂單早已失效,微信端卻仍能完成付款。目前程式裡沒有機制判斷這種逾時狀態。實務上的解法是:以「後端的付款通知」為準來確認訂單狀態,而不是相信前端的回呼結果——微信的異步通知加上訂單逾時檢查,才是唯一可靠的對帳依據。前端 alert 只負責提示,不能當作交易成立與否的判斷。
最後提醒:微信的 API 與安全規範會持續更新(例如新版要求以 APIv3、憑證與平台證書簽驗),動手前請務必以官方最新文件為準,這裡的流程是理解整體結構用的骨架。