Níveis de Risco

Cada chamada verify() retorna um riskLevel e um booleano allowed. Eles são independentes: uma transação pode ter 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 verificação adicional.

high

Alto risco

Sinais fortes de fraude detectados. Ainda pode ser permitida dependendo da configuração de cenários.

blocked

Bloqueado

Transação bloqueada pela política do backend. Valor exclusivo do SDK, sempre allowed: false.

unknown

Desconhecido

O risco não pôde ser determinado. Falha do SDK ou do backend. Valor exclusivo do SDK, sempre allowed: false.

informação

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

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() retorna result

allowed: true

low

medium

high

Transação aceita. O nível de risco indica quanto atrito aplicar:

• low: prossiga normalmente
• medium: prossiga com cautela, considere uma verificação adicional
• high: aceita, mas sinalizada para revisão, adicione atrito ou monitore

allowed: false

high

blocked

unknown

Transação rejeitada. Verifique result.errors para detalhes:

• high: cenário de rejeição acionado
• blocked: bloqueio por política do backend (lista de bloqueio, jurisdição)
• unknown: erro do SDK/rede