Face Identifier

O Face Identifier 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 Face Identifier junto a outras capabilities conforme necessário.

O que faz

A partir da selfie capturada, o Face Identifier 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 jornada Web. Para integração via API headless, a imagem é enviada como imagebase64 no corpo de POST /v1/process com flow=idface. Não inclua subject.code — o Face Identifier 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 Face Identifier não aceita imagens arbitrárias sem controle de qualidade de captura.

Respostas possíveis

idFace.result	Significado
FOUND	Identidade confirmada. personId está retornado e preenchido.
NOT_FOUND	Identidade não confirmada. personId estará ausente.

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 Face Identifier.

Disponibilidade

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