非同步回調:

訂單支付成功後，閘道會向商戶下單時傳入的 notify_url 發起服務端 POST 通知。商戶必須驗簽、冪等處理，並返回約定字串，否則閘道會重試。


觸發時機

  • 鏈上交易確認到賬，訂單狀態變為已支付（status=1）。
  • 後臺人工確認收款並執行手動補單（status=2）。
  • 首次通知在訂單完成時立即發起，請求超時為 30 秒。

請求格式

項
值
請求方法
POST
目標地址
下單時傳入的 notify_url
Content-Type
application/x-www-form-urlencoded
響應要求
驗簽成功事務處理完成後，必須返回，純文本 ok 或 success（不區分大小寫），否則會一直通知

通知參數

參數名
類型
說明
merchant_id
int
商戶 ID，可與本地記錄比對
system_order
string
網關係統訂單號
merchant_order
string
商戶訂單號
amount
string
訂單金額（兩位小數）
pay_amount
string
使用者實際支付金額（兩位小數）
service_fee
string
通道手續費，按商戶費率計算，結算時從商戶餘額扣除
chain_id
int
鏈 ID
token_type
int
代幣類型：1=USDT，2=USDC
product_name
string
商品 / 訂單名稱
parameters
string
下單時的自定義參數，原樣帶回；可能為空字串
status
int
通知狀態：1=已支付，2=手動補單
from_address
string
付款方地址，手動補單時可能為空
to_address
string
收款地址
hash
string
鏈上交易雜湊，手動補單時可能為空
sign
string
簽名，需用 secretkey 按相同規則驗證

通知示例

merchant_id=10000
system_order=P202610260025421871
merchant_order=T202611010001
amount=100.00
pay_amount=100.37
service_fee=5.00
chain_id=56
token_type=1
product_name=TestProduct
parameters=order-123
status=1
from_address=0x9a1b2c3d4.....3a4b5c6d7e8f901234567
to_address=0x4E5e48661B3.....2c4425bBA6Fae0aF09
hash=0x7d1e9f2a4b6c8d0e1f3....6b8c0d2e4f6a8b0c2d4e6f8a0b2c4d6e
sign=a02e78c0df56a06d0dcdfac3f66b4cf9

以上 sign 基於示例金鑰 demo_secret_123456 計算，僅用於演示驗簽流程。


響應約定

  • 商戶必須返回 HTTP 200，響應體為純文本 ok 或 success（不區分大小寫，前後空白會被忽略）。
  • 返回 JSON（即使內容為 {"code":1}）、HTML、空響應或其他文本，均視為通知失敗。
  • 請在 30 秒內完成處理並返回；耗時業務建議非同步執行，先返回 ok。

重試策略

首次通知失敗後，閘道會按距付款完成時間的以下間隔自動重試：

第 1、2、3、5、10、20、30、60、120、360 分鐘各通知一次
  • 共最多 11 次通知（首次 1 次 + 重試 10 次）。
  • 僅對最近 24 小時內建立、已配置 notify_url 且已有付款地址的訂單重試。
  • 達到上限後不再自動通知，但可在商戶控制台手動“重新通知”，手動重新通知不會重複扣除通道手續費。