> ## Documentation Index
> Fetch the complete documentation index at: https://docs.velafi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 获取商户账户列表

> 获取商户法币支付账户的分页列表，包括其激活状态、当前余额和每月交易限额。

使用此端点查看与一个或多个商户关联的法币支付账户。每条账户记录都会显示币种、当前余额、渠道详情，以及每月买入和卖出限额及其使用情况。您可以按商户 ID、币种或激活状态进行筛选以缩小结果范围。

> [!NOTE]
>
> 所有请求都必须包含 `X-BH-TOKEN` 请求头，其中包含通过 `GET /v2/token/generate` 获取的业务令牌。

## 端点

`GET https://api.velafi.com/v2/merchant/accounts`

## 查询参数

**merchantId** `integer`

按商户唯一 ID (MID) 筛选。

**merchantName** `string`

按商户名称筛选。

**email** `string`

按商户电子邮件地址筛选。

**fiat** `string`

按法币代码筛选，例如 `MXN`、`ARS`、`BRL`。

**status** `integer`

按账户激活状态筛选：

* `1` — 待处理
* `2` — 已激活
* `3` — 失败
* `4` — 不完整

**currentPage** `integer`

要获取的页码（从 1 开始）。默认为 `1`。

**pageSize** `integer`

每页记录数。默认为 `10`，最大为 `1000`。

## 响应字段

**code** `number`

HTTP 风格的响应码。`200` 表示成功。

**msg** `string`

人类可读的状态消息，例如 `SUCCESS`。

**data** `object`

**data 字段**

**currentPage** `number`

返回的当前页码。

**size** `number`

本页的记录数。

**total** `number`

符合查询条件的账户总数。

**record** `array`

**record 项字段**

**merchantId** `number`

商户唯一标识符。

**fiat** `string`

此账户的法币。

**balance** `string`

以该法币计的当前余额。

**status** `number`

账户状态：`0` = 已初始化，`1` = 待处理，`2` = 已激活，`3` = 失败，`4` = 不完整。已关闭或已停用的渠道也会报告为 `1`。记录按渠道配置列出，因此仍处于待处理或不完整状态的渠道可能尚未列出。

**paymentId** `number`

支付渠道配置的 ID。

**paymentMethodName** `string`

支付方式的可读名称（例如 `Automated Bank Transfer(Mexico)`）。

**monthBuyLimit** `string`

此账户的每月买入（入金）法币限额。

**monthBuyUsed** `string`

本月已使用的每月买入限额法币金额。

**monthSellLimit** `string`

此账户的每月卖出（出金）法币限额。

**monthSellUsed** `string`

本月已使用的每月卖出限额法币金额。

**failReason** `string`

激活失败的原因（如适用）。

**createTime** `string`

账户创建时的 Unix 时间戳（毫秒）。

**updateTime** `string`

账户最后更新时的 Unix 时间戳（毫秒）。

## 示例

```bash cURL theme={null}
curl -G https://api.velafi.com/v2/merchant/accounts \
  -H "X-BH-TOKEN: YOUR_TOKEN" \
  --data-urlencode "merchantId=100001" \
  --data-urlencode "status=2" \
  --data-urlencode "pageSize=10"
```

```json Response theme={null}
{
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "currentPage": 1,
    "size": 10,
    "total": 2,
    "record": [
      {
        "merchantId": 1,
        "fiat": "MXN",
        "balance": "100.00",
        "status": 2,
        "paymentId": 105,
        "paymentMethodName": "Automated Bank Transfer(Mexico)",
        "monthBuyLimit": "50000",
        "monthBuyUsed": "2000.00",
        "monthSellLimit": "50000",
        "monthSellUsed": "0",
        "failReason": "",
        "createTime": "1737452292000",
        "updateTime": "1737452344000"
      }
    ]
  }
}
```


## Related topics

- [更新日志](https://docs.velafi.com/cn/docs/changelog.md)
- [激活个人商户账户](https://docs.velafi.com/cn/api-reference/merchant/activate-merchant-account-for-individual.md)
- [商户](https://docs.velafi.com/cn/docs/merchants.md)
- [获取商户列表](https://docs.velafi.com/cn/api-reference/merchant/get-a-list-of-merchants.md)
- [获取虚拟账户列表](https://docs.velafi.com/cn/api-reference/merchant/get-multiple-virtual-account.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.