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

# Libreria di regole KYT: oltre 150 scenari predefiniti

> Oltre 150 regole KYT predefinite di Didit per structuring, velocità, sanzioni e frodi iGaming. 1.000 al mese incluse, poi $0.001 ciascuna.

Didit mette a disposizione una libreria curata di **oltre 150 preset di regole per il monitoraggio delle transazioni** che puoi installare singolarmente o per bundle. Ogni regola corrisponde a una tipologia reale di AML, frode o compliance, tratta da standard globali e linee guida normative: raccomandazioni del FATF, avvisi di FinCEN, regole NACHA, principi Wolfsberg, tipologie dell'Egmont Group e schemi di abuso nell'iGaming.

Scegli i preset o i bundle che ti servono, poi controlla la modalità di ogni regola installata (`ACTIVE`, `TEST` o `DISABLED`). Condizioni, soglie e azioni dei preset sono fisse; crea una regola personalizzata quando ti servono logiche diverse. Disinstalla un preset per rimuoverlo dall'applicazione e reinstallalo in seguito, se necessario.

> [!NOTE]
>
> Le regole della libreria si possono sfogliare, installare e disinstallare da *Transactions -> Rules -> Library* nella Business Console, tramite l'[API della libreria di regole](https://docs.didit.me/it/management-api/transactions/rules-library.md) (`GET /v3/transactions/rules/library/`, `POST`/`DELETE /v3/transactions/rules/install/`), oppure con gli [strumenti MCP](https://docs.didit.me/it/integration/mcp/tools.md) `didit_transaction_rule_library_list`, `didit_transaction_rule_install` e `didit_transaction_rule_uninstall`. I preset installati accettano solo modifiche a `mode` (attiva, disattiva, test); le loro soglie sono fisse: per modificarne una, crea una [regola personalizzata](https://docs.didit.me/it/transaction-monitoring/rules.md#creazione-di-regole-personalizzate). Per capire come le regole contribuiscono allo scoring, vedi [punteggio di rischio](https://docs.didit.me/it/transaction-monitoring/risk-scoring.md).

> [!NOTE]
>
> Una regola della libreria le cui condizioni leggono dati che il motore delle regole non può ancora valutare è **sospesa** finché non può essere eseguita: la libreria non la elenca, una richiesta che la nomina in `library_keys` restituisce `400` e non installa nulla (una chiave sconosciuta viene invece saltata), e un'installazione `bundle` la salta. Una copia installata in precedenza viene disattivata (`DISABLED`) e resta nell'elenco delle tue regole, e una richiesta che imposta il suo `mode` su un altro valore restituisce `400`. Una regola sospesa torna disponibile da sola non appena il motore delle regole può valutarne le condizioni, quindi l'elenco della libreria mostra sempre le regole che puoi installare oggi.

## Come sono organizzati i preset

Ogni preset appartiene a un **bundle** (la sua famiglia funzionale) e a una **categoria** (il tema di rischio più ampio). I bundle ti permettono di attivare o disattivare insieme regole correlate dalla console; le categorie determinano il punteggio e il reporting.

| Bundle | Cosa copre |
| - | - |
| `finance` | Strutturazione, transazioni di importo elevato, volume cumulativo, distribuzione per paese, layering, fan-in dei money mule, smurfing |
| `aml_ctf` | Sanzioni, riferimenti di pagamento sospetti, layering con importi tondi, entrate e uscite rapide |
| `aml_monitoring` | Esposizione a origini dei fondi ad alto rischio derivata dalla blockchain, finanziamento del terrorismo, sfruttamento minorile |
| `anomaly_detection` | Velocità elevata, riattivazione di conti dormienti, attività fuori orario |
| `fatf` | Esposizione a giurisdizioni ad alto rischio |
| `device_intelligence` | Riutilizzo dell'impronta del dispositivo, account con più impronte, anomalie di IP e browser, VPN/proxy, spostamenti impossibili |
| `fraud_prevention_multi_accounting` | Impronte condivise tra soggetti distinti |
| `fraud_prevention_app` | Segnali di pagamento push autorizzato, nuovo beneficiario, vittima di truffa |
| `fraud_prevention_ato` | Segnali composti di account takeover (modifica dei dati personali, nuovo metodo di pagamento) |
| `fraud_prevention_consortium` | Controparti segnalate da altri istituti nella rete condivisa |
| `crypto_monitoring` | Esposizione a wallet di mixer, darknet e sanzionati, chain hopping, wallet in autocustodia, lacune dei VASP |
| `travel_rule` | Obblighi della Travel Rule globali e regionali (12 regimi) e due diligence sui VASP controparti |
| `travel_rule_eu_tfr` | Controlli TFR dell'UE: discrepanza dei dati della controparte, titolarità del wallet non verificata, VASP controparte non identificato, conferma scaduta |
| `responsible_gaming` | Limiti di deposito e prelievo per il gioco sicuro, autoesclusione, gioco fuori orario |
| `igaming_fraud` | Abuso di bonus specifico degli eventi, scommesse opposte, frode di affiliazione, farming tramite chat rain, chip dumping, account takeover |
| `e_commerce` | Test di carte con microtransazioni, indicatori di storno, mancata corrispondenza del paese di fatturazione, picchi di affiliazione |
| `check_fraud` | Assegni fuori intervallo, senza numero, presentati più volte, presenti in watchlist del dark web, alterati, kiting |
| `bnpl` | Frode commessa dal cliente per mancato rimborso delle rate, identificativi condivisi tra account BNPL, rate su conti appena aperti |

