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

# Bibliothèque de règles KYT : plus de 150 scénarios prédéfinis

> 150+ règles KYT prédéfinies avec Didit : structuring, vélocité, layering, sanctions, iGaming. 1,000 par mois inclus, puis $0.001 chacune.

Didit propose une bibliothèque sélectionnée de **plus de 150 règles de surveillance des transactions prédéfinies** que vous pouvez installer une à une ou par bundle. Chaque règle correspond à une typologie réelle d'AML, de fraude ou de conformité, tirée de normes internationales et de recommandations réglementaires : recommandations FATF, avis FinCEN, règles NACHA, principes de Wolfsberg, typologies de l'Egmont Group et schémas d'abus propres à l'iGaming.

Choisissez les presets ou bundles dont vous avez besoin, puis contrôlez le mode de chaque règle installée (`ACTIVE`, `TEST` ou `DISABLED`). Les conditions, seuils et actions des presets sont fixes : créez une règle personnalisée si vous avez besoin d'une autre logique. Désinstallez un preset pour le retirer de l'application, et réinstallez-le plus tard si nécessaire.

> [!NOTE]
>
> Les règles de la bibliothèque peuvent être consultées, installées et désinstallées depuis *Transactions -> Rules -> Library* dans la Business Console, via l'[API de la bibliothèque de règles](https://docs.didit.me/fr/management-api/transactions/rules-library.md) (`GET /v3/transactions/rules/library/`, `POST`/`DELETE /v3/transactions/rules/install/`), ou via les [outils MCP](https://docs.didit.me/fr/integration/mcp/tools.md) `didit_transaction_rule_library_list` / `didit_transaction_rule_install` / `didit_transaction_rule_uninstall`. Les presets installés n'acceptent que des changements de `mode` (activer, désactiver, tester) ; leurs seuils sont fixes : pour en modifier un, créez une [règle personnalisée](https://docs.didit.me/fr/transaction-monitoring/rules.md#créer-des-règles-personnalisées). Pour savoir comment les règles contribuent à la notation, consultez la [notation du risque](https://docs.didit.me/fr/transaction-monitoring/risk-scoring.md).

> [!NOTE]
>
> Une règle de la bibliothèque dont les conditions lisent des données que le moteur de règles ne peut pas encore évaluer est **retenue** tant qu'elle ne peut pas s'exécuter : la bibliothèque ne la répertorie pas, une requête qui la désigne dans `library_keys` renvoie `400` et n'installe rien (une clé inconnue est ignorée à la place), et une installation de `bundle` l'ignore. Une copie que vous avez installée auparavant est désactivée (`DISABLED`) et reste dans votre liste de règles ; définir son `mode` sur une autre valeur renvoie `400`. Une règle retenue redevient disponible automatiquement dès que le moteur de règles peut évaluer ses conditions, de sorte que la liste de la bibliothèque affiche toujours les règles que vous pouvez installer aujourd'hui.

## Organisation des presets

Chaque preset appartient à un **bundle** (sa famille fonctionnelle) et à une **catégorie** (son thème de risque plus large). Les bundles vous permettent d'activer ou de désactiver ensemble des règles liées depuis la console, tandis que les catégories servent à la notation et à l'établissement de rapports.

| Bundle | Ce qu'il couvre |
| - | - |
| `finance` | Structuration, transactions de montant élevé, volume cumulé, répartition par pays, layering, fan-in de comptes mules, smurfing |
| `aml_ctf` | Sanctions, références de paiement suspectes, layering à montants ronds, allers-retours rapides |
| `aml_monitoring` | Exposition à des origines de fonds à haut risque dérivées de la blockchain, financement du terrorisme, exploitation d'enfants |
| `anomaly_detection` | Vélocité élevée, réactivation de comptes dormants, activité en dehors des heures ouvrées |
| `fatf` | Exposition à des juridictions à haut risque |
| `device_intelligence` | Réutilisation d'empreintes d'appareil, comptes à plusieurs empreintes, anomalies IP et navigateur, VPN et proxy, déplacements impossibles |
| `fraud_prevention_multi_accounting` | Empreintes partagées entre des personnes distinctes |
| `fraud_prevention_app` | Signaux de paiement autorisé par push, de bénéficiaire utilisé pour la première fois et de victime d'arnaque |
| `fraud_prevention_ato` | Signaux composites de prise de contrôle de compte (modification de données personnelles, nouveau moyen de paiement) |
| `fraud_prevention_consortium` | Contreparties signalées par d'autres établissements du réseau partagé |
| `crypto_monitoring` | Exposition aux mixeurs, au darknet ou à des portefeuilles sanctionnés, chain hopping, portefeuilles non hébergés, lacunes des VASP |
| `travel_rule` | Obligations Travel Rule mondiales et régionales (12 régimes) et diligence raisonnable concernant les VASP des contreparties |
| `travel_rule_eu_tfr` | Contrôles TFR de l'UE : incohérence des données de la contrepartie, propriété non vérifiée du portefeuille, VASP contrepartie non identifié, confirmation expirée |
| `responsible_gaming` | Limites de dépôt et de retrait pour un jeu sûr, auto-exclusion, jeu en dehors des heures ouvrées |
| `igaming_fraud` | Abus de bonus propres aux événements, paris opposés, fraude impliquant des affiliés, farming de pluie de chat, chip dumping, prise de contrôle de compte |
| `e_commerce` | Tests de carte par microtransactions, indicateurs de rétrofacturation, incohérence du pays de facturation, activité soudaine d'affiliés |
| `check_fraud` | Chèques hors plage, numéro manquant, présentation en double, présence sur une liste de surveillance du dark web, chèques lavés, cavalerie (fraude aux chèques) |
| `bnpl` | Fraude de première partie liée à des remboursements échoués, identifiants partagés entre comptes BNPL, versements sur des comptes récemment créés |

## Comment lire cette page

Chaque règle indique son `library_key` (identifiant stable que vous pouvez référencer dans l'API ou dans l'URL de la console), les conditions et l'agrégation qui la déclenchent, ainsi que les actions par défaut qu'elle exécute. Les seuils numériques affichés ici sont les valeurs par défaut fournies : chaque valeur est modifiable pour chaque application sans perdre l'identité de la règle.

***

## Lot Finance

Ces règles s'appliquent à chaque transaction dont `transaction_type = FINANCE`. Elles modélisent la base réglementaire (seuils de déclaration BSA/FinCEN, heuristiques de vélocité du FATF) ainsi que les schémas de mules financières et de smurfing.

### Structuration et montants proches du seuil

| `library_key` | Déclencheur | Action par défaut |
| - | - | - |
| `structuring-inbound` | ≥20 virements entrants inférieurs à \$10,000 par le même sujet sur une période de 30 jours | +35 au score |
| `structuring-outbound` | ≥20 virements sortants inférieurs à \$10,000 par le même sujet sur une période de 30 jours | +35 au score |
| `single-transaction-just-below-threshold` | Une transaction unique comprise entre $9,000 et $9,999 | +25 au score |
| `round-amount-layering` | Le montant du virement correspond à une valeur anormalement ronde ($10k, $25k, $50k, $100k, $250k, $500k, \$1M…) | +20 au score |

### Volume et vélocité

| `library_key` | Déclencheur | Action par défaut |
| - | - | - |
| `large-single-transaction` | Transaction unique ≥ \$25,000 | +50 au score, `IN_REVIEW` |
| `cumulative-outbound-volume` | Volume sortant ≥ \$100,000 sur 30 jours | +45 au score, `IN_REVIEW` |
| `cumulative-inbound-volume-90d` | Volume entrant ≥ \$200,000 sur 90 jours | +30 au score, `IN_REVIEW` |
| `cumulative-outbound-volume-7d` | Volume sortant ≥ \$50,000 sur 7 jours | +30 au score, `IN_REVIEW` |
| `business-4h-inbound-volume` | Volume entrant d'entreprise ≥ \$30,000 dans toute fenêtre de 4 heures | +30 au score, `IN_REVIEW` |
| `business-4h-outbound-volume` | Volume sortant d'entreprise ≥ \$30,000 dans toute fenêtre de 4 heures | +30 au score, `IN_REVIEW` |
| `high-velocity-inbound` | ≥20 transactions entrantes sur une période de 7 jours | +25 au score |
| `high-velocity-outbound` | ≥20 transactions sortantes sur une période de 7 jours | +25 au score |

### Stratification, mule et smurfing

| `library_key` | Déclencheur | Action par défaut |
| - | - | - |
| `rapid-in-and-out-movement` | Un virement sortant précédé d'un virement entrant dans les 6 heures | +60 au score, `IN_REVIEW` |
| `cash-deposit-followed-by-withdrawal` | Dépôts en espèces ≥ \$50,000 sur une période de 72 h, suivis d'un retrait en espèces | +30 au score, `IN_REVIEW` |
| `money-mule-fan-in-to-counterparty` | Une contrepartie reçoit des virements de ≥5 sujets distincts sur une période de 7 jours | +30 au score, `IN_REVIEW` |
| `rapid-repeated-payments-same-counterparty` | ≥5 virements sortants vers la même contrepartie sur une période de 24 heures | +30 au score, `IN_REVIEW` |
| `cross-border-small-amount-velocity` | Un sujet envoie des montants inférieurs à \$1,000 vers ≥4 pays de contrepartie distincts sous 24 h | +30 au score, `IN_REVIEW` |
| `high-risk-jurisdiction-smurfing` | ≥5 virements sortants inférieurs à \$1,000 vers le même pays à haut risque sur une période de 7 jours | +30 au score, `IN_REVIEW` |
| `many-unique-counterparties-24h` | Le sujet réalise des transactions avec ≥6 contreparties distinctes sous 24 h | +30 au score, `IN_REVIEW` |
| `many-unique-payment-methods-7d` | Le sujet alterne entre ≥4 moyens de paiement distincts sur une période de 7 jours | +30 au score, `IN_REVIEW` |
| `counterparty-country-spread-24h` | Le sujet réalise des transactions avec ≥4 pays de contrepartie distincts sous 24 h | +30 au score, `IN_REVIEW` |

### Anomalies comportementales

| `library_key` | Déclencheur | Action par défaut |
| - | - | - |
| `dormant-account-reactivation` | Première transaction ≥ \$1,000 après ≥365 jours d'inactivité | +20 au score |
| `off-hours-high-value-finance` | Virement de montant élevé (≥ \$5,000) marqué comme hors horaires pour les paramètres régionaux du sujet | +25 au score |

***

## Lot AML / CTF

Ces règles modélisent les typologies AML/CTF classiques qui ne reposent pas sur l'enrichissement blockchain : elles s'appliquent de manière universelle aux transferts en monnaie fiduciaire et crypto.

| `library_key` | Déclencheur | Action par défaut |
| - | - | - |
| `sanctions-counterparty` | Le portefeuille contrôlé est lui-même attribué à une entité sanctionnée (`wallet_sanctioned`). La simple exposition ne la déclenche pas | +90 au score, `DECLINED` |
| `sanctions-exposure-review` | Le portefeuille contrôlé a transféré des fonds vers ou depuis des entités sanctionnées sans être lui-même sanctionné | +50 au score, `IN_REVIEW` |
| `suspicious-payment-reference` | La référence de paiement contient des mots-clés liés à des fonds d'origine illicite | +45 au score, `IN_REVIEW` |
| `high-risk-jurisdiction-exposure` | Le pays de la contrepartie ou le pays de l'IP du sujet figure sur la liste des pays à haut risque | +40 au score, `IN_REVIEW` |
| `high-risk-inbound-single` | Entrant ≥ \$20,000 depuis un pays à haut risque | +30 au score, `IN_REVIEW` |
| `high-risk-outbound-single` | Sortant ≥ \$20,000 vers un pays à haut risque | +30 au score, `IN_REVIEW` |

La liste par défaut des pays à haut risque comprend les territoires faisant l'objet d'un appel à l'action du FATF et les zones de conflit : `IRN`, `PRK`, `SYR`, `AFG`, `RUS`, `MMR`. Vous pouvez remplacer la liste pour chaque application.

> [!NOTE]
>
> **La couverture des contreparties PEP n'est actuellement pas proposée.** Aucun fournisseur de filtrage connecté n'indique si une contrepartie est une personne politiquement exposée : le champ `pep_counterparty` vaut `null` sur chaque résultat de filtrage aujourd'hui (voir [filtrage des portefeuilles](https://docs.didit.me/fr/transaction-monitoring/wallet-screening.md#réponse)). La bibliothèque ne propose donc aucune règle prédéfinie pour les contreparties PEP. Une règle installée avant le retrait de ce préréglage continue d'être évaluée, mais elle ne peut correspondre à aucun filtrage réel : supprimez-la, ou remplacez-la par une règle personnalisée si vous devez réagir à un autre signal.

***

## Lot de filtrage crypto

Ces règles exploitent les données enrichies produites par le filtrage crypto de Didit. Elles sont particulièrement utiles pour les applications natives crypto et les VASP.

| `library_key` | Déclencheur | Action par défaut |
| - | - | - |
| `aml-high-risk-source-exposure` | ≥30% des fonds d'origine proviennent de catégories associées à des entités sanctionnées, au darknet, à des fonds volés, aux rançongiciels ou aux escroqueries | +70 au score, `IN_REVIEW` |
| `aml-multiple-risky-counterparties` | ≥3 connexions vers des entités à haut risque dans le graphe de l'origine des fonds | +50 au score, `IN_REVIEW` |
| `aml-terrorist-financing-exposure` | Toute exposition au financement du terrorisme sur le portefeuille | +100 au score, `DECLINED` |
| `aml-child-exploitation-exposure` | Toute exposition à du matériel lié à l'exploitation des enfants sur le portefeuille | +100 au score, `DECLINED` |
| `aml-wallet-risk-score-medium` | Score de risque du portefeuille fourni par le prestataire compris entre 40 et 70 | +30 au score |

***

## Ensemble de surveillance crypto

Règles d'exposition au niveau du portefeuille, ainsi que contrôles d'intégrité liés aux VASP et à la Travel Rule.

| `library_key` | Déclencheur | Action par défaut |
| - | - | - |
| `crypto-mixer-exposure` | Portefeuille lié à un service de mixage ou d'obscurcissement | +80 au score, `IN_REVIEW` |
| `crypto-darknet_market-exposure` | Exposition d'un portefeuille à un marché du darknet | +80 au score, `IN_REVIEW` |
| `crypto-sanctioned-exposure` | Exposition d'un portefeuille sous sanctions | +90 au score, `IN_REVIEW` |
| `crypto-stolen_funds-exposure` | Exposition d'un portefeuille à des fonds volés | +85 au score, `IN_REVIEW` |
| `crypto-scam-exposure` | Exposition d'un portefeuille à une arnaque | +70 au score, `IN_REVIEW` |
| `crypto-ransomware-exposure` | Exposition d'un portefeuille à un rançongiciel | +90 au score, `IN_REVIEW` |
| `crypto-hacked_exchange-exposure` | Exposition d'un portefeuille à une plateforme piratée | +80 au score, `IN_REVIEW` |
| `crypto-gambling_unlicensed-exposure` | Exposition d'un portefeuille à des jeux d'argent non agréés | +60 au score, `IN_REVIEW` |
| `high-risk-wallet-exposure` | Le portefeuille présente un risque lié à un marché du darknet, à des sanctions ou à des fonds volés | +70 au score, `IN_REVIEW` |
| `crypto-wallet-risk-score-critical` | Score du portefeuille fourni par le prestataire ≥ 90 | +90 au score, `IN_REVIEW` |
| `crypto-wallet-risk-score-high` | Score du portefeuille fourni par le prestataire ≥ 70 | +60 au score, `IN_REVIEW` |
| `crypto-unhosted-wallet-large-outbound` | Montant sortant ≥ \$1,000 vers un portefeuille non hébergé | +45 au score, `IN_REVIEW` |
| `crypto-repeated-unhosted-wallet-withdrawals` | ≥5 virements sortants vers des portefeuilles non hébergés en 24 h | +35 au score, `IN_REVIEW` |
| `crypto-many-new-wallets-per-subject` | Le sujet envoie vers ≥5 portefeuilles distincts en 24 h | +40 au score, `IN_REVIEW` |
| `crypto-chain-hopping-pattern` | Le même sujet transfère des fonds sur ≥3 blockchains en 24 h | +45 au score, `IN_REVIEW` |
| `crypto-missing-vasp-id-high-value` | Virement d'un montant ≥ \$1,000 impliquant un portefeuille hébergé, sans identifiant VASP | +30 au score, `IN_REVIEW` |

***

## Ensemble Travel Rule

Les règles Travel Rule ne s'appliquent qu'aux transactions `travelRule`.
Chaque régime régional comprend quatre règles (contrepartie en attente, action en attente, données manquantes, échec de l'échange).

### Travel Rule globale

| `library_key` | Déclencheur | Action par défaut |
| - | - | - |
| `travel-rule-pending-counterparty` | Le statut est `AWAITING_COUNTERPARTY` (en attente du VASP de la contrepartie) | +35 au score, `IN_REVIEW` |
| `travel-rule-pending-action` | Le statut est `ON_HOLD` (sur une plateforme gérée, un virement entrant attend que vous le résolviez : aucune correspondance dans le carnet d'adresses de portefeuilles, ou une demande attend une approbation manuelle) | +35 au score, `AWAITING_USER` |
| `travel-rule-missing-required-data` | `travel_rule_required` vaut `true` et `travel_rule_obligations_count` est supérieur à `0` ; seules les données Travel Rule que vous enregistrez vous-même dans `travel_rule_details` comportent un nombre d'obligations, donc cette règle ne se déclenche jamais sur un virement exécuté par la plateforme gérée | +50 au score, `IN_REVIEW` |

### Régimes régionaux

Le même modèle de quatre règles s'applique à chaque régime. Remplacez `<regime>` ci-dessous par l'un des suivants : `australia`, `dubai`, `eu`, `hong_kong`, `india`, `indonesia`, `japan`, `kazakhstan`, `singapore`, `south_africa`, `turkey`, `uk`.

Le régime est attribué automatiquement : Didit renseigne `custom_values.travel_rule_regime` sur chaque transaction Travel Rule à partir de la `jurisdiction` de vos [paramètres Travel Rule](https://docs.didit.me/fr/transaction-monitoring/travel-rule.md#configuration) : `SG` → `singapore`, `GB` → `uk`, et tout code d'un État membre de l'UE ou de l'EEE, comme `DE` ou `FR` → `eu`. Les codes sans ensemble régional sont renseignés en minuscules (`US` → `us`), afin que les règles personnalisées puissent tout de même les cibler. Une valeur `props.travel_rule_regime` envoyée avec la transaction remplace toujours le régime déduit.

| Modèle de `library_key` | Déclencheur |
| - | - |
| `travel-rule-<regime>-pending-counterparty` | Virement auquel un régime est attribué, en attente du VASP de la contrepartie |
| `travel-rule-<regime>-pending-action` | Virement auquel un régime est attribué, au statut `ON_HOLD` |
| `travel-rule-<regime>-missing-required-data` | Virement auquel un régime est attribué, soumis à l'obligation Travel Rule mais non résolu |
| `travel-rule-<regime>-failed-exchange` | Virement auquel un régime est attribué, au statut `CANCELLED` |

Cela fait 48 règles propres aux régions, en plus des trois règles Travel Rule globales et des cinq règles de contrepartie ci-dessous.
L'ensemble distinct `travel_rule_eu_tfr` ajoute quatre règles TFR de l'UE, décrites dans [Ensemble de règles TFR de l'UE](https://docs.didit.me/fr/transaction-monitoring/travel-rule.md#ensemble-de-règles-eu-tfr).

### Vérification préalable de la contrepartie

Ces règles s'appuient sur ce que votre application sait du VASP de la contrepartie contacté par la plateforme : votre propre décision à son sujet, son niveau de risque de vérification préalable, son pays et sa réactivité.
Consultez [Vérification préalable de la contrepartie](https://docs.didit.me/fr/transaction-monitoring/travel-rule.md#diligence-raisonnable-sur-la-contrepartie) pour connaître l'origine de chaque valeur.

| `library_key` | Déclencheur | Action par défaut |
| - | - | - |
| `travel-rule-counterparty-blocked` | Votre décision sur la contrepartie (`counterparty_dd_status`) est `BLOCKED` | +90 au score, `DECLINED` |
| `travel-rule-counterparty-restricted` | Votre décision sur la contrepartie est `RESTRICTED` | +50 au score, `IN_REVIEW` |
| `travel-rule-counterparty-high-risk` | Le niveau de risque de la contrepartie (`counterparty_risk_level`) est `HIGH` : score de vérification préalable inférieur à 40, ou votre propre filtrage récent de la contrepartie a relevé une correspondance possible avec des sanctions ou de la presse négative | +40 au score, `IN_REVIEW` |
| `travel-rule-counterparty-high-risk-jurisdiction` | La contrepartie est établie dans un pays figurant sur la liste par défaut des pays à haut risque (`IRN`, `PRK`, `SYR`, `AFG`, `RUS`, `MMR`) | +60 au score, `IN_REVIEW` |
| `travel-rule-counterparty-unresponsive` | La contrepartie a répondu à moins de 10 pour cent des demandes Travel Rule que les clients de Didit lui ont envoyées au cours des 90 derniers jours, avec au moins 5 demandes tranchées | +30 au score, `IN_REVIEW` |

***

## Intelligence sur les appareils et prévention de la fraude

Ces règles transforment les signaux issus du SDK client (empreinte de l'appareil, adresse IP, navigateur, ancienneté de la session) et l'enrichissement fourni par le prestataire en événements de détection de fraude.

### Empreinte de l'appareil et multicomptes

| `library_key` | Déclencheur | Action par défaut |
| - | - | - |
| `multi-accounting-shared-fingerprint` | Une même empreinte d'appareil utilisée par ≥3 sujets distincts en 7 jours | +50 au score, `IN_REVIEW` |
| `multiple-device-fingerprints-for-same-subject` | Un même sujet est associé à ≥3 empreintes d'appareil distinctes en 24 h | +20 au score |
| `same-fingerprint-transaction-burst` | ≥6 transactions depuis une même empreinte en 24 h | +30 au score |
| `same-ip-multi-accounting` | Une même IP partagée par ≥3 sujets distincts en 7 jours | +30 au score |
| `same-ip-transaction-burst` | ≥6 transactions depuis une même IP en 24 h | +30 au score |
| `same-fingerprint-multiple-payment-methods` | Une même empreinte alternant entre ≥4 moyens de paiement en 7 jours | +30 au score |
| `shared-payment-method-across-subjects` | Un même moyen de paiement utilisé par ≥3 sujets distincts en 7 jours | +30 au score |
| `many-ip-addresses-per-subject` | Le sujet utilise ≥4 IP distinctes en 24 h | +30 au score |
| `new-browser-and-new-ip-combination` | Le sujet utilise ≥3 navigateurs distincts ET ≥3 IP distinctes en 24 h | +30 au score |

### IP, réseau et VPN

| `library_key` | Déclencheur | Action par défaut |
| - | - | - |
| `vpn-or-proxy-high-value` | VPN ou proxy détecté sur un virement ≥ \$5,000 | +30 au score |
| `impossible-travel-between-transactions` | Le sujet effectue des transactions depuis ≥2 pays correspondant à des adresses IP distinctes dans un délai d'une heure | +30 au score |

### Composite comportemental

| `library_key` | Déclencheur | Action par défaut |
| - | - | - |
| `browser-spoofing-password-reuse` | Usurpation du navigateur détectée ET ≥2 transactions réutilisant le même hachage de mot de passe en 30 minutes | +30 au score |
| `remote-access-high-value-transfer` | Outil d'accès à distance détecté sur un virement ≥ \$5,000 | +30 au score |
| `low-session-age-high-value-transfer` | Virement ≥ \$5,000 dans les 30 secondes suivant le début de la session | +30 au score |
| `synthetic-identity-fresh-account-high-value` | Compte ouvert au cours des 7 derniers jours effectuant des transactions ≥ \$1,000 | +30 au score |

### Prise de contrôle de compte et fraude APP

| `library_key` | Déclencheur | Action par défaut |
| - | - | - |
| `recent-pii-change-and-transaction` | Virement ≥ \$1,000 pendant la fenêtre de modification récente des données personnelles | +45 au score, `IN_REVIEW` |
| `new-payment-method-high-value` | Virement ≥ \$5,000 utilisant un moyen de paiement ajouté au cours des 7 derniers jours | +30 au score |
| `first-time-payee-high-value` | Transaction sortante d'un montant ≥ \$5,000 vers une contrepartie à laquelle le sujet n'a encore jamais effectué de paiement | +40 au score, `IN_REVIEW` |
| `consortium-flagged-counterparty` | Virement ≥ \$500 dont la contrepartie a été signalée par un autre établissement | +60 au score, `IN_REVIEW` |

### Abus d'affiliation et de bonus

| `library_key` | Déclencheur | Action par défaut |
| - | - | - |
| `repeated-bonus-campaign-from-same-fingerprint` | ≥6 transactions sur la même campagne et la même empreinte en 2 h | +35 au score |
| `shared-fingerprint-across-bonus-campaigns` | Une même empreinte revendique ≥3 campagnes distinctes en 7 jours | +30 au score |
| `affiliate-fraud-repeated-fingerprint` | ≥5 transactions sur le même affilié et la même empreinte en 2 h | +30 au score |

***

## Ensemble de règles pour le jeu responsable

Pour les applications iGaming. Ces règles sont conçues pour détecter à la fois les signaux de protection des joueurs et les schémas d'abus de bonus.

| `library_key` | Déclencheur | Action par défaut |
| - | - | - |
| `responsible-gaming-rapid-deposits` | ≥10 transactions entrantes associées à la même action en 24 h | +20 au score |
| `responsible-gaming-rapid-withdrawals` | ≥8 transactions sortantes associées à la même action en 24 h | +20 au score |
| `responsible-gaming-cumulative-deposits-7d` | Volume entrant ≥ \$5,000 en 7 jours | +20 au score |
| `responsible-gaming-cumulative-withdrawals-7d` | Volume sortant ≥ \$5,000 en 7 jours | +20 au score |
| `responsible-gaming-self-excluded-activity` | Toute transaction depuis un compte auto-exclu | +20 au score |
| `responsible-gaming-loss-limit-hit` | Activité se poursuivant après un signal de limite de pertes | +20 au score |
| `responsible-gaming-bonus-hunting` | ≥4 transactions sur la même campagne et la même empreinte en 24 h | +20 au score |
| `responsible-gaming-multiple-payment-methods` | ≥4 moyens de paiement distincts en 7 jours | +20 au score |
| `responsible-gaming-off-hours-high-value` | Activité de jeu identifiée comme ayant lieu en dehors des heures habituelles, d'un montant ≥ \$1,000 | +20 au score |
| `responsible-gaming-failed-withdrawals` | ≥3 tentatives de retrait échouées | +20 au score |
| `responsible-gaming-many-counterparties` | ≥5 contreparties distinctes en 24 h | +20 au score |

***

## Ensemble de lutte contre la fraude iGaming

Pour les opérateurs qui envoient des événements de surveillance en plus des mouvements de fonds. Ces règles utilisent `scope.record_types = ["event"]`, de sorte que les clients qui ne transmettent que des transactions ne constatent aucun changement de comportement. Lorsqu'une solution de repli réservée aux transactions existe, installez la règle de repli nommée en parallèle de la règle d'événement jusqu'à ce que votre intégration envoie la catégorie d'événements.

| `library_key` | Déclencheur | Action par défaut | Repli réservé aux transactions |
| - | - | - | - |
| `igaming-account-takeover-drain` | 3+ échecs de connexion, puis un changement de MFA, puis un changement d'adresse de retrait, puis une demande de retrait - dans cet ordre, en 24h | score +90, `DECLINED` | `recent-pii-change-and-transaction`, `new-payment-method-high-value` |
| `igaming-minimal-play-laundering` | Demande de retrait ≥ \$1,000 alors que le total des mises du compte est ≤ 5% de ses dépôts finalisés sur les 24h précédentes | score +60, `IN_REVIEW` | `rapid-in-and-out-movement` |
| `igaming-chargeback-deposit-ratio` | Les rétrofacturations ouvertes atteignent au moins 50% des dépôts finalisés sur 30 jours | score +80, `DECLINED` | `ecommerce-chargeback-indicator` |
| `igaming-chip-dumping-pair-net-winner` | La même paire P2P effectue le règlement d'au moins 2 mains, manches ou parties distinctes sur 7 jours **et** le résultat net d'un des deux côtés totalise ≥ \$400 | score +70, `IN_REVIEW` | Événement requis |
| `igaming-opposite-betting-same-market` | Des mises sont placées sur les deux côtés du même match et du même marché par 2+ comptes distincts partageant une même empreinte d'appareil, en 1h | score +65, `IN_REVIEW` | Événement requis |
| `igaming-bot-rta-cadence` | `session.bot_signal_observed` signalant un score de bot ≥ 90 et une variance temporelle ≤ 10ms | score +55, `IN_REVIEW` | Événement requis |
| `igaming-self-exclusion-evasion` | Correspondance avec le registre d'auto-exclusion avec `exclusion_status: active` lors d'une tentative de réinscription | score +100, `DECLINED` | `responsible-gaming-self-excluded-activity` |
| `igaming-chat-rain-farming` | Deuxième réclamation du **même** bonus de pluie du chat par un compte en 24h, réclamée dans les 500 ms | score +45, `IN_REVIEW` | `responsible-gaming-bonus-hunting` |
| `igaming-repeated-bonus-claims-one-device` | Troisième réclamation du **même** bonus depuis une même empreinte d'appareil sur 7 jours | score +50, `IN_REVIEW` | `repeated-bonus-campaign-from-same-fingerprint`, `shared-fingerprint-across-bonus-campaigns`, `responsible-gaming-bonus-hunting` |
| `igaming-affiliate-self-referral` | Attribution à un code affilié utilisé par 3+ comptes distincts depuis une même empreinte d'appareil sur 7 jours | score +50, `IN_REVIEW` | `affiliate-fraud-repeated-fingerprint` |
| `igaming-multi-accounting-device` | Connexion ou inscription depuis une empreinte d'appareil utilisée par 3+ comptes distincts en 24h | score +60, `IN_REVIEW` | `multi-accounting-shared-fingerprint` |
| `igaming-shared-proxy-ip` | Connexion depuis une adresse utilisée par 3+ comptes distincts en 24h | score +40, `IN_REVIEW` | `same-ip-multi-accounting` |

### Signaux d'événement requis par chaque règle

Chaque règle ci-dessus lit des champs d'événement nommés. Lorsqu'un champ requis est absent, la règle ne correspond tout simplement pas : elle ne déduit jamais le signal d'une autre donnée et ne se rabat jamais sur les données de transaction seules. Envoyez les clés ci-dessous dans le `payload` de l'événement et dans `device_context` (voir [Événements](https://docs.didit.me/fr/transaction-monitoring/events.md) pour le contrat de soumission complet et [Règles d'événement](https://docs.didit.me/fr/transaction-monitoring/event-rules.md) pour les chemins de champs des règles).

| `library_key` | Actions d'événement lues | Champs requis par la règle |
| - | - | - |
| `igaming-account-takeover-drain` | `security.login_failed`, `security.mfa_changed`, `payment.withdrawal_address_changed`, `payment.withdrawal_requested` | `changed_field`, `withdrawal_address_hash`, et les clés de paiement standard |
| `igaming-minimal-play-laundering` | `payment.withdrawal_requested`, `gameplay.bet_placed`, `payment.deposit_completed` | `amount` sur chacun de ces événements |
| `igaming-chargeback-deposit-ratio` | `dispute.chargeback_opened`, `payment.deposit_completed` | `payment_reference_id`, ainsi que `dispute_id` ou `chargeback_id` |
| `igaming-chip-dumping-pair-net-winner` | `gameplay.p2p_settlement` | `counterparty_vendor_data`, `net_result_amount`, et l'un de `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`, ainsi que `registry_source` et `identity_match_ref` requis |
| `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`, ou un `security.registration_attempt` personnalisé | `device_context.fingerprint` |
| `igaming-shared-proxy-ip` | `security.login_succeeded` | `device_context.network_context.ip_address` |

Utilisez l'ensemble `igaming_fraud` lorsque votre intégration émet des événements de connexion, de jeu, de bonus, d'affiliation, de paiement, de litige, de sécurité et de jeu responsable. Les règles restent optionnelles : les ajouter à la bibliothèque n'installe pas ces règles pour les applications existantes et ne modifie pas les paramètres prédéfinis actuels des clients actifs.

***

## Bundle e-commerce

Pour les places de marché et les applications de type marchand officiel.

| `library_key` | Déclencheur | Action par défaut |
| - | - | - |
| `ecommerce-card-testing-microtransactions` | ≥10 transactions ≤ \$5 provenant de la même empreinte en 1h | +30 au score |
| `ecommerce-high-order-velocity` | ≥8 transactions sur une même empreinte en 30 minutes | +30 au score |
| `ecommerce-chargeback-indicator` | Le fournisseur ou le workflow a signalé un indicateur de rétrofacturation | +30 au score |
| `ecommerce-billing-country-mismatch` | Pays de facturation incohérent sur une transaction ≥ \$500 | +30 au score |
| `ecommerce-shared-payment-method` | Moyen de paiement réutilisé par ≥3 entités e-commerce en 7 jours | +30 au score |
| `ecommerce-shared-ip-multi-accounting` | Une même IP partagée par ≥4 entités e-commerce en 24h | +30 au score |
| `ecommerce-remote-checkout-high-value` | Accès à distance détecté lors du paiement pour un montant ≥ \$1,000 | +30 au score |
| `ecommerce-affiliate-burst` | ≥5 transactions sur le même affilié et la même empreinte en 2h | +30 au score |

***

## Bundle de vérification des chèques

Pour les applications qui soumettent des transactions de dépôt de chèques. Chaque règle se déclenche à partir des indicateurs `custom_values.check_*` que l'appelant définit lorsqu'un chèque présente un signal de risque connu (effacement, MICR absent, numéro de série figurant sur le dark web, etc.).

| `library_key` | Déclencheur | Action par défaut |
| - | - | - |
| `check-amount-out-of-range` | Montant du chèque signalé comme hors de la plage habituelle du compte ET ≥ \$1,000 | +40 au score, `IN_REVIEW` |
| `check-missing-or-invalid-number` | Le chèque est arrivé avec un numéro manquant, incohérent ou non séquentiel | +35 au score, `IN_REVIEW` |
| `check-duplicate-presentation` | Le même chèque semble avoir été déposé deux fois (mobile et guichet) | +70 au score, `IN_REVIEW` |
| `check-on-dark-web-watchlist` | Le numéro de série ou l'image du chèque figure dans un flux de chèques volés sur le dark web ou Telegram | +90 au score, `DECLINED` |
| `check-altered-or-washed` | Le chèque présente un effacement chimique, une altération du MICR ou d'autres preuves d'effacement | +70 au score, `IN_REVIEW` |
| `check-deposit-rapid-multi-bank` | Le même sujet dépose des chèques auprès de ≥3 banques contreparties distinctes en 24h (kiting) | +45 au score, `IN_REVIEW` |

***

## Bundle BNPL

Pour les prestataires d'achat immédiat avec paiement différé. Détecte la fraude commise par le client lui-même (non-paiement) et les schémas de partage d'identifiants propres aux prêts échelonnés.

| `library_key` | Déclencheur | Action par défaut |
| - | - | - |
| `bnpl-failed-repayment-velocity` | ≥2 remboursements échoués récents pour le sujet : signal de fraude commise par le client lui-même | +45 au score, `IN_REVIEW` |
| `bnpl-shared-identifier-across-accounts` | Un numéro de téléphone, une adresse e-mail ou une adresse a déjà été associé à plusieurs sujets BNPL distincts | +40 au score, `IN_REVIEW` |
| `bnpl-high-installment-on-fresh-account` | Échéance ≥ \$500 provenant d'un compte ouvert au cours des 7 derniers jours | +35 au score |

***

## Référence : normes à la base de la bibliothèque

Chaque préréglage de la bibliothèque de Didit correspond à une typologie AML, de fraude ou de conformité largement admise. Voici les normes sur lesquelles nous nous appuyons :

| Source | Typologies apportées à la bibliothèque |
| - | - |
| **Recommandations FATF** | Structuration, mouvements rapides de fonds, exposition à des juridictions à haut risque, filtrage des sanctions visant les contreparties |
| **Avis FinCEN** | Seuils de déclaration BSA / CTR, réactivation de comptes dormants, schémas suspects de liquidités |
| **Règles NACHA** | Seuils propres à l'ACH et schémas hors horaires |
| **Principes de Wolfsberg** | Typologies de la banque correspondante et de la banque privée |
| **Typologies du Groupe Egmont** | Schémas transfrontaliers et de stratification |
| **Bonnes pratiques du secteur** | Fenêtrage de la vélocité, déplacements impossibles, nouveau bénéficiaire, réutilisation d'empreinte d'appareil, signaux de fraude BNPL commise par le client lui-même |

Didit n'implémente que les typologies reconnues comme normes sectorielles et expose chaque seuil afin que vous puissiez le régler.

***

## Personnaliser les préréglages

Chaque préréglage peut être :

* **Ajusté** : modifiez les seuils, les fenêtres, les valeurs de score ou les actions pour chaque application
* **Désactivé** : passez un préréglage en mode `DISABLED` et il cesse d'évaluer sans perdre son identité
* **Testé** : passez un préréglage en mode `TEST` pour l'évaluer en mode parallèle, sans influer sur le résultat des transactions
* **Étendu** : créez des règles personnalisées qui complètent ou remplacent les préréglages

Consultez [Règles et scoring](https://docs.didit.me/fr/transaction-monitoring/rules.md) pour la structure des règles, les endpoints de l'API et des exemples détaillés de création de règles personnalisées.


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