Pular para o conteúdo principal
Versão: Guardian v0.5.3

Níveis de Risco

Toda chamada verify() retorna um riskLevel e um booleano allowed. Eles são independentes: uma transação pode ser allowed: true com riskLevel: high.

Níveis​

low
Risco normal

A transação parece segura. Nenhum sinal sinalizado.

medium
Risco elevado

Alguns sinais sinalizados. Considere uma verificação adicional.

high
Risco alto

Fortes sinais de fraude detectados. Ainda pode ser permitida, dependendo da configuração de cenários.

blocked
Bloqueado

Declarado no tipo RiskLevel do SDK. O backend não o retorna.

unknown
Desconhecido

O SDK não tem um nível de risco do backend. Você o recebe quando failurePolicy é allow e verify() falhou. Nesse caso, allowed é true.

informação

risk_level e allowed são avaliados de forma independente pelo backend. O nível de risco reflete a avaliação dos sinais de fraude, enquanto a decisão de permitir se baseia na configuração de cenários da sua organização. Uma transação de risco high pode ser allowed: true se nenhum cenário de rejeição for acionado.

blocked e unknown existem apenas no SDK. O backend retorna low, medium ou high. Com failurePolicy definido como allow, um verify() que falha retorna allowed: true, riskLevel unknown e a mensagem de erro em errors. Veja Configuração.

Fluxo de Decisão​

verify() retorna result

allowed: true
low
medium
high
unknown

Transação aceita. O nível de risco indica quanta fricção aplicar:

  • low: prossiga normalmente
  • medium: prossiga com cautela, considere uma verificação adicional
  • high: aceita com fortes sinais de fraude, adicione fricção ou monitore
  • unknown: a chamada falhou e failurePolicy é allow
allowed: false
low
medium
high

Transação rejeitada pela configuração da sua organização. O nível de risco pode ser qualquer um dos três.

  • verify() não retorna o motivo da rejeição
  • O fluxo servidor para servidor o retorna em result.details