تقرير فحص AML: التطابقات والدرجات وتنسيق JSON

نظرة عامة

يُجري فحص AML مطابقة تقاطعية لهوية الشخص الذي تم التحقق منه مع مجموعات بيانات العقوبات العالمية، والأشخاص المعرضين سياسياً (PEP)، وقوائم المراقبة، والأخبار السلبية. تُرجع كل نتيجة مطابقة الكيان المطابق، ومجموعة (أو مجموعات) البيانات التي أنتجت المطابقة، ودرجتين — match_score (الثقة في الهوية) وrisk_score (مخاطر الكيان) — بالإضافة إلى تفصيل منظم حسب المصدر (pep_matches[]، وsanction_matches[]، وwarning_matches[]، وadverse_media_matches[]). تمثل الدرجة الإجمالية score أعلى risk_score بين نتائج المطابقة التي لم يتم تمييزها كـ False Positive. يتم إرجاع نفس البنية بواسطة فحص AML في جلسات المستخدمين (KYC)، وجلسات الشركات (KYB)، وAPI الخاص بفحص AML المستقل.

لقطة شاشة لتقرير فحص AML من Didit مع نتائج مطابقة للعقوبات والأشخاص المعرضين سياسياً والأخبار السلبية

أين يظهر في استجابات 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. اقرأها عندما تبني تصنيف المخاطر الخاص بك (على سبيل المثال الجمع بين مخاطر AML وإجابات الاستبيانات مثل مصدر الثروة أو الإقرار الذاتي بكون الشخص معرضاً سياسياً) بدلاً من التفريع فقط بناءً على Approved / In Review / Declined:

الدرجة	المكان	المقياس	ما الذي تجيب عنه
`hits[].match_score`	لكل نتيجة مطابقة	0-100	هل نتيجة المطابقة هذه هي نفس الشخص الذي تم فحصه؟ تحدد `review_status` الأولي لنتيجة المطابقة.
`hits[].risk_score`	لكل نتيجة مطابقة	0-100	ما مدى خطورة الكيان المطابق؟ يعتمد على فئات نتيجة المطابقة (عقوبات، شخص معرض سياسياً، جريمة، …).
`score`	لكل عملية فحص	0-100	أعلى `risk_score` بين نتائج المطابقة التي لم يتم تمييزها كـ `False Positive`. هذا هو ما تتم مقارنته مع حدود القبول / المراجعة لإنتاج `status`.

تتواجد الثلاثة جميعها في كل مكان يُسلَّم فيه تقرير AML: في GET /v3/session/{sessionId}/decision/، وكائن decision في webhooks الخاصة بـ status.updated وdata.updated في كل إصدار من إصدارات webhook (مصفوفة aml_screenings[] في V3، وaml بصيغة المفرد القديمة في V2 / V1)، وAPI الخاص بفحص AML المستقل. والطرف المستهلك الذي يرى فقط تصنيف «مُعلَّم» / «واضح» يقرأ status (أو review_status لنتيجة المطابقة) ويتجاهل الدرجات المجاورة له. تعرض لوحة التحكم نفس الأرقام: يحمل رأس قسم AML درجة المخاطر الإجمالية، ويحمل كل صف في جدول المطابقات درجة التطابق ودرجة المخاطر مع تفصيل يظهر عند التمرير بالفأرة.

المخطط

راجع فحص AML في مرجع نماذج البيانات لمعرفة المخطط المعتمد. الحقول من المستوى الأعلى:

