退款结果查询

简述

注意

日期限定 3 个月内

• 交易结果查询：根据退款订单号查询该订单的退款信息

请求 URL

• /pay/merchant/inquiryRefund

请求参数

• body

参数名	必选	类型	长度	说明
merchantId	是	String	32	商户编码
merRefundOrderId	条件	String	64	商户退款订单号，与 refundOrderId 上送其一
refundOrderId	条件	String	32	平台退款订单号，与 merRefundOrderId 上送其一

请求示例

{
  "merchantId": "MER16951291",
  "merRefundOrderId": "6546575687686456456",
  "refundOrderId": "REF202412011234331234"
}

响应参数

• data

参数名	类型	说明
merchantId	String	商户编码
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	原交易剩余退款金额

响应示例

{
  "code": 10000,
  "message": "success",
  "data": {
    "merchantId": "MER16951291",
    "refundOrderId": "REF2024120813000125123",
    "merRefundOrderId": "2024121015302012345",
    "orderType": "refund",
    "paymentType": "cardpay",
    "refundAmt": "20.00",
    "refundCurrency": "SAR",
    "origOrderInfo": {
      "origOrderId": "TRD20241210153120123456",
      "origMerOrderId": "20241210153323032323",
      "origOrderAmt": "100.00",
      "origRefundedAmt": "20.00",
      "origRemainAmt": "80.00"
    },
    "refundCreateTime": "2024-12-10 15:20:20",
    "refundCompleteTime": "2024-12-10 15:30:20",
    "refundStatus": "success",
    "refundRespCode": null,
    "refundDesc": "success"
  }
}