> ## 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.

# Biblioteca de regles KYT: més de 150 escenaris predefinits

> Didit: més de 150 regles KYT predefinides per a estructuració, velocitat, sancions i cripto. 1,000 al mes incloses; després $0.001 cada una.

Didit ofereix una biblioteca seleccionada de **més de 150 regles predefinides de monitoratge de transaccions** que pots instal·lar individualment o per paquets. Cada regla correspon a una tipologia real de blanqueig de capitals, frau o compliment, extreta d'estàndards globals i de guies reguladores: les recomanacions del FATF, els avisos de FinCEN, les normes de NACHA, els principis de Wolfsberg, les tipologies de l'Egmont Group i els patrons d'abús en iGaming.

Tria les regles o els paquets que necessitis i, després, controla el mode de cada regla instal·lada (`ACTIVE`, `TEST` o `DISABLED`). Les condicions, els llindars i les accions de les regles predefinides són fixos; crea una regla personalitzada quan necessitis una lògica diferent. Desinstal·la una regla predefinida per eliminar-la de l'aplicació, i reinstal·la-la més endavant si cal.

> [!NOTE]
>
> Les regles de la biblioteca es poden explorar, instal·lar i desinstal·lar des de *Transactions -> Rules -> Library* a la Business Console, mitjançant l'[API de la biblioteca de regles](https://docs.didit.me/ca/management-api/transactions/rules-library.md) (`GET /v3/transactions/rules/library/`, `POST`/`DELETE /v3/transactions/rules/install/`), o a través de les [eines MCP](https://docs.didit.me/ca/integration/mcp/tools.md) `didit_transaction_rule_library_list` / `didit_transaction_rule_install` / `didit_transaction_rule_uninstall`. Les regles predefinides instal·lades només admeten canvis de `mode` (activar, desactivar, provar); els seus llindars són fixos: per modificar-ne un, crea una [regla personalitzada](https://docs.didit.me/ca/transaction-monitoring/rules.md#creació-de-regles-personalitzades). Per saber com contribueixen les regles a la puntuació, consulta la [puntuació de risc](https://docs.didit.me/ca/transaction-monitoring/risk-scoring.md).

