查询订单退款记录列表

GET 
/openapi/2025-06/orders/:order_id/refund

返回指定订单上的全部退款记录，同时返回查询时刻订单的支付状态和订单状态。

请求

Path参数

order_id string必填

订单 ID

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object
order_financial_statusstring
订单的支付状态：
• waiting: 待支付
• paying: 支付审核中
• authorized: 已授权
• partially_paid: 部分支付
• paid: 已支付
• cancelled: 已取消
• failed: 支付失败
• refunding: 退款中
• refund_failed: 退款失败
• refunded: 已全退
• partially_refunded: 部分退
order_statusstring
订单状态：
• opened: 待支付
• cancelled: 已取消
• placed: 进行中
• finished: 已完成
records object[]
该订单关联的退款记录列表
Array [
idstring
退款记录 ID
refund_pricestring
退款金额
refund_shippingstring
运费退款信息
refund_shipping_taxstring
退款运费税金额
refund_methodstring
退款方式
refund_statusstring
退款状态：
• pending: 退款中
• finished: 退款完成
• failed: 退款失败
notestring
备注
created_atstring
退款记录创建时间（如 2018-11-02T12:30:10Z）
updated_atstring
退款记录最后更新时间（如 2018-11-02T12:30:10Z）
refund_line_items object[]
退款行项目列表
Array [
line_item_idstring
被退款的订单商品行 ID
refund_quantityint32
退款数量
taxstring
税费
discountstring
折扣信息
sub_totalstring
小计金额
totalstring
总计
delete_quantityint32
删除数量
]
payment_details object[]
支付详情列表
Array [
idstring
退款记录 ID
payment_line_idstring
支付行 ID
payment_channelstring
支付渠道
payment_methodstring
支付方式
refund_pricestring
退款金额
refund_statusstring
退款状态：
• pending: 退款中
• finished: 退款完成
• failed: 退款失败
finished_atstring
退款完成时间
]
additional_totalstring
附加总额
additional_prices object[]
附加价格列表
Array [
namestring
附加费用名称
pricestring
附加费用金额
biz_idstring
业务 ID
fee_titlestring
自定义收费名称
]
refund_tipstring
小费退款金额
order_idstring
订单 ID
]

示例

{
  "code": "string",
  "message": "string",
  "data": {
    "order_financial_status": "string",
    "order_status": "string",
    "records": [
      {
        "id": "string",
        "refund_price": "string",
        "refund_shipping": "string",
        "refund_shipping_tax": "string",
        "refund_method": "string",
        "refund_status": "string",
        "note": "string",
        "created_at": "string",
        "updated_at": "string",
        "refund_line_items": [
          {
            "line_item_id": "string",
            "refund_quantity": 0,
            "tax": "string",
            "discount": "string",
            "sub_total": "string",
            "total": "string",
            "delete_quantity": 0
          }
        ],
        "payment_details": [
          {
            "id": "string",
            "payment_line_id": "string",
            "payment_channel": "string",
            "payment_method": "string",
            "refund_price": "string",
            "refund_status": "string",
            "finished_at": "string"
          }
        ],
        "additional_total": "string",
        "additional_prices": [
          {
            "name": "string",
            "price": "string",
            "biz_id": "string",
            "fee_title": "string"
          }
        ],
        "refund_tip": "string",
        "order_id": "string"
      }
    ]
  }
}