跳到主要内容

交易结果通知(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
real_amount否Integer实付金额(单位:0.01 USDT)。人工审核匹配时返回,表示链上实际到账金额。未设定时不返回
sign是String(32)交易签名

请求示例​

{
"txn_id": "CTX00000007",
"txn_cl_id": "test_payout_txn_1634396394",
"amount": 50000000,
"fee": 0,
"status": 3,
"from_address": "TR1KMKNJAJRsPWuMVYnEkj1H3GaUdUe4wG",
"target_address": "TAkr13ZMWyPSpo7jvQ4ajgmm8X9EG4dEZK",
"create_time": 1634396394,
"update_time": 0,
"sign": "d373360cd44e420863b1ced04bc9efe0"
}

商户返回示例​

商户收到通知后,需返回 JSON 格式数据以确认收到通知。

{
"error_code": "0000"
}

TRC-20 订单交易状态​

状态数值
成功3
关闭4

备注​

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