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

# AML स्क्रीनिंग चेतावनियाँ और अलर्ट कोड

> Didit के AML चेतावनी कोड (POSSIBLE_MATCH_FOUND) समझें। KYC डेटा गायब होने पर थ्रेशोल्ड और पुनः रन करने का व्यवहार कॉन्फ़िगर करें।

## अवलोकन

AML स्क्रीनिंग `aml_screenings[]` में प्रत्येक प्रविष्टि की `warnings[]` सरणी में चेतावनी टैग का एक छोटा सेट जारी करती है। नीचे दिए गए दो टैग **एकमात्र** ऐसी AML चेतावनियाँ हैं जो Didit उत्पन्न करता है — हिट पर दिखने वाली बाकी सभी चीज़ें चेतावनी के रूप में होने के बजाय हिट के अपने फ़ील्ड (`risk_view`, `match_score`, `risk_score`, `sanction_matches[]`, …) में एन्कोड होती हैं। वर्कफ़्लो सत्र और स्टैंडअलोन AML API दोनों `POSSIBLE_MATCH_FOUND` को एक ही तरह से जारी करते हैं।

AML रिकॉर्ड पर लौटाया गया स्टेटस (`Approved`, `In Review`, `Declined`) कुल `score` और आपके थ्रेशोल्ड से प्राप्त होता है — चेतावनियाँ उन्हीं स्थितियों को टैग करती हैं ताकि आप उन पर प्रोग्रामेटिक रूप से प्रतिक्रिया दे सकें। थ्रेशोल्ड स्टेटस से कैसे मैप होते हैं, इसके लिए [AML जोखिम स्कोर](https://docs.didit.me/hi/core-technology/aml-screening/aml-risk-score.md) देखें।

## उत्पन्न होने वाली चेतावनियाँ

| जोखिम | कारण | `log_type` | स्टेटस को प्रभावित करता है | सुझाई गई समस्या निवारण कार्रवाई |
| - | - | - | - | - |
| `POSSIBLE_MATCH_FOUND` | कुल `score` गैर-शून्य है और `aml_score_approve_threshold` (डिफ़ॉल्ट `80`) से ऊपर है — कम से कम एक संभावित मिलान वाला हिट आपके जोखिम बैंड को पार करता है। (स्टैंडअलोन AML API इसे तब भी जारी करता है जब स्कोर बिल्कुल थ्रेशोल्ड के बराबर होता है।) | `warning`; यदि स्कोर `aml_score_review_threshold` (डिफ़ॉल्ट `100`) से अधिक हो जाता है, तो यह `error` में बदल जाता है। | जब स्कोर स्वीकृति थ्रेशोल्ड से ऊपर हो तो `In Review`; जब यह समीक्षा थ्रेशोल्ड से ऊपर हो तो `Declined`। | `hits[]` में प्रत्येक हिट की समीक्षा करें। हिट्स को `Confirmed Match`, `False Positive`, या `Inconclusive` के रूप में चिह्नित करने के लिए AML हिट-स्टेटस endpoint का उपयोग करें। हिट अपडेट `data.updated` webhook को ट्रिगर करते हैं लेकिन AML स्टेटस की पुनर्गणना नहीं करते हैं — AML स्टेटस endpoint या कंसोल समीक्षा के माध्यम से अंतिम स्टेटस सेट करें। |
| `COULD_NOT_PERFORM_AML_SCREENING` | KYC रिकॉर्ड में `full_name`, `date_of_birth`, या `issuing_state` में से एक या अधिक फ़ील्ड गायब हैं। कोई बिल योग्य स्क्रीनिंग कॉल नहीं की जाती है। | `warning` | `In Review` पर रखता है। | KYC रिकॉर्ड पर छूटे हुए फ़ील्ड भरें। तीनों फ़ील्ड मौजूद होने पर AML स्वचालित रूप से फिर से चलता है — पुराना चेतावनी लॉग हटा दिया जाता है और किसी मैन्युअल पुनः ट्रिगर की आवश्यकता नहीं होती है। |

चेतावनियाँ `feature: "AML"` के साथ संग्रहीत की जाती हैं और मानक [चेतावनी ऑब्जेक्ट](https://docs.didit.me/hi/reference/data-models.md#चेतावनी-ऑब्जेक्ट) की संरचना का पालन करती हैं।

## कॉन्फ़िगर करने योग्य सेटिंग्स

प्रति-वर्कफ़्लो-नोड AML नियंत्रण (स्टैंडअलोन AML API पर विकल्पों के रूप में भी स्वीकार किए जाते हैं):

* **`aml_score_approve_threshold`** — डिफ़ॉल्ट `80`। इससे ऊपर का गैर-शून्य स्कोर `POSSIBLE_MATCH_FOUND` उत्पन्न करता है और AML जांच को `In Review` पर भेज देता है। इसके बराबर या उससे कम का स्कोर सत्र वर्कफ़्लो में यह चेतावनी उत्पन्न **नहीं** करता है, भले ही हिट की संख्या कितनी भी हो।
* **`aml_score_review_threshold`** — डिफ़ॉल्ट `100`। इससे ऊपर का स्कोर AML जांच को स्वचालित रूप से अस्वीकार कर देता है (डिफ़ॉल्ट `100` होने पर यह तब तक कभी ट्रिगर नहीं होता जब तक आप इसे कम न करें)।
* **`aml_match_score_threshold`** — डिफ़ॉल्ट `93`। प्रति-हिट वर्गीकरण: इससे कम `match_score` वाले हिट्स `False Positive` के रूप में शुरू होते हैं और कुल स्कोर से बाहर रखे जाते हैं; इसके बराबर या इससे अधिक होने पर वे `Unreviewed` के रूप में शुरू होते हैं।
* **मैच-स्कोर वेटेज** — `aml_name_weight` / `aml_dob_weight` / `aml_country_weight`, डिफ़ॉल्ट `60` / `25` / `15` (कुल योग 100 होना चाहिए)। देखें [AML मैच स्कोर](https://docs.didit.me/hi/core-technology/aml-screening/aml-match-score.md)।
* **सतत निगरानी** — सक्षम होने पर, डेटासेट बदलते ही AML विषय की फिर से स्क्रीनिंग करता है और रिपोर्ट के साथ-साथ एक `status.updated` (स्टेटस बदलने पर) या `data.updated` (हिट्स बदलने पर) webhook पुनः जारी करता है।

> [!NOTE]
>
> जब `COULD_NOT_PERFORM_AML_SCREENING` ट्रिगर होता है, तो AML जांच तब तक `In Review` पर रहती है जब तक कि छूटे हुए पहचान फ़ील्ड प्रदान नहीं किए जाते। जैसे ही Didit को पूरा नाम, जन्म तिथि और जारीकर्ता राज्य मिल जाता है, AML स्वचालित रूप से फिर से चलता है और चेतावनी हट जाती है — इसमें किसी मैन्युअल पुनः ट्रिगर की आवश्यकता नहीं होती है।

## उदाहरण

### `POSSIBLE_MATCH_FOUND` (स्वीकृति थ्रेशोल्ड से ऊपर स्कोर)

```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` (छूटे हुए KYC फ़ील्ड)

```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"
    }
  ]
}
```

## संबंधित

* [AML रिपोर्ट](https://docs.didit.me/hi/core-technology/aml-screening/report-aml-screening.md) — पूर्ण रिस्पॉन्स संरचना, हिट फ़ील्ड, स्टेटस सिमेंटिक्स
* [AML जोखिम स्कोर](https://docs.didit.me/hi/core-technology/aml-screening/aml-risk-score.md) — कुल स्कोर की गणना कैसे की जाती है
* [AML मैच स्कोर](https://docs.didit.me/hi/core-technology/aml-screening/aml-match-score.md) — प्रति-हिट विश्वास स्कोर
* [सतत AML निगरानी](https://docs.didit.me/hi/core-technology/aml-screening/continuous-monitoring-aml-screening.md) — निगरानी जीवनचक्र
* [डेटा मॉडल — AML स्क्रीनिंग](https://docs.didit.me/hi/reference/data-models.md#aml-स्क्रीनिंग) — कैनोनिकल स्कीमा, जिसमें [चेतावनी ऑब्जेक्ट](https://docs.didit.me/hi/reference/data-models.md#चेतावनी-ऑब्जेक्ट) शामिल है

### चेतावनी प्रकार


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