Deriva un person_id estable a partir de un selfie — la identidad es el resultado de la llamada, no el dato de entrada. El usuario no declara ningún identificador.
Qué resuelve este caso de uso
La Identificación Facial está orientada a escenarios donde no existe relación con documentos emitidos por el gobierno — situaciones en las que los clientes desean evitar la recopilación de números de documento por razones de privacidad.
Su función principal es crear una identidad única para cada rostro a partir de un único selfie.
Esto te permite:
- Detectar usuarios recurrentes y prevenir cuentas duplicadas — reconocer si la misma persona regresa o intenta crear múltiples cuentas, garantizando un reconocimiento de identidad consistente sin documentos oficiales.
- Integrar vía Web, Native o API — usando solo la imagen del selfie como entrada, sin datos de documentos adicionales.
- Combinar con otras señales — añadir IdFace junto a otras capacidades según sea necesario.
Usa este caso de uso cuando:
- Quieras un punto de entrada de registro completamente sin fricción, sin escribir ni cargar documentos.
- Necesites reconocer a un usuario recurrente solo por su rostro, vinculándolo a un registro existente en tu sistema identificado por
person_id. - Tu escenario requiera identificar a un usuario sin contexto previo, como en quioscos, terminales o flujos de primer contacto con socios B2B.
Si tu escenario ya cuenta con un identificador declarado y solo necesitas confirmar que el rostro pertenece a ese usuario, usa Registro sin documentos en su lugar.
Capacidades involucradas
Pipeline ejecutado dentro de un único proceso:
| Capacidad | Requerida | Función en el flujo |
|---|---|---|
| Detección de Vida | Recomendada en todos los casos | Confirma que una persona real está frente a la cámara en el momento de la captura. Ancla biométrica del proceso. |
| IdFace | Requerida en todos los casos | Identifica a la persona a partir del selfie contra la base de enrolamiento y devuelve un person_id opaco y estable. |
Clasificación de Riesgo de Fraude puede agregarse al pipeline base cuando se necesitan señales adicionales de fraude.
Prerrequisitos
- Bearer token — consulta Autenticación.
- Credenciales de sandbox — consulta Entornos.
- SDK o componente Web instalado — solo para integraciones Web y SDK.
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
flow=idface. 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 IdFace.
- Aplica las reglas de negocio — evalúa
idFace.resultpara 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
flow=idface. 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 IdFace.
- Aplica las reglas de negocio — evalúa
idFace.resultpara 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
flow=idface, el selfie comoimagebase64. - Consulta el resultado — llama a Obtener Proceso para recuperar los resultados de IdFace.
- Aplica las reglas de negocio — evalúa
idFace.resultpara aprobar, rechazar o escalar.
