**版本：202601**

# 查询余额

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

返回商家当前的余额概览，按币种列出可用余额、待结算余额、滚动备用金和固定备用金。

## 请求

**Query参数**

- `region` string

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

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

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `list` object[]

    余额条目列表，每个币种对应一条记录

    *   Array \[

    - `currency` string

      货币代码（如 USD、EUR）
    - `available_balance` string

      可用余额金额
    - `pending_balance` string

      待结算余额金额
    - `reserve_balance` string

      滚动预留余额金额
    - `fixed_reserve_balance` string

      固定预留余额金额
    *   \]

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "list": [
      {
        "currency": "string",
        "available_balance": "string",
        "pending_balance": "string",
        "reserve_balance": "string",
        "fixed_reserve_balance": "string"
      }
    ]
  }
}
```