**版本：202601**

# 查询备用金明细列表

**GET** `/openapi/2026-01/shoplazza-payment/reserved-fund/details`

分页返回备用金明细记录，可按币种、地区和创建时间范围过滤。

## 请求

**Query参数**

- `cursor` string

  分页游标
- `page_size` int32

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

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

  筛选在该 Unix 时间及之后创建的备用金记录（如 1730548810）
- `created_at_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
    - `pay_currency` string

      支付金额的货币
    - `transaction_id` string

      预留资金的交易 ID
    - `pay_amount` string

      与预留相关的支付金额
    - `reserve_amount` string

      为该交易预留的金额
    - `pay_created_at` string

      与预留相关的付款创建时间（Unix 时间）
    - `merchant_id` string

      与预留相关的商家 ID
    - `reserve_currency` string

      预留金额的货币
    - `settlement_at` string

      预留结算时间（Unix 时间）
    *   \]
  - `cursor` string

    分页游标
  - `has_more` boolean

    是否有更多记录

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "list": [
      {
        "store_id": "string",
        "pay_currency": "string",
        "transaction_id": "string",
        "pay_amount": "string",
        "reserve_amount": "string",
        "pay_created_at": "string",
        "merchant_id": "string",
        "reserve_currency": "string",
        "settlement_at": "string"
      }
    ],
    "cursor": "string",
    "has_more": true
  }
}
```