DIV CSS 佈局教程網

微信 H5 支付踩坑記錄:兩次簽名、版本判斷與那些容易漏掉的細節
編輯:關於JavaScript     

在 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、憑證與平台證書簽驗),動手前請務必以官方最新文件為準,這裡的流程是理解整體結構用的骨架。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved