AML स्क्रीनिंग रिपोर्ट: हिट्स, स्कोर और JSON

Overview

AML स्क्रीनिंग सत्यापित विषय की पहचान का वैश्विक प्रतिबंध, PEP, वॉचलिस्ट और प्रतिकूल मीडिया डेटासेट के साथ क्रॉस-रेफ़रेंस करती है। प्रत्येक हिट से मिलान की गई इकाई, मिलान उत्पन्न करने वाले डेटासेट, दो स्कोर — match_score (पहचान संबंधी विश्वास) और risk_score (इकाई का जोखिम) — और स्रोत के अनुसार एक संरचित विवरण (pep_matches[], sanction_matches[], warning_matches[], adverse_media_matches[]) प्राप्त होता है। समग्र score उन हिट्स में उच्चतम risk_score है जिन्हें False Positive के रूप में चिह्नित नहीं किया गया है। समान संरचना उपयोगकर्ता (KYC) सत्रों, व्यवसाय (KYB) सत्रों और स्टैंडअलोन AML API पर AML स्क्रीनिंग द्वारा लौटाई जाती है।

प्रतिबंध, PEP और प्रतिकूल मीडिया हिट्स के साथ Didit AML स्क्रीनिंग रिपोर्ट का स्क्रीनशॉट

API रिस्पॉन्स में यह कहाँ दिखाई देता है

सत्र निर्णय endpoint पर, AML स्क्रीनिंग बहुवचन ऐरे aml_screenings[] के रूप में लौटाई जाती है। प्रत्येक प्रविष्टि वर्कफ़्लो में एक AML निष्पादन से मेल खाती है (दो बार चलने वाली एक AML जांच अलग-अलग node_id मानों के साथ दो प्रविष्टियाँ उत्पन्न करती है)।

GET /v3/session/{sessionId}/decision/
  ──▶ { "aml_screenings": [ { node_id, status, total_hits, hits, … }, … ] }

स्टैंडअलोन AML और व्यवसाय सत्र समान प्रति-रिकॉर्ड संरचना लौटाते हैं। नीचे दिए गए फ़ील्ड डेटा मॉडल पेज पर कैनोनिकल स्कीमा को दर्शाते हैं।

एक नहीं, तीन स्कोर

status एक निर्णय है; जिन संख्याओं से इसे निकाला गया था वे उसी payload में मौजूद हैं। केवल Approved / In Review / Declined पर शाखा बनाने के बजाय, जब आप अपना स्वयं का जोखिम टियरिंग बनाते हैं (उदाहरण के लिए धन के स्रोत या PEP स्व-घोषणा जैसे प्रश्नावली के उत्तरों के साथ AML जोखिम को संयोजित करना) तो उन्हें पढ़ें:

स्कोर	स्थान	पैमाना	उत्तर
`hits[].match_score`	प्रति हिट	0-100	क्या यह हिट वही व्यक्ति है जिसकी स्क्रीनिंग की गई थी? हिट की प्रारंभिक `review_status` तय करता है।
`hits[].risk_score`	प्रति हिट	0-100	मिलान की गई इकाई कितनी जोखिम भरी है? हिट की श्रेणियों (प्रतिबंध, PEP, अपराध, …) द्वारा संचालित।
`score`	प्रति स्क्रीनिंग	0-100	`False Positive` चिह्नित न किए गए हिट्स में उच्चतम `risk_score`। `status` उत्पन्न करने के लिए इसी की तुलना स्वीकृति / समीक्षा थ्रेशोल्ड से की जाती है।

