跳到主要内容

交易结果通知(TRC20)

系统将 USDT-TRC20 交易结果发送至商户提供的回调地址。

请求资讯

  • 请求 URL: 商户于申请时填入之 notify_url 地址
  • 请求方式: POST
  • Content-Type: application/json;charset=utf-8

请求参数(由系统发送给商户)

参数名必选类型说明
txn_idString(11)系统订单号
txn_cl_idString(32)商户订单号
amountInteger(10)订单金额 (单位:0.01 USDT)
feeint商户手续费 (单位:0.01 USDT)
statusint订单状态(见下表)
from_addressstring转出地址
target_addressstring转入地址
create_timeString(7)创建时间(unix timestamp,单位:秒)
update_timeint更新时间(unix timestamp,单位:秒)
sign_typeString签名类型:HMAC-SHA256MD5(仅 HMAC-SHA256 订单返回)
signString(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

备注

  • 此接口由商户实现,本系统将于订单成功时消费此接口
  • 建议商户实现验签流程,以确认内容没被窜改
  • 未来可能支持更多字段,串接时请动态取得有返回值的字段并产生签名校验,切勿将字段写死