微信入金接入流程:用戶充值、支付確認與余額入賬
這里的“微信入金”,是用戶使用微信給你的網站或APP付款充值:稳付pay確認支付結果后通知你的服務器,你的系統核驗通知,再給對應用戶增加站內余額。付款確認與余額記賬各有職責,接入時必須把它們串成可核對、可重試且不重復充值的完整流程。
文章目錄
一、先明確入金到哪里、誰負責記賬
用戶購買的是你站點或應用里的充值金額,不是向微信錢包本身充值。稳付pay負責接入已開通的微信支付通道、確認付款結果并發送訂單通知;商戶負責維護用戶賬戶、余額流水和后續消費規則。
充值頁面應寫清余額可消費的范圍、有效期和售后規則。有贈送額度時,實付金額與贈送部分分別記錄,不能用最終增加的余額反推支付金額。消費、退款或人工調整也應產生獨立流水,保留原因與關聯訂單,不能刪除原充值記錄來改賬。
一次充值應能從用戶賬戶追溯到商戶訂單,再追溯到平臺支付記錄。不能只憑用戶昵稱、截圖或同金額付款認領余額,也不要把“訂單已創建”當成“充值已到賬”。本文不表示已提供微信提現或USDT兌換功能,獨立代付接口暫未開放。
二、一筆微信充值的六步流程
- 用戶發起充值選擇金額,商戶后端綁定用戶并生成唯一充值訂單。
- 展示微信支付入口后端調用已開通通道,展示實際返回的支付信息。
- 稳付pay確認付款關聯原訂單并核實支付成功結果。
- 發送服務端回調向商戶配置的通知地址發送標準支付通知。
- 商戶驗簽核對驗證簽名、商戶、訂單、金額、幣種及成功狀態。
- 原子增加用戶余額同一事務保存支付、唯一余額流水與余額更新,再確認通知。
三、下單前固定用戶與應付金額
先保存本地充值訂單,記錄用戶ID、商戶訂單號、應付金額、幣種及充值規則快照。這些是商戶自己的業務數據,不代表接口額外接受同名參數。金額由后端計算,不能讓前端修改價格或通過回調重新指定充值用戶。
按代收下單文檔傳入商戶號、已開通的通道編碼、訂單號、金額、通知地址、當前毫秒時間戳和簽名。下單金額單位為分,例如1000表示10.00元。微信聚合編碼為90001,但是否可用以商戶授權和實際配置為準。
微信個碼與原生通道的展示方式、設備限制和操作步驟,由技術團隊在接入時確認;不要自行拼造支付入口。微信官方Native產品說明可幫助理解掃碼術語,但稳付pay的聚合MD5協議不能當作微信官方API使用。
四、收到回調后,先驗證再準備入賬
按標準回調文檔驗證Body中的sign:優先使用配置的CALLBACK_SECRET,未單獨配置才使用MD5_SECRET。保留通知原值后驗簽,不提前把00變為0、把10.00變為10;密鑰只放在服務端。
驗簽通過仍需核對商戶號、業務類型、原訂單號、平臺訂單號、金額及幣種,確認成功狀態。回調amount單位分,應與本地應付金額一致。用戶應由已保存的原訂單確定,不能由通知里的任意附加值替換。
未知訂單、金額不符或狀態沖突應記錄異常并聯系技術核實,不自動加余額。瀏覽器返回成功或用戶點擊“已付款”,只能讓前端向自己的后端查詢充值進度。
五、唯一流水和余額更新必須一起提交
為充值流水設置數據庫唯一約束,例如以“商戶+充值訂單”作為業務唯一鍵;訂單、流水與用戶余額放在同一事務中更新。先查有沒有再寫入,無法擋住兩個并發回調。
驗證支付通知并核對原訂單
開啟數據庫事務
鎖定充值訂單與相關賬戶記錄
若該訂單已有成功充值流水:不再加余額
否則:保存唯一流水、增加對應用戶余額、更新充值狀態
提交事務
返回 HTTP 200,純文本 OK以上是商戶記賬偽代碼,不是稳付pay新增接口。數據庫出錯則回滾,不先回復成功。已確認處理過的重復通知可返回OK;余額流水、支付記錄和賬戶更新應始終一致。查單補償也調用這一處理函數,不另寫一條繞過冪等檢查的加款路徑。
六、超時、重復通知與晚到付款怎么處理
| 場景 | 正確處理 |
|---|---|
| 創建請求超時 | 用原訂單號查單,不直接更換單號再充值。 |
| 付款后余額未增加 | 核對支付、回調處理和本地流水,不能憑截圖直接加款。 |
| 重復回調或查單并發 | 統一進入唯一流水約束保護的記賬事務。 |
| 訂單過期后收到有效付款 | 保存付款事實,按約定補入賬或處理退款,不直接忽略。 |
稳付pay標準通知最多共3次,含首次,前兩次失敗后約60秒、300秒重試,因此還需主動查單補償。查詢響應金額單位在開通時確認后再換算比較。微信官方回調與查單指引也強調,通知可能延遲或遺漏,頁面返回后仍需服務端核實;本文不照搬其API字段或應答規則。
七、用戶余額與商戶USDT結算分開核對
“用戶充值成功”表示用戶在商戶系統中的余額已正確增加;“商戶結算完成”表示相關款項按約定結付給商戶。兩者不是同一筆賬戶余額,也不是同一個狀態。
渠道代收后可按雙方約定進行T0實時USDT結算,網絡、地址、換算與費用另行確認。結算仍在確認不能把用戶已付款改成失敗;用戶已經加款,也不等于商戶錢包已收到USDT。詳見商戶結算完整流程。
八、常見問題與上線驗收
用戶關閉頁面后,還能充值到賬嗎?
可以按服務端結果繼續處理,不依賴用戶回到網頁。商戶需正確接收通知并執行查單補償。
重復回調會把余額加兩次嗎?
正確實現唯一充值流水與原子事務后,同一付款只入賬一次;只在頁面上禁用按鈕不能防止并發重復記賬。
怎樣開始接入稳付pay?
聯系技術團隊說明網站或APP、充值規則和支付需求,確認通道與商戶配置,再按開發文檔聯調。
上線前至少驗證正常充值、重復通知、通知與查單并發、數據庫失敗回滾、關閉頁面和晚到付款。每個測試都要核對訂單、支付記錄、余額流水和最終余額,確認金額準確且只加一次。