तीनों स्कोर उन सभी स्थानों पर मौजूद हैं जहाँ AML रिपोर्ट डिलीवर की जाती है: GET /v3/session/{sessionId}/decision/, प्रत्येक webhook संस्करण (V3 aml_screenings[], और लीगेसी V2 / V1 एकवचन aml) पर status.updated और data.updated webhook का decision ऑब्जेक्ट, और स्टैंडअलोन AML API। कोई उपभोक्ता जो केवल फ़्लैग किया गया / साफ़ लेबल देखता है, वह status (या किसी हिट की review_status) पढ़ रहा है और उसके बगल में दिए गए स्कोर को छोड़ रहा है। कंसोल समान संख्याएँ दिखाता है: AML अनुभाग हेडर में समग्र जोखिम स्कोर होता है, और मिलान तालिका की प्रत्येक पंक्ति में मिलान स्कोर और जोखिम स्कोर होवर करने पर विस्तृत विवरण के साथ दिखाई देता है।

स्कीमा

कैनोनिकल स्कीमा के लिए डेटा मॉडल संदर्भ में AML स्क्रीनिंग देखें। शीर्ष-स्तरीय फ़ील्ड:

फ़ील्ड	प्रकार	नोट्स
`status`	`Not Finished` \| `Approved` \| `Declined` \| `In Review`	सुविधा-स्तरीय स्थिति (`FeatureStatusChoices`)। वर्कफ़्लो नियमों और मैन्युअल समीक्षा स्क्रीन को संचालित करता है।
`total_hits`	integer	`hits[]` में प्रविष्टियों की संख्या। कोई मिलान न होने पर `0`।
`entity_type`	`person` \| `company`	स्क्रीन किए गए विषय का प्रकार। कंपनियाँ और व्यक्ति अलग-अलग मिलान लॉजिक का उपयोग करते हैं।
`score`	float (0-100) \| null	समग्र AML जोखिम स्कोर — `False Positive` के रूप में चिह्नित न किए गए हिट्स में उच्चतम `risk_score`। कोई संभावित मिलान न होने पर `0`; स्क्रीनिंग चलने तक `null`।
`hits`	`Hit[]`	प्रत्येक मिलान किए गए रिकॉर्ड के लिए एक प्रविष्टि, जिसमें स्वचालित रूप से `False Positive` के रूप में वर्गीकृत हिट्स भी शामिल हैं (वे सूचीबद्ध रहते हैं लेकिन समग्र `score` से बाहर रखे जाते हैं)। प्रति-हिट फ़ील्ड नीचे देखें।
`screened_data`	object	Didit द्वारा स्क्रीनिंग के लिए भेजे गए सटीक मान: `full_name`, `date_of_birth`, `nationality` (ISO 3166-1 alpha-2), `document_number`। किसी समीक्षक को हिट समझाने या क्या खोजा गया था इसका ऑडिट करने के लिए उपयोगी।
`is_ongoing_monitoring_enabled`	boolean	सत्र के लिए सतत निगरानी सक्षम करने के बाद `true`।
`next_ongoing_monitoring_bill_date`	string \| null	अगले वार्षिक बिलिंग नवीनीकरण का `YYYY-MM-DD` (`last_aml_bill_date` + 365 दिन)। निगरानी सक्षम होने तक `null`। यह स्क्रीनिंग तिथि नहीं है — नीचे `last_ongoing_screening_at` देखें।
`last_ongoing_screening_at`	string (ISO 8601) \| null	जब सतत निगरानी ने पिछली बार इस रिकॉर्ड की पुनः स्क्रीनिंग पूर्ण की थी, चाहे परिणाम बदला हो या नहीं। यदि इस फ़ील्ड के आने के बाद से रिकॉर्ड की कभी भी पुनः स्क्रीनिंग नहीं की गई है तो `null` — इसे सक्षमीकरण या बिलिंग तिथि से कभी बैक-फ़िल नहीं किया जाता है।
`last_ongoing_screening_datasets_updated_at`	string (ISO 8601) \| null	उस स्क्रीनिंग के समय प्रदाता द्वारा रिपोर्ट की गई नवीनतम AML डेटासेट अपडेट तिथि। जब प्रदाता ने कोई डेटासेट तिथियां रिपोर्ट नहीं कीं तो `null`; इसका कभी अनुमान नहीं लगाया जाता है।
`warnings`	`Warning[]`	AML-विशिष्ट चेतावनी टैग। AML चेतावनियाँ देखें।
`node_id`	string \| null	वर्कफ़्लो ग्राफ़ नोड की पहचान करता है जिसने `/v3/` सत्र रिस्पॉन्स पर यह AML निष्पादन तैयार किया। स्टैंडअलोन AML API रिस्पॉन्स इसे छोड़ देता है।

