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

# Avertissements et codes d'alerte du filtrage AML

> Comprenez les avertissements AML de Didit : POSSIBLE_MATCH_FOUND, codes d'alerte, seuils et comportement en cas de données manquantes.

## Overview

Le filtrage AML émet un ensemble restreint d'étiquettes d'avertissement dans le tableau `warnings[]` de chaque entrée de `aml_screenings[]`. Les deux étiquettes ci-dessous sont les **seuls** avertissements AML produits par Didit — tout le reste de ce que vous voyez sur une correspondance est encodé dans les propres champs de la correspondance (`risk_view`, `match_score`, `risk_score`, `sanction_matches[]`, …) plutôt que sous la forme d'un avertissement. Les sessions de workflow et l'API AML autonome émettent toutes deux `POSSIBLE_MATCH_FOUND` de la même manière.

Le statut renvoyé sur l'enregistrement AML (`Approved`, `In Review`, `Declined`) est dérivé du `score` agrégé et de vos seuils — les avertissements signalent les mêmes conditions afin que vous puissiez y réagir par programmation. Consultez [Score de risque AML](https://docs.didit.me/fr/core-technology/aml-screening/aml-risk-score.md) pour savoir comment les seuils correspondent aux statuts.

## Avertissements produits

| Risque | Cause | `log_type` | Affecte le statut | Mesure corrective recommandée |
| - | - | - | - | - |
| `POSSIBLE_MATCH_FOUND` | Le `score` agrégé est non nul et supérieur au `aml_score_approve_threshold` (valeur par défaut `80`) — au moins une correspondance potentielle franchit votre niveau de risque. (L'API AML autonome l'émet également lorsque le score est exactement égal au seuil.) | `warning` ; passe à `error` lorsque le score dépasse également le `aml_score_review_threshold` (valeur par défaut `100`). | `In Review` lorsque le score est supérieur au seuil d'approbation ; `Declined` lorsqu'il est supérieur au seuil d'examen. | Examinez chaque correspondance dans `hits[]`. Utilisez l'endpoint de statut de correspondance AML pour marquer les correspondances comme `Confirmed Match`, `False Positive` ou `Inconclusive`. Les mises à jour de correspondances déclenchent un webhook `data.updated` mais ne recalculent pas le statut AML — définissez le statut final via l'endpoint de statut AML ou l'examen dans la console. |
| `COULD_NOT_PERFORM_AML_SCREENING` | L'enregistrement KYC ne contient pas un ou plusieurs des champs suivants : `full_name`, `date_of_birth` ou `issuing_state`. Aucun appel de filtrage facturable n'est effectué. | `warning` | Force le statut à `In Review`. | Renseignez les champs manquants dans l'enregistrement KYC. Le filtrage AML s'exécute de nouveau automatiquement dès que les trois champs sont présents — l'avertissement obsolète est supprimé et aucun redéclenchement manuel n'est nécessaire. |

Les avertissements sont stockés avec `feature: "AML"` et suivent la structure standard de l'[objet d'avertissement](https://docs.didit.me/fr/reference/data-models.md#objet-d’avertissement).

## Paramètres configurables

Contrôles AML par nœud de workflow (également acceptés en tant qu'options sur l'API AML autonome) :

* **`aml_score_approve_threshold`** — valeur par défaut `80`. Un score non nul supérieur à ce seuil produit `POSSIBLE_MATCH_FOUND` et oriente la vérification AML vers `In Review`. Les scores inférieurs ou égaux à ce seuil ne produisent **pas** l'avertissement dans les workflows de session, quel que soit le nombre de correspondances.
* **`aml_score_review_threshold`** — valeur par défaut `100`. Un score supérieur à ce seuil refuse automatiquement la vérification AML (avec la valeur par défaut de `100`, cela ne se déclenche jamais tant que vous ne l'abaissez pas).
* **`aml_match_score_threshold`** — valeur par défaut `93`. Classification par correspondance : les correspondances avec un `match_score` inférieur à ce seuil commencent en `False Positive` et sont exclues du score agrégé ; si leur score est égal ou supérieur à ce seuil, elles commencent en `Unreviewed`.
* **Pondérations du score de correspondance** — `aml_name_weight` / `aml_dob_weight` / `aml_country_weight`, valeurs par défaut `60` / `25` / `15` (la somme doit être égale à 100). Consultez [Score de correspondance AML](https://docs.didit.me/fr/core-technology/aml-screening/aml-match-score.md).
* **Surveillance continue** — lorsqu'elle est activée, le filtrage AML analyse à nouveau le sujet à mesure que les jeux de données évoluent et réémet le rapport ainsi qu'un webhook `status.updated` (changement de statut) ou `data.updated` (changement de correspondances).

> [!NOTE]
>
> Lorsque `COULD_NOT_PERFORM_AML_SCREENING` se déclenche, la vérification AML reste en `In Review` jusqu'à ce que les champs d'identité manquants soient fournis. Dès que Didit dispose du nom complet, de la date de naissance et de l'État de délivrance, le filtrage AML s'exécute de nouveau automatiquement et l'avertissement disparaît — aucun redéclenchement manuel n'est nécessaire.

## Exemples

### `POSSIBLE_MATCH_FOUND` (score supérieur au seuil d'approbation)

```json theme={null}
{
  "warnings": [
    {
      "feature": "AML",
      "risk": "POSSIBLE_MATCH_FOUND",
      "additional_data": null,
      "log_type": "warning",
      "short_description": "Possible match found in AML screening",
      "long_description": "The Anti-Money Laundering (AML) screening process identified potential matches with watchlists or high-risk databases, requiring further review.",
      "node_id": "aml-1"
    }
  ]
}
```

### `COULD_NOT_PERFORM_AML_SCREENING` (champs KYC manquants)

```json theme={null}
{
  "warnings": [
    {
      "feature": "AML",
      "risk": "COULD_NOT_PERFORM_AML_SCREENING",
      "additional_data": null,
      "log_type": "warning",
      "short_description": "Could not retrieve data from KYC for performing AML Screening",
      "long_description": "The system encountered issues accessing or processing Know Your Customer (KYC) data necessary for conducting the Anti-Money Laundering (AML) screening. please fill the KYC full name, birth date, issuing state and document number to automatically proceed with AML screening.",
      "node_id": "aml-1"
    }
  ]
}
```

## Voir aussi

* [Rapport AML](https://docs.didit.me/fr/core-technology/aml-screening/report-aml-screening.md) — structure complète de la réponse, champs des correspondances, sémantique des statuts
* [Score de risque AML](https://docs.didit.me/fr/core-technology/aml-screening/aml-risk-score.md) — mode de calcul du score agrégé
* [Score de correspondance AML](https://docs.didit.me/fr/core-technology/aml-screening/aml-match-score.md) — niveau de confiance par correspondance
* [Surveillance AML continue](https://docs.didit.me/fr/core-technology/aml-screening/continuous-monitoring-aml-screening.md) — cycle de vie de la surveillance
* [Modèles de données — Filtrage AML](https://docs.didit.me/fr/reference/data-models.md#filtrage-aml) — schéma de référence, y compris l'[objet d'avertissement](https://docs.didit.me/fr/reference/data-models.md#objet-d’avertissement)

### Types d'avertissements


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