**版本：202601**

# 查询结算明细列表

**GET** `/openapi/2026-01/shoplazza-payment/settlements/details`

分页返回结算明细记录，可按交易类型、币种、地区和结算时间范围过滤。

## 请求

**Query参数**

- `cursor` string

  分页游标
- `page_size` int32

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

  按结算交易类型筛选：

  *   `payment`: 支付结算
  *   `reserve_release`: 备用金按计划释放
  *   `chargeback`: 拒付扣款
  *   `chargeback_win`: 拒付胜诉，资金返还
  *   `refund`: 退款结算
  *   `refund_reversal`: 退款冲正
  *   `ship_ins_comm_transfer`: 运费险佣金转入
  *   `ship_ins_comm_reversal`: 运费险佣金转入冲正
  *   `adjustment`: 结算调整
  *   `debit_negative_balance`: 负余额补扣
  *   `debit_negative_balance_reversal`: 负余额补扣冲正
- `currency` string

  结算账户的币种代码。默认使用商家的默认币种，且必须与所选地区相匹配
- `settlement_time_min` string

  筛选在该 Unix 时间及之后发起的结算记录（如 1730548810）
- `settlement_time_max` string

  筛选在该 Unix 时间及之前发起的结算记录（如 1730548810）
- `region` string

  商家账户所在地区（如 US、HK）。默认使用商家的默认地区

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `list` object[]

    结算明细记录列表

    *   Array \[

    - `store_id` string

      与结算关联的店铺 ID
    - `currency` string

      结算账户的货币
    - `trans_type` string

      交易类型，参见请求参数中的有效 trans\_type 值
    - `trans_id` string

      结算的唯一交易 ID
    - `fee_amount` string

      与交易关联的费用金额
    - `settlement_amount` string

      总结算金额
    - `reserve_amount` string

      交易的预留金额
    - `settlement_time` string

      结算时间，Unix 时间格式
    - `merchant_id` string

      与结算相关的商家 ID
    *   \]
  - `cursor` string

    分页游标
  - `has_more` boolean

    是否有更多记录

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "list": [
      {
        "store_id": "string",
        "currency": "string",
        "trans_type": "string",
        "trans_id": "string",
        "fee_amount": "string",
        "settlement_amount": "string",
        "reserve_amount": "string",
        "settlement_time": "string",
        "merchant_id": "string"
      }
    ],
    "cursor": "string",
    "has_more": true
  }
}
```