> ## 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 عبر API: العقوبات والأشخاص المعرضون سياسياً (PEP) > افحص المستخدمين فورياً مع Didit ضد أكثر من 1,300 قاعدة بيانات للعقوبات وPEP وقوائم المراقبة مقابل $0.20 لكل استدعاء وبلا عقود. يتحقق فحص AML من Didit من الشخص في الوقت الفعلي مقابل 1,300+ مصدر عالمي للعقوبات، والأشخاص المعرضين سياسياً (PEP)، وقوائم المراقبة، والأخبار السلبية، ويعيد كل تطابق محتمل مع درجتين: درجة التطابق لمدى احتمالية أن يكون التطابق هو الشخص نفسه، ودرجة المخاطر لمدى خطورة الكيان المدرج. موجّه تكامل فحص AML نسخ الموجّه إلى الحافظة \

\````# Goal
Integrate Didit AML Screening (PEP, sanctions, warnings, adverse media) into your app. Pick ONE mode.

\# Mode A — Session-based
Run AML as a step inside a verification session. Decisions, ongoing monitoring, and audit history are bound to the session and surfaced in the Business Console.

1\. Add the AML feature to the workflow (Business Console or POST /v3/workflows/). Configure thresholds: aml_match_score_threshold, aml_score_approve_threshold, aml_score_review_threshold, and the weights aml_name_weight + aml_dob_weight + aml_country_weight (must sum to 100).
2\. Create a session — POST /v3/session/ with { workflow_id, vendor_data, callback }. See /sessions-api/create-session.
3\. Fetch the decision — GET /v3/session/{sessionId}/decision/ or subscribe to session.status.updated.

Decision surface: `aml_screenings[]` array on the decision payload.

\# Mode B — Standalone API (server-to-server)
Use when you want a one-shot AML check decoupled from a hosted KYC flow.

POST https://verification.didit.me/v3/aml/
x-api-key: YOUR_API_KEY
Content-Type: application/json

