> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Com Didit puntua cada transacció: regles, llindars i estats (APPROVED, IN_REVIEW, DECLINED). 1,000 al mes incloses, després $0.001 cadascuna.

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](https://docs.didit.me/ca/transaction-monitoring/response-schema.md#execucions-de-regles) per veure tots els camps):

```json theme={null}
{
  "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

> [card] [Regles](https://docs.didit.me/ca/transaction-monitoring/rules.md)
>
> Anatomia de les regles i avaluació.

> [card] [Alertes](https://docs.didit.me/ca/transaction-monitoring/alerts.md)
>
> Què passa quan s'activa una regla.

> [card] [Configuració](https://docs.didit.me/ca/transaction-monitoring/settings.md)
>
> Configura els llindars.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.