Derive um person_id estável a partir de uma selfie — a identidade é o resultado da chamada, não a entrada. Nenhum identificador é declarado pelo usuário.
O que este caso de uso resolve
A Identificação Facial é indicada para cenários onde não existe um relacionamento com documento emitido pelo governo — situações em que os clientes desejam evitar a coleta de números de documento por razões de privacidade.
Sua função central é criar uma identidade única para cada rosto a partir de um único envio de selfie.
Isso permite que você:
- Detecte usuários recorrentes e evite contas duplicadas — reconheça se a mesma pessoa está retornando ou tentando criar múltiplas contas, garantindo um reconhecimento de identidade consistente sem documentos oficiais.
- Integre via Web, Nativo ou API — utilizando apenas a imagem da selfie como entrada, sem necessidade de dados de documento adicionais.
- Combine com outros sinais — adicione o IdFace junto com outras capabilities conforme necessário.
Use este caso de uso quando:
- Você deseja um ponto de entrada de cadastro completamente sem atrito, sem digitação e sem envio de documento.
- Você precisa reconhecer um usuário recorrente apenas pelo rosto, vinculando-o a um registro existente no seu sistema identificado por
person_id. - Seu cenário exige identificar um usuário sem contexto prévio, como totens, terminais ou fluxos B2B de primeiro contato com parceiros.
Se o seu cenário já possui um identificador declarado e você só precisa confirmar que o rosto pertence a esse usuário, utilize o Cadastro sem documento.
Capabilities envolvidas
Pipeline executado dentro de um único processo:
| Capability | Obrigatória | Papel no fluxo |
|---|---|---|
| Prova de Vida | Recomendada em todos os casos | Confirma que uma pessoa real está na frente da câmera no momento da captura. Âncora biométrica do processo. |
| IdFace | Obrigatória em todos os casos | Identifica a pessoa a partir da selfie em relação à base de cadastro e retorna um person_id estável e opaco. |
A Classificação de Risco de Fraude pode ser adicionada ao pipeline base quando sinais adicionais de fraude forem necessários.
Pré-requisitos
- Bearer token — consulte Autenticação.
- Credenciais de sandbox — consulte Ambientes.
- SDK ou componente Web instalado — apenas para integrações Web e SDK.
Implementação passo a passo
- Native
- Web
- API
Integração via SDK nativo — a captura é executada dentro do seu app usando o SDK da Unico para Android, iOS ou Flutter.
- Instale o SDK — adicione a dependência do SDK da Unico para a sua plataforma. Consulte o guia de configuração para Android, iOS ou Flutter.
- Crie um processo — chame Create Process com
flow=idface. Use otokenretornado para inicializar o SDK. - Inicie a captura — o SDK exibe a interface da câmera e realiza a detecção de vivacidade no dispositivo, retornando o payload capturado.
- Consulte o resultado — chame Get Process para recuperar os resultados de IdFace.
- Aplique as regras de negócio — avalie os campos de
idFace.resultpara aprovar, reprovar ou escalar.
Integração via iFrame, Redirect ou Nativa — a Unico hospeda a interface de captura e você recebe o resultado via polling.
- Crie um processo — chame Create Process com
flow=idface. A resposta inclui umauserRedirectUrl. - Redirecione o usuário — envie o usuário para
userRedirectUrl. A Unico renderiza a jornada de captura. Ou utilizewebAppTokenem apps nativos. - O usuário completa a jornada — após a captura, o usuário é redirecionado de volta para o seu
callbackUri. - Consulte o resultado — chame Get Process para recuperar os resultados de IdFace.
- Aplique as regras de negócio — avalie os campos de
idFace.resultpara aprovar, reprovar ou escalar.
Integração direta via API — capture o selfie usando o SDK da Unico ou sua própria UI seguindo o Padrão de Captura, e então envie a imagem diretamente para a API da Unico.
- Capture o selfie — use o SDK da Unico para sua plataforma, ou construa sua própria UI seguindo o Padrão de Captura, para obter uma imagem de selfie que atenda aos requisitos de liveness.
- Crie um processo — chame Criar Processo com
flow=idface, o selfie comoimagebase64. - Consulte o resultado — chame Obter Processo para recuperar os resultados de IdFace.
- Aplique as regras de negócio — avalie os campos de
idFace.resultpara aprovar, reprovar ou escalar.