> [!NOTE]
>
> Una regla de la biblioteca les condicions de la qual llegeixen dades que el motor de regles encara no pot avaluar queda **retinguda** fins que pugui executar-se: la biblioteca no la mostra, una sol·licitud que la nomeni a `library_keys` respon amb `400` i no instal·la res (una clau desconeguda s'omet), i una instal·lació de `bundle` la omet. Una còpia que hagis instal·lat abans es desactiva (`DISABLED`) i es manté a la teva llista de regles, i establir-ne un `mode` diferent respon amb `400`. Una regla retinguda torna a estar disponible sola quan el motor de regles pugui avaluar les seves condicions, de manera que la llista de la biblioteca sempre mostra les regles que pots instal·lar avui.

## Com s'organitzen les regles predefinides

Cada regla predefinida pertany a un **paquet** (la seva família funcional) i a una **categoria** (el seu tema de risc més ampli). Els paquets et permeten activar o desactivar regles relacionades des de la consola; les categories determinen la puntuació i els informes.

| Paquet | Què cobreix |
| - | - |
| `finance` | Estructuració, transaccions de gran import, volum acumulat, dispersió per països, estratificació, concentració de mulers, fraccionament |
| `aml_ctf` | Sancions, referències de pagament sospitoses, estratificació amb imports rodons, entrades i sortides ràpides |
| `aml_monitoring` | Exposició a orígens dels fons d'alt risc derivada de la blockchain, finançament del terrorisme, explotació infantil |
| `anomaly_detection` | Velocitat elevada, reactivació de comptes inactius, activitat fora d'horari |
| `fatf` | Exposició a jurisdiccions d'alt risc |
| `device_intelligence` | Reutilització de petjades digitals de dispositiu, comptes amb múltiples petjades digitals, anomalies d'IP i navegador, VPN/proxy, desplaçaments impossibles |
| `fraud_prevention_multi_accounting` | Petjades digitals compartides entre subjectes diferents |
| `fraud_prevention_app` | Senyals de pagaments push autoritzats, de beneficiaris per primera vegada i de víctimes d'estafa |
| `fraud_prevention_ato` | Senyals compostos de presa de control de comptes (canvi de dades personals, nou mètode de pagament) |
| `fraud_prevention_consortium` | Contraparts marcades per altres entitats a la xarxa compartida |
| `crypto_monitoring` | Exposició a mescladors, darknet i carteres sancionades, salt entre cadenes, carteres autoallotjades i mancances de VASP |
| `travel_rule` | Obligacions globals i regionals de la Travel Rule (12 règims) i diligència deguda sobre els VASP de les contraparts |
| `travel_rule_eu_tfr` | Verificacions del TFR de la UE: discrepància de dades de la contrapart, titularitat no verificada de la cartera, VASP de la contrapart no identificat, confirmació caducada |
| `responsible_gaming` | Límits de dipòsit i retirada per a un joc segur, autoexclusió, joc fora d'horari |
| `igaming_fraud` | Abús de bonificacions propi de l'esdeveniment, apostes oposades, frau d'afiliats, obtenció abusiva de recompenses de pluja de xat, transferència il·lícita de fitxes, presa de control de comptes |
| `e_commerce` | Microtransaccions de prova de targetes, indicadors de contracàrrec, discrepància del país de facturació, ràfega d'afiliats |
| `check_fraud` | Xecs fora de rang, sense número, presentats duplicats, en llistes de vigilància de la dark web, xecs manipulats, kiting |
| `bnpl` | Frau de primera part per impagament de quotes, identificadors compartits entre comptes BNPL, pagaments a terminis de comptes nous |

## Com llegir aquesta pàgina

Cada regla indica el seu `library_key` (identificador estable que pots referenciar a l'API o a l'URL de la consola), les condicions i l'agregació que fan que s'activi, i les accions per defecte que executa. Els llindars numèrics que es mostren aquí són els valors predeterminats de la versió lliurada: cada valor es pot editar per aplicació sense perdre la identitat de la regla.

***

## Paquet de finances

Aquestes regles s'apliquen a cada transacció amb `transaction_type = FINANCE`. Modelen la base normativa (llindars de declaració de BSA/FinCEN, heurístiques de velocitat del FATF) i els patrons de mules de diners i smurfing.

### Fraccionament i quasi-llindar

| `library_key` | Activador | Acció per defecte |
| - | - | - |
| `structuring-inbound` | ≥20 transferències entrants de menys de \$10,000 del mateix subjecte en 30 dies | +35 punts |
| `structuring-outbound` | ≥20 transferències sortints de menys de \$10,000 del mateix subjecte en 30 dies | +35 punts |
| `single-transaction-just-below-threshold` | Una única transacció entre $9,000 i $9,999 | +25 punts |
| `round-amount-layering` | L'import de la transferència és un valor sospitosament rodó ($10k, $25k, $50k, $100k, $250k, $500k, \$1M…) | +20 punts |

### Volum i velocitat

| `library_key` | Activador | Acció per defecte |
| - | - | - |
| `large-single-transaction` | Transacció única ≥ \$25,000 | +50 punts, `IN_REVIEW` |
| `cumulative-outbound-volume` | Volum sortint ≥ \$100,000 en 30 dies | +45 punts, `IN_REVIEW` |
| `cumulative-inbound-volume-90d` | Volum entrant ≥ \$200,000 en 90 dies | +30 punts, `IN_REVIEW` |
| `cumulative-outbound-volume-7d` | Volum sortint ≥ \$50,000 en 7 dies | +30 punts, `IN_REVIEW` |
| `business-4h-inbound-volume` | Volum entrant d'empresa ≥ \$30,000 en qualsevol finestra de 4 hores | +30 punts, `IN_REVIEW` |
| `business-4h-outbound-volume` | Volum sortint d'empresa ≥ \$30,000 en qualsevol finestra de 4 hores | +30 punts, `IN_REVIEW` |
| `high-velocity-inbound` | ≥20 transaccions entrants en 7 dies | +25 punts |
| `high-velocity-outbound` | ≥20 transaccions sortints en 7 dies | +25 punts |

### Estratificació, mules i fraccionament

| `library_key` | Activador | Acció per defecte |
| - | - | - |
| `rapid-in-and-out-movement` | Una sortida precedida d'una entrada en un termini de 6 hores | +60 punts, `IN_REVIEW` |
| `cash-deposit-followed-by-withdrawal` | Dipòsits en efectiu ≥ \$50,000 en 72 h seguits d'una retirada en efectiu | +30 punts, `IN_REVIEW` |
| `money-mule-fan-in-to-counterparty` | Una contrapart rep transferències de ≥5 subjectes diferents en 7 dies | +30 punts, `IN_REVIEW` |
| `rapid-repeated-payments-same-counterparty` | ≥5 transferències sortints a la mateixa contrapart en 24 hores | +30 punts, `IN_REVIEW` |
| `cross-border-small-amount-velocity` | Un subjecte envia imports inferiors a \$1,000 a ≥4 països diferents on estan establertes les contraparts en 24 h | +30 punts, `IN_REVIEW` |
| `high-risk-jurisdiction-smurfing` | ≥5 transferències sortints inferiors a \$1,000 al mateix país d'alt risc en 7 dies | +30 punts, `IN_REVIEW` |
| `many-unique-counterparties-24h` | El subjecte opera amb ≥6 contraparts diferents en 24 hores | +30 punts, `IN_REVIEW` |
| `many-unique-payment-methods-7d` | El subjecte alterna entre ≥4 mètodes de pagament diferents en 7 dies | +30 punts, `IN_REVIEW` |
| `counterparty-country-spread-24h` | El subjecte opera amb contraparts de ≥4 països diferents en 24 hores | +30 punts, `IN_REVIEW` |

### Anomalies de comportament

| `library_key` | Activador | Acció per defecte |
| - | - | - |
| `dormant-account-reactivation` | Primera transacció ≥ \$1,000 després de ≥365 dies d'inactivitat | +20 punts |
| `off-hours-high-value-finance` | Transferència d'alt valor (≥ \$5,000) marcada com a fora d'horari per a la configuració regional del subjecte | +25 punts |

***

## Paquet AML / CTF

Aquestes regles modelen tipologies clàssiques d'AML/CTF que no depenen de l'enriquiment amb blockchain: s'apliquen de manera universal a les transferències fiat i de criptomonedes.

| `library_key` | Activador | Acció per defecte |
| - | - | - |
| `sanctions-counterparty` | La cartera sotmesa a cribratge està atribuïda a una entitat sancionada (`wallet_sanctioned`). La mera exposició no l'activa | +90 punts, `DECLINED` |
| `sanctions-exposure-review` | La cartera sotmesa a cribratge ha mogut fons cap a entitats sancionades o des d'elles sense estar sancionada ella mateixa | +50 punts, `IN_REVIEW` |
| `suspicious-payment-reference` | La referència de pagament conté paraules clau vinculades a productes del delicte | +45 punts, `IN_REVIEW` |
| `high-risk-jurisdiction-exposure` | El país de la contrapart o el país de la IP del subjecte està a la llista d'alt risc | +40 punts, `IN_REVIEW` |
| `high-risk-inbound-single` | Entrada ≥ \$20,000 des d'un país d'alt risc | +30 punts, `IN_REVIEW` |
| `high-risk-outbound-single` | Sortida ≥ \$20,000 cap a un país d'alt risc | +30 punts, `IN_REVIEW` |

La llista predeterminada de jurisdiccions d'alt risc inclou els territoris inclosos en les crides a l'acció de la FATF i els territoris de regions en conflicte: `IRN`, `PRK`, `SYR`, `AFG`, `RUS`, `MMR`. Pots substituir la llista per aplicació.

> [!NOTE]
>
> **Actualment no s'ofereix cobertura de contrapartides PEP.** Cap proveïdor de cribratge connectat informa de si una contrapart és una persona políticament exposada: el camp `pep_counterparty` és `null` en tots els resultats de cribratge actuals (vegeu [cribratge de carteres](https://docs.didit.me/ca/transaction-monitoring/wallet-screening.md#resposta)), de manera que la biblioteca no té cap predefinició per a contraparts PEP. Una regla instal·lada abans que es retirés aquesta predefinició continua avaluant-se, però no pot coincidir amb cap cribratge real: elimina-la o substitueix-la per una regla personalitzada si necessites actuar en funció d'un altre senyal.

***

## Paquet de cribratge cripto

Aquestes regles utilitzen les dades enriquides que produeix el cribratge de criptomonedes de Didit: són especialment útils per a aplicacions natives de criptomonedes i VASP.

| `library_key` | Activador | Acció per defecte |
| - | - | - |
| `aml-high-risk-source-exposure` | ≥30% dels fons d'origen procedeixen de categories sancionades, de darknet, de robatoris, de ransomware o d'estafes | +70 punts, `IN_REVIEW` |
| `aml-multiple-risky-counterparties` | ≥3 connexions amb entitats d'alt risc al graf de l'origen dels fons | +50 punts, `IN_REVIEW` |
| `aml-terrorist-financing-exposure` | Qualsevol exposició al finançament del terrorisme a la cartera | +100 punts, `DECLINED` |
| `aml-child-exploitation-exposure` | Qualsevol exposició a material d'explotació infantil a la cartera | +100 punts, `DECLINED` |
| `aml-wallet-risk-score-medium` | Puntuació de risc de la cartera del proveïdor entre 40 i 70 | +30 punts |

***

## Paquet de monitoratge cripto

Regles d'exposició a nivell de cartera, i comprovacions d'integritat relacionades amb VASP i Travel Rule.

| `library_key` | Activador | Acció per defecte |
| - | - | - |
| `crypto-mixer-exposure` | Cartera vinculada a un mesclador o a un servei d'ofuscació | +80 de puntuació, `IN_REVIEW` |
| `crypto-darknet_market-exposure` | Exposició a una cartera d'un mercat de la darknet | +80 de puntuació, `IN_REVIEW` |
| `crypto-sanctioned-exposure` | Exposició a una cartera sancionada | +90 de puntuació, `IN_REVIEW` |
| `crypto-stolen_funds-exposure` | Exposició a una cartera amb fons robats | +85 de puntuació, `IN_REVIEW` |
| `crypto-scam-exposure` | Exposició a una cartera associada a una estafa | +70 de puntuació, `IN_REVIEW` |
| `crypto-ransomware-exposure` | Exposició a una cartera de ransomware | +90 de puntuació, `IN_REVIEW` |
| `crypto-hacked_exchange-exposure` | Exposició a una cartera d'una plataforma d'intercanvi hackejada | +80 de puntuació, `IN_REVIEW` |
| `crypto-gambling_unlicensed-exposure` | Exposició a una cartera de joc sense llicència | +60 de puntuació, `IN_REVIEW` |
| `high-risk-wallet-exposure` | El risc de la cartera és el d'un mercat de la darknet, d'una cartera sancionada o de fons robats | +70 de puntuació, `IN_REVIEW` |
| `crypto-wallet-risk-score-critical` | Puntuació de la cartera del proveïdor ≥ 90 | +90 de puntuació, `IN_REVIEW` |
| `crypto-wallet-risk-score-high` | Puntuació de la cartera del proveïdor ≥ 70 | +60 de puntuació, `IN_REVIEW` |
| `crypto-unhosted-wallet-large-outbound` | Sortida ≥ \$1,000 cap a una cartera no allotjada | +45 de puntuació, `IN_REVIEW` |
| `crypto-repeated-unhosted-wallet-withdrawals` | ≥5 transferències de sortida cap a carteres no allotjades en 24h | +35 de puntuació, `IN_REVIEW` |
| `crypto-many-new-wallets-per-subject` | El subjecte envia a ≥5 carteres diferents en 24h | +40 de puntuació, `IN_REVIEW` |
| `crypto-chain-hopping-pattern` | El mateix subjecte mou fons entre ≥3 blockchains en 24h | +45 de puntuació, `IN_REVIEW` |
| `crypto-missing-vasp-id-high-value` | Transferència d'una cartera allotjada ≥ \$1,000 sense identificador de VASP | +30 de puntuació, `IN_REVIEW` |

***

## Paquet de Travel Rule

Les regles de Travel Rule només s'apliquen a transaccions `travelRule`.
Cada règim regional inclou quatre regles (pendent de la contrapart, acció pendent, dades obligatòries que falten i intercanvi fallit).

### Travel Rule global

| `library_key` | Activador | Acció per defecte |
| - | - | - |
| `travel-rule-pending-counterparty` | L'estat és `AWAITING_COUNTERPARTY` (s'espera el VASP de la contrapart) | +35 de puntuació, `IN_REVIEW` |
| `travel-rule-pending-action` | L'estat és `ON_HOLD` (en una plataforma d'intercanvi gestionada, una transferència entrant que espera que la resolguis: cap coincidència al llibre d'adreces de la cartera, o una consulta que espera aprovació manual) | +35 de puntuació, `AWAITING_USER` |
| `travel-rule-missing-required-data` | `travel_rule_required` és `true` i `travel_rule_obligations_count` és superior a `0`; només les dades de Travel Rule que registres tu mateix a `travel_rule_details` tenen un recompte d'obligacions, així que aquesta regla mai s'activa en una transferència que gestiona la plataforma d'intercanvi | +50 de puntuació, `IN_REVIEW` |

