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

# Crear una transferencia cripto

> Transfiere criptoactivos al instante entre dos billeteras en custodia de comercios de VelaFi como transferencia interna, sin pagar comisiones de gas on-chain.

Usa este endpoint para mover criptoactivos de forma interna desde la billetera en custodia de VelaFi de un comercio a la de otro. Las transferencias internas se liquidan al instante sin pagar comisiones de gas de blockchain. El saldo del emisor muestra un `amount` negativo (cargo) y el saldo del receptor muestra un `amount` positivo (abono). Envía un `clientId` para habilitar la idempotencia: las solicitudes duplicadas con el mismo `clientId` devuelven el resultado original en lugar de crear una segunda transferencia.

> [!NOTE]
>
> Todas las solicitudes deben incluir el header `X-BH-TOKEN` y `Content-Type: application/json`.

## Endpoint

`POST https://api.velafi.com/v2/assets/internalTransfer`

## Parámetros de la solicitud

**fromMerchantId** `number` *required*

ID del comercio que envía la cripto.

**toMerchantId** `number` *required*

ID del comercio que recibe la cripto.

**tokenId** `string` *required*

Símbolo del token que se va a transferir. Valores admitidos: `USDT`, `USDC`, `BTC`, `MMXN`.

**amount** `number` *required*

Monto del token que se va a transferir.

**clientId** `string`

Tu identificador único para esta transferencia. Se usa para la idempotencia.

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

**id** `string`

ID de registro único de esta transferencia.

**tokenId** `string`

Token que se transfirió.

**amount** `string`

Monto transferido. Negativo en el registro del emisor (cargo), positivo en el del receptor (abono).

**clientId** `string`

El identificador que proporcionaste para esta transferencia.

**merchantId** `string`

ID del comercio al que pertenece este registro (igual que `fromMerchantId`).

**fromMerchantId** `string`

ID del comercio emisor.

**toMerchantId** `string`

ID del comercio receptor.

## Ejemplo

```bash cURL theme={null}
curl -X POST https://api.velafi.com/v2/assets/internalTransfer \
  -H "X-BH-TOKEN: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "fromMerchantId": 246,
    "toMerchantId": 61,
    "tokenId": "USDT",
    "amount": 10,
    "clientId": "crypto-transfer-001"
  }'
```

```json Response theme={null}
{
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "id": "4352",
    "tokenId": "USDT",
    "amount": "-10",
    "clientId": "crypto-transfer-001",
    "merchantId": "246",
    "fromMerchantId": "246",
    "toMerchantId": "61"
  }
}
```

> [!NOTE]
>
> El `amount` de la respuesta es negativo porque representa el cargo en la cuenta del emisor. Usa el endpoint [Consultar transferencias de cripto](https://docs.velafi.com/es/api-reference/merchant/query-crypto-transfers.md) para ver ambos lados de la transferencia.


## Related topics

- [Crear un retiro cripto](https://docs.velafi.com/es/api-reference/crypto-wallet/create-crypto-withdrawal.md)
- [On-ramp (fiat a cripto)](https://docs.velafi.com/es/docs/guides/on-ramp.md)
- [Off-ramp (cripto a fiat)](https://docs.velafi.com/es/docs/guides/off-ramp.md)
- [Evento de retiro cripto](https://docs.velafi.com/es/api-reference/webhooks/crypto-withdraw-message-push.md)
- [Listar transferencias cripto](https://docs.velafi.com/es/api-reference/merchant/query-crypto-transfers.md)


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