प्रति-हिट फ़ील्ड

hits[] की प्रत्येक प्रविष्टि में निम्नलिखित फ़ील्ड होते हैं (सबसेट दिखाया गया है)। मिलान-स्रोत ऐरे — pep_matches[], sanction_matches[], warning_matches[], adverse_media_matches[] — केवल उन्हीं डेटासेट के लिए पॉप्युलेट होते हैं जिनसे हिट संबंधित है।

फ़ील्ड	प्रकार	नोट्स
`id`	string	स्थिर हिट पहचानकर्ता: `hit_` के बाद 24 हेक्साडेसिमल वर्ण। जब विषय की दोबारा स्क्रीनिंग की जाती है तो वही मिलान की गई इकाई वही `id` रखती है। AML हिट-स्थिति endpoint के माध्यम से `review_status` अपडेट करते समय इसे `hit_id` के रूप में उपयोग करें।
`caption`	string	डेटासेट में संग्रहीत इकाई का प्राथमिक नाम।
`datasets`	string[]	वे जोखिम श्रेणियां जिनके तहत इकाई सूचीबद्ध है: `PEP` (इसके स्तर के साथ, `PEP Level 1` से `PEP Level 4`), `Sanctions`, `Adverse Media`, `Warnings and Regulatory Enforcement`, `Fitness and Probity`, `SIP`, `SIE` या `Insolvency`, और जब इकाई का स्रोत इनमें से किसी का भी उल्लेख नहीं करता है तो `Other Lists`।
`match_score`	number (0-100)	पहचान संबंधी विश्वास — यह संभावना कि हिट उसी व्यक्ति का है। `aml_match_score_threshold` (डिफ़ॉल्ट `93`) से नीचे के हिट्स `False Positive` के रूप में शुरू होते हैं; इसके बराबर या उससे ऊपर वे `Unreviewed` के रूप में शुरू होते हैं। AML मिलान स्कोर देखें।
`risk_score`	number (0-100)	इकाई जोखिम — मिलान की गई इकाई कितनी जोखिम भरी है। गैर-`False Positive` हिट्स में उच्चतम `risk_score` शीर्ष-स्तरीय `score` बन जाता है। AML जोखिम स्कोर देखें।
`score`	number (0-1)	पदावनत भारित मिलान स्कोर। इसके बजाय `match_score` का उपयोग करें।
`match`	boolean \| null	लीगेसी सटीक-मिलान फ़्लैग। `match_score` + `review_status` को प्राथमिकता दें।
`target`	boolean \| null	क्या इकाई लिस्टिंग का प्रत्यक्ष लक्ष्य है।
`review_status`	`Unreviewed` \| `Confirmed Match` \| `False Positive` \| `Inconclusive`	प्रारंभिक मान `match_score` बनाम `aml_match_score_threshold` से लिया गया है। AML हिट-स्थिति endpoint के माध्यम से बदला जा सकता है; इसे अपडेट करने पर `data.updated` webhook ट्रिगर होता है लेकिन सुविधा `status` की स्वचालित रूप से पुनर्गणना नहीं होती है — इसके लिए AML स्थिति endpoint या कंसोल समीक्षा का उपयोग करें।
`score_breakdown`	object	`match_score` की गणना कैसे की गई थी: नाम/DOB/देश स्कोर, वेटेज, योगदान, और दस्तावेज़ संख्या की “गोल्डन की” का प्रभाव (`MATCH` 100 पर ओवरराइड करता है, `NEUTRAL` बेस स्कोर रखता है, `HARD_MISMATCH` पेनेलाइज़ करता है)।
`properties`	object	रॉ डेटासेट विशेषताएँ (नाम, उपनाम, जन्म तिथियां, नागरिकता, …)। निर्णय के लिए उपयोगी।
`url`	string \| null	मिलान की गई इकाई के लिए स्रोत URL, जब उपलब्ध हो।
`rca_name`	string \| null	जब हिट कोई रिश्तेदार/करीबी सहयोगी (RCA) हो, तो संबंधित व्यक्ति का नाम जिसके माध्यम से यह मेल खाता है।
`pep_matches[]`	object[]	हिट के लिए PEP पद, प्रकाशक, जन्म तिथियां और शिक्षा।
`sanction_matches[]`	object[]	प्रतिबंध सूची का नाम, कार्यक्रम, प्रतिबंध लगाने वाला प्राधिकरण, सूचीबद्ध होने की तिथि और स्रोत URL।
`warning_matches[]`	object[]	जेनेरिक वॉचलिस्ट या प्रवर्तन-कार्रवाई रिकॉर्ड।
`adverse_media_matches[]`	object[]	लेख-स्तरीय प्रतिकूल मीडिया: शीर्षक, सारांश, भावना, स्रोत URL, प्रकाशन तिथि, कीवर्ड।
`adverse_media_details`	object \| null	पूरे हिट में समग्र प्रतिकूल-मीडिया भावना और कीवर्ड गणना।
`risk_view`	object	हिट के लिए श्रेणी-, देश-, और अपराध-भारित जोखिम विवरण (`risk_level`, `risk_scores`, `weightage`)।
`linked_entities[]`	object[]	संबंधित इकाइयाँ जिन्हें डेटासेट हिट से जोड़ता है (उदा., परिवार या व्यावसायिक सहयोगी)।
`first_seen` / `last_seen`	string \| null	जब डेटासेट ने पहली/आखिरी बार इस प्रविष्टि को देखा था।
`additional_information`	object	डेटासेट प्रदाता से मुक्त-प्रारूप अतिरिक्त डेटा।

