> ## 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.

# Listar cuentas de comercio

> Obtén una lista paginada de las cuentas de pago fiat de los comercios con su estado de activación, saldos actuales y límites mensuales de transacciones.

Usa este endpoint para consultar las cuentas de pago fiat asociadas a uno o más comercios. Cada registro de cuenta muestra la moneda, el saldo actual, los detalles del canal y los límites mensuales de compra y venta con sus cifras de uso. Puedes filtrar por ID de comercio, moneda o estado de activación para acotar los resultados.

> [!NOTE]
>
> Todas las solicitudes deben incluir el header `X-BH-TOKEN` con un token de negocio de `GET /v2/token/generate`.

## Endpoint

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

## Parámetros de consulta

**merchantId** `integer`

Filtra por el ID único del comercio (MID).

**merchantName** `string`

Filtra por nombre del comercio.

**email** `string`

Filtra por dirección de correo electrónico del comercio.

**fiat** `string`

Filtra por código de moneda fiat, por ejemplo `MXN`, `ARS`, `BRL`.

**status** `integer`

Filtra por estado de activación de la cuenta:

* `1` — pendiente
* `2` — activa
* `3` — fallida
* `4` — incompleta

**currentPage** `integer`

Número de página que se va a obtener (empieza en 1). El valor predeterminado es `1`.

**pageSize** `integer`

Número de registros por página. El valor predeterminado es `10` y el máximo es `1000`.

## Campos de la respuesta

**code** `number`

Código de respuesta de tipo HTTP. `200` indica éxito.

**msg** `string`

Mensaje de estado legible, por ejemplo `SUCCESS`.

**data** `object`

**campos de data**

**currentPage** `number`

Número de la página devuelta.

**size** `number`

Número de registros en esta página.

**total** `number`

Número total de cuentas que coinciden con la consulta.

**record** `array`

**campos de cada elemento de record**

**merchantId** `number`

Identificador único del comercio.

**fiat** `string`

Moneda fiat de esta cuenta.

**balance** `string`

Saldo actual en la moneda fiat.

**status** `number`

Estado de la cuenta: `0` = inicializada, `1` = pendiente, `2` = activa, `3` = fallida, `4` = incompleta. Los canales cerrados o deshabilitados también se reportan como `1`. Los registros se listan por configuración de canal, así que un canal que todavía está pendiente o incompleto puede no aparecer aún.

**paymentId** `number`

ID de la configuración del canal de pago.

**paymentMethodName** `string`

Nombre legible del método de pago (por ejemplo, `Automated Bank Transfer(Mexico)`).

**monthBuyLimit** `string`

Límite mensual de compra (on-ramp) en fiat para esta cuenta.

**monthBuyUsed** `string`

Monto en fiat usado este mes contra el límite mensual de compra.

**monthSellLimit** `string`

Límite mensual de venta (off-ramp) en fiat para esta cuenta.

**monthSellUsed** `string`

Monto en fiat usado este mes contra el límite mensual de venta.

**failReason** `string`

Motivo de la falla de activación, si aplica.

**createTime** `string`

Marca de tiempo Unix (milisegundos) de cuando se creó la cuenta.

**updateTime** `string`

Marca de tiempo Unix (milisegundos) de la última actualización de la cuenta.

## Ejemplo

```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

- [Activar la cuenta de un comercio persona física](https://docs.velafi.com/es/api-reference/merchant/activate-merchant-account-for-individual.md)
- [Activar la cuenta de un comercio](https://docs.velafi.com/es/docs/guides/activating-merchant-account.md)
- [Activar la cuenta de un comercio empresa](https://docs.velafi.com/es/api-reference/merchant/activate-merchant-account-for-business.md)
- [Registro de cambios](https://docs.velafi.com/es/docs/changelog.md)
- [Listar comercios](https://docs.velafi.com/es/api-reference/merchant/get-a-list-of-merchants.md)


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