**版本：202601**

# 查询退款单列表

**GET** `/openapi/2026-01/shoplazza-payment/refunds`

分页返回退款单列表，可按状态和创建时间范围过滤。

## 请求

**Query参数**

- `cursor` string

  分页游标
- `page_size` int32

  每页记录数（1-100，默认 10）
- `status` string

  按状态筛选退款单：

  *   `succeeded`: 退款处理成功
  *   `failed`: 退款失败，未退回资金
  *   `processing`: 退款处理中，最终结果待确认
- `created_at_min` string

  按发起时间过滤的起始值。支持 Unix 时间（如 1730548810）或 ISO 时间字符串（如 2018-11-02T12:30:10Z）
- `created_at_max` string

  按发起时间过滤的结束值。支持 Unix 时间（如 1730548810）或 ISO 时间字符串（如 2018-11-02T12:30:10Z）

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `list` object[]

    退款单记录列表

    *   Array \[

    - `id` string

      退款 ID
    - `store_id` string

      与退款关联的店铺 ID
    - `balance_currency` string

      余额使用的货币
    - `transaction_order_id` string

      与退款关联的交易订单 ID
    - `status` string

      退款状态：

      *   `succeeded`: 退款成功
      *   `failed`: 退款失败
      *   `processing`: 退款处理中
    - `amount` string

      退款金额
    - `currency` string

      退款的货币代码（如 USD）
    - `original_order_amount` string

      退款前的原始订单金额
    - `created_at` string

      退款创建时间（ISO-8601 格式）
    - `completed_at` string

      退款完成时间（ISO-8601 格式）
    *   \]
  - `cursor` string

    分页游标
  - `has_more` boolean

    是否有更多记录

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "list": [
      {
        "id": "string",
        "store_id": "string",
        "balance_currency": "string",
        "transaction_order_id": "string",
        "status": "string",
        "amount": "string",
        "currency": "string",
        "original_order_amount": "string",
        "created_at": "string",
        "completed_at": "string"
      }
    ],
    "cursor": "string",
    "has_more": true
  }
}
```