Human Token

O Human Token foi desenvolvido para cenários em que não existe vínculo com documento emitido por governo — situações em que os clientes desejam evitar compartilhar números de documentos por razões de privacidade. Sua função central é criar uma identidade única para cada rosto a partir de uma única selfie.

Isso permite:

• Detectar usuários recorrentes e evitar contas duplicadas — reconhecer se a mesma pessoa está retornando ou tentando criar múltiplas contas, garantindo reconhecimento de identidade consistente sem documentos oficiais.
• Integrar via Web, Nativo ou API — usando apenas a imagem da selfie como entrada, sem necessidade de dados adicionais de documentos.
• Combinar com outros sinais — adicionar o Human Token junto a outras capabilities conforme necessário.

O que faz

A partir da selfie capturada, o Human Token gera um identificador biométrico estável e opaco (personId) que representa de forma exclusiva aquele rosto. O usuário não declara nenhum identificador — a identidade é o resultado da chamada, não a entrada. Em cada correspondência bem-sucedida, a resposta retorna o mesmo personId, permitindo que o mesmo usuário seja reconhecido em processos futuros.

Entradas

A selfie é capturada pelo SDK ou pela Web Journey. Para integração via API headless, a imagem é enviada como imagebase64 no corpo de POST /processes/v1. Não inclua subject.code — o Human Token retorna o personId na resposta.

SDK necessário para captura de qualidade

Para garantir que a imagem enviada via API atenda aos requisitos biométricos, utilize o SDK da Unico para sua plataforma ou siga o Padrão de Captura. O Human Token não aceita imagens arbitrárias sem controle de qualidade de captura.

Respostas possíveis

idFace.result	Significado
FOUND	Identidade resolvida. personId está retornado e preenchido.

Quando nenhum personId pode ser gerado

Há um único cenário em que o Human Token não produz um personId: o rosto não pode ser identificado na imagem enviada — nenhum rosto é detectado, a qualidade da imagem é baixa demais, ou o rosto está fora do padrão de captura (inclinado, virado de lado). Isso não é um valor de result: a requisição falha com 20532 — No face detected in image. Seguir o Padrão de Captura é o que evita isso.

Exemplo de resposta

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

personId é um identificador estável e opaco — o mesmo usuário sempre resolverá para o mesmo valor. Armazene-o junto ao registro do seu usuário para reconhecer a mesma pessoa em chamadas subsequentes ao Human Token.

Disponibilidade

Superfície	Suportado
SDK (Android, iOS, Flutter)	✅
Web (iFrame, Redirect)	✅
API (headless, sem SDK)	✅