Umbrales y decisiones - Kairo Connect Docs

fraud_score

Probabilidad estimada de fraude en [0.0, 1.0]. Valores más altos indican mayor riesgo. El score está calibrado con chargebacks y etiquetas confirmadas.

Umbrales globales por defecto

Banda	Rango de score	risk_level	decision típica
Bajo	≤ 0.25	`LOW`	`APPROVE`
Medio	≤ 0.55	`MEDIUM`	`REVIEW`
Alto	≤ 0.80	`HIGH`	`REVIEW`
Crítico	> 0.80	`CRITICAL`	`REJECT`

Su cliente puede tener umbrales personalizados. Cuando aplican, la respuesta incluye threshold_used:

{
  "threshold_used": {
    "low_max": 0.25,
    "medium_max": 0.55,
    "high_max": 0.80
  }
}

Campo	Descripción
`low_max`	Score máximo inclusive para banda LOW
`medium_max`	Score máximo inclusive para banda MEDIUM
`high_max`	Score máximo inclusive para banda HIGH. Por encima → CRITICAL

threshold_used puede ser null cuando la decisión proviene únicamente de reglas determinísticas.

Reglas vs modelo

El motor de reglas (global + por cliente) puede sobreescribir la decisión del modelo ML. En ese caso decision_source será RULES.

uiaf_reportable

true cuando la transacción cumple criterios SARLAFT/UIAF (típicamente REJECT o CRITICAL). Su equipo de cumplimiento debe revisar estos casos.