Puntuación de riesgo de transacciones: fórmula y umbrales

Cada transacción recibe una puntuación, un número entero que resume su riesgo. La puntuación determina el estado de la transacción (APPROVED, IN_REVIEW, DECLINED) y la decisión de crear una alerta, abrir un caso o exigir que el usuario adopte medidas correctivas.

La fórmula

score = Σ(score_delta of every matched rule)

Puntuación base: 0.
Cada regla que coincide suma su score_delta configurado (normalmente entre 25 y 35).
Una transacción sin reglas coincidentes obtiene una puntuación de 0.

Umbrales y estados

Los umbrales de puntuación se configuran por aplicación en Transacciones → Configuración.

Configuración	Valor predeterminado	Significado
`preferred_review_score_threshold`	75	Las puntuaciones ≥ a este valor pasan a `IN_REVIEW`
`preferred_decline_score_threshold`	500	Las puntuaciones ≥ a este valor pasan a `DECLINED`. El valor predeterminado y máximo (`500`) significa “nunca rechazar por puntuación”, así que redúcelo para empezar a rechazar según la puntuación.

Asignación de estado:

if decline_threshold < 500 and score >= decline_threshold: status = DECLINED
else if score >= review_threshold: status = IN_REVIEW
else: status = APPROVED

Las acciones de cada regla pueden anular esta asignación de estado; por ejemplo, una regla con action: change_status → DECLINED rechazará la transacción independientemente de la puntuación.

Contribuciones de las reglas: ejemplo práctico

Supón que estas reglas se activan en una sola transacción:

Regla	`score_delta`
Salida de alto valor (>$10,000)	30
Contraparte en jurisdicción de alto riesgo	35
Patrón de fraccionamiento detectado	35

Puntuación total = 30 + 35 + 35 = 100. Con un umbral de revisión de 60 y un umbral de rechazo de 85, esta transacción queda DECLINED. Con los umbrales predeterminados (75 de revisión, 500 de rechazo), queda IN_REVIEW, porque la configuración predeterminada nunca rechaza por puntuación.

Anulaciones mediante acciones

Las reglas también pueden establecer directamente el estado, sin pasar por los umbrales de puntuación:

Acción de la regla	Efecto
`change_status → DECLINED`	La transacción se rechaza independientemente de la puntuación
`change_status → IN_REVIEW`	La transacción pasa a revisión independientemente de la puntuación
`change_status → AWAITING_USER`	La transacción espera a que el usuario realice una corrección: se usa el flujo de verificación (workflow) definido en la acción de la regla; las reglas de la biblioteca recurren a la opción elegida en tu configuración, después a tu flujo de Autenticación biométrica (se requiere un rostro almacenado) y, por último, a tu flujo predeterminado
`add_score(n)`	Solo suma a la puntuación; no fuerza ningún estado
`add_tags([...])`	Añade etiquetas para filtrar en la consola; no afecta a la puntuación
`add_to_list(...)`	Añade un identificador a una lista de bloqueo

Una sola regla puede tener varias acciones; por ejemplo, add_score(35) + add_tags(["structuring"]) + add_note("Auto-tagged by structuring preset").

Por qué las puntuaciones superan a las reglas estrictas

Un umbral puro (por ejemplo, “rechazar toda transacción de más de $100k”) se activa tanto ante transacciones legítimas de alto valor como ante riesgos reales. Combinar varias reglas con un score_delta moderado y un umbral de revisión/rechazo te ofrece:

Puntuación por capas: ninguna regla por sí sola provoca un rechazo; varias señales tienen que coincidir.
Sensibilidad ajustable: sube o baja los umbrales sin tocar la definición de las reglas.
Gradación de la gravedad: una transacción con puntuación 65 pasa a revisión (merece un vistazo); una con puntuación 90 se rechaza (grave).

Configurar los umbrales

Desde Transacciones → Configuración:

Umbral de revisión: súbelo si tu cola de revisión está saturada; bájalo para detectar más casos límite.
Umbral de rechazo: súbelo para reducir los rechazos por falsos positivos; bájalo para optar por un bloqueo más agresivo. Establécelo en el valor máximo (500) para enviar las transacciones con puntuaciones altas a revisión en lugar de rechazarlas automáticamente.

Los cambios se aplican solo a las transacciones nuevas; las transacciones históricas conservan el estado asignado en el momento de su evaluación.

Modo de prueba para reglas

Las reglas pueden ejecutarse en modo TEST:

La regla se evalúa con respecto a las transacciones, pero no contribuye a la puntuación ni afecta al estado.
Los registros TransactionRuleRun se crean con is_test = true.
Te permite validar la selectividad de una regla sin arriesgarte a rechazos en producción.

Cambia a ACTIVE cuando estés conforme con la selectividad.

Gravedad y campos heredados

El campo severity de Transaction y TransactionAlert admite valores nulos y es un campo heredado. Las nuevas evaluaciones de reglas no lo establecen. Usa score como señal principal de riesgo.

Consultar las puntuaciones

Mediante la API

Cada respuesta de transacción incluye score y un array rule_runs[] con una entrada por cada regla coincidente (consulta el esquema de respuesta para ver todos los campos):

{
  "txn_id": "tx-0002",
  "status": "IN_REVIEW",
  "score": 65,
  "rule_runs": [
    {
      "rule_title": "High-value outbound",
      "matched": true,
      "score_delta": 30,
      "severity": null,
      "status_target": null,
      "action_summary": "score +30"
    },
    {
      "rule_title": "High-risk jurisdiction counterparty",
      "matched": true,
      "score_delta": 35,
      "severity": "HIGH",
      "status_target": "IN_REVIEW",
      "action_summary": "score +35; add_tag:high_risk_country"
    }
  ]
}

En la consola

En la página de detalle de la transacción, la pestaña Score muestra un desglose de la contribución de cada regla coincidente y la asignación final del estado. Pasa el cursor sobre el indicador de puntuación para ver los valores de umbral usados en el momento de la evaluación.

Próximos pasos

Reglas

Anatomía y evaluación de las reglas.

Alertas

Qué ocurre cuando se activa una regla.

Configuración

Configura los umbrales.

Primeros pasos

Funciones

Referencia

Consola

Puntuación de riesgo de transacciones: fórmula y umbrales

La fórmula

Umbrales y estados

Contribuciones de las reglas: ejemplo práctico

Anulaciones mediante acciones

Por qué las puntuaciones superan a las reglas estrictas

Configurar los umbrales

Modo de prueba para reglas

Gravedad y campos heredados

Consultar las puntuaciones

Mediante la API

En la consola

Próximos pasos

Reglas

Alertas

Configuración

​La fórmula

​Umbrales y estados

​Contribuciones de las reglas: ejemplo práctico

​Anulaciones mediante acciones

​Por qué las puntuaciones superan a las reglas estrictas

​Configurar los umbrales

​Modo de prueba para reglas

​Gravedad y campos heredados

​Consultar las puntuaciones

​Mediante la API

​En la consola

​Próximos pasos

Reglas

Alertas

Configuración

La fórmula

Umbrales y estados

Contribuciones de las reglas: ejemplo práctico

Anulaciones mediante acciones

Por qué las puntuaciones superan a las reglas estrictas

Configurar los umbrales

Modo de prueba para reglas

Gravedad y campos heredados

Consultar las puntuaciones

Mediante la API

En la consola

Próximos pasos