Autenticação Avançada

O que este caso de uso resolve

Detecte se uma biometria facial já está associada a outra conta ativa na base do seu operador — o princípio "One Face, One Contract". Com uma única chamada de API, cruze o rosto capturado com a sua base de cadastro e bloqueie contas duplicadas no ponto de ação.

Use este caso de uso quando:

• O usuário tenta executar uma ação (solicitar o primeiro saque, cash-out) e você quer validar se aquela biometria já pertence a outra conta ativa no seu sistema.
• Você precisa realizar a ingestão retroativa de uma base histórica de selfies para identificar duplicidades existentes (modo batch). Este é o fluxo de Importação de Base Biométrica.
• Seu modelo de negócio exige que cada indivíduo tenha no máximo uma conta ativa por operador (ou por país).
• Você quer reduzir a carga na mesa de revisão manual em vídeo, substituindo a análise humana por uma decisão automática e determinística.

Não use este caso de uso quando:

• Você precisa validar a autenticidade de um documento de identidade → consulte os casos de uso de integração.
• Você precisa confirmar que a pessoa que realiza a transação é o titular da conta (verificação 1:1) → consulte os casos de uso transacionais.
• Seu produto permite múltiplas contas por pessoa por design (por exemplo, contas pessoal e empresarial) → avalie a configuração de clientReferenceSegment com a equipe Unico antes de ativar essa regra. Este campo define o escopo de busca: a comparação 1:N é executada apenas contra registros cadastrados no mesmo segmento, de modo que segmentos distintos podem coexistir em um único operador sem gerar falsos positivos.

Capacidades envolvidas

Pipeline executado dentro de um único processo:

Prova de VidaMúltiplas contas 1:N

Capacidade	Obrigatória	Função no fluxo
Prova de Vida	Opcional para API; obrigatória para Web e Native	Verificação de vivacidade no momento da captura.
Múltiplas contas 1:N	Obrigatória	Realiza busca biométrica segmentada na base do operador, cruzando o rosto recebido com todos os registros no mesmo segmento.

Pré-requisitos

• Bearer token — consulte Autenticação.
• Credenciais de sandbox — consulte Ambientes.
• SDK ou componente Web instalado — apenas para integrações Web e SDK. Consulte SDKs e Ferramentas.
• Campo clientReference preenchido em todas as requisições — identifica o usuário de forma única no sistema do operador. Deve ser único na base do cliente, ter no máximo 256 caracteres e não conter espaços. Este campo é o identificador principal para fins de Múltiplas contas.

Implementação passo a passo

Native

Integração via SDK nativo — a captura é executada dentro do seu app usando o SDK da Unico para Android, iOS ou Flutter.

1. 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.
2. Crie um processo — chame Create Process com o valor de flow apropriado e o identificador do usuário. Use o token retornado para inicializar o SDK.
3. Inicie a captura — o SDK exibe a interface da câmera e realiza a detecção de vivacidade no dispositivo, retornando o payload capturado.
4. Consulte o resultado — chame Get Process para recuperar os resultados das capabilities.
5. Aplique as regras de negócio — avalie os campos da resposta para aprovar, reprovar ou escalar.

Android

SDK Android nativo para captura no app.

Ver visão geral

iOS

SDK iOS nativo para captura no app.

Ver visão geral

Flutter

SDK Flutter multiplataforma para captura no app.

Ver visão geral

Web

Integração via iFrame, Redirect ou Nativa — a Unico hospeda a interface de captura e você recebe o resultado via polling.

1. Crie um processo — chame Create Process com o valor de flow apropriado e o identificador do usuário. A resposta inclui uma userRedirectUrl.
2. Redirecione o usuário — envie o usuário para userRedirectUrl. A Unico renderiza a jornada de captura. Ou utilize webAppToken em apps nativos.
3. O usuário completa a jornada — após a captura, o usuário é redirecionado de volta para o seu callbackUri.
4. Consulte o resultado — chame Get Process para recuperar os resultados das capabilities.
5. Aplique as regras de negócio — avalie os campos da resposta para aprovar, reprovar ou escalar.

Web

Integração rápida via navegador, sem necessidade de instalação.

Ver visão geral

API

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.

1. 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.
2. Crie um processo — chame Criar Processo com o identificador do usuário e o selfie como imagebase64.
3. Consulte o resultado — chame Obter Processo para recuperar os resultados das capabilities.
4. Aplique as regras de negócio — avalie os campos da resposta para aprovar, reprovar ou escalar.

API

Controle total sobre o fluxo com integração back-to-back.

Ver visão geral