Skip to main content

收款交易结果通知（USDT 渠道）

USDT 渠道代收订单成功（到账）后，系统将交易结果发送至商户提供的回调地址。

请求资讯​

  • 请求 URL： 商户于创建收款单时填入的 notify_url 地址
  • 请求方式： POST
  • Content-Type： application/json;charset=utf-8

请求参数​

参数名必选类型说明
payment_id是String系统订单号
payment_cl_id是String商户订单号
platform_id是String商户号
amount是Integer订单金额（单位 0.01 USDT）
real_amount是Integer实际到帐金额（单位 0.01 USDT）
fee是Integer手续费
status是Integer交易状态（2 表示成功）
create_time是Integer创建时间（秒）
update_time是Integer更新时间（秒）
sign_type否String签名类型：HMAC-SHA256
sign是String订单签名
note

USDT 渠道回调为通用代收回调，不包含链上交易明细（交易哈希、收款地址等）。商户以 payment_id + payment_cl_id 对账，以 status=2 判定到账即可。付款人姓名等法币字段在 USDT 渠道通常为空。

请求示例​

{
    "payment_id": "PM00000102",
    "payment_cl_id": "order_20260610001",
    "platform_id": "PF0001",
    "amount": 200,
    "real_amount": 200,
    "fee": 0,
    "status": 2,
    "create_time": 1749523200,
    "update_time": 1749523500,
    "sign": "d2e4534fce8c1d1053bbf59fd8ae4464"
}

商户返回​

{ "error_code": "0000" }

或直接返回纯文本 success。

返回参数说明​

参数名类型说明
error_codeString返回 "0000"（或纯文本 success）即表示平台已处理完成

备注​

  • 此接口由商户实现，本系统将于订单成功时消费此接口
  • 订单完成起一小时内，将重复通知十次，期间商户返回成功便停止通知
  • 建议商户实现验签流程，以确认内容没被篡改，签名规则见 签名说明
  • 此接口可能被重复通知，商户需自行判断是否执行业务逻辑，避免重复入帐
  • 订单状态请参考：订单状态
  • 未来可能支持更多字段，串接时请动态取得有返回值的字段并产生签名校验，切勿将字段写死