False Positive के रूप में वर्गीकृत किए गए हिट्स (क्योंकि match_score मिलान-स्कोर थ्रेशोल्ड से नीचे गिर गया था, या किसी समीक्षक ने उन्हें चिह्नित किया था) ऑडिटेबिलिटी के लिए hits[] में बने रहते हैं। उन्हें केवल समग्र score गणना से बाहर रखा जाता है।

सतत निगरानी

जब is_ongoing_monitoring_enabled का मान true होता है, तो Didit विषय को लगातार पुनः स्क्रीन करता है और जब भी कोई हिट जोड़ी जाती है, हटाई जाती है या बदलती है, तो AML रिपोर्ट फिर से जारी करता है। ऐसी पुनः स्क्रीनिंग जो AML स्थिति को बदलती हैं, वे status.updated webhook ट्रिगर करती हैं; ऐसी पुनः स्क्रीनिंग जो केवल हिट डेटा को बदलती हैं, वे data.updated ट्रिगर करती हैं। निगरानी विंडो last_aml_bill_date से 365 दिनों तक चलती है; next_ongoing_monitoring_bill_date यह दर्शाती है कि अगला वार्षिक नवीनीकरण कब होगा। वे सभी सिग्नल परिवर्तन-आधारित होते हैं, इसलिए बिना किसी नए हिट के महीनों तक पुनः स्क्रीन किए गए विषय के लिए इनमें से कोई भी सिग्नल उत्पन्न नहीं होता है। last_ongoing_screening_at वह एकमात्र फ़ील्ड है जो प्रत्येक पूर्ण रन पर अपडेट होता है, और screening-history endpoint प्रत्येक रन को व्यक्तिगत रूप से सूचीबद्ध करता है — जिसमें वे रन भी शामिल हैं जिन्होंने कुछ भी नहीं बदला। संपूर्ण जीवनचक्र के लिए सतत AML निगरानी देखें।