### Règims regionals

La mateixa plantilla de quatre regles s'aplica a cada règim. Substitueix `<regime>` per qualsevol de les opcions següents: `australia`, `dubai`, `eu`, `hong_kong`, `india`, `indonesia`, `japan`, `kazakhstan`, `singapore`, `south_africa`, `turkey`, `uk`.

L'etiquetatge del règim és automàtic: Didit assigna `custom_values.travel_rule_regime` a cada transacció de Travel Rule a partir del `jurisdiction` de la teva [configuració de Travel Rule](https://docs.didit.me/ca/transaction-monitoring/travel-rule.md#configuració) - `SG` → `singapore`, `GB` → `uk`, i qualsevol codi d'un estat membre de la UE o de l'EEE, com `DE` o `FR`, → `eu`. Els codis sense paquet regional s'assignen en minúscules (`US` → `us`), de manera que les regles personalitzades els poden tenir com a objectiu. Un valor `props.travel_rule_regime` enviat a la transacció sempre substitueix el règim derivat.

| plantilla de `library_key` | Activador |
| - | - |
| `travel-rule-<regime>-pending-counterparty` | Transferència amb règim assignat que espera el VASP de la contrapart |
| `travel-rule-<regime>-pending-action` | La transferència amb règim assignat és `ON_HOLD` |
| `travel-rule-<regime>-missing-required-data` | La transferència amb règim assignat està subjecta a aquest requisit però no està resolta |
| `travel-rule-<regime>-failed-exchange` | La transferència amb règim assignat és `CANCELLED` |

