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.

Markdown

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

• Você só precisa validar a integridade estática de um documento em uma base de dados governamental → use Onboarding.
• 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 Criar Processo com o valor de flow apropriado e o identificador do usuário. A resposta inclui o webAppToken.
3. Abra a jornada — abra o SDK com o webAppToken. O SDK executa a jornada no seu app e chama onSuccess com o processId quando o usuário termina.
4. Consulte o resultado — chame Obter Processo 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 no navegador — a Unico hospeda a jornada, e você a abre com o SDK de Jornadas ou redirecionando o usuário.

1. Crie um processo — chame Criar Processo com o valor de flow apropriado e o identificador do usuário. A resposta inclui o id do processo, o token e a userRedirectUrl.
2. Abra a jornada — abra-a dentro da sua página com o SDK de Jornadas, passando o id do processo (como transactionId) e o token. Esta é a opção recomendada. Se a jornada puder ser executada fora da sua página, use o Acesso direto: envie o usuário para userRedirectUrl e defina o callbackUri no Criar Processo para que a Unico saiba para onde devolvê-lo.
3. O usuário completa a jornada — o SDK de Jornadas chama onFinish. Com o Acesso direto, a Unico envia o usuário de volta para o seu callbackUri.
4. Consulte o resultado — chame Obter Processo 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

SDK de Jornadas ou Acesso direto, no navegador.

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 Unico API.

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

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.