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

# Transferir fondos Pending Fund

> Mueve saldo fiat de la cuenta Pending Fund de un comercio a otro comercio dentro de la plataforma de VelaFi, al instante y sin transferencia bancaria.

Usa este endpoint para transferir fondos en fiat entre dos cuentas de comercio dentro del sistema de VelaFi. La transferencia es interna y no requiere una transacción bancaria. Tanto el comercio que envía como el que recibe deben tener cuentas activas para la combinación de `fiat` y `paymentId` especificada. Usa primero el endpoint [Comisión de transferencia](https://docs.velafi.com/es/api-reference/merchant/get-transfer-pending-funds-fee.md) para revisar los costos aplicables antes de iniciar la transferencia.

> [!NOTE]
>
> Todas las solicitudes deben incluir el encabezado `X-BH-TOKEN` y `Content-Type: application/json`. El `clientId` se usa para la idempotencia: los valores de `clientId` duplicados devuelven el resultado original.

## Endpoint

`POST https://api.velafi.com/v2/merchant/transfer`

## Parámetros de la solicitud

**clientId** `string` *required*

Tu identificador único para esta transferencia. Se usa para eliminar duplicados y para el rastreo.

**fromMerchantId** `number` *required*

ID del comercio que envía los fondos.

**toMerchantId** `number` *required*

ID del comercio que recibe los fondos.

**fiat** `string` *required*

Moneda fiat que se transferirá. Valores admitidos: `MXN`, `ARS`, `COP`, `BRL`, `PEN`.

**paymentId** `number` *required*

ID del canal de pago correspondiente a la moneda fiat:

* `105` o `72` — MXN
* `63` — ARS
* `68` — COP
* `90` — BRL
* `95` — PEN

**fiatAmount** `number` *required*

Monto que se transferirá en la moneda fiat especificada.

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

**clientId** `string`

El identificador que proporcionaste, devuelto tal cual.

**fromId** `number`

ID del registro de fondeo en la cuenta del remitente (asiento de cargo).

**toId** `number`

ID del registro de fondeo en la cuenta del destinatario (asiento de abono).

**fiat** `string`

Moneda fiat de la transferencia.

**fiatAmount** `string`

Monto neto transferido.

**totalFiatAmount** `string`

Monto total descontado al remitente (fiatAmount + comisión).

**fee** `string`

Comisión cobrada por esta transferencia.

**createTime** `number`

Marca de tiempo Unix (milisegundos) en la que se creó la transferencia.

## Ejemplos

> [tab] MXN
>
> ```bash cURL theme={null}
> curl -X POST https://api.velafi.com/v2/merchant/transfer \
>   -H "X-BH-TOKEN: YOUR_TOKEN" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "clientId": "transfer-mxn-001",
>     "fromMerchantId": 434,
>     "toMerchantId": 5,
>     "fiat": "MXN",
>     "paymentId": 105,
>     "fiatAmount": 10
>   }'
> ```
>
> ```json Respuesta theme={null}
> {
>   "code": 200,
>   "msg": "SUCCESS",
>   "data": {
>     "clientId": "transfer-mxn-001",
>     "fromId": 521006138624569344,
>     "toId": 521006138641346560,
>     "fiat": "MXN",
>     "fiatAmount": "10",
>     "totalFiatAmount": "10",
>     "fee": "0",
>     "createTime": 1746694343261
>   }
> }
> ```

> [tab] ARS
>
> ```json Cuerpo de la solicitud theme={null}
> {
>   "clientId": "transfer-ars-001",
>   "fromMerchantId": 434,
>   "toMerchantId": 5,
>   "fiat": "ARS",
>   "paymentId": 63,
>   "fiatAmount": 10
> }
> ```
>
> ```json Respuesta theme={null}
> {
>   "code": 200,
>   "msg": "SUCCESS",
>   "data": {
>     "clientId": "transfer-ars-001",
>     "fromId": 521006138624569345,
>     "toId": 521006138641346561,
>     "fiat": "ARS",
>     "fiatAmount": "10",
>     "totalFiatAmount": "10",
>     "fee": "0",
>     "createTime": 1746694343261
>   }
> }
> ```

> [tab] COP / BRL / PEN
>
> ```json Cuerpo de la solicitud COP theme={null}
> {
>   "clientId": "transfer-cop-001",
>   "fromMerchantId": 15127301,
>   "toMerchantId": 15127302,
>   "fiat": "COP",
>   "paymentId": 68,
>   "fiatAmount": 10
> }
> ```
>
> ```json Cuerpo de la solicitud BRL theme={null}
> {
>   "clientId": "transfer-brl-001",
>   "fromMerchantId": 15127301,
>   "toMerchantId": 15127302,
>   "fiat": "BRL",
>   "paymentId": 90,
>   "fiatAmount": 10
> }
> ```
>
> ```json Cuerpo de la solicitud PEN theme={null}
> {
>   "clientId": "transfer-pen-001",
>   "fromMerchantId": 15127301,
>   "toMerchantId": 15127302,
>   "fiat": "PEN",
>   "paymentId": 95,
>   "fiatAmount": 10
> }
> ```

> [!NOTE]
>
> Usa los valores `fromId` y `toId` para buscar los asientos correspondientes en el endpoint de registros de fondeo y obtener el rastro de auditoría completo.


## Related topics

- [Reclamar fondos Pending Fund](https://docs.velafi.com/es/api-reference/merchant/claim-pending-fund.md)
- [Obtener la comisión de transferencia](https://docs.velafi.com/es/api-reference/merchant/get-transfer-pending-funds-fee.md)
- [Obtener la cuenta Pending Fund](https://docs.velafi.com/es/api-reference/merchant/get-pending-fund-account.md)
- [Registro de cambios](https://docs.velafi.com/es/docs/changelog.md)
- [On-ramp (fiat a cripto)](https://docs.velafi.com/es/docs/guides/on-ramp.md)


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