Como adicionar uma nova capacidade (API)
Este guia é para clientes que já integraram via API (POST /processes/v1) com Fraud Risk Classification (Trust Network) e estão adicionando Identity Verification ao contrato.
Adicionando Identity Verification
Este guia explica a evolução do motor de decisão para fortalecer os processos de validação de identidade.
Diferente de outras integrações, habilitar esta capacidade exige a atualização da sua API key. Sem essa mudança, você não conseguirá receber as novas respostas de validação de identidade — seu contato Unico irá compartilhá-las com você.
A grande mudança: Identity Verification
A principal melhoria é a capacidade de validar a identidade do titular (além das respostas de fraude). O sistema agora verifica se a pessoa que está realizando o processo é, de fato, o titular do documento fornecido.
É fundamental que sua equipe entenda e mapeie corretamente a nova interpretação de resposta antes que a capacidade seja ativada, para não impactar sua operação.
Tabela de comparação de resultados
| Resultado (somente Trust) | Resultado (Trust + IDUnico) | Significado e ação recomendada |
|---|---|---|
| N/A | APPROVED | Novo (estado ideal). O usuário é o titular do documento e não há evidências de fraude. |
INCONCLUSIVE | INCONCLUSIVE | Mudança de nuance. O usuário é real e não há evidências de fraude, mas não há certeza de que seja o titular do documento. |
REPROVED | REPROVED | Rejeição recomendada. Indicadores de fraude, ou o sistema confirmou que o usuário não é o titular do documento. |
HIGH_RISK | HIGH_RISK | Pelo menos uma evidência forte de fraude. O cliente decide a ação. |
CRITICAL_RISK | CRITICAL_RISK | Pelo menos duas evidências críticas de fraude. Rejeição recomendada. |
Principais mudanças de nomenclatura
Certifique-se de que seu sistema está pronto para mapear estas três mudanças fundamentais no seu fluxo de aprovação:
- A chegada do
APPROVED— este é agora o estado "ideal". Se você receber este código, você tem certeza total da identidade e da segurança do processo. - A nova nuance do
INCONCLUSIVE— anteriormente seu principal sinal verde. Agora significa que a pessoa é "real" e não há fraude evidente, mas o sistema não conseguiu vinculá-la à identidade do documento com certeza total. - A severidade do
REPROVED— além dos indicadores de fraude multifatoriais, este estado agora também inclui casos em que o usuário está se passando pelo titular do documento.