Integración ONP

Visión general

La Onboarding Platform (ONP) es el módulo de la Suite Guardline responsable de conducir recorridos de onboarding de clientes. La integración con la ONP permite que el sistema de la institución inicie recorridos de forma programática, haga seguimiento del progreso y reciba el resultado final con puntaje y decisión.

Flujo de integración

El flujo típico de integración con la ONP sigue estos pasos:

1. El sistema de la institución solicita la creación de un onboarding, informando los datos iniciales del cliente.
2. La ONP devuelve un identificador y una URL de recorrido para el cliente.
3. El cliente realiza el recorrido (captura de documentos, biometría, ingreso de datos).
4. La ONP invoca a los proveedores de verificación configurados para el recorrido (verificación documental, prueba de vida (liveness), facematch, antecedentes, entre otros).
5. Con los resultados de las verificaciones, el motor de scoring calcula el puntaje y aplica las reglas definidas por la institución.
6. La ONP notifica al sistema de la institución sobre la conclusión vía webhook.
7. El sistema de la institución consulta el resultado (estado, puntaje, decisión).

Tipos de recorrido

La ONP admite tres tipos de recorrido de onboarding:

• kyc: verificación de identidad para personas físicas (adultos). Incluye recolección de datos personales, captura de documentos, biometría facial y análisis de riesgo.
• kyb: verificación empresarial para personas jurídicas. Incluye validación societaria, identificación de beneficiarios finales y verificación de representantes legales.
• kyc_minor: verificación para menores de edad (14 a 17 años) con representante legal. El menor completa el recorrido primero y, a continuación, el representante legal recibe un enlace por SMS o WhatsApp para completar una verificación simplificada. La decisión final considera los datos de ambos.

Verificaciones y proveedores

La ONP invoca a los proveedores de verificación de acuerdo con la configuración del recorrido. Cada recorrido puede incluir combinaciones diferentes de verificaciones (biometría facial, verificación documental, prueba de vida, facematch, device fingerprint, antecedentes, OCR) según la política de la institución.

Cuando una verificación falla o el proveedor no está disponible, la plataforma aplica un mecanismo de fallback (contingencia) con tres niveles:

• Reintento automático: la solicitud se reenvía al mismo proveedor después de un intervalo configurable.
• Proveedor alternativo: si el reintento falla, la verificación se redirige a un proveedor equivalente preconfigurado.
• Aprobación condicional: si ningún proveedor responde, el onboarding puede ser derivado a la mesa de análisis con estado condicional, evitando el bloqueo del flujo.

Más detalles sobre la arquitectura de conectores se encuentran en la página de proveedores y conectores.

Notificaciones

La institución recibe notificaciones vía webhook sobre los principales eventos del ciclo de vida de un onboarding: inicio del recorrido, conclusión de pasos, resultado de verificaciones, decisión final y expiración. La configuración de qué eventos recibir se realiza durante el setup de la integración.

Todas las notificaciones incluyen firma HMAC para la validación de autenticidad, como se describe en los conceptos de integración.