Skip to content

查询退款

功能简述

  • 查询退款订单

查询退款 API

请求 URL

  • /refunds/{REFUND_ID}
    • {REFUND_ID}:您的退款单 ID

请求 Method

  • refund.detail

请求方式

  • GET

请求参数

请求参数如下:

响应参数

响应参数如下:

  • Response Body
参数类型描述示例
amountnumber订单金额,注意这里是数字类型,浮点数,最多两位小数3.23
idstring退单 ID,全局唯一"M948164T2023072607034709567189_R1"
merchantIdstring商户 ID"M948164"
orderIdstring所属订单 ID"M948164T2023072607034709567189"
merchantRefundIdstring商户退款单 ID"TEST934759263495634"
refundTransactionIdstring退款操作交易 ID"M948164T2023072607034709567189_2"
originTransactionIdstring订单交易 ID"M948164T2023072607034709567189_1"
paymentMethodstring支付方式:
stcpay
mastercard
applePay
tap
"mastercard"
statusstring退款状态:
pending:退款中
success:退款完成
fail:退款失败
"pending"
currencystring货币类型货币种类,三位大写字母"SAR"
"KWD"
"BHD"
"AED"
"OMR"
"QAR"
reasonstring退款原因"退运费"
finishedAtstring退款完成时间"2023-07-27T11:38:11.000Z"
createdAtstring创建时间"2023-07-26T04:06:33.227Z"
updatedAtstring更新时间"2023-07-26T04:06:33.227Z"

响应参数示例

json
{
  "amount": 7, // 订单金额
  "id": "M948164T2023072607034709567189_R1", // 退单 ID
  "merchantId": "M948164", // 商户 ID
  "orderId": "M948164T2023072607034709567189", // 所属订单 ID
  "merchantRefundId": "TEST456345768345", // 商户退款单 ID
  "refundTransactionId": "M948164T2023072607034709567189_2", // 退款操作交易 ID
  "originTransactionId": "M948164T2023072607034709567189_1", // 订单交易 ID 
  "paymentMethod": "mastercard", // 支付方式
  "status": "success", // 退款状态
  "currency": "SAR", // 货币类型
  "reason": null,  // 退款原因
  "finishedAt": "2023-07-27T11:38:11.000Z", // 退款完成时间
  "createdAt": "2023-07-26T04:06:33.000Z", // 创建时间
  "updatedAt": "2023-07-27T11:38:11.000Z" // 更新时间
}