Multi Contas
Multi Contas pergunta "esse rosto já existe em outro lugar na base do operador?".
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.clientReferencena 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
| Resposta | Significado |
|---|---|
YES | Multi-conta detectado. A biometria facial já está vinculada a um clientReference diferente dentro do mesmo segmento. |
NO | Multi-conta não detectado. A pessoa foi identificada e o rosto não está vinculado a nenhum outro clientReference dentro do mesmo segmento. |
INCONCLUSIVE | A 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çãoUm 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.
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.
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.