Multi Contas

Parte da Classificação de Risco de Fraude

Este produto depende da capacidade Multi Contas, parte do produto Classificação de Risco de Fraude. Ela é habilitada na configuração da sua API Key durante o onboarding com a Unico.

O que este produto 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 produto 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 produto quando:

• Você precisa validar a autenticidade de um documento de identidade → consulte os produtos de integração.
• Você precisa confirmar que a pessoa que realiza a transação é o titular da conta (verificação 1:1) → consulte os produtos transacionais.
• Seu produto permite múltiplas contas por pessoa por design (por exemplo, contas pessoal e empresarial) — nesse caso, converse com seu contato na Unico: a busca pode ser segmentada para que esses tipos de conta não sejam detectados como duplicidades.

Capacidades envolvidas

Pipeline executado dentro de um único processo:

Prova de VidaMulti Contas

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.
Multi Contas	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.
• Capacidade Multi Contas habilitada na sua API Key.
• 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 Multi 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 de capability.
5. Aplique as regras de negócio — avalie os campos de 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 de capability.
5. Aplique as regras de negócio — avalie os campos de 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; as capacidades executadas são definidas pela configuração da sua API Key.
3. Consulte o resultado — chame Obter Processo para recuperar os resultados de capability.
4. Aplique as regras de negócio — avalie os campos de da resposta para aprovar, reprovar ou escalar.

API

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

Ver visão geral