الحقل	النوع	ملاحظات
`status`	`Not Finished` \| `Approved` \| `Declined` \| `In Review`	حالة على مستوى الميزة (`FeatureStatusChoices`). تقود قواعد سير العمل وشاشة المراجعة اليدوية.
`total_hits`	عدد صحيح	عدد الإدخالات في `hits[]`. القيمة `0` عند عدم وجود أي تطابقات.
`entity_type`	`person` \| `company`	نوع الكيان المفحوص. تستخدم الشركات والأفراد منطق تطابق مختلفاً.
`score`	عدد عشري (0-100) \| null	درجة مخاطر AML الإجمالية — أعلى `risk_score` بين النتائج غير المصنفة كـ `False Positive`. القيمة `0` عند عدم وجود تطابقات محتملة؛ و`null` حتى يتم تشغيل الفحص.
`hits`	`Hit[]`	إدخال واحد لكل سجل متطابق، بما في ذلك النتائج المصنفة تلقائياً كـ `False Positive` (تظل مدرجة ولكن تُستبعد من `score` الإجمالي). راجع الحقول الخاصة بكل نتيجة أدناه.
`screened_data`	كائن	القيم الدقيقة التي أرسلتها Didit للفحص: `full_name`، `date_of_birth`، `nationality` (ISO 3166-1 alpha-2)، `document_number`. مفيدة لتوضيح النتيجة للمراجع أو لتدقيق ما تم البحث عنه.
`is_ongoing_monitoring_enabled`	قيمة منطقية	`true` بمجرد تفعيل المراقبة المستمرة للجلسة.
`next_ongoing_monitoring_bill_date`	سلسلة نصية \| null	بتنسيق `YYYY-MM-DD` لتاريخ تجديد الفوترة السنوي التالي (`last_aml_bill_date` + 365 يوماً). القيمة `null` حتى يتم تفعيل المراقبة. هذا ليس تاريخ فحص — راجع `last_ongoing_screening_at` أدناه.
`last_ongoing_screening_at`	سلسلة نصية (ISO 8601) \| null	وقت آخر عملية إعادة فحص مكتملة لهذا السجل بواسطة المراقبة المستمرة، سواء تغيرت النتيجة أم لا. تكون القيمة `null` عندما لا يكون السجل قد خضع لإعادة الفحص مطلقاً منذ إطلاق هذا الحقل — ولا يتم ملؤه بأثر رجعي من تاريخ التفعيل أو الفوترة أبداً.
`last_ongoing_screening_datasets_updated_at`	سلسلة نصية (ISO 8601) \| null	أحدث تاريخ تحديث لمجموعة بيانات AML أبلغ عنه المزود في وقت ذلك الفحص. تكون القيمة `null` عندما لا يبلغ المزود عن أي تواريخ لمجموعات البيانات؛ ولا يتم تقديره مطلقاً.
`warnings`	`Warning[]`	وسوم تحذير خاصة بفحص AML. راجع تحذيرات AML.
`node_id`	سلسلة نصية \| null	يحدد عقدة مخطط سير العمل التي أنتجت تنفيذ AML هذا في استجابات جلسة `/v3/`. لا تتضمنه استجابة واجهة برمجة تطبيقات AML المستقلة.

حقول كل نتيجة

يحتوي كل إدخال في hits[] على الحقول التالية (يظهر جزء منها). يتم ملء مصفوفات مصدر التطابق — pep_matches[]، وsanction_matches[]، وwarning_matches[]، وadverse_media_matches[] — فقط لمجموعة (أو مجموعات) البيانات التي تنتمي إليها النتيجة.

الحقل	النوع	ملاحظات
`id`	سلسلة نصية	معرّف ثابت للنتيجة: `hit_` متبوعاً بـ 24 حرفاً بالنظام الست عشري. يحتفظ الكيان المتطابق نفسه بنفس المعرّف `id` عند إعادة فحص الكيان نفسه. استخدمه كـ `hit_id` عند تحديث `review_status` عبر endpoint الخاص بحالة نتيجة AML.
`caption`	سلسلة نصية	الاسم الأساسي للكيان كما هو مخزن في مجموعة البيانات.
`datasets`	سلسلة نصية[]	فئات المخاطر المدرج تحتها الكيان: `PEP` (مع مستواه، من `PEP Level 1` إلى `PEP Level 4`)، و`Sanctions`، و`Adverse Media`، و`Warnings and Regulatory Enforcement`، و`Fitness and Probity`، و`SIP`، و`SIE` أو `Insolvency`، و`Other Lists` عندما لا يحدد مصدر الكيان أيّاً منها.
`match_score`	رقم (0-100)	الثقة في الهوية — مدى احتمالية أن تكون النتيجة لنفس الشخص. النتائج الأقل من `aml_match_score_threshold` (الافتراضي `93`) تبدأ كـ `False Positive`؛ والنتائج التي تساوي هذا الحد أو تتجاوزه تبدأ كـ `Unreviewed`. راجع درجة تطابق AML.
`risk_score`	رقم (0-100)	مخاطر الكيان — مدى خطورة الكيان المتطابق. أعلى `risk_score` بين النتائج غير المصنفة كـ `False Positive` يصبح هو `score` في المستوى الأعلى. راجع درجة مخاطر AML.
`score`	رقم (0-1)	درجة التطابق الموزونة المهملة. استخدم `match_score` بدلاً منها.
`match`	قيمة منطقية \| null	علامة التطابق التام القديمة. يفضل استخدام `match_score` + `review_status`.
`target`	قيمة منطقية \| null	ما إذا كان الكيان هو الهدف المباشر للإدراج.
`review_status`	`Unreviewed` \| `Confirmed Match` \| `False Positive` \| `Inconclusive`	تُشتق القيمة الأولية من مقارنة `match_score` مقابل `aml_match_score_threshold`. قابلة للتعديل عبر endpoint الخاص بحالة نتيجة AML؛ يؤدي تحديثها إلى إطلاق webhook بالحدث `data.updated` ولكنه لا يعيد احتساب `status` للميزة تلقائياً — استخدم endpoint الخاص بحالة AML أو المراجعة عبر لوحة التحكم لذلك.
`score_breakdown`	كائن	كيفية احتساب `match_score`: درجات الاسم/تاريخ الميلاد/الدولة، والأوزان، والمساهمات، وتأثير “المفتاح الذهبي” لرقم المستند (`MATCH` يضبط النتيجة على 100، و`NEUTRAL` يحتفظ بالدرجة الأساسية، و`HARD_MISMATCH` يفرض خصماً).
`properties`	كائن	سمات مجموعة البيانات الأولية (الأسماء، والأسماء المستعارة، وتواريخ الميلاد، والجنسية، …). مفيدة لاتخاذ القرار.
`url`	سلسلة نصية \| null	الرابط المصدري للكيان المتطابق، عند توفره.
`rca_name`	سلسلة نصية \| null	عندما تكون النتيجة لأحد الأقارب أو الشركاء المقربين (RCA)، يمثل هذا اسم الشخص ذي الصلة الذي حدث التطابق من خلاله.
`pep_matches[]`	كائن[]	مناصب الأشخاص المعرضين سياسياً (PEP)، والجهات الناشرة، وتواريخ الميلاد، والتعليم الخاص بالنتيجة.
`sanction_matches[]`	كائن[]	اسم قائمة العقوبات، والبرنامج، والجهة الفارضة للعقوبات، وتاريخ الإدراج، وروابط المصدر.
`warning_matches[]`	كائن[]	سجلات قوائم المراقبة العامة أو إجراءات الإنفاذ التنظيمي.
`adverse_media_matches[]`	كائن[]	الأخبار السلبية على مستوى المقال: العنوان، والملخص، والمشاعر، ورابط المصدر، وتاريخ النشر، والكلمات المفتاحية.
`adverse_media_details`	كائن \| null	تحليل المشاعر الإجمالي للأخبار السلبية وتعداد الكلمات المفتاحية عبر النتيجة.
`risk_view`	كائن	تفصيل المخاطر الموزونة حسب الفئة والدولة والجريمة للنتيجة (`risk_level`، `risk_scores`، `weightage`).
`linked_entities[]`	كائن[]	الكيانات ذات الصلة التي تربطها مجموعة البيانات بالنتيجة (مثل العائلة أو شركاء العمل).
`first_seen` / `last_seen`	سلسلة نصية \| null	متى رصدت مجموعة البيانات هذا الإدخال لأول مرة/آخر مرة.
`additional_information`	كائن	بيانات إضافية حرة من مزود مجموعة البيانات.

