H5微信喚醒支付怎么對接:瀏覽器跳轉、支付查單與餘額回調
H5微信喚醒支付,是用戶在手機瀏覽器的網站頁面發起付款,再跳轉微信收銀臺完成支付。接入時要把網頁跳轉、服務端確認付款和網站增加餘額連成閉環。本文依據微信支付官方資料解釋流程;通過稳付pay接入時,具體H5能力、商戶權限和接口參數須由技術人員確認。
按主題繼續閱讀
一、分清H5、微信內網頁和APP支付
微信官方H5支付面向微信客戶端以外的手機瀏覽器網頁。微信內打開的網頁通常對應JSAPI支付,原生APP則使用APP支付;不能因為APP內嵌了網頁,就直接把它當作官方H5使用場景。本文參考的第二份官方鏈接是APP開發指引,其中的OpenSDK、sendReq和onResp屬於另一套流程。
普通商戶直接接入官方H5前,需要具備相應商戶資質、H5產品權限、商戶號與APPID綁定關系,並配置H5支付域名。申請要求以官方當前說明為準。網站走稳付pay聚合通道時,應先告知技術人員域名、業務內容和打開方式,確認分配通道是否支持H5;本文上線不代表為所有商戶開通了該能力。
不要按瀏覽器名稱猜接口,也不要把所有“微信原生通道”都理解成同一種H5能力。先確認實際場景、權限和通道,再確定前端跳轉方式與後端協議。
二、稳付pay接入教程:從申請通道到測試上線
第1步,聯系稳付pay的@tonyyyds,說明網站域名、業務類型、手機瀏覽器或APP等使用場景、充值或訂閱流程、預計訂單量,以及USDT結算需求。技術人員會確認H5能力、可用通道、費率、結算口徑和聯調安排;不能只看到通道名稱就默認已經開通。
第2步,取得實際網關、商戶號mchId、已授權wayCode和服務端密鑰,準備公網notifyUrl及本地訂單表。密鑰只放後端。微信聚合編碼示例是90001,支付寶聚合編碼示例是80001,只有商戶已獲授權時才可使用,也可能分配真實通道編碼。
第3步,後端保存唯一outTradeNo和可信金額,再按下單文檔向POST /api/pay/collect/create發送JSON。amount以整數分提交,1000表示10元;reqTime使用當前毫秒整數,sign由後端按實際MD5規則生成。下面僅展示本篇支付方式的字段,占位值必須替換並重新簽名。
{
"mchId": "YOUR_MERCHANT_ID",
"wayCode": "90001",
"outTradeNo": "YOUR_UNIQUE_ORDER_NO",
"amount": 1000,
"currencyCode": "CNY",
"notifyUrl": "https://merchant.example.com/pay/notify",
"subject": "WENFUPAY_H5_DEMO",
"reqTime": "CURRENT_UNIX_MILLISECONDS",
"sign": "GENERATE_MD5_ON_SERVER"
}第4步,保存返回的平臺訂單號,取得有效payUrl後按技術方案展示或跳轉,不自行拼接微信或支付寶收銀臺鏈接。code=0僅代表請求業務受理成功,不能直接增加餘額。H5跳轉能否直接喚起客戶端,以實際通道和瀏覽器聯調結果為準。
第5步,接收稳付pay統一JSON通知,先驗簽再核對商戶、訂單、金額和幣種,成功後僅記賬一次;可靠保存後返回HTTP 200與純文本OK。未收到通知或下單結果未知時,由後端用原訂單調用GET /api/pay/collect/query補核,查詢金額單位按開通說明確認。
第6步,在技術人員安排的測試環境驗證支付、取消、超時、重復回調及餘額更新,核對首批正式訂單後逐步放量。下面提供接入咨詢和完整文檔入口。
三、為什么用稳付pay:通道與服務優勢
多種收款選擇:目前提供微信個碼代收、微信原生代收、支付寶原生代收,並支持聚合接入。商戶按實際業務配置支付方式,可減少逐個對接不同渠道的工作;具體H5能力仍取決於已開通通道。現有通道成功率表現穩定,實際結果受訂單、用戶環境和通道狀態影響,不承諾固定百分比。
統一訂單與回調:前端使用返回的支付入口,後端按統一下單、查詢與JSON回調流程處理,便於把網站充值、會員訂閱、發卡或TG機器人訂單接到自己的業務系統。平臺負責支付狀態通知,用戶餘額和權益由商戶按可信結果更新,不能把回調成功等同於所有業務都自動完成。
T0實時USDT結算:用戶付款確認後,可按雙方約定向商戶實時結算USDT,方便有該結算需求的網站安排資金。開通時確認可結算金額、服務費、換算口徑、結算網絡和地址;實際處理及鏈上到賬仍有條件與確認過程,不等於零費用、零確認或所有訂單無條件秒到。
技術人員協助聯調:從商戶參數、通道選擇、簽名、查單到回調異常可聯系團隊確認。微信、支付寶代收後以USDT結算,與USDT鏈上自有地址監控是兩種資金路徑;後者是客戶直接轉到商戶錢包,由稳付pay監控確認並回調,不能混寫成同一服務。
四、官方H5與稳付pay支付鏈接如何區分
先由網站後端創建本地訂單,綁定登錄用戶、商品或充值檔位、金額與幣種。金額從服務端價目表讀取,不能信任前端自行提交的價格。直接接官方API v3時,後端請求POST /v3/pay/transactions/h5,使用唯一out_trade_no,提交notify_url、amount及scene_info等要求字段;amount.total是人民幣分,例如10元填寫1000。簽名與私鑰留在服務端。稳付pay通道應使用實際文檔的字段、單位和簽名規則,不能直接套用官方參數。
取得h5_url後,由已配置H5支付域名的頁面跳轉該地址。指定返回頁面時,將redirect_url作為查詢參數追加到原支付鏈接,完整保留原有參數,並對返回地址正確編碼一次;返回域名也必須是已配置的H5支付域名。使用URL構造工具時避免重復編碼。redirect_url是瀏覽器返回地址,notify_url是服務端付款通知地址,不能互相代替。
官方H5開發指引給出的h5_url有效期是5分鐘,不等於訂單整體支付期限。鏈接過期後先核對訂單狀態;仍可付款時,按官方規則用原下單參數獲取新鏈接。業務訂單超過支付期限時,先查單再按接口規則關單或重建,不能僅憑頁面倒計時認定付款失敗。
五、返回後查單,確認成功再回調和增加餘額
支付完成與中途取消都可能返回商戶頁面。因此,回到redirect_url、前端顯示成功或者用戶上傳付款截圖,都不能單獨作為增加餘額的依據。返回頁可提供“我已支付,查詢結果”按鈕,由網站後端按該用戶有權查看的訂單查單,展示已付款、待確認等真實狀態。不要根據返回地址中的金額或success參數直接入賬。
直接接官方API的系統按API v3規範驗證通知、解密資源並核對訂單;稳付pay商戶按實際回調文檔驗簽。兩者都要核對收款身份、商戶訂單號、交易號、預期金額與幣種。查單和回調進入同一套狀態處理邏輯,不能把晚到的未支付結果覆蓋已經確認的成功結果。
以網站充值為例,為業務訂單建立唯一入賬記錄,在同一數據庫事務內更新訂單與餘額流水。回調重試、多次查單或頁面刷新不能再加一次錢。會員或商品交付也要防重;付款已確認但權益處理失敗時保留可重試任務,不要求用戶重新付款。通知已可靠落庫後,按所用接口約定應答。
六、喚不起微信、返回空白和到賬延遲怎么驗收
喚不起時記錄訂單號、發生時間、系統與瀏覽器、實際打開場景、錯誤提示及脫敏請求標識。依次檢查H5權限與域名、鏈接是否過期、跳轉鏈是否保留必要信息、客戶端是否允許打開微信。不要通過偽造來源或繞過域名檢查解決問題,也不要承諾所有瀏覽器都能自動喚醒。
返回空白時檢查redirect_url編碼、返回域名、頁面路由及登錄態恢復。付款已確認但餘額未變時,沿交易記錄、回調驗簽、訂單狀態、入賬流水定位;未收到回調可查單補核,不能盲目重建已付款訂單。日志要脫敏,支付鏈接和密鑰不應進入公開工單或網頁。
驗收至少覆蓋正常支付、取消返回、鏈接過期、關閉頁面、回調晚到或重復、查單與回調並發、餘額寫入失敗後恢復。確認同一訂單僅入賬一次,訂單號貫穿支付、通知和餘額流水。稳付pay可協助確認接入與回調方案;費率、通道範圍及USDT結算條件另行約定,喚起收銀臺不代表付款或商戶結算已經完成。
常見問題
H5喚醒支付不需要商戶資質,也不用配置域名嗎?
不是。直接接微信官方H5需要滿足其商戶與產品權限要求,並配置H5支付域名。通過稳付pay接入時,可用場景、業務審核、域名及參數由技術人員核實,不能理解為免審核或繞過微信規則。
用戶點了完成,卻沒有收到回調,可以直接給餘額嗎?
不能僅憑前端動作增加餘額。網站後端先查證付款結果,核對商戶、金額與幣種,再通過統一防重入賬流程處理。仍無法確認時顯示待核實並提供訂單號排查,避免用戶重復支付。