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

# Surveillance AML continue : filtrage quotidien

> Didit filtre chaque jour vos utilisateurs vérifiés avec alertes webhook pour les sanctions et changements d'état. Conformité dès $0.07/year.

La surveillance continue est un élément essentiel d'un programme AML complet. Elle garantit que votre devoir de vigilance à l'égard de la clientèle reste à jour et vous aide à identifier les risques potentiels susceptibles de survenir après le processus initial d'onboarding. Cette fonctionnalité est automatiquement incluse pour toutes les sessions où une vérification AML a été effectuée, sans nécessiter aucune étape d'intégration supplémentaire.

![Tableau de bord de surveillance continue AML Didit avec refiltrage quotidien et alertes webhook](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/aml-continuous-monitoring.png?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=8cf8c4ecef0f78953423a598defd2b2b)

### Comment cela fonctionne

Notre système de surveillance continue vérifie en permanence vos utilisateurs vérifiés par rapport à diverses listes de surveillance, listes de sanctions et sources de presse négative. Voici un aperçu détaillé du processus :

1. **Vérifications quotidiennes automatisées** :
   * Notre système exécute des vérifications quotidiennes automatisées pour toutes les sessions qui ont été préalablement approuvées
   * Chaque vérification refiltre l'utilisateur par rapport à notre base de données complète de listes de surveillance et de listes de sanctions
   * Le système compare toute nouvelle correspondance à vos seuils AML configurés

