Pular para o conteúdo principal

Multi Contas

Markdown

Multi Contas pergunta "esse rosto já existe em outro lugar na base do operador?".

Parte da Classificação de Risco de Fraude

Multi Contas é uma capacidade do produto Classificação de Risco de Fraude. Ela não é contratada separadamente: é habilitada na configuração da sua API Key durante o onboarding com a Unico.

O que faz​

Realiza uma busca biométrica 1:N segmentada na base do operador, cruzando o rosto recebido com todos os registros associados ao mesmo clientReferenceSegment. Detecta se a biometria já está vinculada a um clientReference diferente — indicando que a mesma pessoa criou, ou está tentando criar, múltiplas contas com o mesmo operador.

Entradas​

  • A selfie do usuário — em integrações via API você a envia como imageBase64 (PNG, JPEG ou WebP; mínimo 640×480; máximo 800 KB); em integrações Web a captura é realizada pela Unico.
  • clientReference (subject.clientReference na API) — obrigatório. Identificador único do usuário no sistema do operador: único na sua base, máximo de 256 caracteres, sem espaços.

Respostas possíveis​

RespostaSignificado
YESMulti-conta detectado. A biometria facial já está vinculada a um clientReference diferente dentro do mesmo segmento.
NOMulti-conta não detectado. A pessoa foi identificada e o rosto não está vinculado a nenhum outro clientReference dentro do mesmo segmento.
INCONCLUSIVEA avaliação não chegou a uma conclusão — por exemplo, a pessoa não pôde ser identificada ou a selfie não passou na Prova de Vida. Isso não significa que não exista duplicidade.

Esta tabela representa a resposta individual da capacidade.

INCONCLUSIVE não é uma aprovação

Um resultado INCONCLUSIVE significa que a avaliação não conseguiu chegar a uma conclusão. Ele não confirma que a pessoa não tem outras contas — trate-o de acordo com a sua política de risco.

Disponibilidade​

Componentes de integração necessários
API Web or SDK

Em todas as superfícies, a capacidade exige o clientReference do usuário na requisição e a habilitação na sua API Key.

Valores de enum da API

Na resposta do contrato Web & Native, authenticationInfo.accountFarmingResult informa a avaliação de multi-conta (account farming) quando a capacidade está habilitada para o cliente:

  • TRUST_RESULT_YES: foram encontradas outras contas para a mesma pessoa.
  • TRUST_RESULT_NO: a pessoa foi identificada e nenhuma outra conta foi encontrada.
  • TRUST_RESULT_INCONCLUSIVE: a avaliação não conseguiu chegar a uma conclusão, por exemplo porque a pessoa não pôde ser identificada ou a selfie não passou na verificação de Prova de Vida. Isso não é uma aprovação e não significa que não exista duplicidade. Trate-o de acordo com a sua política de risco.
  • TRUST_RESULT_UNSPECIFIED: nenhuma avaliação foi realizada para este processo, por exemplo quando o processo terminou antes da etapa de autenticação.

É um campo dedicado — ele não é combinado com authenticationInfo.identityFraudstersResult, que corresponde a uma avaliação diferente da Classificação de Risco de Fraude.

Integração via API: Prova de Vida

Em integrações via API, a Prova de Vida é opcional. Se você enviar imagens sem uma verificação de prova de vida, a busca 1:N é executada sobre uma captura não verificada (por exemplo, uma foto de uma foto) e o resultado herda esse risco. Recomendamos habilitar a Prova de Vida no mesmo processo, ou capturar com o SDK da Unico seguindo o Padrão de Captura.

Escopo de busca​

O escopo de busca é controlado pelo campo clientReferenceSegment, configurado pela Unico na sua API Key durante o onboarding — não é um campo que você envia na requisição. Segmentos distintos podem coexistir dentro de um mesmo operador sem gerar falsos positivos (útil para subclientes B2B ou modelos com contas pessoais e empresariais); se sua operação precisa segmentar a busca, converse com seu contato na Unico.

Produtos que utilizam esta capacidade​