تظل النتائج المصنفة كـ False Positive (بسبب انخفاض match_score عن حد درجة التطابق، أو لأن المراجع حددها كذلك) موجودة في hits[] لأغراض التدقيق. ولا يتم استبعادها إلا من عملية احتساب score الإجمالي فقط.

المراقبة المستمرة

عندما تكون قيمة is_ongoing_monitoring_enabled هي true، تعيد Didit فحص الشخص المعني باستمرار وتُعيد إصدار تقرير AML في أي وقت تُضاف فيه نتيجة مطابقة، أو تُزال، أو تتغير. عمليات إعادة الفحص التي تُغيّر حالة AML تُطلق webhook من نوع status.updated؛ بينما عمليات إعادة الفحص التي تُغيّر بيانات نتائج المطابقة فقط تُطلق data.updated. تمتد نافذة المراقبة بدءاً من last_aml_bill_date لمدة 365 يوماً؛ ويوضح next_ongoing_monitoring_bill_date موعد حلول التجديد السنوي التالي. تعتمد كل هذه الإشارات على التغييرات، لذا فإن الشخص الذي يُعاد فحصه لعدة أشهر دون أي نتائج مطابقة جديدة لن يُنتج أيًا منها. يُعد last_ongoing_screening_at الحقل الوحيد الذي يتحدّث بعد كل عملية تشغيل مكتملة، ويسرد 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.

أمثلة

قيد المراجعة — نتيجة مطابقة لـ 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

نظرة عامة

أين يظهر في استجابات API

ثلاث درجات، وليس حكماً واحداً

المخطط

حقول كل نتيجة

المراقبة المستمرة

قيم الحالة

أمثلة

مقبولة — لا توجد نتائج مطابقة

قيد المراجعة — نتيجة مطابقة لـ PEP + الأخبار السلبية

ذات صلة

​نظرة عامة

​أين يظهر في استجابات API

​ثلاث درجات، وليس حكماً واحداً

​المخطط

​حقول كل نتيجة

​المراقبة المستمرة

​قيم الحالة

​أمثلة

​مقبولة — لا توجد نتائج مطابقة

​قيد المراجعة — نتيجة مطابقة لـ PEP + الأخبار السلبية

​ذات صلة

نظرة عامة

أين يظهر في استجابات API

ثلاث درجات، وليس حكماً واحداً

المخطط

حقول كل نتيجة

المراقبة المستمرة

قيم الحالة

أمثلة

مقبولة — لا توجد نتائج مطابقة

قيد المراجعة — نتيجة مطابقة لـ PEP + الأخبار السلبية

ذات صلة