Avertissements et codes d'alerte du filtrage AML

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

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

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)

{
  "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)

{
  "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 — structure complète de la réponse, champs des correspondances, sémantique des statuts
Score de risque AML — mode de calcul du score agrégé
Score de correspondance AML — niveau de confiance par correspondance
Surveillance AML continue — cycle de vie de la surveillance
Modèles de données — Filtrage AML — schéma de référence, y compris l’objet d’avertissement

Authentification

Vérification

Surveillance

Plateforme

Avertissements et codes d'alerte du filtrage AML

Overview

Avertissements produits

Paramètres configurables

Exemples

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

`COULD_NOT_PERFORM_AML_SCREENING` (champs KYC manquants)

Voir aussi

Types d’avertissements

​Overview

​Avertissements produits

​Paramètres configurables

​Exemples

​POSSIBLE_MATCH_FOUND (score supérieur au seuil d’approbation)

​COULD_NOT_PERFORM_AML_SCREENING (champs KYC manquants)

​Voir aussi

​Types d’avertissements

Overview

Avertissements produits

Paramètres configurables

Exemples

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

`COULD_NOT_PERFORM_AML_SCREENING` (champs KYC manquants)

Voir aussi

Types d’avertissements