收款交易结果通知(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 | 订单签名 |
备注
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_code | String | 返回 "0000"(或纯文本 success)即表示平台已处理完成 |