退款结果回调

简述

• 退款结果回调通知

回调通知规则

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

回调 URL

• 商户回调地址

推送参数

• 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": "REF2024120813000125123_1",
  "merchantId": "M12345678",
  "callbackBusi": "refund",
  "callbackEvent": "refund.success",
  "code": 10000,
  "message": "success",
  /* data内所有字段参与加密和签名 */
  "data": {
    "refundOrderId": "REF250310133208366713457",
    "merRefundOrderId": "202501231241084485484",
    "orderType": "refund",
    "paymentType": "cardpay",
    "refundAmt": "100.00",
    "refundCurrency": "SAR",
    "refundCreateTime": "2025-03-10 13:53:52",
    "refundCompleteTime": "2025-03-10 13:53:51",
    "refundStatus": "success",
    "refundRespCode": null,
    "refundDesc": "",
    "origOrderInfo": {
      "origOrderId": "ORD250310130935707656566",
      "origMerOrderId": "202501231241084485484",
      "origOrderAmt": "130.00",
      "origRefundedAmt": "100.00",
      "origRemainAmt": "30.00"
    }
  }
}

响应参数

• body

参数名	类型	说明
merchantId	String	商户编码
refundOrderId	String	退款订单号
respCode	String	响应码 success

响应示例

{
  "merchantId": "M12345678",
  "refundOrderId": "TRD2024120813000125123",
  "respCode": "success"
}