## Come leggere questa pagina

Ogni regola elenca il suo `library_key` (identificatore stabile che puoi usare nell'API o nell'URL della console), le condizioni e l'aggregazione che la fanno scattare, e le azioni predefinite che esegue. Le soglie numeriche mostrate qui sono i valori predefiniti: ogni valore è modificabile per ciascuna applicazione senza perdere l'identità della regola.

***

## Bundle finanziario

Queste regole si applicano a ogni transazione con `transaction_type = FINANCE`. Modellano la base normativa (soglie di segnalazione BSA/FinCEN, euristiche FATF sulla velocità) e i pattern di money mule e smurfing.

### Strutturazione e soglie prossime

| `library_key` | Trigger | Azione predefinita |
| - | - | - |
| `structuring-inbound` | ≥20 trasferimenti in entrata di importo inferiore a \$10,000 dallo stesso soggetto entro 30 giorni | +35 punteggio |
| `structuring-outbound` | ≥20 trasferimenti in uscita di importo inferiore a \$10,000 dallo stesso soggetto entro 30 giorni | +35 punteggio |
| `single-transaction-just-below-threshold` | Una singola transazione tra $9,000 e $9,999 | +25 punteggio |
| `round-amount-layering` | L'importo del trasferimento corrisponde a un valore sospettosamente tondo ($10k, $25k, $50k, $100k, $250k, $500k, \$1M…) | +20 punteggio |

### Volume e velocità

| `library_key` | Trigger | Azione predefinita |
| - | - | - |
| `large-single-transaction` | Singola transazione ≥ \$25,000 | +50 punteggio, `IN_REVIEW` |
| `cumulative-outbound-volume` | Volume in uscita ≥ \$100,000 in 30 giorni | +45 punteggio, `IN_REVIEW` |
| `cumulative-inbound-volume-90d` | Volume in entrata ≥ \$200,000 in 90 giorni | +30 punteggio, `IN_REVIEW` |
| `cumulative-outbound-volume-7d` | Volume in uscita ≥ \$50,000 in 7 giorni | +30 punteggio, `IN_REVIEW` |
| `business-4h-inbound-volume` | Volume in entrata dell'azienda ≥ \$30,000 in una qualsiasi finestra di 4 ore | +30 punteggio, `IN_REVIEW` |
| `business-4h-outbound-volume` | Volume in uscita dell'azienda ≥ \$30,000 in una qualsiasi finestra di 4 ore | +30 punteggio, `IN_REVIEW` |
| `high-velocity-inbound` | ≥20 transazioni in entrata in 7 giorni | +25 punteggio |
| `high-velocity-outbound` | ≥20 transazioni in uscita in 7 giorni | +25 punteggio |

### Layering, mule e smurfing

| `library_key` | Trigger | Azione predefinita |
| - | - | - |
| `rapid-in-and-out-movement` | Un'uscita preceduta da un'entrata entro 6 ore | +60 punteggio, `IN_REVIEW` |
| `cash-deposit-followed-by-withdrawal` | Depositi in contanti ≥ \$50,000 in 72 ore seguiti da un prelievo in contanti | +30 punteggio, `IN_REVIEW` |
| `money-mule-fan-in-to-counterparty` | Una controparte riceve trasferimenti da ≥5 soggetti distinti in 7 giorni | +30 punteggio, `IN_REVIEW` |
| `rapid-repeated-payments-same-counterparty` | ≥5 trasferimenti in uscita verso la stessa controparte in 24 ore | +30 punteggio, `IN_REVIEW` |
| `cross-border-small-amount-velocity` | Un soggetto invia importi inferiori a \$1,000 a ≥4 paesi distinti delle controparti in 24 ore | +30 punteggio, `IN_REVIEW` |
| `high-risk-jurisdiction-smurfing` | ≥5 trasferimenti in uscita di importo inferiore a \$1,000 verso lo stesso paese ad alto rischio in 7 giorni | +30 punteggio, `IN_REVIEW` |
| `many-unique-counterparties-24h` | Il soggetto effettua transazioni con ≥6 controparti distinte in 24 ore | +30 punteggio, `IN_REVIEW` |
| `many-unique-payment-methods-7d` | Il soggetto alterna ≥4 metodi di pagamento distinti in 7 giorni | +30 punteggio, `IN_REVIEW` |
| `counterparty-country-spread-24h` | Il soggetto effettua transazioni con ≥4 paesi distinti delle controparti in 24 ore | +30 punteggio, `IN_REVIEW` |

