**版本：202601**

# 创建订单退款记录

**POST** `/openapi/2026-01/orders/:order_id/refund`

为指定订单新增一条退款记录，声明退款金额及使用的支付渠道；返回新建退款 记录的 ID 与关联的售后记录 ID。

## 请求

**Path参数**

- `order_id` string (required)

  订单 ID

**application/json**

**请求体 | 示例**

**请求体 (required)**

- `refund` object (required)

  退款请求体，包含退款金额、商品明细、支付渠道及备注等信息

  - `refund_total` string (required)

    退款总金额。若指定了 refund\_payments，则退款总金额等于所有 refund\_payments 退款金额之和
  - `refund_shipping_total` string

    运费退款总金额
  - `refund_tip` string

    小费退款金额
  - `refund_additional_total` string

    附加费用退款总金额
  - `refund_product_total` string

    商品退款总金额
  - `refund_line_items` object[]

    按商品行项目划分的退款明细列表

    *   Array \[

    - `line_item_id` string (required)

      被退款的订单商品行 ID
    - `refund_item_type` enum

      退款项目类型：

      *   `auto`: 自动按类型计算退款数量
      *   `shipped`: 仅退已发货的商品
      *   `waiting_ship`: 仅退未发货（待发货）的商品
    - `quantity` int32

      退款数量
    - `return_inventory` boolean

      是否将退款商品退还到库存
    *   \]
  - `refund_payments` object[]

    按支付渠道划分的退款金额列表

    *   Array \[

    - `payment_line_id` string (required)

      退款使用的支付渠道 ID
    - `refund_price` string (required)

      该支付渠道的退款金额
    *   \]
  - `refund_additional_prices` object[]

    按附加费用划分的退款明细列表

    *   Array \[

    - `name` string (required)

      被退款的附加费用名称
    - `price` string (required)

      该附加费用的退款金额
    *   \]
  - `note` string

    商家填写的退款备注

```json
{
  "refund": {
    "refund_total": "string",
    "refund_shipping_total": "string",
    "refund_tip": "string",
    "refund_additional_total": "string",
    "refund_product_total": "string",
    "refund_line_items": [
      {
        "line_item_id": "string",
        "refund_item_type": 0,
        "quantity": 0,
        "return_inventory": true
      }
    ],
    "refund_payments": [
      {
        "payment_line_id": "string",
        "refund_price": "string"
      }
    ],
    "refund_additional_prices": [
      {
        "name": "string",
        "price": "string"
      }
    ],
    "note": "string"
  }
}
```

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `refund_record_id` string

    创建的退款记录 ID
  - `post_sale_id` string

    随退款一并生成的售后记录 ID

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "refund_record_id": "string",
    "post_sale_id": "string"
  }
}
```