交易結果通知(TRC20)
系統將 USDT-TRC20 交易結果發送至商戶提供的回調地址。
請求資訊
- 請求 URL: 商戶於申請時填入之
notify_url地址 - 請求方式:
POST - Content-Type:
application/json;charset=utf-8
請求參數(由系統發送給商戶)
| 參數名 | 必選 | 類型 | 說明 |
|---|---|---|---|
| txn_id | 是 | String(11) | 系統訂單號 |
| txn_cl_id | 是 | String(32) | 商戶訂單號 |
| amount | 是 | Integer(10) | 訂單金額 (單位:0.01 USDT) |
| fee | 是 | int | 商戶手續費 (單位:0.01 USDT) |
| status | 是 | int | 訂單狀態(見下表) |
| from_address | 是 | string | 轉出地址 |
| target_address | 是 | string | 轉入地址 |
| create_time | 是 | String(7) | 創建時間(unix timestamp,單位:秒) |
| update_time | 是 | int | 更新時間(unix timestamp,單位:秒) |
| sign | 是 | String(32) | 交易簽名 |
請求示例
{
"txn_id": "CTX00000007",
"txn_cl_id": "test_payout_txn_1634396394",
"amount": 50000000,
"fee": 0,
"status": 1,
"from_address": "TR1KMKNJAJRsPWuMVYnEkj1H3GaUdUe4wG",
"target_address": "TAkr13ZMWyPSpo7jvQ4ajgmm8X9EG4dEZK",
"create_time": 1634396394,
"update_time": 0,
"sign": "d373360cd44e420863b1ced04bc9efe0"
}
商戶返回示例
商戶收到通知後,需返回 JSON 格式數據以確認收到通知。
{
"error_code": "0000"
}
TRC-20 訂單交易狀態
| 狀態 | 數值 |
|---|---|
| 初始 | 0 |
| 等待中 | 1 |
| 執行中 | 2 |
| 成功 | 3 |
| 取消 | 4 |
| 失敗 | 5 |
備註
- 此接口由商戶實現,本系統將於訂單成功時消費此接口
- 建議商戶實現驗簽流程,以確認內容沒被竄改