跳到主要内容

出款交易结果通知（渠道型加密货币）

渠道型加密货币代付订单处理完成后，系统将交易结果发送至商户提供的回调地址。代付成功 = 链上打款完成；代付失败 = 退回商户余额。

请求资讯​

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

请求参数​

参数名必选类型说明
payout_id是String系统订单号
payout_cl_id是String商户订单号
platform_id是String商户号
amount是Integer订单金额（单位 0.01）
fee是Integer手续费
currency是String币种（usdt / jpyc）
target_address是String收款链上地址
status是Integer交易状态（3 = 成功 / 5 = 失败已退款；完整状态见 订单状态）
create_time是Integer创建时间（秒）
update_time是Integer更新时间（秒）
sign_type否String签名类型：HMAC-SHA256
sign是String订单签名
备注

代付回调以 payout_id + payout_cl_id 对账：status=3 表示链上打款成功，status=5 表示打款失败、金额已退回商户余额，商户应据此回滚业务状态。回调不包含完整链上交易明细（交易哈希等），链上信息由渠道侧管理。

请求示例​

{
    "payout_id": "PO00000102",
    "payout_cl_id": "payout_20260610001",
    "platform_id": "PF0001",
    "amount": 200,
    "fee": 0,
    "currency": "usdt",
    "target_address": "TAkr13ZMWyPSpo7jvQ4ajgmm8X9EG4dEZK",
    "status": 3,
    "create_time": 1749523200,
    "update_time": 1749523500,
    "sign": "d2e4534fce8c1d1053bbf59fd8ae4464"
}

商户返回​

{ "error_code": "0000" }

或直接返回纯文本 success。

返回参数说明​

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

备注​

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