Integra cuentas en stablecoins en tu producto
Producto / Finance API
Cuentas virtuales, cuentas en stablecoins, pagos salientes y transferencias de stablecoins: una sola API para las cuatro.
Venly coordina la configuración de los proveedores que necesita cada flujo.
Hablemos
Ver la referencia de la API
El problema
Cuatro proveedores para un solo producto financiero
4 contratos
Acuerdos separados para cuentas, monederos, cuentas virtuales y KYC.
4 calendarios
Cada integración tiene su propia API, su sandbox y su fecha de salida a producción.
4 revisiones
Revisiones de cumplimiento separadas por proveedor, que multiplican la carga legal.
El modelo de cuentas
Una arquitectura clara y modular
Los clientes (parties) son identidades. Las cuentas son contenedores. Los monederos guardan stablecoins, las cuentas receptoras reciben USD o EUR, y las sesiones de pago y las transferencias mueven el dinero. Cada capa se apoya en la anterior.
Cliente (Party)
Capa de identidad
Persona física
→ verificación KYC
Organización
→ verificación KYB
Cuenta
Contenedor
Monedero
Stablecoins en las redes habilitadas para tu cuenta
Cuenta receptora
Entrada de USD o EUR; conversión a stablecoins compatibles
Transferencias
Pagos y transferencias cripto
Seis capacidades en una API
Cada fila es un objeto de la API, el papel que tiene en la cuenta de María y la guía que lo documenta.
Objeto
En la cuenta de María
Detalles
Guía
Gestión de clientes (Party)
Party
Crea y gestiona personas físicas y organizaciones con verificación de identidad integrada.
María es un cliente persona física. Su verificación empieza en VERIFICATION_PENDING.
Guía de integración (en inglés)
- Personas físicas: nombre, apellidos, dirección → verificación KYC
- Organizaciones: razón social, identificación fiscal → verificación KYB
- Estado de verificación: VERIFICATION_PENDING, VERIFIED o REJECTED
- Mapeo de ID externo con tu propia base de usuarios
Gestión de cuentas
Account
Crea cuentas que contienen monederos, cuentas receptoras e instrumentos de pago.
La cuenta de María lleva tu propio identificador para ella: user-123.
Guía de integración (en inglés)
- Crea una cuenta con un cliente existente o nuevo y el modelo de monedero configurado
- Asociaciones por rol (ACCOUNT_HOLDER)
- Varios clientes por cuenta y varias cuentas por cliente
- Seguimiento del ciclo de vida y del estado de la cuenta
Monederos cripto
Wallet
Crea o conecta monederos según el modelo de custodia de tu cuenta.
Su saldo en USDC, en Base.
Monederos y saldos (en inglés)
- Los monederos gestionados pueden crearse al dar de alta la cuenta
- La disponibilidad de redes y activos depende de la configuración de la cuenta
- Consulta de saldo en tiempo real
- Activo principal: USDC
Cuentas receptoras (IBAN virtuales)
Receiving account
Ofrece a tus clientes datos para recibir USD o EUR. Los fondos entrantes se convierten en la stablecoin configurada.
Sus datos para recibir USD, a los que se llega por transferencia ACH.
Cuentas bancarias virtuales (en inglés)
- USD según las instrucciones habilitadas para la cuenta; EUR mediante SEPA
- Los datos de recepción varían según la vía bancaria
- El dinero recibido se convierte en la stablecoin compatible configurada
- Los pagos en GBP por Faster Payments están disponibles; los datos para recibir GBP están en incorporación
Pagos fiat a cripto
Payment session
Crea una sesión de pago bancario alojada para un flujo de ingreso habilitado.
No se usa en la historia de María: su dinero llega por transferencia ACH.
Crear una sesión de pago (en inglés)
- Indica el importe, la divisa y la stablecoin de destino
- Obtén un paymentUrl alojado para el cliente
- La banca abierta en EUR requiere una cuenta receptora en EUR activa y compatible; sigue el estado mediante callbacks
Transferencias cripto
Transfer
Transfiere stablecoins compatibles entre cuentas aptas de tu plataforma.
50 USDC de María a Carlos, primero PENDING y después COMPLETED.
- POST /accounts/{senderAccountId}/transfers/crypto
- Se aplica la configuración de redes y activos habilitados
- Sigue los estados PENDING, COMPLETED o FAILED
- Idempotencia mediante el campo idempotencyKey del cuerpo
El ciclo de vida de la cuenta
Sigue la cuenta de María desde el alta hasta la transferencia.
Cada paso muestra la pantalla de María en tu app junto a la vista con la que trabaja tu equipo. La historia sigue una cuenta receptora en USD que convierte a USDC.
Alta
Crea la cuenta del cliente
Crea la cuenta y su asociación con el cliente. La verificación y los requisitos del proveedor tienen estados propios.
Datos de recepción
Solicita datos para recibir USD
María obtiene datos para recibir USD según las instrucciones habilitadas para la cuenta, sujetos a los requisitos de la cuenta y del proveedor. Para EUR se usa SEPA.
Datos para recibir USD y EUR en Cuentas virtuales
¿Recibes en EUR? IBAN virtual EUR a USDC
Ingreso
Llega un pago en USD y se convierte
Una transferencia ACH llega a los datos de recepción de María. Los USD recibidos se convierten en USDC, la stablecoin configurada para esta cuenta. Sigue el estado del pago y de la conversión.
Saldo
Los saldos se mantienen en stablecoins compatibles
El saldo de María se mantiene en USDC, el activo principal, en la red habilitada para su cuenta. Tu equipo consulta el mismo saldo mediante la API.
Transferencia
Solicita una transferencia
María envía 50 USDC a Carlos, otra cuenta apta de tu plataforma. La petición es idempotente gracias a su idempotencyKey.
Reintentos seguros con claves de idempotencia
Transferencia
Sigue el estado hasta el resultado
Una transferencia informa PENDING, COMPLETED o FAILED. Tu app puede mostrar a María el mismo resultado que tu equipo lee en la API.
Estas operaciones muestran el flujo de la cuenta. Completa por separado la verificación, la configuración del proveedor y la financiación; los activos y las rutas disponibles dependen de la configuración.
Las peticiones, los campos y los estados de esta historia están documentados en la referencia de la API.
La guía de integración, paso a paso
Las plataformas integran cuentas como la de María en productos financieros, nóminas y plataformas de compraventa.
Más allá de un flujo
Quién construye con estas cuentas
Productos financieros
Cómo lanza un neobanco estas cuentas, versión a versión
Plataformas de nóminas
Pagar a destinatarios en otros países
Plataformas de compraventa
Pagos a vendedores a una cuenta bancaria o a una billetera
Los saldos propios de tu empresa funcionan con otro producto.
Convertir los saldos propios de tu empresa con Fundflow
Añadir dinero
Entrada de dinero
Varios métodos de entrada de fondos
Según configuración
En incorporación
Transferencia bancaria
Los clientes envían USD o EUR siguiendo sus instrucciones de recepción habilitadas. Los fondos se convierten en la stablecoin configurada.
Ideal para: Importes altos, ingresos recurrentes y clientes empresa.
Pagos desde cuenta bancaria
En un flujo en EUR habilitado, genera una sesión de pago bancario alojada. El cliente autoriza el pago en su banco; sigue el estado del pago y de la conversión.
Ideal para: Clientes que prefieren autorizar un pago bancario en un flujo alojado.
Tarjetas y monederos digitales
Permite que los usuarios finales compren stablecoins con tarjeta, Apple Pay o Google Pay dentro de tu app. En incorporación; consulta la disponibilidad con Venly.
Ideal para: Usuarios de consumo y microingresos.
Para tus desarrolladores
Preparada para producción
La transferencia de María a Carlos de la historia de arriba, tal como la envía tu backend.
Petición de transferencia
La petición es idempotente mediante su idempotencyKey.
- API REST con especificación OpenAPI
- Autenticación OAuth2 client credentials
- Peticiones POST idempotentes (campo idempotencyKey)
- Bloqueo optimista en las actualizaciones (concurrencia por versión)
- Endpoints de listado paginados con filtrado y ordenación
- Callbacks en tiempo real en los pagos (callbackUrl)
- Webhooks a un endpoint HTTPS registrado para pay-ins, transferencias, pay-outs, resultados de verificación y cuentas bancarias virtuales
- Mapeo de ID externo para recursos compatibles
- Dos entornos: el sandbox y producción
- Códigos de error completos
- API idempotente y con registro de auditoría
SDK, componentes React y herramientas MCP
Preguntas sobre la Finance API
¿Qué monedas pueden recibir los clientes?
USD según las instrucciones habilitadas para la cuenta y EUR mediante SEPA. Los fondos entrantes se convierten en la stablecoin compatible configurada.
¿Qué stablecoin mantienen las cuentas?
USDC es el activo principal. La disponibilidad de redes y activos depende de la configuración de la cuenta.
¿Qué estados devuelve una transferencia?
PENDING, COMPLETED o FAILED. Las solicitudes de transferencia son idempotentes mediante el campo idempotencyKey del cuerpo.
¿Cómo se autentica la API?
Con credenciales de cliente OAuth2. Hay dos entornos: el sandbox y producción.
Construye tu producto financiero
Empieza por la documentación y define con nosotros los requisitos de cuentas, verificación y pagos.
Hablemos
Leer la documentación
Aprende los conceptos
Todos los artículos (en inglés)
Aprende los conceptos
IBAN virtual, explicado (en inglés)
Cómo funcionan las cuentas virtuales con nombre como primitiva de liquidación para plataformas.
IBAN virtual, explicado (en inglés)
Liquidación multirraíl (en inglés)
Cómo se enruta cada pago por la vía que necesita.
Liquidación multirraíl (en inglés)
Quién puede marcar a María como verificada
Abrir una cuenta no completa el onboarding. La cuenta empieza con kycStatus VERIFICATION_PENDING y tu plataforma no puede fijarla en VERIFIED. La verificación y los requisitos del proveedor tienen estados propios.
Certificación SOC 2 Type 2. Nuestras propias licencias están en curso y hoy los flujos se ejecutan a través de rieles de socios con licencia.