**版本：202601**

# 查询余额明细列表

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

分页返回指定账户类型（可用、待结算或固定备用金）的余额交易明细。

## 请求

**Query参数**

- `balance_type` string

  要查询的余额账户类型：

  *   `available`: 可用余额（acc\_settle）
  *   `pending`: 待结算余额（acc\_payment）
  *   `fixed_reserve`: 固定备用金余额（acc\_fixed\_reserve）
- `region` string

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

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

  分页游标
- `page_size` int32

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

  按交易事件类型筛选。仅在 balance\_type 为 "available" 时生效；当 balance\_type 为 "pending" 或 "fixed\_reserve" 时该字段被忽略：

  *   `batch_settlement`: 已完成支付的批量结算
  *   `funds_reserved`: 资金划入滚动或固定备用金
  *   `released_reserve`: 备用金释放回可用余额
  *   `return_funds`: 退款相关资金退回
  *   `balance_debit`: 余额扣减
  *   `pay_in`: 入账到可用余额
  *   `adjustment`: 人工或系统的余额调整
  *   `payout`: 向商家银行账户的打款
  *   `payout_fee`: 打款手续费
  *   `active_account_fee`: 账户活跃服务费
  *   `withdrawal_exchange_fee`: 提现汇兑费
- `trans_time_min` string

  筛选在该 Unix 时间及之后发生的交易（如 1730548810）
- `trans_time_max` string

  筛选在该 Unix 时间及之前发生的交易（如 1730548810）

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `list` object[]

    余额交易明细记录列表

    *   Array \[

    - `trans_time` string

      交易发生的时间（如 2018-11-02T12:30:10Z）
    - `trans_id` string

      关联的业务交易 ID
    - `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`: 负余额补扣冲正
    - `trans_amount` string

      交易金额，正值表示入账，负值表示出账
    - `currency` string

      交易的币种代码（如 USD、EUR）
    - `balance_before` string

      此交易发生前的账户余额
    - `balance_after` string

      此交易发生后的账户余额
    - `description` string

      交易的可读描述说明
    *   \]
  - `cursor` string

    分页游标
  - `has_more` boolean

    是否有更多记录

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "list": [
      {
        "trans_time": "string",
        "trans_id": "string",
        "trans_type": "string",
        "trans_amount": "string",
        "currency": "string",
        "balance_before": "string",
        "balance_after": "string",
        "description": "string"
      }
    ],
    "cursor": "string",
    "has_more": true
  }
}
```