Valida que una persona real esté realizando el registro combinando Detección de Vida con Alerta de Comportamiento, sin necesidad de captura de documentos ni identificador gubernamental.
Qué resuelve este caso de uso
La Detección de Nivel de Riesgo de Fraude aborda el desafío de validar que una persona real esté realizando el registro, sin requerir captura de documentos ni verificación de identidad mediante un identificador gubernamental, todo dentro de un único proceso.
Al combinar Detección de Vida con Alerta de Comportamiento, el pipeline confirma la presencia de una persona real frente a la cámara y, simultáneamente, verifica si ese rostro lleva señales de riesgo en la red de Unico. El resultado es una decisión de registro basada en confianza conductual, no solo en datos documentales.
Utiliza este caso de uso cuando:
- Tu operación sufre fraude donde la identidad es legítima pero la intención es criminal.
- Necesitas identificar y bloquear intentos de fraude de identidad donde los usuarios abren cuentas con identidades sintéticas.
- Necesitas identificar y bloquear ataques de Cuenta Mula, donde los usuarios abren múltiples cuentas en diferentes instituciones para lavar dinero.
- Quieres mitigar el Bust-out Fraud detectando usuarios que generan hiperactividad repentina en la red.
- Tu modelo de negocio requiere que cada persona tenga como máximo una cuenta activa por operador (o por país).
No utilices este caso de uso cuando:
- Solo necesitas validar la integridad estática de un documento contra una base de datos gubernamental → usa Registro.
- Solo necesitas saber si este rostro es el mismo que completó el onboarding → usa Validación (1:1).
Capacidades involucradas
Pipeline ejecutado dentro de un único proceso:
| Capacidad | Rol en el flujo |
|---|---|
| Detección de Vida (Opcional) | Confirma que el selfie pertenece a una persona viva, mitigando ataques de deepfake o inyección. Garantiza la integridad de la entrada antes del análisis de comportamiento. |
| Clasificación de Riesgo de Fraude | Cruza los datos de la transacción (rostro, código, historial) con el historial de la red global. Aplica modelos estadísticos para generar el nivel de riesgo final de esa transacción. |
Requisitos previos
- Bearer token — autenticación OAuth2 mediante Client Credentials. Consulta Autenticación.
- APIKEY habilitada — clave configurada para V3 con permiso de análisis de comportamiento. Consulta Entornos.
- Clave primaria (
subject.code) — el identificador que realiza la transacción: número de documento, correo electrónico o número de teléfono.
Se recomienda ampliamente enviar metadatos y contexto junto con la solicitud. Esto incluye datos de registro (nombre, fecha de nacimiento, género y otra información), email, phone y clientReference. Usar nuestra solución Detección de Vida también enriquece el análisis con riesgo del dispositivo, ubicación y señales de comportamiento adicionales.
Implementación paso a paso
- Native
- Web
- API
Integración mediante SDK nativo — la captura se ejecuta dentro de tu aplicación usando el SDK de Unico para Android, iOS o Flutter.
- Instala el SDK — añade la dependencia del SDK de Unico para tu plataforma. Consulta la guía de configuración para Android, iOS o Flutter.
- Crea un proceso — llama a Create Process con el valor de
flowadecuado y el identificador del usuario. Usa eltokendevuelto para inicializar el SDK. - Inicia la captura — el SDK renderiza la interfaz de cámara y realiza la detección de vida en el dispositivo, devolviendo el payload capturado.
- Consulta el resultado — llama a Get Process para obtener los resultados de las capabilities.
- Aplica las reglas de negocio — evalúa la respuesta para aprobar, rechazar o escalar.
Integración mediante iFrame, Redirección o Nativa — Unico aloja la interfaz de captura y tú recibes el resultado por polling.
- Crea un proceso — llama a Create Process con el valor de
flowadecuado y el identificador del usuario. La respuesta incluye unauserRedirectUrl. - Redirige al usuario — envía al usuario a
userRedirectUrl. Unico renderiza el recorrido de captura. OwebAppTokenen aplicaciones nativas. - El usuario completa el recorrido — tras la captura, el usuario es redirigido de vuelta a tu
callbackUri. - Consulta el resultado — llama a Get Process para obtener los resultados de las capabilities.
- Aplica las reglas de negocio — evalúa la respuesta para aprobar, rechazar o escalar.
Integración directa con la API — captura el selfie usando el SDK de Unico o tu propia interfaz siguiendo el Estándar de Captura, luego envía la imagen directamente a la API de Unico.
- Captura el selfie — usa el SDK de Unico para tu plataforma, o crea tu propia interfaz siguiendo el Estándar de Captura, para obtener una imagen de selfie que cumpla con los requisitos de liveness.
- Crea un proceso — llama a Crear Proceso con el valor de
flowadecuado, el identificador del usuario y el selfie comoimagebase64. - Consulta el resultado — llama a Obtener Proceso para recuperar los resultados de las capacidades.
- Aplica las reglas de negocio — evalúa la respuesta para aprobar, rechazar o escalar.
Manejo de Errores
| Código | Descripción |
|---|---|
20807 | Imagen fuera del estándar HD (mínimo 640×480). |
20506 | El archivo Base64 supera el límite máximo admitido (800 KB). |
20507 | El campo subject.code no es válido. |
20510 | El campo clientReference no es válido. |
10201 | El encabezado APIKEY no es válido o la credencial no tiene permiso para la capa de Riesgo. |