### Anomalie comportamentali

| `library_key` | Trigger | Azione predefinita |
| - | - | - |
| `dormant-account-reactivation` | Prima transazione ≥ \$1,000 dopo ≥365 giorni di inattività | +20 punteggio |
| `off-hours-high-value-finance` | Trasferimento di valore elevato (≥ \$5,000) contrassegnato come fuori orario per la località del soggetto | +25 punteggio |

***

## Bundle AML / CTF

Queste regole modellano le tipologie classiche AML/CTF che non dipendono dall'arricchimento blockchain: si applicano in modo universale ai trasferimenti in valuta fiat e crypto.

| `library_key` | Trigger | Azione predefinita |
| - | - | - |
| `sanctions-counterparty` | Il wallet sottoposto a screening è a sua volta attribuito a un'entità sanzionata (`wallet_sanctioned`). La sola esposizione non attiva la regola | +90 punteggio, `DECLINED` |
| `sanctions-exposure-review` | Il wallet sottoposto a screening ha trasferito fondi da o verso entità sanzionate senza essere a sua volta sanzionato | +50 punteggio, `IN_REVIEW` |
| `suspicious-payment-reference` | Il riferimento del pagamento contiene parole chiave legate a proventi illeciti | +45 punteggio, `IN_REVIEW` |
| `high-risk-jurisdiction-exposure` | Il paese della controparte o il paese dell'IP del soggetto figura nella lista dei paesi ad alto rischio | +40 punteggio, `IN_REVIEW` |
| `high-risk-inbound-single` | Entrata ≥ \$20,000 da un paese ad alto rischio | +30 punteggio, `IN_REVIEW` |
| `high-risk-outbound-single` | Uscita ≥ \$20,000 verso un paese ad alto rischio | +30 punteggio, `IN_REVIEW` |

La lista predefinita dei paesi ad alto rischio comprende i territori soggetti all'invito all'azione della FATF e le regioni interessate da conflitti: `IRN`, `PRK`, `SYR`, `AFG`, `RUS`, `MMR`. Puoi sovrascrivere la lista per ogni applicazione.

