鏈上充值

USDT入金接入流程:TRC20與ERC20收款、鏈上確認和余額記賬

USDT入金,是用戶向商戶自己的區塊鏈地址付款,再由商戶系統給用戶增加站內余額。稳付pay負責監控交易、核實確認條件并發送業務回調,資金直接進入商戶錢包,不代收、不托管。接入時應把真實鏈上收款與站內余額分開記錄,用可靠的訂單關聯和冪等記賬連接兩者。

文章目錄

一、兩條網絡與商戶自有錢包

本站支持的網絡資產形式接入時核對
TronUSDT TRC20Tron網絡、已核驗USDT合約、商戶收款地址。
EthereumUSDT ERC20Ethereum網絡、已核驗USDT合約、商戶收款地址。

不能只看“USDT”名稱或代幣圖標。Tether官方協議與合約列表可用于核對對應網絡的資產;同名代幣不自動等于受支持的USDT。確認完整地址,不僅比較末尾幾位。

客戶直接支付到商戶控制的錢包。開通監控只需按要求提供收款資料,不向稳付pay交出私鑰或助記詞。站內USDT余額是商戶業務賬本,錢包余額是鏈上資產,兩者不能混為一個賬戶。

二、先綁定用戶訂單,再確認識別策略

商戶先保存用戶ID、原充值訂單號、所選網絡、資產、接收地址、應付數量、有效期和入賬規則。若站內使用積分或其他計價單位,還要保存本次換算、精度與贈送規則快照,不能在付款后隨意更改。

一筆轉賬怎樣對應原訂單,須在開通時與技術團隊確認;不能假設平臺會每單分配新地址、要求備注memo或自動微調金額。同地址下多用戶同時付同額時,僅憑金額和大致時間不夠識別,應按確認過的方案核對,無法唯一歸屬則轉人工。

展示給用戶的網絡、商戶地址與應付數量必須來自后端已保存的訂單。本文只用MERCHANT_WALLET_ADDRESS、ORDER_ID等占位符,不提供可直接轉賬的示例地址。

地址變更應保留版本和生效范圍,舊訂單仍按原配置核對。是否接受分筆付款、如何累計以及訂單失效后的處理,也需事先約定,不能把幾筆同金額轉賬自動湊給一個用戶。

三、從鏈上付款到站內余額的六步流程

  1. 創建充值訂單綁定用戶與網絡、資產、收款地址和應付數量。
  2. 用戶核對并付款選擇正確網絡,向商戶自己的地址發送USDT。
  3. 監控候選交易識別相關轉賬事件,保留交易及事件標識。
  4. 核實執行與確認核對實際收款,等待所選網絡配置的確認條件。
  5. 商戶認證回調按專門約定驗證來源與內容,匹配原訂單。
  6. 原子記賬事件認領、充值流水與用戶余額一起持久化。
達到配置確認條件后提供秒級業務回調,不代表區塊確認固定只需幾秒。

四、看到轉賬不等于已滿足確認條件

錢包顯示“已發送”、拿到交易哈希、廣播成功或監聽到Transfer,都不能單獨作為余額入賬依據。要核對正確網絡上的實際執行結果、已核驗代幣合約、實際接收地址和USDT數量,再判斷確認條件是否滿足。交易調用的目標合約與事件里的收款人也不能混淆。

TRON確認語義文檔區分廣播、執行回執和固化狀態;進入固化鏈仍需檢查執行是否成功。Ethereum的終結性說明也表明,進入區塊與達到終結性是不同階段。

具體確認條件按網絡及接入配置確定,不統一寫成固定秒數。節點索引延遲或查詢暫時失敗時保留原記錄繼續核實,不因此認定轉賬失敗或要求用戶再轉一次。

五、USDT回調協議需單獨確認

開通時由技術人員明確回調認證方式、字段定義、確認規則、重試安排、應答內容和主動核查途徑。本站現有支付寶、微信代收文檔不能直接當作USDT協議,不套用其中的MD5字段、通知次數、OK應答或狀態枚舉。

商戶后端驗證通知真實性后,核對原訂單、網絡、代幣合約、接收地址、實際USDT數量、交易標識及確認情況。用戶歸屬由已保存訂單確定,不信任瀏覽器提交的“付款成功”或未經認證的通知。信息不足時先核查,不直接加余額。

