Níveis de Risco
Cada chamada verify() retorna um riskLevel indicando a avaliação do backend.
Níveis
| Nível | Significado | Ação Recomendada |
|---|---|---|
low | Risco normal - transação parece segura | Prosseguir |
medium | Risco elevado - alguns sinais sinalizados | Prosseguir com cautela ou solicitar verificação adicional |
high | Alto risco - sinais fortes de fraude | Bloquear ou escalar |
blocked | Bloqueado pela política do backend | Não prosseguir - estado de erro |
unknown | Risco não pôde ser determinado | Não prosseguir - estado de erro |
aviso
blocked e unknown são valores exclusivos do SDK que indicam condições de erro. Quando riskLevel for um desses, allowed será false e o array errors conterá detalhes. O backend retorna apenas low, medium ou high.
Fluxo de Decisão
verify() → result
├── result.allowed === true
│ └── riskLevel: low | medium
│ └── Prosseguir (opcionalmente adicionar atrito para medium)
└── result.allowed === false
└── riskLevel: high | blocked | unknown
└── Bloquear transação, verificar result.errors