查询订单(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 |