接收退款处理状态通知

能力概览

• 退款处理状态通知

通知规则

1. 接入方通知 URL 需要配置在接入方后台，否则不会发送结果通知，可配置通知结果的事件：refund.success、refund.fail
2. 通知如果接入方没有被正确响应，则平台会多次推送调用，规则如下： 如果接入方未响应通知，则每隔 5 分钟推送 1 次，总共重试 5 次推送。

通知地址

• 接入方通知地址

通知参数

• body

字段	数据类型	业务含义
callbackNo	String	平台生成的本次异步通知流水号
merchantId	String	接收通知的接入方标识
callbackBusi	String	通知所属业务类型，固定值为 refund
callbackEvent	String	退款结果事件类型，固定值为 refund.success/refund.fail
code	Int	本次通知对应的业务响应码
message	String	响应码对应的说明文案
data	String	退款结果明细数据

• data

字段	数据类型	业务含义
refundOrderId	String	平台生成的退款业务订单号
merRefundOrderId	String	接入方提交的退款订单号
orderType	String	订单所属交易类型，固定值为 refund
paymentType	String	原收款交易使用的支付方式，如：stcpay、cardpay、applepay
refundAmt	String	本次退款金额，按两位小数格式返回，如：100.00
refundCurrency	String	本次退款金额对应的币种
origOrderInfo	Object	原收款交易信息对象，结构见 Object:origOrderInfo
refundCreateTime	String	退款请求提交到平台的时间，格式：YYYY-MM-DD HH:MM:SS
refundCompleteTime	String	退款在平台完成处理的时间，格式：YYYY-MM-DD HH:MM:SS
refundStatus	String	退款订单当前处理状态 pending：处理中 success：退款成功 fail：失败
refundRespCode	String	退款失败时返回的业务响应码
refundDesc	String	退款处理结果说明

• Object:origOrderInfo

字段	数据类型	业务含义
origOrderId	String	平台原收款交易订单号
origMerOrderId	String	接入方原收款订单号
origOrderAmt	String	原收款交易金额
origRefundedAmt	String	原交易已成功退款金额
origRemainAmt	String	原交易当前剩余可退款金额

推送示例

{
  "callbackNo": "REF20260509105844002984_1",
  "merchantId": "MER20460873",
  "callbackBusi": "refund",
  "callbackEvent": "refund.success",
  "code": 10000,
  "message": "success",
  /* data内所有字段参与加密和签名 */
  "data": {
    "refundOrderId": "REF20260509105844002984",
    "merRefundOrderId": "RF202605090001",
    "orderType": "refund",
    "paymentType": "cardpay",
    "refundAmt": "36.50",
    "refundCurrency": "SAR",
    "refundCreateTime": "2026-05-09 10:58:44",
    "refundCompleteTime": "2026-05-09 11:03:20",
    "refundStatus": "success",
    "refundRespCode": null,
    "refundDesc": "",
    "origOrderInfo": {
      "origOrderId": "TRD20260509104532001876",
      "origMerOrderId": "PAYIN202605090001",
      "origOrderAmt": "186.40",
      "origRefundedAmt": "36.50",
      "origRemainAmt": "149.90"
    }
  }
}

响应参数

• body

字段	数据类型	业务含义
merchantId	String	接入方返回确认的商户标识
refundOrderId	String	接入方确认已接收的平台退款订单号
respCode	String	通知接收结果，成功时返回 success

响应示例

{
  "merchantId": "MER20460873",
  "refundOrderId": "REF20260509105844002984",
  "respCode": "success"
}