Saltar al contenido principal
Yuno Banking Connectivity ofrece una API unificada para crear cuentas bancarias, procesar transferencias y gestionar el onboarding de entidades en múltiples proveedores bancarios. Una sola integración te da acceso a proveedores en EE. UU., Reino Unido, Australia y la UE.

Flujo de integración

Sigue estos pasos para ir de la creación de la entidad a las transferencias de fondos:
  1. Crea una entidad: registra a una persona o un negocio con Create Entity.
  2. Haz el onboarding de la entidad: envía la documentación de KYC/KYB mediante Create Entity Onboarding.
  3. Espera la aprobación del onboarding: monitorea el estado del onboarding con Get Entity Onboarding Status o escucha los eventos de webhook.
  4. Crea una cuenta bancaria: cuando el onboarding sea exitoso, abre una cuenta con Create Account.
  5. Inicia transferencias: envía fondos con Initiate Entity Transfer.

Tipos de entidad

El campo entity_type determina la estructura de la entidad:

Tipos de onboarding

Estados del onboarding

Estados de la transferencia

Nota: Los canales de pago instantáneo (RTP) omiten el estado PROCESSING y pasan directamente de PENDING a COMPLETED o FAILED.

Canales de pago

Los canales de pago disponibles dependen de la región del proveedor. El campo payment_rail acepta solo los valores siguientes, además de BOOK (con transfer_type: BOOK) y PUSH_TO_CARD:

Identificadores de cuenta por región

Las respuestas de Create Account incluyen identificadores bancarios específicos de cada región:

Tipos de documentación

Al crear o actualizar un onboarding, el arreglo documentation acepta elementos con un campo document_type obligatorio. Completa el subobjeto con el nombre del tipo, en minúsculas (por ejemplo, bank_statement para BANK_STATEMENT):
Cada subobjeto incluye sus documentos en un arreglo files (por ejemplo, bank_statement.files, identity_document.files), excepto tax_information, que usa tax_records. Cada archivo usa codificación base64 con los campos file_name, content_type y content. Un ejemplo de elemento:

Eventos de webhook

Yuno envía notificaciones de webhook a tu endpoint configurado para los siguientes eventos. Para la configuración general de webhooks, el comportamiento de entrega y la lógica de reintentos, consulta Eventos y disparadores.

Eventos de entidad

  • banking.entity.created: entidad creada
  • banking.entity.updated: entidad actualizada
  • banking.entity.deleted: entidad eliminada

Eventos de onboarding

  • banking.onboarding.created: onboarding creado
  • banking.onboarding.pending: enviado, pendiente de revisión
  • banking.onboarding.pending_additional_documentation: se requieren más documentos
  • banking.onboarding.succeeded: onboarding aprobado
  • banking.onboarding.failed: el onboarding falló
  • banking.onboarding.declined: rechazado por el proveedor
  • banking.onboarding.cancelled: cancelado por el comercio (aún no disponible)
  • banking.onboarding.expired: el onboarding expiró

Eventos de cuenta

  • banking.account.created: cuenta creada
  • banking.account.updated: cuenta actualizada
  • banking.account.activated: cuenta activada
  • banking.account.closed: cuenta cerrada

Eventos de transferencia (salientes)

  • banking.transfer.pending: transferencia pendiente
  • banking.transfer.processing: transferencia en procesamiento
  • banking.transfer.completed: transferencia completada
  • banking.transfer.failed: la transferencia falló
  • banking.transfer.cancelled: transferencia cancelada
  • banking.transfer.reversed: transferencia revertida

Eventos de transferencia (entrantes)

  • banking.transfer.incoming.pending: transferencia entrante pendiente de liquidación
  • banking.transfer.incoming.completed: transferencia entrante liquidada
Las notificaciones de transferencias entrantes se envían a tu endpoint en {merchant_base_URL}/v1/banking/transfers. Consulta Notificaciones de webhook para ver la estructura del payload.

Códigos de error

Las respuestas de error siguen este formato: