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

# Obtener la cuenta Pending Fund

> Obtén los datos bancarios o un enlace de pago de la cuenta Pending Fund (fondos pendientes) de un comercio para precargar saldo fiat disponible antes de operar.

Usa este endpoint para obtener las instrucciones de depósito de la cuenta Pending Fund (fondos pendientes) de un comercio. Precargar fondos permite ejecutar las operaciones más rápido, porque VelaFi no necesita esperar a que se liquide una transferencia externa al momento de crear la orden. La respuesta varía según el método de pago: por ejemplo, una cuenta CLABE en MXN devuelve un número CLABE y el nombre del beneficiario, mientras que una cuenta Pix Woovi en BRL devuelve un código QR y la clave Pix para copiar y pegar.

> [!NOTE]
>
> `amount` es obligatorio para los IDs de pago `95`, `142` y `144`, y opcional para `92` y `137`. Consulta el parámetro `amount` más abajo.

## Endpoint

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

## Parámetros de consulta

**merchantId** `integer` *required*

El ID del comercio.

**paymentId** `integer` *required*

ID del canal de pago. Valores admitidos:

| ID | Método | Moneda |
| - | - | - |
| `105` | SPEI (Finco Pay) | MXN |
| `72` | CLABE - Tesored | MXN |
| `63` | CBU/CVU (Momentum) | ARS |
| `137` | QR Argentina | ARS |
| `68` | Automatic ACH (payment link) | COP |
| `69` | Bre-B | COP |
| `142` | BanColombia Link | COP |
| `144` | QR Bre-B | COP |
| `90` | Pix (Genial) | BRL |
| `92` | Pix - Woovi (Avenia) | BRL |
| `81`–`84` | ACH / Wire (Lead Bank) | USD |
| `85` | SEPA (Bridge) | EUR |
| `95` | Bank Transfer | PEN |

**fiat** `string` *required*

Código de moneda fiat: `MXN`, `ARS`, `COP`, `BRL`, `PEN`, `USD` o `EUR`.

**depositAlias** `string`

Alias de la cuenta virtual en la que se depositará (opcional).

**amount** `number`

Monto del depósito. Obligatorio para `95` (mínimo 10 PEN), `142` y `144`. Opcional para `92` (mínimo 0.01 BRL) y `137`: cuando lo envías, la respuesta corresponde a un depósito por ese monto e incluye `txId`.

**bank** `string`

Código de banco para PSE (`141`). Por ahora, los depósitos PSE no están disponibles en este endpoint.

**type** `string`

Enum: `alias` o `emailAddress`. Se usa con `69` (Bre-B): es obligatorio en la primera llamada, cuando se crea la clave Bre-B.

## Campos de la respuesta

**code** `number`

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

**msg** `string`

Mensaje de estado legible, p. ej. `SUCCESS`.

**data** `object`

**campos de data**

**fiat** `string`

Moneda fiat de la cuenta Pending Fund.

**paymentMethodName** `string`

Nombre legible del método de pago.

**txId** `string`

ID del registro de fondeo. Se devuelve cuando la llamada crea un depósito por un monto específico: siempre para `95`, `142` y `144`, y para `92` y `137` cuando envías `amount`.

**fieldList** `object`