> [!NOTE]
>
> **La copertura PEP per le controparti non è al momento offerta.** Nessun provider di screening collegato segnala se una controparte è una persona politicamente esposta: il campo `pep_counterparty` è `null` in ogni risultato di screening attuale (vedi [screening dei wallet](https://docs.didit.me/it/transaction-monitoring/wallet-screening.md#risposta)), quindi la libreria non ha alcuna preimpostazione PEP per le controparti. Una regola installata prima che la preimpostazione fosse ritirata continua a essere valutata, ma non può corrispondere a uno screening reale: rimuovila o sostituiscila con una regola personalizzata se devi agire su un altro segnale.

***

## Bundle screening crypto

Queste regole utilizzano i dati arricchiti prodotti dallo screening crypto di Didit: sono più utili per le applicazioni native crypto e per i VASP.

| `library_key` | Trigger | Azione predefinita |
| - | - | - |
| `aml-high-risk-source-exposure` | ≥30% dei fondi di origine provengono da categorie sanzionate, darknet, rubate, ransomware o truffe | +70 punteggio, `IN_REVIEW` |
| `aml-multiple-risky-counterparties` | ≥3 connessioni con entità ad alto rischio nel grafo dell'origine dei fondi | +50 punteggio, `IN_REVIEW` |
| `aml-terrorist-financing-exposure` | Qualsiasi esposizione a finanziamento del terrorismo sul wallet | +100 punteggio, `DECLINED` |
| `aml-child-exploitation-exposure` | Qualsiasi esposizione a materiale di sfruttamento minorile sul wallet | +100 punteggio, `DECLINED` |
| `aml-wallet-risk-score-medium` | Punteggio di rischio del wallet fornito dal provider compreso tra 40 e 70 | +30 punteggio |

***

## Pacchetto di monitoraggio crypto

Regole di esposizione a livello di wallet, oltre a controlli di integrità relativi ai VASP e correlati alla Travel Rule.

| `library_key` | Trigger | Azione predefinita |
| - | - | - |
| `crypto-mixer-exposure` | Wallet collegato a un mixer o a un servizio di offuscamento | +80 al punteggio, `IN_REVIEW` |
| `crypto-darknet_market-exposure` | Esposizione a un wallet di un mercato darknet | +80 al punteggio, `IN_REVIEW` |
| `crypto-sanctioned-exposure` | Esposizione a un wallet sanzionato | +90 al punteggio, `IN_REVIEW` |
| `crypto-stolen_funds-exposure` | Esposizione a un wallet con fondi rubati | +85 al punteggio, `IN_REVIEW` |
| `crypto-scam-exposure` | Esposizione a un wallet di truffa | +70 al punteggio, `IN_REVIEW` |
| `crypto-ransomware-exposure` | Esposizione a un wallet di ransomware | +90 al punteggio, `IN_REVIEW` |
| `crypto-hacked_exchange-exposure` | Esposizione a un wallet di un exchange compromesso | +80 al punteggio, `IN_REVIEW` |
| `crypto-gambling_unlicensed-exposure` | Esposizione a un wallet di gioco d'azzardo non autorizzato | +60 al punteggio, `IN_REVIEW` |
| `high-risk-wallet-exposure` | Il rischio del wallet è associato a un mercato darknet, a sanzioni o a fondi rubati | +70 al punteggio, `IN_REVIEW` |
| `crypto-wallet-risk-score-critical` | Punteggio del wallet del provider ≥ 90 | +90 al punteggio, `IN_REVIEW` |
| `crypto-wallet-risk-score-high` | Punteggio del wallet del provider ≥ 70 | +60 al punteggio, `IN_REVIEW` |
| `crypto-unhosted-wallet-large-outbound` | Uscita ≥ \$1,000 verso un wallet in autocustodia | +45 al punteggio, `IN_REVIEW` |
| `crypto-repeated-unhosted-wallet-withdrawals` | ≥5 trasferimenti in uscita verso wallet in autocustodia in 24 ore | +35 al punteggio, `IN_REVIEW` |
| `crypto-many-new-wallets-per-subject` | Il soggetto invia fondi a ≥5 wallet distinti in 24 ore | +40 al punteggio, `IN_REVIEW` |
| `crypto-chain-hopping-pattern` | Lo stesso soggetto sposta fondi su ≥3 blockchain in 24 ore | +45 al punteggio, `IN_REVIEW` |
| `crypto-missing-vasp-id-high-value` | Trasferimento con un wallet ospitato ≥ \$1,000 senza identificativo VASP | +30 al punteggio, `IN_REVIEW` |

***

## Pacchetto Travel Rule

Le regole Travel Rule si applicano solo alle transazioni `travelRule`.
Ogni regime regionale include quattro regole (controparte in attesa, azione in attesa, dati mancanti, scambio non riuscito).

### Travel Rule globale

| `library_key` | Trigger | Azione predefinita |
| - | - | - |
| `travel-rule-pending-counterparty` | Lo stato è `AWAITING_COUNTERPARTY` (in attesa del VASP della controparte) | +35 al punteggio, `IN_REVIEW` |
| `travel-rule-pending-action` | Lo stato è `ON_HOLD` (su un exchange gestito, un trasferimento in entrata in attesa che tu lo risolva: nessuna corrispondenza nella rubrica dei wallet oppure una richiesta in attesa di approvazione manuale) | +35 al punteggio, `AWAITING_USER` |
| `travel-rule-missing-required-data` | `travel_rule_required` è `true` e `travel_rule_obligations_count` è maggiore di `0`; solo i dati Travel Rule che registri tu stesso in `travel_rule_details` hanno un conteggio degli obblighi, quindi questa regola non si attiva mai su un trasferimento eseguito dall'exchange gestito | +50 al punteggio, `IN_REVIEW` |

### Regimi regionali

Lo stesso modello di quattro regole si applica a ogni regime. Sostituisci `<regime>` con uno dei seguenti valori: `australia`, `dubai`, `eu`, `hong_kong`, `india`, `indonesia`, `japan`, `kazakhstan`, `singapore`, `south_africa`, `turkey`, `uk`.

L'assegnazione del regime è automatica: Didit imposta `custom_values.travel_rule_regime` su ogni transazione Travel Rule in base al campo `jurisdiction` delle tue [impostazioni Travel Rule](https://docs.didit.me/it/transaction-monitoring/travel-rule.md#configurazione): `SG` → `singapore`, `GB` → `uk`, e qualsiasi codice di uno Stato membro UE o SEE, come `DE` o `FR`, → `eu`. I codici senza un bundle regionale vengono convertiti in minuscolo (`US` → `us`), così le regole personalizzate possono comunque applicarsi a essi. Un valore `props.travel_rule_regime` inviato nella transazione sostituisce sempre il regime derivato.

| Modello di `library_key` | Trigger |
| - | - |
| `travel-rule-<regime>-pending-counterparty` | Trasferimento con regime assegnato in attesa del VASP della controparte |
| `travel-rule-<regime>-pending-action` | Trasferimento con regime assegnato in stato `ON_HOLD` |
| `travel-rule-<regime>-missing-required-data` | Trasferimento con regime assegnato soggetto alla Travel Rule ma non ancora risolto |
| `travel-rule-<regime>-failed-exchange` | Trasferimento con regime assegnato in stato `CANCELLED` |

Sono quindi 48 regole specifiche per regione, che si aggiungono alle tre regole Travel Rule globali e alle cinque regole sulla controparte qui sotto.
Il bundle separato `travel_rule_eu_tfr` aggiunge quattro regole EU TFR, descritte in [Pacchetto di regole EU TFR](https://docs.didit.me/it/transaction-monitoring/travel-rule.md#bundle-di-regole-tfr-ue).

### Due diligence sulla controparte

Queste regole leggono ciò che la tua applicazione sa della VASP controparte con cui l'exchange è entrato in contatto: la tua decisione su di essa, il suo livello di rischio di due diligence, il suo paese e la sua reattività.
Consulta [Due diligence sulla controparte](https://docs.didit.me/it/transaction-monitoring/travel-rule.md#due-diligence-sulla-controparte) per sapere da dove provengono i singoli valori.

| `library_key` | Trigger | Azione predefinita |
| - | - | - |
| `travel-rule-counterparty-blocked` | La tua decisione sulla controparte (`counterparty_dd_status`) è `BLOCKED` | +90 al punteggio, `DECLINED` |
| `travel-rule-counterparty-restricted` | La tua decisione sulla controparte è `RESTRICTED` | +50 al punteggio, `IN_REVIEW` |
| `travel-rule-counterparty-high-risk` | Il livello di rischio della controparte (`counterparty_risk_level`) è `HIGH`: un punteggio di due diligence inferiore a 40, oppure il tuo screening aggiornato della controparte ha rilevato una possibile corrispondenza con sanzioni o notizie negative | +40 al punteggio, `IN_REVIEW` |
| `travel-rule-counterparty-high-risk-jurisdiction` | La controparte è stabilita in un paese presente nella lista predefinita ad alto rischio (`IRN`, `PRK`, `SYR`, `AFG`, `RUS`, `MMR`) | +60 al punteggio, `IN_REVIEW` |
| `travel-rule-counterparty-unresponsive` | La controparte ha risposto a meno del 10 per cento delle richieste Travel Rule che i clienti di Didit le hanno inviato negli ultimi 90 giorni, con almeno 5 richieste decise | +30 al punteggio, `IN_REVIEW` |

***

## Intelligenza dei dispositivi e prevenzione delle frodi

Queste regole trasformano i segnali provenienti dall'SDK lato client (fingerprint del dispositivo, IP, browser, anzianità della sessione) e dall'arricchimento fornito dal provider in eventi di rilevamento delle frodi.

### Fingerprint del dispositivo e account multipli

| `library_key` | Trigger | Azione predefinita |
| - | - | - |
| `multi-accounting-shared-fingerprint` | Un fingerprint del dispositivo riutilizzato da ≥3 soggetti distinti in 7 giorni | +50 al punteggio, `IN_REVIEW` |
| `multiple-device-fingerprints-for-same-subject` | Un soggetto compare con ≥3 fingerprint distinti in 24 ore | +20 al punteggio |
| `same-fingerprint-transaction-burst` | ≥6 transazioni da un fingerprint in 24 ore | +30 al punteggio |
| `same-ip-multi-accounting` | Un IP condiviso da ≥3 soggetti distinti in 7 giorni | +30 al punteggio |
| `same-ip-transaction-burst` | ≥6 transazioni da un IP in 24 ore | +30 al punteggio |
| `same-fingerprint-multiple-payment-methods` | Un fingerprint che utilizza alternativamente ≥4 metodi di pagamento in 7 giorni | +30 al punteggio |
| `shared-payment-method-across-subjects` | Un metodo di pagamento riutilizzato da ≥3 soggetti distinti in 7 giorni | +30 al punteggio |
| `many-ip-addresses-per-subject` | Il soggetto usa ≥4 IP distinti in 24 ore | +30 al punteggio |
| `new-browser-and-new-ip-combination` | Il soggetto mostra ≥3 browser distinti E ≥3 IP distinti in 24 ore | +30 al punteggio |

### IP, rete e VPN

| `library_key` | Trigger | Azione predefinita |
| - | - | - |
| `vpn-or-proxy-high-value` | VPN o proxy rilevato su un trasferimento ≥ \$5,000 | +30 al punteggio |
| `impossible-travel-between-transactions` | Il soggetto effettua transazioni da ≥2 paesi distinti associati agli indirizzi IP entro 1 ora | +30 al punteggio |

### Composito comportamentale

| `library_key` | Trigger | Azione predefinita |
| - | - | - |
| `browser-spoofing-password-reuse` | Spoofing del browser rilevato E ≥2 transazioni che riutilizzano lo stesso hash della password in 30 minuti | +30 al punteggio |
| `remote-access-high-value-transfer` | Strumento di accesso remoto rilevato su un trasferimento ≥ \$5,000 | +30 al punteggio |
| `low-session-age-high-value-transfer` | Trasferimento ≥ \$5,000 entro 30 secondi dall'inizio della sessione | +30 al punteggio |
| `synthetic-identity-fresh-account-high-value` | Un account aperto negli ultimi 7 giorni effettua transazioni ≥ \$1,000 | +30 al punteggio |

### Presa di controllo dell'account e frode APP

| `library_key` | Trigger | Azione predefinita |
| - | - | - |
| `recent-pii-change-and-transaction` | Trasferimento ≥ \$1,000 entro la finestra successiva a una modifica recente dei dati personali (PII) | +45 al punteggio, `IN_REVIEW` |
| `new-payment-method-high-value` | Trasferimento ≥ \$5,000 con un metodo di pagamento aggiunto negli ultimi 7 giorni | +30 al punteggio |
| `first-time-payee-high-value` | In uscita ≥ \$5,000 verso una controparte a cui il soggetto non ha mai effettuato pagamenti in precedenza | +40 al punteggio, `IN_REVIEW` |
| `consortium-flagged-counterparty` | Trasferimento ≥ \$500 la cui controparte è stata segnalata da un'altra istituzione | +60 al punteggio, `IN_REVIEW` |

### Abuso di affiliati e bonus

| `library_key` | Trigger | Azione predefinita |
| - | - | - |
| `repeated-bonus-campaign-from-same-fingerprint` | ≥6 transazioni sulla stessa campagna + fingerprint in 2 ore | +35 al punteggio |
| `shared-fingerprint-across-bonus-campaigns` | Un fingerprint richiede ≥3 campagne distinte in 7 giorni | +30 al punteggio |
| `affiliate-fraud-repeated-fingerprint` | ≥5 transazioni sullo stesso affiliato + fingerprint in 2 ore | +30 al punteggio |

***

## Pacchetto gioco responsabile

Per le applicazioni iGaming. Queste regole sono progettate per rilevare sia i segnali di tutela del giocatore sia i pattern di abuso dei bonus.

| `library_key` | Trigger | Azione predefinita |
| - | - | - |
| `responsible-gaming-rapid-deposits` | ≥10 transazioni in entrata della stessa azione in 24 ore | +20 al punteggio |
| `responsible-gaming-rapid-withdrawals` | ≥8 transazioni in uscita della stessa azione in 24 ore | +20 al punteggio |
| `responsible-gaming-cumulative-deposits-7d` | Volume in entrata ≥ \$5,000 in 7 giorni | +20 al punteggio |
| `responsible-gaming-cumulative-withdrawals-7d` | Volume in uscita ≥ \$5,000 in 7 giorni | +20 al punteggio |
| `responsible-gaming-self-excluded-activity` | Qualsiasi transazione da un account autoescluso | +20 al punteggio |
| `responsible-gaming-loss-limit-hit` | L'attività continua dopo un segnale relativo al limite di perdita | +20 al punteggio |
| `responsible-gaming-bonus-hunting` | ≥4 transazioni con stessa campagna + stesso fingerprint in 24 ore | +20 al punteggio |
| `responsible-gaming-multiple-payment-methods` | ≥4 metodi di pagamento distinti in 7 giorni | +20 al punteggio |
| `responsible-gaming-off-hours-high-value` | Gioco etichettato come fuori orario ≥ \$1,000 | +20 al punteggio |
| `responsible-gaming-failed-withdrawals` | ≥3 tentativi di prelievo falliti | +20 al punteggio |
| `responsible-gaming-many-counterparties` | ≥5 controparti distinte in 24 ore | +20 al punteggio |

***

## Pacchetto antifrode per l'iGaming

Per gli operatori che inviano eventi di monitoraggio oltre ai movimenti di denaro. Queste regole usano `scope.record_types = ["event"]`, quindi i clienti che usano solo transazioni non vedono alcuna variazione di comportamento. Dove esiste un fallback solo transazioni, installa la regola di fallback indicata insieme alla regola evento finché la tua integrazione non invia la categoria evento.

| `library_key` | Trigger | Azione predefinita | Fallback solo transazioni |
| - | - | - | - |
| `igaming-account-takeover-drain` | 3+ accessi falliti, poi una modifica MFA, poi una modifica dell'indirizzo di prelievo, poi una richiesta di prelievo - in quest'ordine, entro 24h | punteggio +90, `DECLINED` | `recent-pii-change-and-transaction`, `new-payment-method-high-value` |
| `igaming-minimal-play-laundering` | Richiesta di prelievo ≥ \$1,000 mentre le puntate dell'account totalizzano ≤ 5% dei depositi completati nelle 24h precedenti | punteggio +60, `IN_REVIEW` | `rapid-in-and-out-movement` |
| `igaming-chargeback-deposit-ratio` | I chargeback aperti raggiungono almeno il 50% dei depositi completati in 30 giorni | punteggio +80, `DECLINED` | `ecommerce-chargeback-indicator` |
| `igaming-chip-dumping-pair-net-winner` | La stessa coppia P2P conclude almeno 2 mani, round o partite distinti in 7 giorni **e** il risultato netto di un lato ammonta ad almeno \$400 | punteggio +70, `IN_REVIEW` | Evento richiesto |
| `igaming-opposite-betting-same-market` | Entrambi i lati dello stesso match e dello stesso mercato sostenuti da 2+ account distinti che condividono un unico fingerprint del dispositivo, entro 1h | punteggio +65, `IN_REVIEW` | Evento richiesto |
| `igaming-bot-rta-cadence` | `session.bot_signal_observed` che riporta un punteggio bot ≥ 90 e una varianza dei tempi ≤ 10ms | punteggio +55, `IN_REVIEW` | Evento richiesto |
| `igaming-self-exclusion-evasion` | Corrispondenza nel registro di autoesclusione con `exclusion_status: active` in un tentativo di riregistrazione | punteggio +100, `DECLINED` | `responsible-gaming-self-excluded-activity` |
| `igaming-chat-rain-farming` | Secondo riscatto dello **stesso** bonus chat-rain da parte di un account in 24h, riscattato entro 500ms | punteggio +45, `IN_REVIEW` | `responsible-gaming-bonus-hunting` |
| `igaming-repeated-bonus-claims-one-device` | Terzo riscatto dello **stesso** bonus da un unico fingerprint del dispositivo in 7 giorni | punteggio +50, `IN_REVIEW` | `repeated-bonus-campaign-from-same-fingerprint`, `shared-fingerprint-across-bonus-campaigns`, `responsible-gaming-bonus-hunting` |
| `igaming-affiliate-self-referral` | Attribuzione a un codice affiliato usato da 3+ account distinti da un unico fingerprint del dispositivo in 7 giorni | punteggio +50, `IN_REVIEW` | `affiliate-fraud-repeated-fingerprint` |
| `igaming-multi-accounting-device` | Login o registrazione da un fingerprint del dispositivo usato da 3+ account distinti in 24h | punteggio +60, `IN_REVIEW` | `multi-accounting-shared-fingerprint` |
| `igaming-shared-proxy-ip` | Login da un indirizzo IP usato da 3+ account distinti in 24h | punteggio +40, `IN_REVIEW` | `same-ip-multi-accounting` |

### Segnali evento richiesti da ogni regola

Ogni regola sopra legge campi evento con nome specifico. Quando un campo richiesto è assente, la regola semplicemente non trova corrispondenza: non approssima mai il segnale utilizzando altri dati, e non ricorre mai da sola ai dati della transazione. Invia le chiavi indicate di seguito nel `payload` e nel `device_context` dell'evento (vedi [Eventi](https://docs.didit.me/it/transaction-monitoring/events.md) per il contratto completo di invio e [Regole sugli eventi](https://docs.didit.me/it/transaction-monitoring/event-rules.md) per i percorsi dei campi delle regole).

| `library_key` | Azioni degli eventi esaminate | Campi richiesti dalla regola |
| - | - | - |
| `igaming-account-takeover-drain` | `security.login_failed`, `security.mfa_changed`, `payment.withdrawal_address_changed`, `payment.withdrawal_requested` | `changed_field`, `withdrawal_address_hash`, e le chiavi di pagamento standard |
| `igaming-minimal-play-laundering` | `payment.withdrawal_requested`, `gameplay.bet_placed`, `payment.deposit_completed` | `amount` in ciascuno di questi eventi |
| `igaming-chargeback-deposit-ratio` | `dispute.chargeback_opened`, `payment.deposit_completed` | `payment_reference_id`, oltre a `dispute_id` o `chargeback_id` |
| `igaming-chip-dumping-pair-net-winner` | `gameplay.p2p_settlement` | `counterparty_vendor_data`, `net_result_amount`, e uno tra `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`, oltre a `registry_source` e `identity_match_ref` obbligatori |
| `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`, oppure un `security.registration_attempt` personalizzato | `device_context.fingerprint` |
| `igaming-shared-proxy-ip` | `security.login_succeeded` | `device_context.network_context.ip_address` |

Usa il pacchetto `igaming_fraud` quando la tua integrazione emette eventi di login, gameplay, bonus, affiliazione, pagamento, contestazione, sicurezza e gioco responsabile. Le regole restano opt-in: aggiungerle alla libreria non le installa per le applicazioni esistenti e non modifica i preset attuali di nessun cliente.

***

## Bundle e-commerce

Per marketplace e applicazioni con merchant of record.

| `library_key` | Trigger | Azione predefinita |
| - | - | - |
| `ecommerce-card-testing-microtransactions` | ≥10 transazioni ≤ \$5 dallo stesso fingerprint in 1h | +30 punti |
| `ecommerce-high-order-velocity` | ≥8 transazioni su un fingerprint in 30 minuti | +30 punti |
| `ecommerce-chargeback-indicator` | Il provider o il workflow ha segnalato un indicatore di chargeback | +30 punti |
| `ecommerce-billing-country-mismatch` | Mancata corrispondenza del paese di fatturazione su una transazione ≥ \$500 | +30 punti |
| `ecommerce-shared-payment-method` | Metodo di pagamento riutilizzato da ≥3 soggetti e-commerce in 7 giorni | +30 punti |
| `ecommerce-shared-ip-multi-accounting` | Un IP condiviso da ≥4 soggetti e-commerce in 24h | +30 punti |
| `ecommerce-remote-checkout-high-value` | Accesso remoto rilevato al checkout ≥ \$1,000 | +30 punti |
| `ecommerce-affiliate-burst` | ≥5 transazioni sullo stesso affiliato e fingerprint in 2h | +30 punti |

***

## Bundle frode sugli assegni

Per le applicazioni che inviano transazioni di deposito di assegni. Ogni regola si attiva con i flag `custom_values.check_*` che il chiamante imposta quando un assegno presenta un segnale di rischio noto (lavaggio, MICR mancante, numero seriale presente in liste del dark web, ecc.).

| `library_key` | Trigger | Azione predefinita |
| - | - | - |
| `check-amount-out-of-range` | Importo dell'assegno segnalato come fuori dall'intervallo normale del conto E ≥ \$1,000 | +40 punti, `IN_REVIEW` |
| `check-missing-or-invalid-number` | L'assegno è arrivato con un numero di assegno mancante, incoerente o non sequenziale | +35 punti, `IN_REVIEW` |
| `check-duplicate-presentation` | Lo stesso assegno risulta depositato due volte (da mobile + in filiale) | +70 punti, `IN_REVIEW` |
| `check-on-dark-web-watchlist` | Numero seriale o immagine dell'assegno trovati in un feed di assegni rubati sul dark web o su Telegram | +90 punti, `DECLINED` |
| `check-altered-or-washed` | L'assegno presenta cancellazione chimica, alterazione MICR o altre prove di lavaggio | +70 punti, `IN_REVIEW` |
| `check-deposit-rapid-multi-bank` | Lo stesso soggetto deposita assegni presso ≥3 banche controparti distinte entro 24h (kiting) | +45 punti, `IN_REVIEW` |

***

## Bundle BNPL

Per i provider buy-now-pay-later. Individua la frode del cliente (mancato pagamento) e gli schemi di condivisione di identificativi specifici del credito rateale.

| `library_key` | Trigger | Azione predefinita |
| - | - | - |
| `bnpl-failed-repayment-velocity` | ≥2 rimborsi rateali falliti recenti sul soggetto: segnale di frode del cliente | +45 punti, `IN_REVIEW` |
| `bnpl-shared-identifier-across-accounts` | Telefono, email o indirizzo visti su più soggetti BNPL distinti | +40 punti, `IN_REVIEW` |
| `bnpl-high-installment-on-fresh-account` | Rata ≥ \$500 da un conto aperto negli ultimi 7 giorni | +35 punti |

***

## Riferimento: standard alla base della libreria

Ogni preset della libreria di Didit corrisponde a una tipologia AML, di frode o di compliance ampiamente riconosciuta. Gli standard di riferimento sono:

| Fonte | Tipologie apportate alla libreria |
| - | - |
| **Raccomandazioni FATF** | Frazionamento, rapido movimento di fondi, esposizione a giurisdizioni ad alto rischio, screening delle sanzioni sulle controparti |
| **Avvisi FinCEN** | Soglie di segnalazione BSA / CTR, riattivazione di conti dormienti, schemi sospetti di operazioni in contanti |
| **Regole NACHA** | Soglie specifiche ACH e schemi fuori orario |
| **Principi Wolfsberg** | Tipologie di attività di banca corrispondente e di private banking |
| **Tipologie del Gruppo Egmont** | Schemi transfrontalieri e di stratificazione |
| **Best practice di settore** | Finestre temporali per la frequenza delle transazioni, viaggi impossibili, beneficiario alla prima transazione, riutilizzo del fingerprint del dispositivo, segnali di frode del cliente BNPL |

Didit implementa solo le tipologie riconosciute come standard di settore e rende ogni soglia modificabile.

***

## Personalizzazione dei preset

Ogni preset può essere:

* **Personalizzato**: modificare le soglie, le finestre, i valori di punteggio o le azioni per applicazione
* **Disabilitato**: impostare un preset in modalità `DISABLED` e smette di valutare senza perdere la propria identità
* **Testato**: impostare un preset in modalità `TEST` per valutarlo in modalità shadow senza influire sugli esiti delle transazioni
* **Esteso**: creare regole personalizzate che integrano o sostituiscono i preset

Consulta [Rules & scoring](https://docs.didit.me/it/transaction-monitoring/rules.md) per la struttura delle regole, gli endpoint API e gli esempi svolti di creazione di regole personalizzate.


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