支付寶入金接入流程:網站APP充值、支付回調與余額記賬
支付寶入金,是用戶通過支付寶向你的網站或APP付款充值。稳付pay確認支付結果后,把訂單通知發送到你的服務器;你的系統完成驗簽和訂單核對,再增加對應用戶的站內余額。接入重點是讓付款、通知和記賬彼此可追溯,并確保同一筆付款不會被重復充值。
文章目錄
一、區分用戶充值、支付收款和賬戶記賬
用戶充值的是商戶系統中的余額,并非給支付寶錢包本身充值。稳付pay負責已開通的支付寶原生代收通道、支付結果確認及通知;商戶負責用戶賬戶、余額流水、消費記錄和售后規則。
充值頁面應說明余額用途、有效期、贈送額度及退款條件。實付金額與贈送部分分別記錄,不用最終增加的余額反推支付金額。消費、退款和人工調整各留獨立流水,不能刪除原充值記錄來改賬。本文所述服務不代表已開放支付寶出金或USDT兌換,獨立代付接口暫未開放。
二、一筆支付寶充值怎樣完成
- 用戶提交充值后端綁定用戶、確定金額,保存唯一充值訂單。
- 創建支付寶支付調用已開通通道,展示真實返回的支付信息。
- 平臺確認收款結果稳付pay關聯原訂單并確認支付成功。
- 發送服務端通知向商戶配置的notifyUrl發送標準回調。
- 商戶驗簽與核對檢查簽名、商戶、訂單、金額、幣種和成功狀態。
- 余額原子入賬同一事務保存支付、唯一充值流水及余額更新。
三、固定充值用戶、金額和通道配置
下單前保存用戶ID、商戶訂單號、金額、幣種及充值規則快照。這些是商戶自己的業務記錄,不是接口新增參數。應付金額從后端可信數據計算,不能直接接受瀏覽器改價,也不能在回調到達后臨時更換充值用戶。
按代收下單與查詢文檔填寫mchId、wayCode、outTradeNo、amount、notifyUrl、reqTime和sign等參數。amount單位為分,例如1000表示10.00元;reqTime使用當前毫秒時間戳。支付寶聚合編碼為80001,僅在商戶有授權且通道實際啟用時可用。
“支付寶原生”是本站現有通道的業務名稱。具體支付頁面、設備要求和接入交互,由技術團隊按配置聯調,不承諾任意通道都支持所有APP、H5或掃碼場景。只展示實際返回且有效的支付入口,不自行拼接收銀臺地址。
用戶進入實際支付寶付款頁后,應核對顯示的收款方和應付金額。與當前充值訂單不符時先暫停付款并聯系商戶核實,不自行改額后再要求后臺認領。商戶支付說明也應寫清訂單關聯和查詢入口,方便用戶付款后回查。
四、用稳付pay協議核驗回調
按簽名規則與回調文檔處理Body中的sign。回調優先使用CALLBACK_SECRET,未單獨配置時使用MD5_SECRET;按實際非空字段排序拼接后計算小寫MD5。保留00、10.00等原始字符串,不先轉換成0、10再驗簽,密鑰只保存于服務端。
驗簽后核對商戶歸屬、業務類型、原訂單、平臺訂單、分金額及幣種,確認成功狀態。未知訂單或金額不符不能自動加余額,需保留異常并聯系技術核查。前端跳轉成功或用戶點擊“已付款”,只能觸發向自己后端查詢進度。
本站聚合接口與支付寶官方直連協議不同。支付寶官方SDK的RSA2簽名實現不能替代這里的MD5規則;也不能把別處的success應答示例當作本文的處理流程。稳付pay標準回調建議在可靠保存后返回HTTP 200、純文本OK。
五、以唯一流水保護賬戶余額
為充值流水建立數據庫唯一約束,例如“商戶+充值訂單”。訂單、支付記錄、充值流水與余額變化應在同一事務內提交,不能先把余額加上,再單獨寫“已處理”。只在頁面禁用按鈕,或先查是否存在再寫入,都擋不住并發通知。
驗證通知并核對已保存的充值訂單
開啟數據庫事務
鎖定訂單與相關賬戶
若已有該訂單的成功充值流水:不再增加余額
否則:保存唯一流水、增加對應用戶余額、更新訂單
提交事務
返回 HTTP 200,純文本 OK這是商戶記賬偽代碼,不是新增接口。失敗時回滾,不提前確認成功;已可靠處理的重復通知核實后可返回OK。查單確認成功也調用同一個記賬函數,讓回調、重試和人工補償共享同一條防重復邊界。
六、超時與重復通知先查原訂單
| 情況 | 處理方式 |
|---|---|
| 下單請求超時 | 保留原訂單號查單,不直接換號重復充值。 |
| 已付款但余額未變 | 核對支付、通知處理和充值流水,不憑截圖直接加款。 |
| 重復通知或查詢并發 | 進入同一個受唯一約束保護的記賬事務。 |
| 過期訂單出現有效付款 | 保存支付事實,按約定補記或退款,不直接忽略。 |
用戶支付寶賬單里的交易記錄、稳付pay返回的platformOrderNo、商戶自己生成的outTradeNo,屬于不同系統的標識,不應假定三者相同。后臺應保存關聯,客服用原商戶訂單定位后再核對支付證據,不能只按賬單尾號、昵稱或同金額匹配就加款。
稳付pay通知最多共3次,包含首次;前兩次失敗后約60秒、300秒重試,因此還需主動查單補償。查詢響應amount的單位在開通時確認后再轉換比較,不直接當作下單分金額。支付寶官方SDK也提供交易查詢請求,這里僅參考主動核實的概念,實際調用仍使用稳付pay代收查詢接口。
七、用戶充值和商戶USDT結算分別對賬
用戶余額增加,說明商戶賬戶系統完成記賬;商戶USDT結算完成,說明相應款項按約定結付到收款地址。這兩層記錄不能共用一個“完成”狀態。
支付寶通道代收后可按雙方約定進行T0實時USDT結算,網絡、地址、換算和費用另行確認。結算待確認不能把用戶已支付改成失敗;用戶已加余額,也不表示商戶錢包已經收到USDT。詳見商戶結算完整流程,逐筆關聯用戶訂單、支付記錄、結算單和鏈上記錄。
八、常見問題與上線前驗收
付款后關掉頁面,還能充值成功嗎?
后端可以按有效通知或查單繼續處理,不依賴用戶返回頁面,商戶需實現可靠記賬和補償。
已有微信充值,可以共用賬戶余額嗎?
可在商戶系統共用余額賬本,但訂單保留支付方式與原通道,同一付款只產生一條有效充值流水。
現成支付寶插件改個網址就能接入嗎?
先核對字段、簽名、回調和查詢是否匹配。官方直連插件不能僅替換網關就當作聚合適配完成,請技術團隊協助聯調。
上線前測試正常充值、錯誤簽名、金額不符、重復通知、通知與查單并發、數據庫回滾和晚到付款。每次核對訂單、唯一流水和最終余額,確認金額正確且只加一次。微信接入可參看微信充值與余額入賬。