通知已到達但數據庫寫入失敗,應按約定處理失敗和補償;重復通知與主動核查的結果進入同一記賬入口。保留認證與處理記錄,公開日志不寫密鑰或錢包秘密。

六、按轉賬事件去重,并原子更新余額

一筆鏈上交易可能包含多個轉賬事件,只用交易哈希去重可能漏記或錯認。可用“網絡+txHash+logIndex或事件序號”設計內部唯一事件鍵;這里是業務標識示例,不是已公布的平臺字段。索引口徑需統一,保留對應區塊及事件證據,確保同一收款事件不能給多個訂單重復抵款。

Ethereum日志說明包含交易哈希、日志索引和因重組而移除的標記。遇到確認回退或事件變化,應停止自動處理并復核原記錄,不能當成新轉賬再次加款。

原訂單的可入賬額度和狀態也要鎖定核對;重復付款、多付或分筆付款按約定規則處理,不能看到新事件就再按整單金額加款。

認證通知并驗證已確認的收款事件
開啟數據庫事務
  鎖定原充值訂單及用戶賬戶
  檢查事件唯一鍵及其已關聯訂單
  若本事件已為本訂單入賬:不再加款
  若本事件已被其他訂單認領:記錄沖突,不重復抵款
  否則:保存事件認領、唯一充值流水和余額更新
提交事務
按約定返回處理結果

按已核驗代幣合約的decimals處理最小單位整數,用定點或精確十進制計算,不用float計算USDT數量。原始數量、換算結果和贈送額度分別保存;事務失敗整體回滾,重復或并發處理依靠數據庫唯一約束,不能只靠先查后寫。

例如事件EVENT_A已經計入ORDER_A,再次收到通知或核查結果時返回原處理結果;若另一訂單ORDER_B試圖認領EVENT_A,則保留沖突待核實。記錄交易中其他事件,不等于它們都屬于當前充值訂單。

七、晚付、金額差異與網絡費用怎么處理

情況處理原則
晚到付款保留實際收款,按訂單有效期規則核對后補入賬或處理售后。
少付、多付記錄應付與實收差異,按約定核實,不擅自湊成另一筆訂單。
錯誤網絡、錯誤代幣停止自動入賬,核實資產、地址及控制情況,再聯系技術處理。
確認回退或結果未知保留事件和原訂單復核,不重復加款,也不直接要求重轉。

退款需單獨確認對象、網絡、數量、費用和授權,不能假設監控服務會自動退款。站內沖正保留獨立流水,不通過刪除原記錄改賬;鏈上轉賬不會因為修改站內狀態而自動撤銷。

自有錢包發送TRC20交易涉及Tron帶寬、能量及可能消耗的TRX;Ethereum交易燃料費以ETH支付。從交易所提幣還要核對其提現費用和實際轉出數量。費用按當時網絡與發送工具確認,不給所有訂單套固定費率。

八、逐筆對賬與接入驗收

把網絡、合約、地址、交易事件、充值訂單、入賬流水與用戶余額關聯起來。錢包總余額可能還包含其他收支,不能僅憑余額增長給某個用戶充值;也不能把商戶自有錢包直收,與微信、支付寶代收后的USDT結算混為一條資金路徑。

聯調至少驗證正常付款、重復通知、主動核查并發、同交易多事件、同地址同額訂單、少付多付、晚付、數據庫回滾及確認異常。逐項核對事件認領和最終余額,確保不漏記、不重復,也不把同一事件分給兩個用戶。

錢會先進入稳付pay錢包嗎?

不會。客戶直接付到商戶自己的地址,平臺只提供監控和回調,不代收、不托管。

鏈上看到交易后立即加余額嗎?

先核實執行、資產、地址、金額和配置確認條件,再由后端冪等記賬。

目前支持與收費怎樣確認?

Tron與Ethereum兩條網絡的監控回調面向中小站長免費開放;企業級服務另行收費。聯系技術團隊確認訂單識別與回調配置,獨立代付接口暫未開放。

參考資料

官方資料用于核對資產、鏈上確認和網絡費用;USDT監控與回調的實際協議、確認條件和訂單識別規則,以技術團隊開通時確認的配置為準。

按你的業務場景確認接入

說明商品、訂單量、支付方式與結算需求,逐項確認接口、資金路徑和異常處理。

聯系稳付pay ↗