Multi Cuentas

Markdown

Parte de Clasificación de Riesgo de Fraude

Este producto se basa en la capacidad Multi Cuentas, parte del producto Clasificación de Riesgo de Fraude. Se habilita en la configuración de tu API Key durante el onboarding con Unico.

Qué resuelve este producto

Detecta si una biometría facial ya está asociada a otra cuenta activa en tu base de operador — el principio "One Face, One Contract". Con una sola llamada a la API, cruza la cara capturada contra tu base de registro y bloquea cuentas duplicadas en el punto de acción.

Utiliza este producto cuando:

• El usuario intenta ejecutar una acción (solicitar el primer retiro, cash-out) y quieres validar si esa biometría ya pertenece a otra cuenta activa en tu sistema.
• Necesitas realizar una ingesta retroactiva de una base histórica de selfies para identificar duplicados existentes (modo batch). Este es el flujo de Importación de Base Biométrica.
• Tu modelo de negocio requiere que cada persona tenga como máximo una cuenta activa por operador (o por país).
• Quieres reducir la carga del escritorio de revisión manual de video, reemplazando el análisis humano por una decisión automática y determinista.

No utilices este producto cuando:

• Necesitas validar la autenticidad de un documento de identidad → consulta los productos de onboarding.
• Necesitas confirmar que la persona que realiza la transacción es el titular de la cuenta (verificación 1:1) → consulta los productos de autenticación step-up.
• Tu producto permite múltiples cuentas por persona por diseño (p. ej., cuentas personal y empresarial) — en ese caso, coméntalo con tu contacto en Unico: la búsqueda puede segmentarse para que esos tipos de cuenta no se detecten como duplicados.

Capacidades involucradas

Pipeline ejecutado dentro de un único proceso:

Detección de VidaMúltiples cuentas

Capacidad	Requerida	Rol en el flujo
Detección de Vida	Opcional para API; requerida para Web y Nativo	Verificación de vida en el momento de la captura.
Múltiples cuentas	Requerida	Realiza búsqueda biométrica segmentada en la base del operador, cruzando la cara recibida contra todos los registros del mismo segmento.

Requisitos previos

• Bearer token — consulta Autenticación.
• Credenciales de sandbox — consulta Entornos.
• SDK o componente Web instalado — solo para integraciones Web y SDK. Consulta SDKs y Herramientas.
• Capacidad Multi Cuentas habilitada en tu API Key.
• Campo clientReference completado en todas las solicitudes — identifica de forma única al usuario en el sistema del operador. Debe ser único en la base de datos del cliente, tener un máximo de 256 caracteres y no contener espacios. Este campo es el identificador principal para fines de Múltiples cuentas.

Implementación paso a paso

Native

Integración mediante SDK nativo — la captura se ejecuta dentro de tu aplicación usando el SDK de Unico para Android, iOS o Flutter.

1. 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.
2. Crea un proceso — llama a Create Process con el valor de flow adecuado y el identificador del usuario. La respuesta incluye el webAppToken.
3. Abre el recorrido — abre el SDK con el webAppToken. El SDK ejecuta el recorrido en tu aplicación y llama a onSuccess con el processId cuando el usuario termina.
4. Consulta el resultado — llama a Get Process para obtener los resultados de las capabilities.
5. Aplica las reglas de negocio — evalúa la respuesta para aprobar, rechazar o escalar.

Android

SDK nativo de Android para captura en la aplicación.

Ver descripción general

iOS

SDK nativo de iOS para captura en la aplicación.

Ver descripción general

Flutter

SDK de Flutter multiplataforma para captura en la aplicación.

Ver descripción general

Web

Integración en el navegador — Unico aloja el recorrido, y tú lo abres con el SDK de Jornadas o redirigiendo al usuario.

1. Crea un proceso — llama a Create Process con el valor de flow adecuado y el identificador del usuario. La respuesta incluye el id del proceso, el token y la userRedirectUrl.
2. Abre el recorrido — ábrelo dentro de tu página con el SDK de Jornadas, pasando el id del proceso (como transactionId) y el token. Esta es la opción recomendada. Si el recorrido puede ejecutarse fuera de tu página, usa Acceso directo en su lugar: envía al usuario a userRedirectUrl y define callbackUri en Create Process para que Unico sepa a dónde devolverlo.
3. El usuario completa el recorrido — el SDK de Jornadas llama a onFinish. Con Acceso directo, Unico envía al usuario de vuelta a tu callbackUri.
4. Consulta el resultado — llama a Get Process para obtener los resultados de las capabilities.
5. Aplica las reglas de negocio — evalúa la respuesta para aprobar, rechazar o escalar.

Web

SDK de Jornadas o Acceso directo, en el navegador.

Ver descripción general

API

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 Unico API.

1. 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.
2. Crea un proceso — llama a Crear Proceso con el identificador del usuario y el selfie como imagebase64; las capacidades ejecutadas las define la configuración de tu API Key.
3. Consulta el resultado — llama a Obtener Proceso para recuperar los resultados de las capacidades.
4. Aplica las reglas de negocio — evalúa la respuesta para aprobar, rechazar o escalar.

API

Control total sobre el flujo con integración back-to-back.

Ver descripción general