Saltar al contenido principal
Version: Guardian v0.5.3

Niveles de riesgo

Cada llamada a verify() devuelve un riskLevel y un booleano allowed. Son independientes: una transacción puede ser allowed: true con riskLevel: high.

Niveles​

low
Riesgo normal

La transacción parece segura. No hay señales marcadas.

medium
Riesgo elevado

Algunas señales marcadas. Considera una verificación adicional.

high
Riesgo alto

Se detectaron señales fuertes de fraude. Aun así puede permitirse según la configuración de escenarios.

blocked
Bloqueado

Declarado en el tipo RiskLevel del SDK. El backend no lo devuelve.

unknown
Desconocido

El SDK no tiene un nivel de riesgo del backend. Lo obtienes cuando failurePolicy es allow y verify() falló. En ese caso allowed es true.

info

risk_level y allowed son evaluados de forma independiente por el backend. El nivel de riesgo refleja la evaluación de las señales de fraude, mientras que la decisión de allowed se basa en la configuración de escenarios de tu organización. Una transacción de riesgo high puede tener allowed: true si no se activa ningún escenario de rechazo.

blocked y unknown existen solo en el SDK. El backend devuelve low, medium o high. Con failurePolicy en allow, un verify() fallido devuelve allowed: true, riskLevel unknown, y el mensaje de error en errors. Consulta Configuración.

Flujo de decisión​

verify() devuelve result

allowed: true
low
medium
high
unknown

Transacción aceptada. El nivel de riesgo te indica cuánta fricción aplicar:

  • low: continúa normalmente
  • medium: continúa con precaución, considera una verificación reforzada
  • high: aceptada con señales fuertes de fraude, agrega fricción o monitorea
  • unknown: la llamada falló y failurePolicy es allow
allowed: false
low
medium
high

Transacción rechazada por la configuración de tu organización. El nivel de riesgo puede ser cualquiera de los tres.

  • verify() no devuelve el motivo del rechazo
  • El flujo servidor a servidor lo devuelve en result.details