Puntuació de risc de transaccions: fórmula i llindars

Cada transacció rep una puntuació: un enter que resumeix el seu risc. La puntuació determina l’estat de la transacció (APPROVED, IN_REVIEW, DECLINED) i si cal crear una alerta, obrir un cas o exigir una correcció a l’usuari.

La fórmula

score = Σ(score_delta of every matched rule)

Puntuació base: 0.
Cada regla que coincideix aporta el seu score_delta configurat (normalment entre 25 i 35).
Una transacció sense cap regla coincident obté una puntuació de 0.

Llindars i estats

Els llindars de puntuació es configuren per aplicació a Transaccions → Configuració.

Configuració	Valor per defecte	Significat
`preferred_review_score_threshold`	75	Les puntuacions ≥ aquest valor passen a `IN_REVIEW`
`preferred_decline_score_threshold`	500	Les puntuacions ≥ aquest valor passen a `DECLINED`. El valor per defecte i el màxim (`500`) vol dir «mai denegar per puntuació», així que cal reduir-lo per començar a denegar per puntuació.

Assignació d’estat:

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

Les accions individuals de les regles poden substituir aquesta assignació. Per exemple, una regla amb action: change_status → DECLINED denegarà la transacció independentment de la puntuació.

Contribucions de les regles: exemple pràctic

Suposem que aquestes regles s’activen en una única transacció:

Regla	`score_delta`
Transacció sortint d’alt valor (>$10,000)	30
Contrapart en una jurisdicció d’alt risc	35
Patró d’estructuració detectat	35

Puntuació total = 30 + 35 + 35 = 100. Amb un llindar de revisió de 60 i un llindar de denegació de 85, aquesta transacció passa a DECLINED. Amb els valors per defecte (75 de revisió i 500 de denegació), passa a IN_REVIEW, perquè el valor per defecte mai denega per puntuació.

Anul·lacions per acció

Les regles també poden establir directament l’estat, saltant-se els llindars de puntuació:

Acció de la regla	Efecte
`change_status → DECLINED`	Transacció denegada independentment de la puntuació
`change_status → IN_REVIEW`	Transacció enviada a revisió independentment de la puntuació
`change_status → AWAITING_USER`	La transacció espera la correcció per part de l’usuari: s’utilitza el flux de treball definit a l’acció de la regla; les regles de la biblioteca recorren primer a l’opció que hagis triat a la configuració, després al teu flux d’autenticació biomètrica (cal que hi hagi una cara emmagatzemada) i finalment al teu flux de treball per defecte
`add_score(n)`	Només contribueix a la puntuació; no força cap estat
`add_tags([...])`	Afegeix etiquetes per filtrar a la consola; no afecta la puntuació
`add_to_list(...)`	Afegeix un identificador a una llista de bloqueig

Una mateixa regla pot tenir diverses accions, per exemple add_score(35) + add_tags(["structuring"]) + add_note("Auto-tagged by structuring preset").

Per què les puntuacions superen les regles rígides

Un llindar fix (per exemple, «denegar cada transacció superior a $100k») activa tant transaccions legítimes d’alt import com transaccions amb risc real. Combinar diverses regles amb score_delta moderats i un llindar de revisió i un de denegació et permet:

Puntuació per capes: cap regla individual no provoca una denegació; diversos senyals han de coincidir.
Sensibilitat ajustable: pots pujar o baixar els llindars sense modificar les definicions de les regles.
Gradació de gravetat: una transacció amb puntuació 65 passa a revisió (val la pena mirar-la-hi); una amb puntuació 90 passa a denegació (és greu).

Configuració dels llindars

Des de Transaccions → Configuració:

Llindar de revisió: augmenta’l si la cua de revisió està saturada; redueix-lo per detectar més casos límit.
Llindar de denegació: augmenta’l per reduir les denegacions per falsos positius; redueix-lo si vols un bloqueig més agressiu. Estableix-lo al valor màxim (500) per enviar les puntuacions altes a revisió en lloc de denegar-les automàticament.

Els canvis només s’apliquen a les transaccions noves; les transaccions històriques conserven l’estat que tenien en el moment de l’avaluació.

Mode de prova per a les regles

Les regles poden executar-se en mode TEST:

La regla s’avalua sobre les transaccions, però no contribueix a la puntuació ni a l’estat.
Es creen registres TransactionRuleRun amb is_test = true.
Permet validar la selectivitat d’una regla sense arriscar denegacions en producció.

Canvia a ACTIVE quan estiguis satisfet amb la selectivitat.

Severitat i camps heretats

El camp severity de Transaction i de TransactionAlert és anul·lable i heretat. Les noves avaluacions de regles no l’estableixen. Fes servir score com a senyal principal de risc.

Inspecció de les puntuacions

Mitjançant l’API

Cada resposta de transacció inclou score i un array rule_runs[] amb una entrada per cada regla coincident (consulta l’esquema de resposta per veure tots els camps):

{
  "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"
    }
  ]
}

A la consola

A la pàgina de detall de la transacció, la pestanya Puntuació mostra el desglossament de la contribució de cada regla i l’assignació final d’estat. Passa el cursor per sobre de la insígnia de puntuació per veure els valors dels llindars utilitzats en el moment de l’avaluació.

Següents passos

Regles

Anatomia de les regles i avaluació.

Alertes

Què passa quan s’activa una regla.

Configuració

Configura els llindars.

Primers passos

Funcionalitats

Referència

Consola

Puntuació de risc de transaccions: fórmula i llindars

La fórmula

Llindars i estats

Contribucions de les regles: exemple pràctic

Anul·lacions per acció

Per què les puntuacions superen les regles rígides

Configuració dels llindars

Mode de prova per a les regles

Severitat i camps heretats

Inspecció de les puntuacions

Mitjançant l’API

A la consola

Següents passos

Regles

Alertes

Configuració

​La fórmula

​Llindars i estats

​Contribucions de les regles: exemple pràctic

​Anul·lacions per acció

​Per què les puntuacions superen les regles rígides

​Configuració dels llindars

​Mode de prova per a les regles

​Severitat i camps heretats

​Inspecció de les puntuacions

​Mitjançant l’API

​A la consola

​Següents passos

Regles

Alertes

Configuració

La fórmula

Llindars i estats

Contribucions de les regles: exemple pràctic

Anul·lacions per acció

Per què les puntuacions superen les regles rígides

Configuració dels llindars

Mode de prova per a les regles

Severitat i camps heretats

Inspecció de les puntuacions

Mitjançant l’API

A la consola

Següents passos