curl example:
\```bash
curl -X POST 'https://verification.didit.me/v3/aml/' \
-H "x-api-key: $DIDIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"full_name": "Javier Ejemplo Modelo",
"entity_type": "person",
"date_of_birth": "1974-01-01",
"nationality": "ES",
"include_adverse_media": true,
"vendor_data": "user-1234"
}'
\```
Returns: { request_id, aml: { status, screening_id, hits: [...], warnings: [...] } }.

\# Important policy rules
\- aml_name_weight + aml_dob_weight + aml_country_weight must equal exactly 100 — request rejected with HTTP 400 otherwise.
\- include_adverse_media=true increases latency to ~25s; use a client timeout of at least 45s.
\- include_ongoing_monitoring=true keeps the entity under daily re-screening at **$0.07 per year per screened entity** (billing alert) and requires save_api_request=true (HTTP 400 otherwise). Disable from the Business Console.

\# Status enum (per aml_screenings[].status / aml.status)
"Not Started" | "In Progress" | "Approved" | "In Review" | "Declined" | "Abandoned" | "Kyc Expired"

\# Warnings (LogWarningChoices.AML)
warnings[] risk codes include:
POSSIBLE_MATCH_FOUND, MATCH_FOUND, HIGH_RISK_COUNTRY, ADVERSE_MEDIA_HIT, SANCTIONED_ENTITY, PEP_MATCH, ONGOING_MONITORING_ENABLED.
Full catalogue: /core-technology/aml-screening/warnings-aml-screening.

\# Failure modes to handle
\- HTTP 400 — weights don't sum to 100; ongoing_monitoring without save_api_request.
\- HTTP 403 — out of credits.
\- status="Declined" — at least one hit's risk_score ≥ aml_score_review_threshold and crossed the decline boundary.
\- status="In Review" — risk_score between approve and review thresholds; route to manual queue.
\- Adverse-media timeout — the upstream provider was slow; the result returns without adverse-media hits (still actionable).

\# See also
\- Canonical schema: /reference/data-models#aml-screening
\- Per-feature report: /core-technology/aml-screening/report-aml-screening
\- Risk catalogue: /core-technology/aml-screening/warnings-aml-screening
\- Ongoing monitoring: /core-technology/aml-screening/continuous-monitoring-aml-screening
\- Full integration playbook: /integration/integration-prompt````

\
الصق في يتناول درس الأكاديمية حول قراءة نتيجة التحقق فحص AML عند الدقيقة 8:40: العقوبات، وPEPs، والأخبار السلبية في جلسة حقيقية.[فحص AML: العقوبات، وPEPs، والأخبار السلبية — Didit Academy](https://www.youtube.com/embed/7htTWCWsl60?start=520\&rel=0\&playsinline=1)![جدول مصادر قوائم المراقبة لفحص AML من Didit متضمناً قوائم عقوبات OFAC والاتحاد الأوروبي والأمم المتحدة وقوائم PEP](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/aml-list-table.jpeg?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=b254abf5bb564018e15588ef7c56f92e)## المفاهيم الأساسية: درجة التطابق مقابل درجة المخاطريستخدم Didit **نظاماً من درجتين** لفحص AML:### درجة التطابق (الثقة في الهوية)- **السؤال:** هل هذا التطابق هو الشخص نفسه الذي نتحقق منه؟ - **العوامل:** تشابه الاسم، تاريخ الميلاد، الدولة/الجنسية، رقم المستند - **الغرض:** يصنف التطابق على أنه **إيجابي كاذب** أو **لم تتم مراجعته** (تطابق محتمل) - **الحد:** حد درجة التطابق (الافتراضي: 93)### درجة المخاطر (مستوى مخاطر الكيان)- **السؤال:** ما مدى خطورة هذا الكيان إذا كان تطابقاً حقيقياً؟ - **العوامل:** مخاطر الدولة، الفئة (PEP/عقوبات/إلخ)، السجلات الجنائية - **الغرض:** يحدد **حالة AML النهائية** (مقبولة/قيد المراجعة/مرفوضة) - **الحدود:** حد القبول (الافتراضي: 80) وحد المراجعة (الافتراضي: 100)``` ┌─────────────────────────────────────────────────────────────────────────────┐ │ AML SCREENING FLOW │ ├─────────────────────────────────────────────────────────────────────────────┤ │ │ │ STEP 1: Screen against watchlists │ │ └── Returns potential matches (match score ≥ 75% included) │ │ │ │ STEP 2: For each match, calculate MATCH SCORE │ │ └── Match Score = (Name × W1) + (DOB × W2) + (Country × W3) │ │ │ │ STEP 3: Classify match by match score │ │ ├── Match Score < 93 → FALSE POSITIVE (excluded from risk) │ │ └── Match Score ≥ 93 → UNREVIEWED (included in risk) │ │ │ │ STEP 4: For unreviewed matches, calculate RISK SCORE │ │ └── Risk Score = (Country × 30%) + (Category × 50%) + (Criminal × 20%) │ │ │ │ STEP 5: Determine AML STATUS (highest risk score among non-FP matches) │ │ ├── Risk Score < 86 → APPROVED │ │ ├── 86 ≤ Risk Score ≤ 100 → IN REVIEW │ │ └── Risk Score > 100 → DECLINED │ │ │ └─────────────────────────────────────────────────────────────────────────────┘ ```## حالات مراجعة التطابقيتم تعيين حالة مراجعة لكل تطابق AML بناءً على درجة التطابق الخاصة به:| الحالة | الوصف | وقت التعيين | | - | - | - | | **إيجابي كاذب** | من المرجح ألا يكون التطابق للشخص نفسه | درجة التطابق \< الحد (يُعيّن تلقائياً) | | **لم تتم مراجعته** | التطابق محتمل ويتطلب مراجعة | درجة التطابق ≥ الحد (يُعيّن تلقائياً) | | **تطابق مؤكد** | تم التحقق من أن التطابق هو الشخص نفسه | يُعيّن يدوياً بواسطة مسؤول الامتثال | | **غير حاسم** | يتعذر تحديد ما إذا كان الشخص المطابق هو الشخص نفسه | يُعيّن يدوياً بواسطة مسؤول الامتثال |> [!NOTE] > > ### **نصيحة:** يمكنك تغيير حالة مراجعة التطابق في لوحة التحكم من خلال عرض نظرة عامة على AML أو النقر على تطابق محدد للاطلاع على تفاصيله.## الميزات الرئيسية### 1. استخراج شامل للبيانات- **استخراج دقيق**: استخراج البيانات من المعلومات المقدمة من المستخدم أو مستندات الهوية باستخدام تقنية OCR المتقدمة. - **المنطق الضبابي**: مراعاة الاختلافات في الأسماء والأخطاء الإملائية لضمان جمع البيانات بشكل شامل.### 2. تغطية واسعة لقوائم المراقبةإجراء الفحص مقابل فئات متعددة تشمل:- **قوائم العقوبات**: من الهيئات الحكومية والدولية. - **الأشخاص المعرضون سياسياً (PEPs)**: أفراد ذوو وظائف عامة بارزة. - **السجلات الجنائية**: بما في ذلك قواعد البيانات الجنائية العالمية والمحلية. - **الإشارات في الأخبار السلبية**: المقالات والتقارير الإخبارية المتعلقة بالجرائم المالية والمخاطر الأخرى. - **قوائم مراقبة مخصصة**: قابلة للتهيئة بناءً على متطلبات العميل المحددة.### 3. خوارزميات مطابقة متقدمة- **التطابق الضبابي**: رصد الاختلافات الطفيفة في الأسماء أو التفاصيل لضمان تطابق دقيق. - **نقاط بيانات متعددة**: استخدام الاسم وتاريخ الميلاد والجنسية والمعرّفات الأخرى لإجراء فحص شامل. - **منطق المفتاح الذهبي**: مطابقة رقم المستند التي يمكنها تجاوز الدرجات لتحديد الهوية بشكل قاطع.### 4. تقييم المخاطر بدرجتينيحصل كل تطابق على درجتين:| الدرجة | الغرض | التصنيف | | - | - | - | | **درجة التطابق** (0-100) | هل هذا هو الشخص نفسه؟ | إيجابي كاذب مقابل لم تتم مراجعته | | **درجة المخاطر** (0-100) | ما مدى خطورة هذا الكيان؟ | تحدد حالة AML النهائية |**حالة مراجعة التطابق (بناءً على درجة التطابق):**- **إيجابي كاذب**: درجة التطابق أقل من الحد - من المرجح أنه ليس الشخص نفسه - **لم تتم مراجعته**: درجة التطابق عند الحد أو أعلى منه - يتطلب المراجعة**حالة AML النهائية (بناءً على أعلى درجة مخاطر بين التطابقات التي ليست إيجابية كاذبة):**- **مقبولة**: جميع التطابقات التي لم تتم مراجعتها لديها درجات مخاطر منخفضة - **قيد المراجعة**: تطابق واحد على الأقل لم تتم مراجعته لديه درجة مخاطر متوسطة إلى عالية - **مرفوضة**: تطابق واحد على الأقل لم تتم مراجعته لديه درجة مخاطر عالية جداً### 5. فحص تفصيلي للأخبار السلبيةإجراء الفحص مقابل مجموعة واسعة من فئات الأخبار السلبية، بما في ذلك:- **الجرائم المالية**: غسل الأموال والاختلاس وغيرها. - **جرائم العنف**: الاعتداء والقتل والجرائم ذات الصلة. - **الإرهاب**: التورط في الأنشطة الإرهابية أو دعمها. - **المخدرات**: الاتجار بالمخدرات والجرائم ذات الصلة. - **الاحتيال**: أنواع مختلفة من الاحتيال والممارسات الخادعة. - **الانتهاكات التنظيمية**: مخالفات متطلبات الامتثال التنظيمي.### 6. معاملات الفحص القابلة للتخصيص- **حساسية قابلة للتعديل**: تهيئة حساسية الفحص بناءً على تقبل مؤسستك للمخاطر. - **قوائم المراقبة القابلة للتخصيص**: تحديد قوائم المراقبة والفئات التي سيتم تضمينها في عملية الفحص لتلبية متطلبات محددة.### حدود قابلة للتهيئةيمكنك تخصيص مستويات الأمان من خلال تعيين حدود مختلفة:**تهيئة درجة التطابق:**| الإعداد | القيمة الافتراضية | الوصف | | - | - | - | | حد درجة التطابق | 93 | التطابقات الأقل من هذا الحد هي إيجابي كاذب، وعند الحد أو أعلى منه تكون لم تتم مراجعته | | وزن الاسم | 60 | وزن الاسم في درجة التطابق | | وزن تاريخ الميلاد | 25 | وزن تاريخ الميلاد في درجة التطابق | | وزن الدولة | 15 | وزن الدولة في درجة التطابق |**حدود درجة المخاطر (الحالة النهائية):**| الإعداد | القيمة الافتراضية | الوصف | | - | - | - | | حد الموافقة | 80 | درجات المخاطر الأقل = مقبولة | | حد المراجعة | 100 | درجات المخاطر الأعلى = مرفوضة؛ بين الحدين = قيد المراجعة |![Didit AML risk score thresholds for Approved, In Review and Declined statuses](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/aml-risk-score.png?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=297acc5d98dcd0f038597c4f2d953f46)> [!NOTE] > > يمكن تعديل هذه الحدود بناءً على درجة تقبلك للمخاطر ومتطلبات الأمان الخاصة بك.## كيف يعملتحدد عملية فحص AML لدينا المخاطر المحتملة بكفاءة مع تقليل التأخير للمستخدمين الشرعيين.**1. استخراج البيانات**يستخرج النظام المعلومات ذات الصلة إما من البيانات المقدمة من المستخدم أو من مستندات الهوية المرفوعة.| الإدخال | الطريقة | | - | - | | **مستندات الهوية** | تقنية OCR المتقدمة لاستخراج البيانات بدقة | | **البيانات المقدمة من المستخدم** | إدخال مباشر (الاسم، تاريخ الميلاد، الجنسية، رقم المستند) | | **المنطق الضبابي** | يأخذ في الاعتبار الاختلافات في الأسماء والأخطاء الإملائية |**2. فحص قوائم المراقبة**تتم مطابقة البيانات المستخرجة مع **1,300+ قائمة مراقبة عالمية** وقواعد بيانات في الوقت الفعلي:- **قوائم العقوبات** — الهيئات الحكومية والدولية (OFAC، والاتحاد الأوروبي، والأمم المتحدة، وغيرها) - **الأشخاص المعرضون سياسياً (PEPs)** — الأفراد ذوو المناصب العامة البارزة - **السجلات الجنائية** — قواعد البيانات الجنائية العالمية والمحلية - **الأخبار السلبية** — المقالات الإخبارية والتقارير المتعلقة بالجرائم المالية - **قوائم المراقبة المخصصة** — قابلة للتهيئة بناءً على متطلباتك**3. حساب درجة التطابق**لكل تطابق محتمل، يحسب النظام **درجة الثقة في الهوية** — مدى احتمالية أن يكون هو الشخص نفسه.| العامل | الوزن الافتراضي | الوصف | | - | :-: | - | | **تشابه الاسم** | 60% | مطابقة ضبابية تأخذ في الاعتبار الاختلافات | | **تاريخ الميلاد** | 25% | مقارنة دقيقة أو جزئية لتاريخ الميلاد | | **البلد/الجنسية** | 15% | مقارنة بلد المنشأ |- درجة تطابق **أقل من الحد** (افتراضياً: 93) ← مصنفة كـ **إيجابي خاطئ** - درجة تطابق **تساوي الحد أو تتجاوزه** ← مصنفة كـ **غير مُراجَع** (تطابق محتمل) - **المفتاح الذهبي**: يمكن لمطابقة رقم المستند تجاوز النتيجة إلى 100% لتحديد الهوية بشكل قاطع**4. حساب درجة المخاطر**بالنسبة للتطابقات التي ليست إيجابية خاطئة، يحسب النظام **مستوى المخاطر** للكيان:| العامل | الوزن | الوصف | | - | :-: | - | | **الفئة** | 50% | مستوى PEP، ونوع العقوبات، وشدة الجرم الجنائي | | **مخاطر البلد** | 30% | تقييم مخاطر البلدان المرتبطة | | **السجلات الجنائية** | 20% | وجود السجل الجنائي ومدى خطورته |**5. تحديد الحالة النهائية**بناءً على **أعلى درجة مخاطر** بين جميع التطابقات التي ليست إيجابية خاطئة:| درجة المخاطر | الحالة | الإجراء | | :-: | - | - | | أقل من حد الموافقة | **مقبولة** | تبرئة تلقائية، لا توجد مخاطر موثوقة | | بين الحدود | **قيد المراجعة** | وُضعت عليها علامة لإجراء مراجعة يدوية من جانب الامتثال | | أعلى من حد المراجعة | **مرفوضة** | مخاطر عالية، رفض تلقائي |إذا كانت **جميع** التطابقات حالات إيجابية خاطئة، فإن النتيجة تكون **مقبولة** (لم يتم العثور على تطابقات موثوقة).**6. إنشاء النتيجة**يتم إنشاء تقرير مفصل بشفافية كاملة:- **درجة التطابق** و**درجة المخاطر** لكل تطابق مع تفاصيلها - تصنيف التطابق (إيجابي خاطئ مقابل غير مُراجَع مقابل مؤكد) - قاعدة البيانات المصدرية وتفاصيل الفئة لكل نتيجة مطابقة - تسليم النتائج عبر **استجابة API**، أو **webhook**، أو **Business Console** - اتخاذ القرارات تلقائياً استناداً إلى حدود درجات المخاطر التي قمت بتهيئتها## مرجع بيانات مطابقة AMLتحتوي كل نتيجة تطابق AML مسترجعة في استجابة API على معلومات مفصلة حول الكيان المتطابق. فيما يلي الحقول الرئيسية وقيمها المحتملة.### فئات مجموعات البياناتيشير الحقل `datasets` في كل نتيجة تطابق إلى فئات قواعد بيانات الامتثال التي تم العثور على الكيان فيها. القيم المحتملة:| Value | Description | | - | - | | `PEP` | شخص معرض سياسياً (عام) | | `PEP Level 1` | رؤساء الدول، وكبار السياسيين، وقضاة المحكمة العليا | | `PEP Level 2` | أعضاء البرلمان، والسفراء، والقادة العسكريون | | `PEP Level 3` | مسؤولو الإدارات المحلية، والموظفون المدنيون من المستوى المتوسط | | `PEP Level 4` | الأقارب والشركاء المقربون (RCA) من أفراد PEP | | `Sanctions` | قوائم العقوبات الدولية والوطنية (OFAC، والاتحاد الأوروبي، والأمم المتحدة، وغيرها) | | `Adverse Media` | الأخبار السلبية والتقارير المتعلقة بالجرائم المالية | | `Warnings and Regulatory Enforcement` | التحذيرات التنظيمية، وإجراءات الإنفاذ، وتنبيهات الامتثال | | `Fitness and Probity` | سجلات الأهلية والنزاهة الصادرة عن الجهات التنظيمية المالية | | `SIP` | قوائم الأشخاص ذوي الأهمية الخاصة | | `SIE` | قوائم الكيانات ذات الأهمية الخاصة | | `Insolvency` | سجلات الإعسار والإفلاس |### تطابقات العقوباتتحتوي المصفوفة `sanction_matches` على تفاصيل عن كل قائمة عقوبات تم العثور على الكيان فيها. الحقول الرئيسية:| Field | Type | Description | | - | - | - | | `list_name` | `string[]` | اسم (أو أسماء) قائمة (أو قوائم) العقوبات | | `matched_name` | `string` | الاسم كما يظهر في قائمة العقوبات | | `description` | `string` | وصف قيد العقوبة | | `reason` | `string` | سبب نصي حر يوضح سبب فرض العقوبة على الكيان. هذا الحقل ليس تعداداً (enum) — حيث تأتي القيم مباشرة من سلطة فرض العقوبات وتصف الأسباب المحددة للإدراج (على سبيل المثال، "Executive Order 13224 (Terrorism)" أو "Support for actions undermining Ukraine's sovereignty"). | | `legal_basis` | `string[]` | الأساس القانوني للعقوبة | | `sanction_program` | `string[]` | برنامج (أو برامج) العقوبات المدرج الكيان تحته(ا) | | `sanctioning_authority` | `string[]` | السلطة التي فرضت العقوبة | | `listed_on` | `string[]` | تاريخ (أو تواريخ) إدراج الكيان | | `source_url` | `string` | رابط URL للمصدر |### تطابقات التحذيراتتحتوي المصفوفة `warning_matches` على تفاصيل التطابقات من قوائم التحذيرات، والإنفاذ التنظيمي، والقوائم ذات الصلة. قد يتضمن الحقل `additional_data` مصفوفة `data.case_details` تحتوي على معلومات الحالة المنظمة.#### أنواع حالات التحذيريصف الحقل `case_type` داخل `additional_data.data.case_details[]` طبيعة حالة التحذير. القيم المعروفة:| Value | Description | | - | - | | `Accusation` | اتهام أو توجيه تهمة رسمية | | `Arrest` | سجل توقيف | | `Bribery` | قضية مرتبطة بالرشوة | | `Criminal` | قضية جنائية عامة | | `Fraud` | قضية احتيال | | `Illegal Fundraising` | نشاط جمع أموال غير قانوني | | `Non-conviction Terror` | إدراج متعلق بالإرهاب دون إدانة | | `Proclaimed Offender` | مجرم مُعلن رسمياً | | `Regulatory Enforcement` | إجراء إنفاذ تنظيمي | | `Terrorism` | قضية مرتبطة بالإرهاب | | `Terrorism-related` | متعلق بأنشطة إرهابية | | `Terrorism-related listing` | إدراج على صلة بالإرهاب | This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.