Saltar al contenido principal
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.

On-ramp fiat → cripto

Acepta moneda fiat local de un cliente y acredita al instante el equivalente en stablecoin o criptomoneda en su billetera de custodia.

Off-ramp cripto → fiat

Convierte un saldo en cripto o stablecoin y entrega los fondos fiat directamente en la cuenta bancaria de un beneficiario, en su moneda local.

Pagos globales fiat → fiat

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. 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 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.
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.
Este es un ejemplo mínimo que obtiene los datos de tu cuenta:
Consulta Autenticación para ver los pasos de firma y el requisito de la lista blanca de IP.
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

Inicio rápido

Crea tu cuenta, genera una clave de API y haz tu primera llamada a la API en minutos.

Sandbox

Prueba tu integración completa con datos simulados antes de salir a producción.

Guía de on-ramp

Instrucciones paso a paso para construir el flujo de on-ramp de fiat a cripto.

Referencia de la API

Documentación completa de los endpoints, con parámetros, cuerpos de solicitud y esquemas de respuesta.