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

> Obtén una lista paginada de las subcuentas virtuales de un comercio y sus datos bancarios en todas las monedas fiat admitidas.

Usa este endpoint para listar las cuentas virtuales creadas para un comercio. Cada registro incluye el alias de la cuenta virtual, el nombre del método de pago y los datos bancarios específicos necesarios para fondearla (por ejemplo, un número CLABE, un CVU o un código QR de Pix). Es la contraparte de lectura del endpoint Crear cuentas virtuales y admite paginación para comercios con muchas cuentas virtuales.

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

## Endpoint

`GET https://api.velafi.com/v2/merchant/virtual/addfunds`

## Parámetros de consulta

**merchantId** `integer` *required*

El ID del comercio.

**paymentId** `integer` *required*

ID del canal de pago. Valores admitidos:

* `105` — SPEI (Finco Pay), MXN
* `72` — SPEI (Tesored), MXN
* `63` — CBU/CVU (Momentum), ARS
* `137` — QR Argentina, ARS (QR estático)
* `68` — Automatic ACH (link de pago), COP
* `69` — Bre-B, COP (solo después de que se haya creado la llave Bre-B del comercio)
* `90` — Pix (Genial), BRL
* `92` — Pix - Woovi (Avenia), BRL (QR estático)

**fiat** `string` *required*

Moneda fiat. Valores admitidos: `MXN`, `ARS`, `COP`, `BRL`.

**depositAlias** `string`

Filtra por un alias de cuenta virtual específico.

**currentPage** `integer`

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

**pageSize** `integer`

Registros por página. El valor predeterminado es `10`. Los valores mayores a `100` se limitan a `100`; los valores mayores a `1000` se rechazan.

## Campos de la respuesta

**code** `number`

Código de respuesta de estilo 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 actual devuelta.

**size** `number`

Número de registros en esta página.

**total** `number`

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

**record** `array`

**campos de cada elemento de record**

**fiat** `string`

Moneda fiat de la cuenta virtual.

**depositAlias** `string`

Alias que identifica esta cuenta virtual.

**paymentMethodName** `string`

Nombre legible del método de pago.

**status** `number`

Estado: `1` = en autenticación, `2` = normal (activa), `3` = autenticación fallida.

**fieldList** `object`

Mapa de nombres de campos de datos bancarios a sus valores. Las claves son las mismas que en [Obtener cuenta Pending Fund](https://docs.velafi.com/es/api-reference/merchant/get-pending-fund-account.md#fieldlist-keys-by-payment-method). Este endpoint no recibe `amount`, así que nunca devuelve un QR específico de un depósito ni un `txId`.

## Ejemplos

> [tab] MXN
>
> ```bash cURL theme={null}
> curl -G https://api.velafi.com/v2/merchant/virtual/addfunds \
>   -H "X-BH-TOKEN: YOUR_TOKEN" \
>   --data-urlencode "merchantId=151209" \
>   --data-urlencode "fiat=MXN" \
>   --data-urlencode "paymentId=105"
> ```
>
> ```json Response theme={null}
> {
>   "code": 200,
>   "msg": "SUCCESS",
>   "data": {
>     "currentPage": 1,
>     "size": 10,
>     "total": 50,
>     "record": [
>       {
>         "fiat": "MXN",
>         "depositAlias": "store001",
>         "paymentMethodName": "SPEI - FINCO PAY",
>         "fieldList": {
>           "Cuenta CLABE": "000000000000000001"
>         }
>       }
>     ]
>   }
> }
> ```

> [tab] ARS
>
> ```json Response theme={null}
> {
>   "code": 200,
>   "msg": "SUCCESS",
>   "data": {
>     "currentPage": 1,
>     "size": 10,
>     "total": 5,
>     "record": [
>       {
>         "fiat": "ARS",
>         "depositAlias": "arg-store",
>         "paymentMethodName": "Automated Bank Transfer (Argentina)",
>         "fieldList": {
>           "CVU Number": "0000000000000000000003",
>           "CUIT": "20000000002"
>         }
>       }
>     ]
>   }
> }
> ```

> [tab] BRL (Pix)
>
> ```json Response theme={null}
> {
>   "code": 200,
>   "msg": "SUCCESS",
>   "data": {
>     "currentPage": 1,
>     "size": 10,
>     "total": 3,
>     "record": [
>       {
>         "fiat": "BRL",
>         "depositAlias": "brl-main",
>         "paymentMethodName": "Automated Pix",
>         "fieldList": {
>           "Pix copia e cola": "00020101021126580014br.gov.bcb.pix013865755...",
>           "Pix QR Code": "https://example.com/pix-qr-code.png"
>         }
>       }
>     ]
>   }
> }
> ```


## Related topics

- [Crear cuentas virtuales](https://docs.velafi.com/es/api-reference/merchant/create-multiple-virtual-account.md)
- [Códigos de error](https://docs.velafi.com/es/docs/error-codes.md)
- [Registro de cambios](https://docs.velafi.com/es/docs/changelog.md)
- [Listar cuentas de comercio](https://docs.velafi.com/es/api-reference/merchant/get-a-list-of-merchant-accounts.md)
- [Listar beneficiarios](https://docs.velafi.com/es/api-reference/beneficiary/get-beneficiary.md)


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