इस रिपोर्ट की तीन तारीखों का अर्थ तीन अलग-अलग चीजें हैं। next_ongoing_monitoring_bill_date वह समय है जब आपको अगली बार बिल भेजा जाएगा। last_ongoing_screening_at वह समय है जब विषय को पिछली बार वास्तव में स्क्रीन किया गया था। last_ongoing_screening_datasets_updated_at वह समय है जब उस स्क्रीनिंग से संबद्ध सूचियों को प्रदाता द्वारा पिछली बार रीफ़्रेश किया गया था। केवल दूसरा वाला ही यह प्रमाणित करता है कि नियंत्रण चलाया गया था।

स्थिति मान

मान	अर्थ
`Not Finished`	इस सत्र/नोड के लिए AML अभी तक निष्पादित नहीं हुआ है।
`Approved`	समग्र स्कोर स्वीकृति थ्रेशोल्ड (डिफ़ॉल्ट `80`) पर या उससे नीचे है — जिसमें वह स्थिति भी शामिल है जब कोई हिट नहीं होती है या प्रत्येक हिट एक `False Positive` (स्कोर `0`) होती है।
`In Review`	समग्र स्कोर स्वीकृति थ्रेशोल्ड से ऊपर है (और समीक्षा थ्रेशोल्ड पर या उससे नीचे है), या `COULD_NOT_PERFORM_AML_SCREENING` ट्रिगर हुआ है।
`Declined`	समग्र स्कोर समीक्षा थ्रेशोल्ड से ऊपर है (डिफ़ॉल्ट `100`, इसलिए ऑटो-अस्वीकृति केवल तभी होती है जब आप इसे कम करते हैं), या स्थिति मैन्युअल रूप से सेट की गई थी।

थ्रेशोल्ड प्रति वर्कफ़्लो नोड कॉन्फ़िगर करने योग्य हैं — AML जोखिम स्कोर देखें। कस्टम स्थिति नियम Declined > In Review > Approved वरीयता का उपयोग करके व्युत्पन्न स्थिति के साथ संयोजित होते हैं; समीक्षक कंसोल या AML स्थिति endpoint से भी AML स्थिति को ओवरराइड कर सकते हैं।

उदाहरण

स्वीकृत — कोई हिट नहीं

{
  "aml_screenings": [
    {
      "node_id": "aml-1",
      "status": "Approved",
      "total_hits": 0,
      "entity_type": "person",
      "score": 0,
      "hits": [],
      "screened_data": {
        "full_name": "Jane Doe",
        "nationality": "US",
        "date_of_birth": "1990-06-12",
        "document_number": "P9876543"
      },
      "is_ongoing_monitoring_enabled": false,
      "last_ongoing_screening_at": null,
      "last_ongoing_screening_datasets_updated_at": null,
      "next_ongoing_monitoring_bill_date": null,
      "warnings": []
    }
  ]
}

समीक्षाधीन — PEP + प्रतिकूल मीडिया हिट

नीचे दिए गए सभी नाम, URL और लेख काल्पनिक हैं।

