Human Token

Human Token está diseñado para escenarios en los que no existe una relación con documentos emitidos por el gobierno — situaciones en las que los clientes desean evitar compartir 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 — reconoce 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 — utilizando únicamente la imagen del selfie como entrada, sin datos de documento adicionales requeridos.
• Combinar con otras señales — agrega Human Token junto con otras capacidades según sea necesario.

Qué hace

A partir del selfie capturado, Human Token genera un identificador biométrico estable y opaco (personId) que representa de forma única ese rostro. El usuario no declara ningún identificador — la identidad es el resultado de la llamada, no el dato de entrada. En cada coincidencia exitosa, la respuesta devuelve el mismo personId, lo que permite reconocer al mismo usuario en procesos futuros.

Entradas

El selfie es capturado por el SDK o el Web Journey. Para integración headless vía API, la imagen se envía como imagebase64 en el cuerpo de POST /processes/v1. No incluyas subject.code — Human Token devuelve el personId en la respuesta.

SDK requerido para captura de calidad

Para garantizar que la imagen enviada vía API cumpla con los requisitos biométricos, usa el SDK de Unico para tu plataforma o sigue el Estándar de Captura. Human Token no acepta imágenes arbitrarias sin control de calidad de captura.

Posibles respuestas

idFace.result	Significado
FOUND	Identidad resuelta. personId se devuelve y está disponible.

Cuando no se puede generar un personId

Existe un único escenario en el que Human Token no produce un personId: el rostro no puede ser identificado en la imagen enviada — no se detecta ningún rostro, la calidad de la imagen es demasiado baja o el rostro está fuera del estándar de captura (inclinado, girado hacia el costado). Esto no es un valor de result: la solicitud falla con 20532 — No face detected in image. Seguir el Estándar de Captura es lo que lo previene.

Ejemplo de respuesta

{
  "id": "1c1fc38b-7e98-4f9a-a04d-7a4a8b29d2c1",
  "status": 3,
  "idFace": {
    "personId": "a1b2c3d4e5f67890a1b2c3d4e5f67890a1b2c3d4e5f67890a1b2c3d4e5f67890",
    "result": "FOUND"
  }
}

personId es un identificador estable y opaco — el mismo usuario siempre resolverá al mismo valor. Almacénalo junto al registro del usuario para reconocer a la misma persona en llamadas posteriores a Human Token.

Disponibilidad

Superficie	Compatible
SDK (Android, iOS, Flutter)	✅
Web (iFrame, Redirect)	✅
API (headless, sin SDK)	✅