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
lowLa transacción parece segura. No hay señales marcadas.
mediumAlgunas señales marcadas. Considera una verificación adicional.
highSe detectaron señales fuertes de fraude. Aun así puede permitirse según la configuración de escenarios.
blockedDeclarado en el tipo RiskLevel del SDK. El backend no lo devuelve.
unknownEl SDK no tiene un nivel de riesgo del backend. Lo obtienes cuando failurePolicy es allow y verify() falló. En ese caso allowed es true.
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
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
failurePolicyesallow
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