Saltar al contenido principal
Human Token
Markdown

Con solo una foto del rostro, conviertes a tu usuario en un humano único. Simple, intuitivo y seguro.

Un humano. Un token. Siempre. Human Token crea una identidad única para cada rostro a partir de un único selfie, sin exigir un documento emitido por el gobierno. Esto es útil tanto donde ese vínculo no existe como donde tus clientes prefieren no compartir números de documento. Siempre que lo necesites, solicita una nueva verificación y compara los tokens: tokens iguales significan el mismo humano.

Esto te permite:

  • Detectar usuarios recurrentes y prevenir cuentas duplicadas: un rostro, un token. Identifica cuentas duplicadas o falsas en el registro, el inicio de sesión y la recuperación, 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 a otras capabilities según sea necesario.

Entre los escenarios más comunes están los ataques de deepfake (confirmar que hay una persona real y presente detrás de cada acción, sin CAPTCHA y sin SMS), las cuentas múltiples, el abuso de promociones y referidos, la recuperación de contraseña, la autenticación de un nuevo dispositivo y la reducción de la morosidad. Verifica el riesgo antes de la decisión, no después de la pérdida.

Qué hace​

A partir del selfie capturado, Human Token genera un identificador biométrico estable y opaco (humanToken) 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 humanToken, lo que permite reconocer al mismo usuario en procesos futuros, en cualquier dispositivo o sesión.

Privacy by Design: no se necesita ningún dato previo y la foto del rostro puede descartarse después del procesamiento: lo que queda en tu sistema es el token, no el rostro — lo que reduce de forma significativa la exposición biométrica de tu empresa y de tus clientes.

Entradas​

La única entrada es el selfie. Con los flujos API Only, tu backend lo envía como imageBase64 en el cuerpo de Crear Proceso. Con el flujo Human Token Journey flow (humantoken o humantoken+revalidation), el selfie se captura en la jornada.

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​

El resultado viene en data.humanToken: value es el identificador y state indica en qué punto está el proceso — PROCESS_STATE_FINISHED cuando el resultado está listo. Consulta Crear Proceso › Interpretar el resultado.

Cuando no se puede generar un humanToken

Hay un único escenario en el que Human Token no produce un humanToken: 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). Seguir el Estándar de Captura es lo que lo previene.

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

Integración por API​

Human Token se ejecuta en la Human API. Tu backend crea el proceso con Crear Proceso: con un flujo API Only (api+humantoken, api+liveness+humantoken o api+liveness+humantoken+revalidation), el humanToken vuelve en la misma respuesta; con el flujo Human Token Journey flow (humantoken o humantoken+revalidation), el usuario recorre la jornada y tu backend obtiene el resultado con Obtener Proceso.

Para comenzar:

  1. Configura la Autenticación — cada llamada envía tu clave de acceso en el header x-unico-accesskey.
  2. Crea el proceso con Crear Proceso y lee data.humanToken.
  3. Consulta el proceso nuevamente, cuando lo necesites, con Obtener Proceso.

Disponibilidad​

Componentes de integración requeridos
API Web