查詢訂單(TRC20)
查詢 USDT-TRC20 訂單詳情接口。
請求資訊
- 請求 URL:
/gateway/api/v1/tron/txns - 請求方式:
GET - Content-Type:
application/json;charset=utf-8
請求頭 (Headers)
| 參數名 | 類型 | 說明 |
|---|---|---|
| Authorization | String | {authorization} 系統分配給平台之授權識別 |
請求參數
使用 Query String 將查詢參數帶在請求網址後,txn_id 與 txn_cl_id 至少需填入一個。
| 參數名 | 必選 | 類型 | 說明 |
|---|---|---|---|
| txn_cl_id | 否 | string | 商戶訂單號 |
| txn_id | 否 | string | 系統訂單號 |
請求示例
/gateway/api/v1/tron/txns?txn_cl_id=test_payout_txn_163439639
返回示例
成功返回
{
"error_code": "0000",
"data": {
"amount": 50000000,
"fee": 0,
"txn_id": "CTX00000007",
"txn_cl_id": "test_payout_txn_1634396394",
"status": 1,
"from_address": "TR1KMKNJAJRsPWuMVYnEkj1H3GaUdUe4wG",
"target_address": "TAkr13ZMWyPSpo7jvQ4ajgmm8X9EG4dEZK",
"create_time": 1634396394,
"update_time": 0
}
}
錯誤返回示例
{
"error_code": "0050",
"error_msg": "查无订单!"
}
返回參數說明
| 參數名 | 類型 | 說明 |
|---|---|---|
| error_code | String | 錯誤碼 |
| error_msg | String | 錯誤訊息(error_code 不為 "0000" 時返回) |
| amount | Int | 轉帳金額 |
| from_address | String | 發送方 |
| target_address | String | 接收方 |
| status | Int | 訂單狀態(見下表) |
TRC-20 訂單交易狀態
| 狀態 | 數值 |
|---|---|
| 初始 | 0 |
| 等待中 | 1 |
| 執行中 | 2 |
| 成功 | 3 |
| 取消 | 4 |
| 失敗 | 5 |