订单Webhook
接口描述
当订单到流转到一状态时,给商户推送订单状态信息。
注意:如果商户的 http 应答码不是 200 或响应内容未包含 success,会判定本次通知失败。后续会重新通知,通知频率如下:
| 时间范围 | 发送频率 | 
|---|---|
| 10 分钟内 | 每 2 分钟发送 1 次 | 
| 1 小时内 | 每 10 分钟发送 1 次 | 
| 12 小时内 | 每 1 小时发送 1 次 | 
- 商户需对通知内容进行签名验证,并检查返回的订单金额是否与商户端金额相符。
 - 签名字符串只包含 “验证= Y” 的参数
 
接口说明
请求方式:POST
请求地址:创建订单时上传的 callbackURL 参数
请求参数
参数名  | 验证  | 类型  | 长度  | 详情  | 
|---|---|---|---|---|
orderNo  | Y  | string  | 64  | 订单号  | 
orderStatus  | Y  | string  | 32  | |
userId  | Y  | string  | 128  | 用户ID (邮箱或手机号码)  | 
merchantOrderNo  | Y  | string  | 64  | 用户交易编号  | 
orderCurrency  | Y  | string  | 32  | 订单的法定货币 (USD/EUR)  | 
orderAmount  | Y  | string  | 16  | 订单金额 (单位:元)  | 
payCryptoRate  | Y  | string  | 16  | 支付加密货币汇率 (到USDT)  | 
payCryptoCurrency  | Y  | string  | 32  | 用戶支付的token  | 
payCryptoVolume  | Y  | string  | 16  | 用户支付金额(token)  | 
payCryptoNetwork  | Y  | string  | 32  | 用户支付token的网络  | 
hxAddress  | Y  | string  | 256  | 哈希  | 
failReason  | Y  | string  | 256  | 失败原因  | 
fee  | Y  | string  | 16  | 手续费  | 
settlementAmount  | N  | string  | 16  | 入账金额  | 
settlementCurrency  | N  | string  | 16  | 入账金额币种  | 
customParam  | N  | object  | 512  | 可定制字段  | 
address  | N  | string  | 64  | 用戶打币地址  | 
payNo  | N  | string  | 64  | 支付单号(需配置)  | 
sign  | N  | string  | 256  | 签名  | 
payMethod  | N  | string  | 16  | 用戶支付方式(仅在使用wallet connect或ton connect时返回)  | 
fromAddress  | N  | string  | 256  | 用户打币地址(仅在使用wallet connect或ton connect时返回)  | 
payTime  | N  | string  | 64  | 时区 UTC+8,格式: yyyy-MM-dd hh:mm:ss (仅在订单状态COMPLETED时返回)  | 
orderTime  | N  | string  | 64  | UTC+8时区的时间,格式为yyyy-MM-dd hh:mm:ss  | 
回调参数示例
COMPLETED
{
    "fee": "2",
    "hxAddress": "2b04aa547740d8de8d442bc1827457b3e9bf4551234567893c319",
    "merchantOrderNo": "to_4bc9603bc5c123456",
    "orderAmount": "100",
    "orderCurrency": "USD",
    "orderNo": "3002172361782345678",
    "orderStatus": "COMPLETED",
    "payCryptoCurrency": "USDT",
    "payCryptoNetwork": "TRX",
    "payCryptoRate": "1",
    "payCryptoVolume": "102",
    "payFiatRate": "1",
    "settlementAmount": "100",
    "settlementCurrency": "USD",
    "sign": "C615A4F6436CAA3C5B74AA80AF0CF08D342E7C49D0164765D3563EC3E3E61F889E9B46BB1E6F1EEEB28280DA233B81E31591C8B1A33C0EE7969CD3",
    "userId": "u_dabd123456"
}订单状态说明
| 参数名 | 详情 | 
|---|---|
| COMPLETED | 支付成功 | 
| TIMEOUT | 支付取消 | 
| FAILED | 支付失败 | 
| DELAY_SUCCESS | 订单超时,支付成功 | 
| DELAY_FAILED | 订单超时,支付失败 | 
| ORDER_EXCEPTION | 异常订单,用户重复支付(需配置) | 
Updated 4 months ago