Això suposa 48 regles específiques per regió, a més de les tres regles globals de Travel Rule i de les cinc regles sobre la contrapart que hi ha a continuació.
El paquet separat `travel_rule_eu_tfr` afegeix quatre regles del TFR de la UE, descrites a [Paquet de regles del TFR de la UE](https://docs.didit.me/ca/transaction-monitoring/travel-rule.md#regles-del-paquet-tfr-de-la-ue).

### Diligència deguda de la contrapart

Aquestes regles llegeixen el que la teva aplicació sap sobre el VASP de la contrapart amb què ha contactat la plataforma d'intercanvi: la teva pròpia decisió sobre aquest VASP, el seu nivell de risc de diligència deguda, el seu país i la seva capacitat de resposta.
Consulta [Diligència deguda de la contrapart](https://docs.didit.me/ca/transaction-monitoring/travel-rule.md#diligència-deguda-sobre-la-contrapart) per saber d'on prové cada valor.

| `library_key` | Activador | Acció per defecte |
| - | - | - |
| `travel-rule-counterparty-blocked` | La teva decisió sobre la contrapart (`counterparty_dd_status`) és `BLOCKED` | +90 de puntuació, `DECLINED` |
| `travel-rule-counterparty-restricted` | La teva decisió sobre la contrapart és `RESTRICTED` | +50 de puntuació, `IN_REVIEW` |
| `travel-rule-counterparty-high-risk` | El nivell de risc de la contrapart (`counterparty_risk_level`) és `HIGH`: una puntuació de diligència deguda inferior a 40, o el teu propi cribratge recent de la contrapart ha trobat una possible coincidència amb sancions o amb mitjans adversos | +40 de puntuació, `IN_REVIEW` |
| `travel-rule-counterparty-high-risk-jurisdiction` | La contrapart està establerta en un país de la llista per defecte d'alt risc (`IRN`, `PRK`, `SYR`, `AFG`, `RUS`, `MMR`) | +60 de puntuació, `IN_REVIEW` |
| `travel-rule-counterparty-unresponsive` | La contrapart ha respost menys del 10 per cent de les sol·licituds de Travel Rule que els clients de Didit li han enviat en els últims 90 dies, de les quals almenys 5 han estat objecte d'una decisió | +30 de puntuació, `IN_REVIEW` |

***

## Intel·ligència de dispositiu i prevenció del frau

Aquestes regles converteixen els senyals del SDK del client (empremta digital del dispositiu, IP, navegador, antiguitat de la sessió) i l'enriquiment del proveïdor en esdeveniments de detecció de frau.

### Empremta digital i multicomptes

| `library_key` | Activador | Acció per defecte |
| - | - | - |
| `multi-accounting-shared-fingerprint` | Una mateixa empremta digital de dispositiu es reutilitza en ≥3 subjectes diferents en 7 dies | +50 punts a la puntuació, `IN_REVIEW` |
| `multiple-device-fingerprints-for-same-subject` | Un subjecte apareix amb ≥3 empremtes digitals diferents en 24 h | +20 punts a la puntuació |
| `same-fingerprint-transaction-burst` | ≥6 transaccions des d'una mateixa empremta digital en 24 h | +30 punts a la puntuació |
| `same-ip-multi-accounting` | Una mateixa adreça IP és compartida per ≥3 subjectes diferents en 7 dies | +30 punts a la puntuació |
| `same-ip-transaction-burst` | ≥6 transaccions des d'una mateixa adreça IP en 24 h | +30 punts a la puntuació |
| `same-fingerprint-multiple-payment-methods` | Una mateixa empremta digital alterna entre ≥4 mètodes de pagament en 7 dies | +30 punts a la puntuació |
| `shared-payment-method-across-subjects` | Un mateix mètode de pagament es reutilitza en ≥3 subjectes diferents en 7 dies | +30 punts a la puntuació |
| `many-ip-addresses-per-subject` | El subjecte utilitza ≥4 adreces IP diferents en 24 h | +30 punts a la puntuació |
| `new-browser-and-new-ip-combination` | El subjecte mostra ≥3 navegadors diferents i ≥3 adreces IP diferents en 24 h | +30 punts a la puntuació |

### IP, xarxa i VPN

| `library_key` | Activador | Acció per defecte |
| - | - | - |
| `vpn-or-proxy-high-value` | Es detecta VPN o proxy en una transferència ≥ \$5,000 | +30 punts a la puntuació |
| `impossible-travel-between-transactions` | El subjecte fa transaccions des de ≥2 països associats a adreces IP diferents en 1 hora | +30 punts a la puntuació |

### Combinació de comportaments

| `library_key` | Activador | Acció per defecte |
| - | - | - |
| `browser-spoofing-password-reuse` | Es detecta suplantació del navegador i ≥2 transaccions que reutilitzen el mateix hash de contrasenya en 30 minuts | +30 punts a la puntuació |
| `remote-access-high-value-transfer` | Es detecta una eina d'accés remot en una transferència ≥ \$5,000 | +30 punts a la puntuació |
| `low-session-age-high-value-transfer` | Transferència ≥ \$5,000 en 30 segons des de l'inici de la sessió | +30 punts a la puntuació |
| `synthetic-identity-fresh-account-high-value` | Un compte obert en els últims 7 dies fa transaccions ≥ \$1,000 | +30 punts a la puntuació |

### Presa de control de comptes i frau APP

| `library_key` | Activador | Acció per defecte |
| - | - | - |
| `recent-pii-change-and-transaction` | Transferència ≥ \$1,000 dins de la finestra de canvi recent de PII | +45 punts a la puntuació, `IN_REVIEW` |
| `new-payment-method-high-value` | Transferència ≥ \$5,000 utilitzant un mètode de pagament afegit en els últims 7 dies | +30 punts a la puntuació |
| `first-time-payee-high-value` | Transferència sortint ≥ \$5,000 a una contrapart a la qual el subjecte mai no ha pagat abans | +40 punts a la puntuació, `IN_REVIEW` |
| `consortium-flagged-counterparty` | Transferència ≥ \$500 la contrapart de la qual ha estat reportada per una altra institució | +60 punts a la puntuació, `IN_REVIEW` |

### Abús d'afiliats i de bonificacions

| `library_key` | Activador | Acció per defecte |
| - | - | - |
| `repeated-bonus-campaign-from-same-fingerprint` | ≥6 transaccions amb la mateixa campanya i empremta digital en 2 h | +35 punts a la puntuació |
| `shared-fingerprint-across-bonus-campaigns` | Una mateixa empremta digital reclama ≥3 campanyes diferents en 7 dies | +30 punts a la puntuació |
| `affiliate-fraud-repeated-fingerprint` | ≥5 transaccions amb el mateix afiliat i empremta digital en 2 h | +30 punts a la puntuació |

***

## Paquet de joc responsable

Per a aplicacions d'iGaming. Aquestes regles estan dissenyades per detectar tant senyals de protecció del jugador com patrons d'abús de bonificacions.

| `library_key` | Activador | Acció per defecte |
| - | - | - |
| `responsible-gaming-rapid-deposits` | ≥10 transaccions entrants de la mateixa acció en 24 h | +20 punts a la puntuació |
| `responsible-gaming-rapid-withdrawals` | ≥8 transaccions de sortida de la mateixa acció en 24 h | +20 punts a la puntuació |
| `responsible-gaming-cumulative-deposits-7d` | Volum entrant ≥ \$5,000 en 7 dies | +20 punts a la puntuació |
| `responsible-gaming-cumulative-withdrawals-7d` | Volum sortint ≥ \$5,000 en 7 dies | +20 punts a la puntuació |
| `responsible-gaming-self-excluded-activity` | Qualsevol transacció d'un compte autoexclòs | +20 punts a la puntuació |
| `responsible-gaming-loss-limit-hit` | L'activitat continua després d'un senyal de límit de pèrdues | +20 punts a la puntuació |
| `responsible-gaming-bonus-hunting` | ≥4 transaccions amb la mateixa campanya i empremta digital en 24 h | +20 punts a la puntuació |
| `responsible-gaming-multiple-payment-methods` | ≥4 mètodes de pagament diferents en 7 dies | +20 punts a la puntuació |
| `responsible-gaming-off-hours-high-value` | Joc marcat com a fora d'horari ≥ \$1,000 | +20 punts a la puntuació |
| `responsible-gaming-failed-withdrawals` | ≥3 intents de retirada fallits | +20 punts a la puntuació |
| `responsible-gaming-many-counterparties` | ≥5 contraparts diferents en 24 h | +20 punts a la puntuació |

***

## Paquet de frau d'iGaming

Per a operadors que envien esdeveniments de monitoratge i també moviments de diners. Aquestes regles fan servir `scope.record_types = ["event"]`, de manera que els clients només amb transaccions no veuen cap canvi de comportament. Quan existeixi una alternativa només per transaccions, instal·la la regla alternativa indicada juntament amb la regla d'esdeveniments fins que la teva integració enviï la categoria d'esdeveniments.

| `library_key` | Activador | Acció per defecte | Alternativa només per transaccions |
| - | - | - | - |
| `igaming-account-takeover-drain` | 3+ inicis de sessió fallits, després un canvi de MFA, després un canvi d'adreça de retirada i després una sol·licitud de retirada, en aquest ordre, dins de 24 h | +90 de puntuació, `DECLINED` | `recent-pii-change-and-transaction`, `new-payment-method-high-value` |
| `igaming-minimal-play-laundering` | Sol·licitud de retirada ≥ \$1,000 mentre les apostes del compte sumen ≤ 5% dels seus dipòsits completats en les 24 h anteriors | +60 de puntuació, `IN_REVIEW` | `rapid-in-and-out-movement` |
| `igaming-chargeback-deposit-ratio` | Els contracàrrecs oberts arriben almenys al 50% dels dipòsits completats en 30 dies | +80 de puntuació, `DECLINED` | `ecommerce-chargeback-indicator` |
| `igaming-chip-dumping-pair-net-winner` | La mateixa parella P2P liquida almenys 2 mans, rondes o partides diferents en 7 dies **i** el resultat net d'un dels dos costats suma ≥ \$400 | +70 de puntuació, `IN_REVIEW` | Es requereix esdeveniment |
| `igaming-opposite-betting-same-market` | Els dos costats de la mateixa partida i del mateix mercat reben apostes de 2+ comptes diferents que comparteixen una empremta de dispositiu, dins d'1 h | +65 de puntuació, `IN_REVIEW` | Es requereix esdeveniment |
| `igaming-bot-rta-cadence` | `session.bot_signal_observed` que informa d'una puntuació de bot ≥ 90 i d'una variància de temps ≤ 10ms | +55 de puntuació, `IN_REVIEW` | Es requereix esdeveniment |
| `igaming-self-exclusion-evasion` | Coincidència al registre d'autoexclusió amb `exclusion_status: active` en un intent de re-registre | +100 de puntuació, `DECLINED` | `responsible-gaming-self-excluded-activity` |
| `igaming-chat-rain-farming` | Segona reclamació del **mateix** bonus de pluja de xat per part d'un compte en 24 h, reclamada en un termini de 500 ms | +45 de puntuació, `IN_REVIEW` | `responsible-gaming-bonus-hunting` |
| `igaming-repeated-bonus-claims-one-device` | Tercera reclamació del **mateix** bonus des d'una mateixa empremta de dispositiu en 7 dies | +50 de puntuació, `IN_REVIEW` | `repeated-bonus-campaign-from-same-fingerprint`, `shared-fingerprint-across-bonus-campaigns`, `responsible-gaming-bonus-hunting` |
| `igaming-affiliate-self-referral` | Atribució a un codi d'afiliat que 3+ comptes diferents han fet servir des d'una mateixa empremta de dispositiu en 7 dies | +50 de puntuació, `IN_REVIEW` | `affiliate-fraud-repeated-fingerprint` |
| `igaming-multi-accounting-device` | Inici de sessió o registre des d'una empremta de dispositiu usada per 3+ comptes diferents en 24 h | +60 de puntuació, `IN_REVIEW` | `multi-accounting-shared-fingerprint` |
| `igaming-shared-proxy-ip` | Inici de sessió des d'una adreça IP usada per 3+ comptes diferents en 24 h | +40 de puntuació, `IN_REVIEW` | `same-ip-multi-accounting` |

### Senyals d'esdeveniment que necessita cada regla

Cada regla anterior llegeix camps d'esdeveniment amb nom. Quan falta un camp obligatori, la regla simplement no coincideix: no fa mai una aproximació del senyal a partir d'una altra cosa, i mai no recorre per si sola a dades de transacció. Envia les claus següents al `payload` i al `device_context` de l'esdeveniment (consulta [Esdeveniments](https://docs.didit.me/ca/transaction-monitoring/events.md) per al contracte complet d'enviament i [Regles d'esdeveniments](https://docs.didit.me/ca/transaction-monitoring/event-rules.md) per a les rutes de camps de les regles).

| `library_key` | Accions d'esdeveniment que llegeix la regla | Camps que necessita la regla |
| - | - | - |
| `igaming-account-takeover-drain` | `security.login_failed`, `security.mfa_changed`, `payment.withdrawal_address_changed`, `payment.withdrawal_requested` | `changed_field`, `withdrawal_address_hash`, i les claus de pagament estàndard |
| `igaming-minimal-play-laundering` | `payment.withdrawal_requested`, `gameplay.bet_placed`, `payment.deposit_completed` | `amount` a cadascun d'aquests esdeveniments |
| `igaming-chargeback-deposit-ratio` | `dispute.chargeback_opened`, `payment.deposit_completed` | `payment_reference_id`, més `dispute_id` o `chargeback_id` |
| `igaming-chip-dumping-pair-net-winner` | `gameplay.p2p_settlement` | `counterparty_vendor_data`, `net_result_amount`, i un dels camps `hand_id` / `round_id` / `match_id` |
| `igaming-opposite-betting-same-market` | `gameplay.bet_placed` | `match_id`, `market_id`, `side`, `device_context.fingerprint` |
| `igaming-bot-rta-cadence` | `session.bot_signal_observed` | `device_context.bot_score`, `timing_variance_ms` |
| `igaming-self-exclusion-evasion` | `responsible_gambling.self_exclusion_match` | `exclusion_status`, `re_registration_attempt`, més el `registry_source` i el `identity_match_ref` obligatoris |
| `igaming-chat-rain-farming` | `bonus.bonus_claimed` | `bonus_id`, `bonus_type`, `claim_delay_ms` |
| `igaming-repeated-bonus-claims-one-device` | `bonus.bonus_claimed` | `bonus_id`, `device_context.fingerprint` |
| `igaming-affiliate-self-referral` | `affiliate.affiliate_attributed` | `affiliate_code`, `device_context.fingerprint` |
| `igaming-multi-accounting-device` | `security.login_succeeded`, o un `security.registration_attempt` personalitzat | `device_context.fingerprint` |
| `igaming-shared-proxy-ip` | `security.login_succeeded` | `device_context.network_context.ip_address` |

Utilitza el paquet `igaming_fraud` quan la teva integració emeti esdeveniments d'inici de sessió, de joc, de bonus, d'afiliació, de pagament, de disputa, de seguretat i de joc responsable. Les regles són d'adhesió voluntària: afegir-les a la biblioteca no les instal·la per a les aplicacions existents i no canvia les predefinicions actives de cap client actual.

***

## Paquet de comerç electrònic

Per a mercats i aplicacions de comerciant registrat.

| `library_key` | Activador | Acció per defecte |
| - | - | - |
| `ecommerce-card-testing-microtransactions` | ≥10 transaccions ≤ \$5 de la mateixa empremta en 1 h | +30 a la puntuació |
| `ecommerce-high-order-velocity` | ≥8 transaccions d'una mateixa empremta en 30 minuts | +30 a la puntuació |
| `ecommerce-chargeback-indicator` | El proveïdor o el flux de treball ha marcat un indicador de contracàrrec | +30 a la puntuació |
| `ecommerce-billing-country-mismatch` | Discrepància del país de facturació en una transacció ≥ \$500 | +30 a la puntuació |
| `ecommerce-shared-payment-method` | Mètode de pagament reutilitzat per ≥3 subjectes de comerç electrònic en 7 dies | +30 a la puntuació |
| `ecommerce-shared-ip-multi-accounting` | Una IP compartida per ≥4 subjectes de comerç electrònic en 24 h | +30 a la puntuació |
| `ecommerce-remote-checkout-high-value` | Accés remot detectat al pagament ≥ \$1,000 | +30 a la puntuació |
| `ecommerce-affiliate-burst` | ≥5 transaccions amb el mateix afiliat i la mateixa empremta en 2 h | +30 a la puntuació |

***

## Paquet de frau amb xecs

Per a aplicacions que envien transaccions de dipòsit de xecs. Cada regla s'activa a partir dels indicadors `custom_values.check_*` que estableix qui fa la sol·licitud quan un xec presenta un senyal de risc conegut (lavatge, MICR absent, número de sèrie inclòs en una llista de la dark web, etc.).

| `library_key` | Activador | Acció per defecte |
| - | - | - |
| `check-amount-out-of-range` | Import del xec marcat com a situat fora del rang normal del compte i ≥ \$1,000 | +40 a la puntuació, `IN_REVIEW` |
| `check-missing-or-invalid-number` | El xec s'ha rebut amb un número de xec que falta, incoherent o no seqüencial | +35 a la puntuació, `IN_REVIEW` |
| `check-duplicate-presentation` | Sembla que el mateix xec s'ha dipositat dues vegades (mòbil i branca) | +70 a la puntuació, `IN_REVIEW` |
| `check-on-dark-web-watchlist` | El número de sèrie o la imatge del xec s'ha trobat en un canal de la dark web o de Telegram que difon xecs robats | +90 a la puntuació, `DECLINED` |
| `check-altered-or-washed` | El xec presenta esborrat químic, alteració MICR o altres indicis de rentat | +70 a la puntuació, `IN_REVIEW` |
| `check-deposit-rapid-multi-bank` | El mateix subjecte diposita xecs en ≥3 bancs contraparts diferents en 24 h (kiting) | +45 a la puntuació, `IN_REVIEW` |

***

## Paquet BNPL

Per a proveïdors de compra ara i paga després (BNPL). Detecta patrons de frau de primera part (impagament) i de compartició d'identificadors propis del crèdit a terminis.

| `library_key` | Activador | Acció per defecte |
| - | - | - |
| `bnpl-failed-repayment-velocity` | ≥2 pagaments fallits recents del subjecte: senyal de frau de primera part | +45 a la puntuació, `IN_REVIEW` |
| `bnpl-shared-identifier-across-accounts` | Telèfon, correu electrònic o adreça vistos en diversos subjectes BNPL diferents | +40 a la puntuació, `IN_REVIEW` |
| `bnpl-high-installment-on-fresh-account` | Quota ≥ \$500 d'un compte obert en els últims 7 dies | +35 a la puntuació |

***

## Referència: estàndards en què es basa la biblioteca

Cada preajust de la biblioteca de Didit correspon a una tipologia d'AML, de frau o de compliment àmpliament acceptada. Els estàndards en què ens basem són:

| Font | Tipologies aportades a la biblioteca |
| - | - |
| **Recomanacions del FATF** | Estructuració, moviment ràpid de fons, exposició a jurisdiccions d'alt risc, cribratge de sancions de contraparts |
| **Avisos del FinCEN** | Llindars d'informes BSA / CTR, reactivació de comptes inactius, patrons sospitosos d'efectiu |
| **Normes de NACHA** | Llindars específics d'ACH i patrons fora d'horari |
| **Principis de Wolfsberg** | Tipologies de banca corresponsal i banca privada |
| **Tipologies del Grup Egmont** | Patrons transfronterers i d'estratificació |
| **Bones pràctiques de la indústria** | Finestres temporals de velocitat, viatge impossible, beneficiari nou, reutilització de l'empremta del dispositiu, senyals de frau de primera part de BNPL |

Didit només implementa les tipologies que són estàndards acceptats de la indústria i exposa tots els llindars perquè els puguis ajustar.

***

## Personalitzar els preajustos

Cada preajust es pot:

* **Ajustable**: permet canviar els llindars, les finestres, els valors de puntuació o les accions per aplicació
* **Desactivable**: permet canviar un preajust al mode `DISABLED`, de manera que deixa d'avaluar-se sense perdre la seva identitat
* **Avaluable**: permet canviar un preajust al mode `TEST` per avaluar-lo en mode d'ombra sense afectar els resultats de les transaccions
* **Ampliable**: permet crear regles personalitzades que complementin o substitueixin els preajustos

Consulta [Regles i puntuació](https://docs.didit.me/ca/transaction-monitoring/rules.md) per conèixer l'anatomia de les regles, els endpoints de l'API i exemples pràctics de creació de regles personalitzades.


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