2. **Mises à jour basées sur les seuils** :
   * Si de nouvelles correspondances dépassent votre seuil d'examen configuré, le statut de la session passe à « En cours d'examen »
   * Si de nouvelles correspondances dépassent votre seuil de refus, le statut de la session passe automatiquement à « Refusé »
   * Ces seuils sont les mêmes que ceux que vous avez configurés dans vos [Workflows](https://docs.didit.me/fr/console/workflows.md)

3. **Notifications en temps réel** :
   * Lorsqu'un changement de statut survient, votre application reçoit une notification par webhook
   * Le payload du webhook inclut le statut mis à jour et des informations détaillées sur les nouvelles correspondances AML
   * Ces notifications suivent le même format que notre [système de webhooks](https://docs.didit.me/fr/integration/webhooks.md) standard

4. **Mises à jour dans la Business Console** :
   * Tous les changements sont immédiatement répercutés dans votre Business Console
   * Votre équipe de conformité peut examiner les nouvelles correspondances AML, analyser les résultats détaillés et prendre les mesures appropriées
   * La console conserve un journal d'audit complet de toutes les activités de surveillance et des changements de statut

### Activer la surveillance pour les utilisateurs et les entreprises

Vous pouvez activer ou désactiver la surveillance continue pour l'ensemble des utilisateurs et des entreprises directement depuis la console — y compris pour les utilisateurs qui n'ont jamais fait l'objet d'une vérification AML, comme les utilisateurs importés.

1. Ouvrez **Utilisateurs** (ou **Entreprises**) dans votre Business Console, sélectionnez les profils que vous souhaitez surveiller, puis cliquez sur **Surveillance continue AML**.
2. La boîte de dialogue affiche une estimation des coûts avant toute exécution : combien de profils sont sélectionnés, combien nécessitent un nouveau filtrage AML, le coût du filtrage ponctuel et le coût annuel de la surveillance.
3. Cliquez sur **Activer la surveillance**. Les petites sélections se terminent immédiatement ; les plus volumineuses s'exécutent en arrière-plan pendant que la boîte de dialogue affiche la progression en direct.
4. Lorsque l'exécution se termine, la boîte de dialogue détaille le résultat par profil : activé, filtré et activé, déjà activé, ou ignoré avec le motif (par exemple, un profil auquel il manque le nom complet, la date de naissance et le pays nécessaires au filtrage).

Quelques détails utiles à connaître :

* **Les profils sans filtrage AML sont d'abord filtrés.** Didit crée une nouvelle vérification AML pour ces profils (visible dans l'onglet **Vérifications** du profil), facturée comme un filtrage AML standard. La surveillance est ensuite activée sur ce filtrage.
* **Un seul filtrage surveillé par profil.** L'activation maintient exactement un filtrage AML surveillé par utilisateur ou par entreprise, de sorte qu'une personne vérifiée plusieurs fois n'est surveillée — et facturée — qu'une seule fois. La désactivation coupe la surveillance sur l'ensemble des filtrages du profil.
* **Les listes affichent la surveillance en un coup d'œil.** Les listes **Utilisateurs** et **Entreprises** comportent toutes deux une colonne **Surveillance continue** ; survolez-la pour voir la prochaine date de facturation annuelle.
* **Tout sélectionner fonctionne avec vos filtres.** Lorsque toutes les lignes sont sélectionnées, l'action s'applique à votre vue filtrée actuelle, et pas seulement à la page chargée.

### Activer la surveillance via l'API

La même opération est accessible à votre backend à l'aide de votre clé API, afin que vous n'ayez jamais besoin de refiltrer manuellement un profil ou d'ouvrir la console pour modifier sa surveillance :

* [`POST /v3/users/aml-monitoring/`](https://docs.didit.me/fr/management-api/aml-monitoring/toggle-users) pour les utilisateurs
* [`POST /v3/businesses/aml-monitoring/`](https://docs.didit.me/fr/management-api/aml-monitoring/toggle-businesses) pour les entreprises
* [`GET /v3/aml-monitoring/jobs/{job_id}/`](https://docs.didit.me/fr/management-api/aml-monitoring/get-job) pour interroger l'état d'une tâche

Ces deux endpoints d'activation/désactivation acceptent une liste de vos propres identifiants (`vendor_data_list`) et/ou d'identifiants Didit (`didit_internal_id_list`), jusqu'à 1000 par appel, et suivent exactement les règles de la console : un seul filtrage surveillé par profil, les profils sans filtrage sont d'abord filtrés, et la désactivation coupe la surveillance sur tous les filtrages du profil.

```bash theme={null}
# 1. Preview the cost. Nothing is written.
curl -X POST https://verification.didit.me/v3/users/aml-monitoring/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"is_enabled": true, "estimate_only": true, "vendor_data_list": ["user-123", "user-456"]}'

# 2. Enable monitoring. 20 profiles or fewer complete inline (200);
#    larger selections return 202 and a job_id to poll.
curl -X POST https://verification.didit.me/v3/users/aml-monitoring/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"is_enabled": true, "vendor_data_list": ["user-123", "user-456"]}'
```

La réponse contient la même ventilation que celle affichée par la boîte de dialogue de la console, ainsi qu'une entrée `results` par profil avec son résultat : `enabled`, `screened_and_enabled`, `already_enabled`, `disabled`, ou un motif d'omission tel que `skipped_no_identity_data`. Les identifiants qui ne correspondent à rien sont renvoyés sous `unmatched`. L'activation ou la désactivation de la surveillance n'émet aucun webhook dédié ; une fois la surveillance activée, les refiltrages déclenchent les événements habituels `status.updated` et `data.updated`.

### Prouver que la surveillance a bien été exécutée

Les alertes, les entrées d'activité et les webhooks mentionnés ci-dessus se déclenchent tous lors d'un **changement**. Un sujet filtré quotidiennement pendant un an sans nouvelle correspondance ne génère aucun de ces signaux, de sorte que « aucune nouvelle » et « rien n'a jamais été exécuté » se ressemblent à s'y méprendre — ce qui n'est pas une réponse recevable lors d'un audit. Trois interfaces enregistrent les exécutions elles-mêmes.

**1. La date du dernier filtrage, sur le rapport AML.** `last_ongoing_screening_at` est mis à jour à chaque exécution terminée, qu'il y ait eu un changement ou non, sur les décisions de session `/v2/` et `/v3/` ainsi que sur le rapport AML autonome. À ses côtés, `last_ongoing_screening_datasets_updated_at` indique la mise à jour du jeu de données AML la plus récente signalée par le fournisseur pour cette exécution. Aucun des deux n'est jamais estimé : `null` signifie respectivement « jamais refiltré » et « aucune date de jeu de données signalée », et non « inconnue, en voici donc une plausible ». Ne confondez pas `next_ongoing_monitoring_bill_date` avec une date de filtrage — il s'agit d'une date de facturation.

**2. L'historique de filtrage, par sujet.** `GET /v1/session/{session_id}/aml-screening-history/` renvoie chaque exécution terminée pour la vérification AML de cette session, de la plus récente à la plus ancienne, y compris les exécutions dont le résultat était `NO_CHANGE`. Ajoutez `?node_id=` lorsqu'un workflow de graphe comporte plusieurs nœuds AML.

```bash theme={null}
curl https://verification.didit.me/v1/session/SESSION_ID/aml-screening-history/ \
  -H "x-api-key: YOUR_API_KEY"
```

```json theme={null}
{
  "count": 2,
  "results": [
    {
      "uuid": "0d1c...",
      "completed_at": "2026-09-12T04:03:11Z",
      "started_at": "2026-09-12T04:00:02Z",
      "outcome": "NO_CHANGE",
      "trigger": "ONGOING_MONITORING",
      "status": "Approved",
      "score": 0,
      "total_hits": 0,
      "dataset_freshness": null
    }
  ]
}
```

| Champ | Signification |
| - | - |
| `outcome` | `NO_CHANGE` — l'exécution s'est achevée et le résultat n'a pas changé. `CHANGED` — l'exécution s'est achevée et le score, le statut ou les correspondances ont évolué. `FAILED` — le fournisseur n'a renvoyé aucune réponse exploitable pour ce sujet, rien n'a donc été filtré et rien n'a été modifié. Une rupture de couverture est enregistrée plutôt que dissimulée. |
| `completed_at` / `started_at` | Le moment où le filtrage de ce sujet s'est terminé, et celui où le lot auquel il appartenait a débuté. |
| `status` / `score` / `total_hits` | L'état dans lequel l'exécution a laissé la vérification. |
| `dataset_freshness` | Le niveau d'actualisation des listes du fournisseur pour cette exécution, ou `null` si aucune date de jeu de données n'était disponible. |

**3. Les éléments de preuve exportables.** `GET /v1/session/{session_id}/aml-screening-history/export/` diffuse le même historique sous la forme d'un fichier CSV — une ligne par filtrage terminé, avec la date de mise à jour du jeu de données par famille de sources lorsque le fournisseur en a indiqué une, et une cellule vide dans le cas contraire. Ce fichier est celui qu'une équipe de conformité transmet à un auditeur. La Business Console affiche la même liste et le même export à côté du résultat AML, afin que les réviseurs n'aient pas besoin d'un accès à l'API pour le générer.

> [!NOTE]
>
> **Limites de disponibilité, expliquées simplement.** L'historique est enregistré à compter du déploiement de cette fonctionnalité ; les filtrages antérieurs ne sont pas reconstitués et sont simplement absents. Les exécutions sont conservées pendant la fenêtre de conservation configurée (deux ans par défaut). La fraîcheur du jeu de données dépend de la publication par le fournisseur des dates des jeux de données pour l'environnement sur lequel vous vous trouvez — si ce n'est pas le cas, chaque champ de jeu de données affiche `null` et `GET /v1/aml/dataset-freshness/` renvoie `availability: "not_configured"`. Une date absente n'est jamais remplacée par un substitut.

### Avantages de la surveillance continue

1. **Conformité continue** : Assurez le respect permanent des réglementations AML/KYC sans aucune configuration supplémentaire.
2. **Atténuation des risques** : Identifiez et traitez rapidement les risques émergents grâce à la surveillance automatique.
3. **Efficacité opérationnelle** : Automatisez les processus chronophages de nouveau filtrage manuel sans aucun travail d'intégration supplémentaire.
4. **Diligence raisonnable renforcée** : Maintenez automatiquement à jour les profils clients.
5. **Soutien réglementaire** : Démontrez facilement vos efforts continus de conformité auprès des régulateurs.
6. **Intégration sans effort** : Bénéficiez de la surveillance continue sans aucun travail de développement supplémentaire.


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