完成退款

POST 
/openapi/2026-07/orders/:order_id/refund/finish

将退款中的退款记录处理成退款成功，此时订单状态是部分退款或者已退款。

该接口仅适用于使用自定义支付渠道或测试支付渠道（bogus）的订单。

请求

Path参数

order_id string必填

订单 ID

application/json

请求体

请求体必填

post_sale_idstring必填

售后记录 ID

refund_record_idstring必填

退款记录 ID

refund_timestring

第三方退款完成时间，RFC3339 格式（如 2018-11-02T12:30:10Z）

transaction_numberstring

退款交易流水号

payment_channelstring

退款渠道

extra_info object

退款记录附加信息

posstring

附加 POS 信息

示例

{
  "post_sale_id": "string",
  "refund_record_id": "string",
  "refund_time": "string",
  "transaction_number": "string",
  "payment_channel": "string",
  "extra_info": {
    "pos": "string"
  }
}

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

order_idstring

订单 ID

post_sale_idstring

售后记录 ID

refund_record object

退款记录信息

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

extra_info object

退款记录附加信息

posstring

附加 POS 信息

示例

{
  "code": "string",
  "message": "string",
  "data": {
    "order_id": "string",
    "post_sale_id": "string",
    "refund_record": {
      "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",
      "extra_info": {
        "pos": "string"
      }
    }
  }
}