Saltar al contenido principal
POST
Realiza el onboarding de una entidad existente con un proveedor de Banking Connectivity.

Tipos de onboarding

  • ONE_STEP: Envía de una sola vez toda la información, las declaraciones de cumplimiento, la evaluación de riesgo y los documentos. El proveedor lo procesa de inmediato.
  • PREVIOUSLY_ONBOARDED: Genera un ID de onboarding interno de Yuno sin contactar al proveedor. Úsalo cuando la entidad ya pasó por el onboarding de forma externa.
Para ONE_STEP, incluye compliance_declaration, risk_assessment, source_of_funds y documentation. Consulta Tipos de documentación para ver la lista completa de tipos de documento admitidos. Monitorea el progreso mediante Obtener el estado del onboarding de una entidad o eventos de webhook. Consulta Estados del onboarding para ver el ciclo de vida completo de los estados.

Autorizaciones

public-api-key
string
header
requerido
private-secret-key
string
header
requerido

Encabezados

x-idempotency-key
string
requerido

Identificador único que se usa en los encabezados HTTP para asegurar que una solicitud se procese una sola vez, aunque se reintente por problemas de red o tiempos de espera agotados. Consulta autenticación para ver los detalles (UUID).

Parámetros de ruta

entity_id
string
requerido

El id de la entidad, que se obtiene de Create Entity.

Cuerpo

application/json
account_id
string
requerido

El identificador único de la cuenta de Yuno del comercio (UUID, 36 caracteres).

Ejemplo:

"550e8400-e29b-41d4-a716-446655440000"

onboarding_type
enum<string>
requerido

El tipo de flujo de onboarding. ONE_STEP envía toda la información de una vez para que la procese el proveedor. PREVIOUSLY_ONBOARDED genera un ID interno de Yuno sin contactar al proveedor.

Opciones disponibles:
ONE_STEP,
PREVIOUSLY_ONBOARDED
Ejemplo:

"ONE_STEP"

connection_id
string

El identificador de la conexión con el proveedor de Banking Connectivity (UUID, 36 caracteres).

Ejemplo:

"bb0e8400-e29b-41d4-a716-446655440001"

compliance_declaration
object

Acuerdos legales aceptados por la entidad. Obligatorio para el onboarding ONE_STEP.

risk_assessment
object

Resultados de verificación de cumplimiento preexistentes que aporta el comercio.

source_of_funds
object

Información AML/KYC sobre el origen de los fondos.

documentation
object[]

Documentos KYC/KYB. Cada elemento tiene un document_type y un subobjeto con ese nombre (identity_document, proof_of_address, bank_statement, tax_information, biometric_verification, employment_information, business_document, financial_document). Las fechas usan YYYY-MM-DD. Los archivos deben ser image/jpeg, image/png, application/pdf o image/tiff.

Respuesta