以下示範如何在網頁中串接微信 JSAPI 支付:先向後端取得支付參數,再依序呼叫 wx.config 與 wx.chooseWXPay 拉起支付面板。
$('.Save_Patient_Msg').click(function(){ $('.Save_Patient_Msg').off('click'); // 防止重複點擊 var hrdfId = getOrderId(); var data = { orderId: hrdfId, txnAmt: "0.01", prodDesc: "遠程診斷服務", callType: "JSAPI", access_token: getUrlParam("access_token") }; $.ajax({ type: 'POST', url: '/hims/api/commonPay/queryTransNo?access_token=' + getUrlParam('access_token'), dataType: 'json', contentType: 'application/json', data: JSON.stringify(data), success: function(Wxres){ if (!Wxres) { $.alert('服務器擁堵,請稍後訪問'); return; } if (Wxres.data.respCode == 'fail') { $.alert(Wxres.data.respMsg); return; } // 10 微信支付接口 // 10.1 發起支付請求 var param = Wxres.data; wx.config({ debug: false, // 開啟後所有 api 返回值會 alert 出來,僅 PC 端會 log 參數 appId: 'wx403ead26691402fb', // 公眾號唯一標識 timestamp: param.timestamp, // 生成簽名的時間戳 nonceStr: param.noncestr, // 生成簽名的隨機串 signature: param.signJs, // 支付簽名 jsApiList: ['chooseWXPay'] // 需要使用的 JS 接口 }); wx.chooseWXPay({ timestamp: param.timestamp, // 注意:jssdk 中一律小寫 timestamp,但後端簽名用的 timeStamp 大寫 S nonceStr: param.noncestr, // 隨機串,不長於 32 位 package: "prepay_id=" + param.transNo, // 統一支付接口回傳的 prepay_id signType: "MD5", // 新版支付需傳 MD5 paySign: param.sign, success: function (res) { if (res.errMsg == "chooseWXPay:ok") { window.location.href = "/hims/weixin/pages/Order_ok.html?access_token=" + getUrlParam("access_token"); } else { alert(res.errMsg); } }, cancel: function(res){ // 使用者取消 } }); }, error: function(data){ var msg = data.message || data.status; $.alert('服務器錯誤' + msg); } }); return false; }); function getUrlParam(name){ var reg = new RegExp("(^|&)" + name + "=([^&]*)(&|$)") // 構造含目標參數的正則 var r = window.location.search.substr(1).match(reg); // 匹配 if (r != null) return unescape(r[2]); return null; }
1. 簽名一律由後端產生。 signature 與 paySign 都涉及商戶金鑰,絕不能放在前端計算,否则金鑰等於公開。
2. timestamp 的大小寫陷阱。 jssdk 規定使用小寫的 timestamp,而微信支付後端產生簽名時用的是 timeStamp(大寫 S)。這個不一致是新手最常卡住的地方。
3. 金額應以「分」為單位整數傳輸。 範例中 txnAmt 用了字串 "0.01",實際串接時建議後端統一以整數分計算,避免浮點誤差。
4. 記得解除綁定。 範例開頭的 $('.Save_Patient_Msg').off('click') 是為了防止使用者連續點擊送出多筆訂單;更嚴謹的做法是搭配一個全域旗標,在支付流程結束(不論成功、取消或失敗)後再恢復。
本文已整理進《JavaScript 微信開發技巧匯總》,另有《微信小程序開發教程》可一併參考。