交易结果通知(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_type | 否 | String | 签名类型:HMAC-SHA256 或 MD5(仅 HMAC-SHA256 订单返回) |
| 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 |
备注
- 此接口由商户实现,本系统将于订单成功时消费此接口
- 建议商户实现验签流程,以确认内容没被窜改
- 未来可能支持更多字段,串接时请动态取得有返回值的字段并产生签名校验,切勿将字段写死