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

# Introducción

> VelaFi permite a los desarrolladores de empresas crear on-ramps de fiat a cripto, off-ramps de cripto a fiat y flujos de pagos globales en fiat sobre rieles de stablecoins.

VelaFi es una plataforma de API financiera que te permite gestionar de forma programática conversiones de activos y transferencias entre monedas a gran escala. Ya sea que necesites aceptar fiat local y liquidar en stablecoins, pagar saldos cripto a cuentas bancarias o mover dinero entre países sin una red tradicional de bancos corresponsales, VelaFi expone cada flujo a través de una sola interfaz RESTful. La API acepta y devuelve JSON, se autentica sobre HTTPS y usa códigos de estado HTTP estándar, así que se integra sin complicaciones en cualquier backend existente.

## Flujos principales

VelaFi organiza sus capacidades en tres flujos de pago distintos. Cada flujo se basa en la misma infraestructura de cuentas y comercios, así que una vez que completes el onboarding puedes habilitar cualquier combinación de ellos.

> [card] [On-ramp fiat → cripto](https://docs.velafi.com/es/docs/guides/on-ramp.md)
>
> Acepta moneda fiat local de un cliente y acredita al instante el equivalente en stablecoin o criptomoneda en su billetera de custodia.

> [card] [Off-ramp cripto → fiat](https://docs.velafi.com/es/docs/guides/off-ramp.md)
>
> Convierte un saldo en cripto o stablecoin y entrega los fondos fiat directamente en la cuenta bancaria de un beneficiario, en su moneda local.

> [card] [Pagos globales fiat → fiat](https://docs.velafi.com/es/docs/guides/global-payments.md)
>
> Envía dinero entre países usando stablecoins como canal de liquidación, con el remitente y el destinatario operando cada uno en su propia moneda local.

### On-ramp: fiat → cripto

El flujo de on-ramp permite que tus comercios reciban depósitos en fiat local (por ejemplo, pesos argentinos (ARS) o pesos mexicanos (MXN)) y reciban automáticamente el saldo correspondiente en criptomoneda. Después de activar una cuenta fiat del comercio, creas una orden, y VelaFi concilia la transferencia bancaria entrante y acredita la cripto en la billetera de custodia del comercio.

### Off-ramp: cripto → fiat

El flujo de off-ramp funciona a la inversa. Tu comercio tiene un saldo en cripto o stablecoin y quiere pagarle a un destinatario en fiat. Creas una orden de cripto a fiat, VelaFi valida la cripto, la convierte y entrega la liquidación en fiat a la cuenta del beneficiario que especifiques.

### Pagos globales: fiat → fiat

El flujo de pagos globales usa stablecoins únicamente como canal de liquidación interno. El remitente paga en una moneda fiat y el destinatario recibe una moneda fiat distinta, sin exposición a cripto en ninguno de los dos lados. Esto lo hace adecuado para nómina, pagos a proveedores y dispersiones de marketplaces entre regiones.

***

## Resumen del onboarding

Antes de poder llamar a la API, completa la siguiente secuencia de configuración, que solo se hace una vez. Cada paso habilita el siguiente.

**1. Crea una cuenta de VelaFi**

Regístrate en [velafi.com/signup](https://www.velafi.com/signup). Una vez que el registro sea exitoso, VelaFi te asigna un **User ID (UID)** único que vincula todos tus comercios, claves de API e historial de transacciones.

**2. Crea un comercio y completa KYC/KYB**

Crea una entidad legal (persona física o empresa) en tu cuenta y envía los documentos de cumplimiento requeridos. Una vez aprobada, VelaFi asigna un **Merchant ID (MID)** y crea automáticamente una billetera de custodia cripto para ese comercio.

**3. Genera tu clave de API**

Inicia sesión en el panel de VelaFi, ve a **Gestión de API** y haz clic en **Crear clave de API**. Se te pedirá activar la autenticación de dos factores (2FA) si todavía no está activa. Copia la clave de API y el secreto de API, y luego agrega las direcciones IP públicas de tus servidores a la lista blanca de la clave. Una clave sin lista blanca no puede obtener un token.

**4. Activa el acceso a la API**

Escribe a [contact@velafi.com](mailto:contact@velafi.com) para solicitar la activación del acceso a la API para tu cuenta. El equipo de soporte de VelaFi te confirmará cuando tu cuenta esté habilitada.

**5. Activa las cuentas de pago del comercio**

Envía los documentos específicos de cada país para activar los canales fiat (ARS, MXN, BRL, USD y otros) en los que operará tu comercio. Cada canal activado recibe una cuenta de pago dedicada; por ejemplo, un CVU y un CUIT para operaciones en pesos argentinos.

***

## Entornos de la API

VelaFi ofrece dos entornos aislados. Usa el sandbox para desarrollar y probar tu integración antes de pasar a producción.

| Entorno | URL base | Propósito |
| - | - | - |
| **Sandbox** | `https://api-test.velafi.com` | Transacciones simuladas, sin fondos reales |
| **Producción** | `https://api.velafi.com` | Transacciones reales con fondos reales |

> [!NOTE]
>
> Las credenciales de sandbox son independientes de tu clave de API de producción. Contacta al equipo de VelaFi para obtener credenciales de sandbox; no se requiere KYC ni crear una clave de API para acceder al sandbox.

***

## Autenticación

Las solicitudes autenticadas llevan un token de negocio en el encabezado `X-BH-TOKEN`. Tu servidor obtiene el token de `GET /v2/token/generate` firmando la solicitud con tu clave de API y tu secreto de API, y solicita uno nuevo antes de que expire. Una solicitud sin token falla con el código `-1002`, y una con un token inválido o expirado falla con el código `-1022`.

```http theme={null}
X-BH-TOKEN: YOUR_TOKEN
```

Este es un ejemplo mínimo que obtiene los datos de tu cuenta:

```bash theme={null}
curl --request GET \
  --url https://api.velafi.com/v2/user/account \
  --header "X-BH-TOKEN: YOUR_TOKEN"
```

Consulta [Autenticación](https://docs.velafi.com/es/api-reference/authentication.md) para ver los pasos de firma y el requisito de la lista blanca de IP.

> [!WARNING]
>
> Trata tu secreto de API y tus tokens como contraseñas. Nunca los expongas en código del lado del cliente, repositorios públicos ni archivos de log. Si sospechas que tu clave o tu secreto se vieron comprometidos, elimina la clave en la página API Management y crea una nueva.

***

## Explora la documentación

> [card] [Inicio rápido](https://docs.velafi.com/es/docs/quickstart.md)
>
> Crea tu cuenta, genera una clave de API y haz tu primera llamada a la API en minutos.

> [card] [Sandbox](https://docs.velafi.com/es/docs/sandbox.md)
>
> Prueba tu integración completa con datos simulados antes de salir a producción.

> [card] [Guía de on-ramp](https://docs.velafi.com/es/docs/guides/on-ramp.md)
>
> Instrucciones paso a paso para construir el flujo de on-ramp de fiat a cripto.

> [card] [Referencia de la API](https://docs.velafi.com/es/api-reference/overview.md)
>
> Documentación completa de los endpoints, con parámetros, cuerpos de solicitud y esquemas de respuesta.


## Related topics

- [Documentación de la API de VelaFi](https://docs.velafi.com/es/index.md)


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