Detecção de Nível de Risco de Fraude

Valida que uma pessoa real está realizando o cadastro combinando Liveness com Alerta Comportamental — sem necessidade de captura de documento ou identificador governamental.

O que este caso de uso resolve

A Detecção de Nível de Risco de Fraude resolve o desafio de validar que uma pessoa real está realizando o cadastro, sem exigir captura de documento ou verificação de identidade por meio de um identificador governamental — tudo em um único processo.

Ao combinar Liveness com Alerta Comportamental, o pipeline confirma a presença de uma pessoa real à frente da câmera e, simultaneamente, verifica se esse rosto carrega sinais de risco na rede da Unico. O resultado é uma decisão de onboarding baseada em confiança comportamental, não apenas em dados documentais.

Use este caso de uso quando:

• Sua operação sofre com fraudes em que a identidade é legítima, mas a intenção é criminosa.
• Você precisa identificar e bloquear tentativas de fraude de identidade em que usuários abrem contas com identidades sintéticas.
• Você precisa identificar e bloquear ataques de Conta Mula, em que usuários abrem múltiplas contas em diferentes instituições para lavagem de dinheiro.
• Você quer mitigar Bust-out Fraud detectando usuários que geram hiperatividade repentina na rede.
• Seu modelo de negócio exige que cada indivíduo tenha no máximo uma conta ativa por operador (ou por país).

Não use este caso de uso quando:

• Você só precisa validar a integridade estática de um documento em uma base de dados governamental → use Integração.
• Você só precisa saber se este rosto é o mesmo que concluiu o onboarding → use Validação 1:1.

Capacidades envolvidas

Pipeline executado dentro de um único processo:

Prova de VidaClassificação de risco de fraude

Capacidade	Função no fluxo
Prova de Vida (Opcional)	Confirma que a selfie pertence a uma pessoa viva, mitigando ataques de deepfake ou injeção. Garante a integridade da entrada antes da análise comportamental.
Classificação de risco de fraude	Cruza os dados da transação (rosto, código, histórico) com o histórico da rede global. Aplica modelos estatísticos para gerar o nível de risco final para aquela transação.

Pré-requisitos

• Bearer token — autenticação OAuth2 via Client Credentials. Consulte Autenticação.
• APIKEY habilitada — chave configurada para V3 com permissão de análise comportamental. Consulte Ambientes.
• Chave primária (subject.code) — o identificador que está realizando a transação: número do documento, e-mail ou número de telefone.

Maximize a precisão do Nível de Risco de Fraude

É altamente recomendado enviar metadados e contexto junto com a requisição. Isso inclui dados de cadastro (nome, data de nascimento, gênero e outras informações), email, phone e clientReference. O uso da nossa solução de Liveness também enriquece a análise com risco do dispositivo, localização e sinais comportamentais adicionais.

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 valor de flow apropriado, o identificador do usuário e o selfie como imagebase64.
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

Tratamento de Erros

Código	Descrição
20807	Imagem fora do padrão HD (mínimo 640×480).
20506	O arquivo Base64 excede o limite máximo suportado (800 KB).
20507	O campo subject.code é inválido.
20510	O campo clientReference é inválido.
10201	O cabeçalho APIKEY é inválido ou a credencial não tem permissão para a camada de Risco.