Decisiones de riesgo

Cada llamada a POST /api/v1/assess devuelve un risk_score de 0 a 100 y una decision. El score es la suma de los pesos de las señales que se activaron, con tope en 100.

Decisiones

Decision	Score típico	Acción recomendada
`approve`	bajo	Proceder con la transacción.
`review`	moderado	Permitir, pero encolar para revisión manual o monitoreo.
`challenge`	elevado	Requerir verificación step-up (3DS, OTP, KYC).
`decline`	alto / bloqueo duro	Bloquear la transacción.

Los umbrales entre estas bandas son configurables por organización en el panel, para ajustar Clausum a tu apetito de riesgo sin cambios de código.

Un bloqueo duro (por ejemplo un email en blocklist con severidad block, o un monto por encima de tu máximo configurado) fuerza decline con risk_score de 100 y rellena blocked_by con la razón.

Forma de la respuesta

{
  "decision": "challenge",
  "risk_score": 55,
  "signals": ["high_velocity", "disposable_email"],
  "signal_details": [
    { "code": "high_velocity", "weight": 35, "description": "6 transactions in the last hour" },
    { "code": "disposable_email", "weight": 20, "description": "Disposable email detected" }
  ],
  "session_id": "ps_1716998400000_a1b2c3d4e",
  "blocked_by": null,
  "latency_ms": 48
}

signals — códigos cortos de cada señal que contribuyó.
signal_details — peso y descripción legible por humanos de cada una.
session_id — persiste esto para correlacionar con reportes y webhooks posteriores.
blocked_by — distinto de null solo cuando la transacción fue bloqueada de forma dura.

Categorías de señales

Coincidencias en blocklist

Email, dominio de email, IP, rango IP, huella de dispositivo, BIN de tarjeta, hash de tarjeta, país, teléfono o customer_id presentes en tus blocklists. Severidad block declina de forma dura; flag y review agregan peso.

Señales de email

Proveedores de email desechable y TLD sospechosos (.xyz, .top, .click, …).

Señales conductuales

Sesiones muy cortas, sin movimiento de mouse, campos pegados y patrones tipo bot — más fiables con el SDK para navegador.

Señales de monto

Límites min/max configurables y valores atípicos estadísticos frente a tu historial reciente de transacciones.

Señales de velocidad

Transacciones repetidas del mismo email o dispositivo en una ventana corta.

Historial del pagador

Fraude confirmado previo asociado al email conlleva penalización fuerte.

Reglas personalizadas

Reglas definidas por la organización pueden sumar o restar score, o forzar una decisión específica. Las reglas activadas aparecen en rules_applied.

Aplicar decisiones

function enforce(assessment) {
  switch (assessment.decision) {
    case "approve":   return proceed()
    case "review":    return proceed({ flagForReview: true })
    case "challenge": return requireStepUp()        // 3DS / OTP
    case "decline":   return block(assessment.blocked_by)
  }
}

Registra session_id, risk_score y signals junto a tus registros de orden. Son invaluables al investigar disputas y al llamar report-fraud después.

Primeros pasos

Integración por tipo de cliente

Soluciones y prevención

Capacidades — eventos y operaciones

Panel de control

Conceptos clave

Referencia

Decisiones de riesgo

Decisiones

Forma de la respuesta

Categorías de señales

Aplicar decisiones

​Decisiones

​Forma de la respuesta

​Categorías de señales

​Aplicar decisiones

Decisiones

Forma de la respuesta

Categorías de señales

Aplicar decisiones