Libreria di regole KYT: oltre 150 scenari predefiniti

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.

Le regole della libreria si possono sfogliare, installare e disinstallare da Transactions -> Rules -> Library nella Business Console, tramite l’API della libreria di regole (GET /v3/transactions/rules/library/, POST/DELETE /v3/transactions/rules/install/), oppure con gli strumenti MCP 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. Per capire come le regole contribuiscono allo scoring, vedi punteggio di rischio.

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.

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), 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: 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.

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 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 per il contratto completo di invio e Regole sugli eventi 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 per la struttura delle regole, gli endpoint API e gli esempi svolti di creazione di regole personalizzate.

Primi passi

Funzionalità

Riferimento

Console

Libreria di regole KYT: oltre 150 scenari predefiniti

Come sono organizzati i preset

Come leggere questa pagina

Bundle finanziario

Strutturazione e soglie prossime

Volume e velocità

Layering, mule e smurfing

Anomalie comportamentali

Bundle AML / CTF

Bundle screening crypto

Pacchetto di monitoraggio crypto

Pacchetto Travel Rule

Travel Rule globale

Regimi regionali

Due diligence sulla controparte

Intelligenza dei dispositivi e prevenzione delle frodi

Fingerprint del dispositivo e account multipli

IP, rete e VPN

Composito comportamentale

Presa di controllo dell’account e frode APP

Abuso di affiliati e bonus

Pacchetto gioco responsabile

Pacchetto antifrode per l’iGaming

Segnali evento richiesti da ogni regola

Bundle e-commerce

Bundle frode sugli assegni

Bundle BNPL

Riferimento: standard alla base della libreria

Personalizzazione dei preset

​Come sono organizzati i preset

​Come leggere questa pagina

​Bundle finanziario

​Strutturazione e soglie prossime

​Volume e velocità

​Layering, mule e smurfing

​Anomalie comportamentali

​Bundle AML / CTF

​Bundle screening crypto

​Pacchetto di monitoraggio crypto

​Pacchetto Travel Rule

​Travel Rule globale

​Regimi regionali

​Due diligence sulla controparte

​Intelligenza dei dispositivi e prevenzione delle frodi

​Fingerprint del dispositivo e account multipli

​IP, rete e VPN

​Composito comportamentale

​Presa di controllo dell’account e frode APP

​Abuso di affiliati e bonus

​Pacchetto gioco responsabile

​Pacchetto antifrode per l’iGaming

​Segnali evento richiesti da ogni regola

​Bundle e-commerce

​Bundle frode sugli assegni

​Bundle BNPL

​Riferimento: standard alla base della libreria

​Personalizzazione dei preset

Come sono organizzati i preset

Come leggere questa pagina

Bundle finanziario

Strutturazione e soglie prossime

Volume e velocità

Layering, mule e smurfing

Anomalie comportamentali

Bundle AML / CTF

Bundle screening crypto

Pacchetto di monitoraggio crypto

Pacchetto Travel Rule

Travel Rule globale

Regimi regionali

Due diligence sulla controparte

Intelligenza dei dispositivi e prevenzione delle frodi

Fingerprint del dispositivo e account multipli

IP, rete e VPN

Composito comportamentale

Presa di controllo dell’account e frode APP

Abuso di affiliati e bonus

Pacchetto gioco responsabile

Pacchetto antifrode per l’iGaming

Segnali evento richiesti da ogni regola

Bundle e-commerce

Bundle frode sugli assegni

Bundle BNPL

Riferimento: standard alla base della libreria

Personalizzazione dei preset