{
  "aml_screenings": [
    {
      "node_id": "aml-1",
      "status": "In Review",
      "total_hits": 1,
      "entity_type": "person",
      "score": 85,
      "hits": [
        {
          "id": "hit_7c1e9a40b2d35f86e0a4c912",
          "caption": "John Q. Exampleton",
          "datasets": ["PEP"],
          "match_score": 96,
          "risk_score": 85,
          "score": 0.97,
          "match": false,
          "target": null,
          "review_status": "Unreviewed",
          "properties": {
            "name": ["John Q. Exampleton"],
            "alias": ["Johnny Example"],
            "birthDate": ["1974"],
            "birthPlace": ["Springfield"]
          },
          "score_breakdown": {
            "name_score": 95,
            "name_weight": 60,
            "name_weight_normalized": 70.59,
            "name_contribution": 67.06,
            "dob_score": 100,
            "dob_weight": 25,
            "dob_weight_normalized": 29.41,
            "dob_contribution": 29.41,
            "country_score": 0,
            "country_weight": 15,
            "country_weight_normalized": 0,
            "country_contribution": 0,
            "document_number_match_type": "NEUTRAL",
            "document_number_effect": "No document number provided for screening",
            "total_score": 96
          },
          "pep_matches": [
            {
              "list_name": "Example PEP Registry",
              "publisher": "Example Registry",
              "matched_name": "John Q. Exampleton",
              "pep_position": "Regional council member",
              "date_of_birth": "1974-01-01",
              "place_of_birth": "Springfield",
              "source_url": "https://example.org/registry/entities/Q0000001"
            }
          ],
          "sanction_matches": [],
          "warning_matches": [],
          "adverse_media_matches": [
            {
              "country": "freedonia",
              "headline": "Court opens inquiry into council hiring irregularities",
              "summary": "John Q. Exampleton is named in a legal investigation regarding irregularities in public hiring.",
              "sentiment": "moderately negative",
              "sentiment_score": -2,
              "source_url": "https://example-news.org/articles/12345",
              "publication_date": "2025-06-09T10:19:10",
              "adverse_keywords": ["fraud", "irregularities"]
            }
          ],
          "adverse_media_details": {
            "sentiment": "Moderately Negative",
            "sentiment_score": -2,
            "entity_type": "person",
            "adverse_keywords": { "fraud": 3, "corruption": 2 }
          },
          "risk_view": {
            "categories": { "score": 100.0, "weightage": 50, "risk_level": "High", "risk_scores": { "PEP": 100.0 } },
            "countries":  { "score": 0.0,   "weightage": 30, "risk_level": "Low",  "risk_scores": {} },
            "crimes":     { "score": 0.0,   "weightage": 20, "risk_level": "Low",  "risk_scores": {} },
            "custom_list": {}
          },
          "linked_entities": [
            { "name": ["Mary Exampleton"], "relation": [], "details": [], "active": [], "status": [] }
          ],
          "first_seen": "2025-01-18T00:00:00",
          "last_seen": "2025-06-13T00:00:00"
        }
      ],
      "screened_data": {
        "full_name": "John Q. Exampleton",
        "nationality": "US",
        "date_of_birth": "1974-01-01",
        "document_number": null
      },
      "is_ongoing_monitoring_enabled": true,
      "next_ongoing_monitoring_bill_date": "2027-05-17",
      "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"
        }
      ]
    }
  ]
}

प्रमाणीकरण

सत्यापन

निगरानी

प्लेटफ़ॉर्म

AML स्क्रीनिंग रिपोर्ट: हिट्स, स्कोर और JSON

Overview

API रिस्पॉन्स में यह कहाँ दिखाई देता है

एक नहीं, तीन स्कोर

स्कीमा

प्रति-हिट फ़ील्ड

सतत निगरानी

स्थिति मान

उदाहरण

स्वीकृत — कोई हिट नहीं

समीक्षाधीन — PEP + प्रतिकूल मीडिया हिट

संबंधित

​Overview

​API रिस्पॉन्स में यह कहाँ दिखाई देता है

​एक नहीं, तीन स्कोर

​स्कीमा

​प्रति-हिट फ़ील्ड

​सतत निगरानी

​स्थिति मान

​उदाहरण

​स्वीकृत — कोई हिट नहीं

​समीक्षाधीन — PEP + प्रतिकूल मीडिया हिट

​संबंधित

Overview

API रिस्पॉन्स में यह कहाँ दिखाई देता है

एक नहीं, तीन स्कोर

स्कीमा

प्रति-हिट फ़ील्ड

सतत निगरानी

स्थिति मान

उदाहरण

स्वीकृत — कोई हिट नहीं

समीक्षाधीन — PEP + प्रतिकूल मीडिया हिट

संबंधित