退款订单回调

介绍

支付回调通知,当订单支付成功/失败会通知商户,如果需要,请商户提供退款回调地址配置

  • 支付完成后,会把订单信息通过json形式发送给商户,商户需要接收处理,并按文档规范返回应答。
    同样的通知可能会多次发送给商户。商户必须能够正确处理重复的通知。
  • 后台通知交互时,如果收到商户的应答http响应不等于200并且响应内容包含success,会判定本次通知失败,重新发送通知,总共会发起多次通知。通知频率为10分钟内订单每2分钟请求一次,1小时内订单每10分钟请求一次,12小时内订单每1小时请求一次。
  • 商户系统对于支付结果通知的内容一定要做签名验证,并校验返回的订单金额是否与商户侧的订单金额一致,防止数据泄露导致出现“假通知”,造成资金损失。
  • 所有字段值为空(为null或为””)时不参与签名

回调参数

参数名验签类型长度说明
refundTypestring64退款类型
merchantOrderNostring64商户订单号
paymentOrderNostring64ach支付单号
orderStatusstring16退款订单状态
tokenAmountstring32token数量
faitAmountstring16数币数量
fiatCurrencystring16法币币种
refundNetworkstring32退款币种网络(TRX)
refundTokenstring32退款币种网络(USD)
refundOrderNostring64ach退款单号
hxAddressstring256hash地址
signstring128签名

回调状态

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"
}