Mapa de nombres de campos de depósito a sus valores. Las claves dependen del método de pago; consulta [Claves de `fieldList` por método de pago](#fieldlist-keys-by-payment-method).

## Claves de `fieldList` por método de pago

Las claves de `fieldList` son fijas para cada método de pago. Sus valores se llenan cuando llamas al endpoint, a partir de la cuenta del comercio en ese canal. Las imágenes QR se devuelven como enlaces temporales que expiran una hora después de la respuesta, así que vuelve a llamar al endpoint cuando necesites un enlace nuevo.

| `paymentId` | Claves | Valores | Notas |
| - | - | - | - |
| `105` SPEI (Finco Pay) | `Cuenta CLABE` | La CLABE del comercio | |
| `72` SPEI (Tesored) | `clabeNumber` | La CLABE del comercio | |
| `63` CBU/CVU (Momentum) | `CVU Number`, `CUIT`, `Alias` | El CVU, el CUIT del titular de la cuenta y el alias del CVU | `Alias` puede estar vacío. |
| `137` QR Argentina | `qrCodeLink` | Enlace a la imagen QR | Con `amount` mayor que `0`, el QR corresponde a ese monto y se devuelve `txId`. |
| `68` Automatic ACH | `alias`, `paymentLink` | El alias del comercio y el enlace de depósito | `alias` puede estar vacío. |
| `69` Bre-B | `brebKey` | La clave Bre-B del comercio | La primera llamada debe incluir `type`. Mientras se crea la clave, la solicitud falla; vuelve a llamar más tarde. |
| `142` BanColombia | `paymentLink`, `Alias` | El enlace de pago (checkout) para este depósito; `Alias` siempre está vacío | `amount` es obligatorio. Se devuelve `txId`. |
| `144` QR Bre-B | `qrCode` | Enlace a la imagen QR | `amount` es obligatorio. Se devuelve `txId`. |
| `90` Pix (Genial) | `Chave Pix - Random Pix`, `Pix copia e cola`, `Pix QR Code` | La clave Pix aleatoria del comercio, el código Pix para copiar y pegar, y el enlace a la imagen QR | `Pix copia e cola` solo se devuelve cuando el comercio tiene un código QR de Pix. |
| `92` Pix - Woovi (Avenia) | `pixKey`, `qrCodeLink`, `qrCode` | La clave Pix, el enlace a la imagen QR y el código Pix para copiar y pegar | `pixKey` se omite cuando el comercio no tiene una. Con `amount` (mínimo 0.01 BRL), el QR corresponde a ese monto y se devuelve `txId`. |
| `81`, `83` ACH / FedWire de referencia (Lead Bank) | `Deposit Message`, `Bank Account Number`, `Bank Routing Number`, `Bank Beneficiary Name`, `Bank Name`, `Bank Address` | Datos bancarios a los que debes enviar el depósito | Los valores pueden estar vacíos. |
| `82`, `84` ACH / FedWire virtual (Lead Bank) | `Bank Account Number`, `Bank Routing Number`, `Bank Beneficiary Name`, `Bank Name`, `Bank Address` | Datos bancarios a los que debes enviar el depósito | Los valores pueden estar vacíos. |
| `85` SEPA (Bridge) | `Deposit Message`, `BIC/Swift Code`, `IBAN`, `Bank Beneficiary Name`, `Bank Name`, `Bank Address` | Datos bancarios a los que debes enviar el depósito | `Deposit Message` se devuelve vacío. |
| `95` Bank Transfer (PEN) | `paymentLink` | El enlace de pago (checkout) para este depósito | `amount` es obligatorio, mínimo 10 PEN. Se devuelve `txId`. |

`141` (PSE), `143` (Nequi) y `70` (VelaFi Pending Fund) no están disponibles en este endpoint.

## Ejemplos

> [tab] MXN (SPEI)
>
> ```bash cURL theme={null}
> curl -G https://api.velafi.com/v2/merchant/addfunds \
>   -H "X-BH-TOKEN: YOUR_TOKEN" \
>   --data-urlencode "merchantId=100001" \
>   --data-urlencode "paymentId=105" \
>   --data-urlencode "fiat=MXN"
> ```
>
> ```json Response theme={null}
> {
>   "code": 200,
>   "msg": "SUCCESS",
>   "data": {
>     "fiat": "MXN",
>     "paymentMethodName": "SPEI - FINCO PAY",
>     "fieldList": {
>       "Cuenta CLABE": "000000000000000001"
>     }
>   }
> }
> ```

> [tab] ARS (CVU)
>
> ```json Response theme={null}
> {
>   "code": 200,
>   "msg": "SUCCESS",
>   "data": {
>     "fiat": "ARS",
>     "paymentMethodName": "Automated Bank Transfer (Argentina)",
>     "fieldList": {
>       "CVU Number": "0000000000000000000003",
>       "CUIT": "20000000002"
>     }
>   }
> }
> ```

> [tab] BRL (Pix Genial)
>
> ```json Response theme={null}
> {
>   "code": 200,
>   "msg": "SUCCESS",
>   "data": {
>     "fiat": "BRL",
>     "paymentMethodName": "Pix (Genial)",
>     "fieldList": {
>       "Chave Pix - Random Pix": "00000000-0000-0000-0000-000000000005",
>       "Pix copia e cola": "00020101021126580014br.gov.bcb.pix0138...",
>       "Pix QR Code": "https://example.com/pix-qr-code.png"
>     }
>   }
> }
> ```

> [tab] USD (ACH/Wire)
>
> ```json Response theme={null}
> {
>   "code": 200,
>   "msg": "SUCCESS",
>   "data": {
>     "fiat": "USD",
>     "paymentMethodName": "ACH_push",
>     "fieldList": {
>       "Deposit Message": "BRG0000000000000000",
>       "Bank Account Number": "11223344556672",
>       "Bank Routing Number": "123456790",
>       "Bank Beneficiary Name": "Ventures Inc",
>       "Bank Name": "Bank of Nowhere",
>       "Bank Address": "1800 North Pole St., Orlando, FL 32803"
>     }
>   }
> }
> ```

> [tab] EUR (SEPA)
>
> ```json Response theme={null}
> {
>   "code": 200,
>   "msg": "SUCCESS",
>   "data": {
>     "fiat": "EUR",
>     "paymentMethodName": "SEPA",
>     "fieldList": {
>       "Deposit Message": "BRG0000000000000000",
>       "BIC/Swift Code": "123456790",
>       "IBAN": "11223344556672",
>       "Bank Beneficiary Name": "Ventures Inc",
>       "Bank Name": "Bank of Nowhere",
>       "Bank Address": "1800 North Pole St., Orlando, FL 32803"
>     }
>   }
> }
> ```

> [!TIP]
>
> Incluye siempre el `Deposit Message` (código de referencia) cuando envíes fondos por ACH o SEPA, para que VelaFi pueda identificar y acreditar el depósito automáticamente.


## Related topics

- [Registro de cambios](https://docs.velafi.com/es/docs/changelog.md)
- [Obtener los detalles de la cuenta](https://docs.velafi.com/es/api-reference/account/get-account-details.md)
- [Reclamar fondos Pending Fund](https://docs.velafi.com/es/api-reference/merchant/claim-pending-fund.md)
- [Transferir fondos Pending Fund](https://docs.velafi.com/es/api-reference/merchant/transfer-pending-funds.md)
- [Obtener la comisión de transferencia](https://docs.velafi.com/es/api-reference/merchant/get-transfer-pending-funds-fee.md)


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