**版本：202601**

# 查询争议单列表

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

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

## 请求

**Query参数**

- `cursor` string

  分页游标
- `page_size` int32

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

  按状态筛选争议单：

  *   `lost`: 争议判定商家败诉，资金未追回
  *   `won`: 争议判定商家胜诉，资金保留或已追回
  *   `warning_closed`: 预警型争议已关闭，无需进一步处理
  *   `needs_response`: 争议需要商家提交回复或证据后才能继续处理
  *   `under_review`: 争议正由支付处理方或金融机构审核中
  *   `warning_under_review`: 预警型争议审核中，可能需要进一步处理
  *   `warning_needs_response`: 预警型争议等待商家回复，否则可能升级
- `created_at_min` string

  筛选在该 Unix 时间及之后创建的争议单（如 1730548810）
- `created_at_max` string

  筛选在该 Unix 时间及之前创建的争议单（如 1730548810）

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `list` object[]

    争议单记录列表

    *   Array \[

    - `id` string

      争议 ID
    - `transaction_order_id` string

      与争议相关的交易订单 ID
    - `original_order_id` string

      与交易相关的原始订单 ID
    - `store_id` string

      店铺 ID
    - `currency` string

      争议金额的货币代码
    - `created_at` string

      争议创建时间，ISO 8601 格式
    - `updated_at` string

      争议最后更新时间，ISO 8601 格式
    - `expiration_time` string

      争议回应的截止时间
    - `dispute_reason` string

      发起争议时填写的原因
    - `original_order_amount` string

      原始订单的总金额
    - `dispute_amount` string

      争议金额
    - `status` string

      争议当前状态，可选值：won（已胜诉）、lost（已败诉）、under\_review（审核中）等
    - `fee` string

      与争议关联的费用
    - `fee_currency` string

      关联费用的货币
    *   \]
  - `cursor` string

    分页游标
  - `has_more` boolean

    是否有更多记录

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "list": [
      {
        "id": "string",
        "transaction_order_id": "string",
        "original_order_id": "string",
        "store_id": "string",
        "currency": "string",
        "created_at": "string",
        "updated_at": "string",
        "expiration_time": "string",
        "dispute_reason": "string",
        "original_order_amount": "string",
        "dispute_amount": "string",
        "status": "string",
        "fee": "string",
        "fee_currency": "string"
      }
    ],
    "cursor": "string",
    "has_more": true
  }
}
```