退款订单回调
介绍
支付回调通知,当订单支付成功/失败会通知商户,如果需要,请商户提供退款回调地址配置
- 支付完成后,会把订单信息通过json形式发送给商户,商户需要接收处理,并按文档规范返回应答。
同样的通知可能会多次发送给商户。商户必须能够正确处理重复的通知。 - 后台通知交互时,如果收到商户的应答http响应不等于200并且响应内容包含success,会判定本次通知失败,重新发送通知,总共会发起多次通知。通知频率为10分钟内订单每2分钟请求一次,1小时内订单每10分钟请求一次,12小时内订单每1小时请求一次。
- 商户系统对于支付结果通知的内容一定要做签名验证,并校验返回的订单金额是否与商户侧的订单金额一致,防止数据泄露导致出现“假通知”,造成资金损失。
- 所有字段值为空(为null或为””)时不参与签名
回调参数
参数名 | 验签 | 类型 | 长度 | 说明 |
---|---|---|---|---|
refundType | 是 | string | 64 | 退款类型 |
merchantOrderNo | 是 | string | 64 | 商户订单号 |
paymentOrderNo | 是 | string | 64 | ach支付单号 |
orderStatus | 是 | string | 16 | 退款订单状态 |
tokenAmount | 是 | string | 32 | token数量 |
faitAmount | 是 | string | 16 | 数币数量 |
fiatCurrency | 是 | string | 16 | 法币币种 |
refundNetwork | 是 | string | 32 | 退款币种网络(TRX) |
refundToken | 是 | string | 32 | 退款币种网络(USD) |
refundOrderNo | 是 | string | 64 | ach退款单号 |
hxAddress | 是 | string | 256 | hash地址 |
sign | 否 | string | 128 | 签名 |
回调状态
code码 | 解释 |
---|---|
COMPLETED | 退款成功 |
FAILED | 退款失败 |
回调参数示例
{
"faitAmount": "9.90000000",
"fiatCurrency": "USD",
"hxAddress": "05b40909e7dd03cd0c1303c1e740edaa682f15ea7ed4af3bca5adffbe10da277",
"merchantOrderNo": "17304484880000",
"orderStatus": "COMPLETED",
"paymentOrderNo": "300317304490044680240",
"refundNetwork": "TRX",
"refundOrderNo": "300217304490044230335",
"refundToken": "USDT",
"refundType": "MERCHANT_APPROVE_REFUND",
"sign": "C2A745E335DE17F3D0C6F2920CD62A96F6F8445E692ED5CDE7EED35BF8AF7B2BC298CC2440700A6F3323A71D18C5200B793286B340B8AB6B67F99424C1B3A154",
"tokenAmount": "8.40000000"
}
Updated 16 days ago