提交在线退款

能力概览

• 接入方提交在线退款申请服务

调用地址

• /pay/merchant/refund

请求参数

• body

字段	提交要求	数据类型	长度限制	业务含义
merchantId	是	String	32	平台分配给接入方的唯一商户标识
merRefundOrderId	是	String	64	接入方系统生成的退款订单号，需保证在接入方侧唯一
origOrderId	条件	String	32	平台原收款交易订单号，与 origMerOrderId 二选一提交
origMerOrderId	条件	String	64	接入方原收款订单号，与 origOrderId 二选一提交
refundAmt	是	String	12	退款金额，按两位小数格式提交，如：100.00
refundCurrency	是	String	10	退款金额对应的币种代码
refundDesc	否	String	128	退款申请的业务说明
serverNotifyUrl	否	String	255	退款结果服务端通知地址；传入时平台按该 URL 推送，未传入时使用后台配置地址

请求示例

{
  "merchantId": "MER20460873",
  "merRefundOrderId": "RF202605090001",
  "origOrderId": "TRD20260509104532001876",
  "origMerOrderId": "",
  "refundAmt": "36.50",
  "refundCurrency": "SAR",
  "refundDesc": "partial refund for returned item",
  "serverNotifyUrl": "https://merchant.example.com/notify/refund"
}

响应参数

• data

字段	数据类型	业务含义
merchantId	String	当前退款订单所属的接入方标识
refundOrderId	String	平台生成的退款业务订单号
merRefundOrderId	String	接入方提交的退款订单号，按请求原值返回
refundAmt	String	本次退款金额，按两位小数格式返回，如：100.00
refundCurrency	String	本次退款金额对应的币种
refundTime	String	平台受理退款的时间，格式：YYYY-MM-DD HH:MM:SS
refundChannel	String	退款处理通道，固定值为 original（原路退款）
refundStatus	String	退款订单当前处理状态： init：初始化 pending：处理中 success：退款成功 fail：失败
origOrdInfo	Object	原收款交易信息对象，结构见 Object:origOrdInfo

• Object:origOrdInfo

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

响应示例

{
  "code": 10000,
  "message": "success",
  "data": {
    "merchantId": "MER20460873",
    "refundOrderId": "REF20260509105844002984",
    "merRefundOrderId": "RF202605090001",
    "refundAmt": "36.50",
    "refundCurrency": "SAR",
    "refundTime": "2026-05-09 10:58:44",
    "refundChannel": "original",
    "refundStatus": "pending",
    "origOrdInfo": {
      "origOrderId": "TRD20260509104532001876",
      "origMerOrderId": "PAYIN202605090001",
      "origOrderAmt": "186.40",
      "origRefundedAmt": "36.50",
      "origRemainAmt": "149.90"
    }
  }
}