Como adicionar uma nova capacidade (API)
Este guia é para clientes que já integraram via API (POST /processes/v1) com Classificação de Risco de Fraude (Trust Network) e estão adicionando Verificação de Identidade ao contrato.
Adicionando Verificação de Identidade
Este guia explica a evolução do motor de decisão para fortalecer seus 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: Verificação de Identidade
A principal melhoria é a capacidade de validar a identidade do titular (além das respostas de fraude). O sistema agora verifica se a pessoa realizando o processo é de fato a titular do documento fornecido.
É essencial que sua equipe compreenda corretamente e mapeie a nova interpretação de resposta antes que a capacidade seja ativada, para não impactar sua operação.
Tabela comparativa 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. Indícios 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 na nomenclatura
Garanta que seu sistema esteja 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, tem certeza total da identidade e 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 total certeza. - A severidade do
REPROVED— além dos indícios de fraude multifatorial, este estado agora também inclui casos em que o usuário está se passando pelo titular do documento.