Flujo de integración
Sigue estos pasos para ir de la creación de la entidad a las transferencias de fondos:- Crea una entidad: registra a una persona o un negocio con Create Entity.
- Haz el onboarding de la entidad: envía la documentación de KYC/KYB mediante Create Entity Onboarding.
- Espera la aprobación del onboarding: monitorea el estado del onboarding con Get Entity Onboarding Status o escucha los eventos de webhook.
- Crea una cuenta bancaria: cuando el onboarding sea exitoso, abre una cuenta con Create Account.
- Inicia transferencias: envía fondos con Initiate Entity Transfer.
Tipos de entidad
El campoentity_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 campopayment_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 arreglodocumentation 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):
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 creadabanking.entity.updated: entidad actualizadabanking.entity.deleted: entidad eliminada
Eventos de onboarding
banking.onboarding.created: onboarding creadobanking.onboarding.pending: enviado, pendiente de revisiónbanking.onboarding.pending_additional_documentation: se requieren más documentosbanking.onboarding.succeeded: onboarding aprobadobanking.onboarding.failed: el onboarding fallóbanking.onboarding.declined: rechazado por el proveedorbanking.onboarding.cancelled: cancelado por el comercio (aún no disponible)banking.onboarding.expired: el onboarding expiró
Eventos de cuenta
banking.account.created: cuenta creadabanking.account.updated: cuenta actualizadabanking.account.activated: cuenta activadabanking.account.closed: cuenta cerrada
Eventos de transferencia (salientes)
banking.transfer.pending: transferencia pendientebanking.transfer.processing: transferencia en procesamientobanking.transfer.completed: transferencia completadabanking.transfer.failed: la transferencia fallóbanking.transfer.cancelled: transferencia canceladabanking.transfer.reversed: transferencia revertida
Eventos de transferencia (entrantes)
banking.transfer.incoming.pending: transferencia entrante pendiente de liquidaciónbanking.transfer.incoming.completed: transferencia entrante liquidada
{merchant_base_URL}/v1/banking/transfers. Consulta Notificaciones de webhook para ver la estructura del payload.