دمج فحص غسل الأموال

افحص العملاء والأطراف المقابلة على قوائم مراقبة غسل الأموال.

الأدلة مرجع API أمثلة الكود أفضل الممارسات

تكامل مكافحة غسل الأموال

افحص العملاء والكيانات، وأرسل أحداث المعاملات والأطراف المقابلة، واربط النتائج بسياسة الامتثال لديك.

متى تنفذ الفحص؟

عند تسجيل العميل أو قبل تفعيل الحساب.
عند تغيير بيانات الهوية الجوهرية.
قبل معاملة عالية المخاطر أو إضافة طرف مقابل جديد.
بشكل دوري عند تحديث القوائم أو حسب سياسة الامتثال.

الحقل	النوع	مطلوب	الوصف
inputName	string	نعم	الاسم القانوني للفرد أو الكيان.
externalId	string	نعم	معرف الكيان داخل نظامك.
entityType	enum	لا	INDIVIDUAL أو ORGANIZATION أو VESSEL أو AIRCRAFT.
inputDob	date	اختياري	تاريخ الميلاد بصيغة ISO 8601 لتحسين دقة المطابقة.
inputNationality	string	اختياري	الجنسية برمز ISO 3166-1 alpha-2.

POST /api/v1/aml/screen

curl -X POST https://api.naiza.ai/api/v1/aml/screen \
  -H "x-api-key: naiza_api_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "inputName": "John Michael Smith",
    "externalId": "cust_123456",
    "entityType": "INDIVIDUAL",
    "inputDob": "1985-04-12",
    "inputNationality": "GB"
  }'

التعامل مع النتائج

AUTO_CLEAR يعني استمرار التدفق، و REVIEW يحتاج مراجعة، و CONFIRMED يحتاج إيقافًا أو تعليقًا حسب سياسة الامتثال.

أحداث مكافحة غسل الأموال

استخدم الأحداث عندما يرتبط الفحص بمعاملة أو طرف مقابل أو تدفق غير متزامن يحتاج متابعة لاحقة.

POST /api/v1/aml/events

curl -X POST https://api.naiza.ai/api/v1/aml/events \
  -H "x-api-key: naiza_api_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "eventName": "payment.completed",
    "eventCategory": "TRANSACTION",
    "externalEventId": "transfer_98765",
    "customer": {
      "externalId": "cust_123456",
      "email": "user@example.com"
    },
    "sourceReportedAt": 1672520400,
    "metadata": { "amount": 42000, "currency": "SAR" },
    "custom_fields": { "counterparty_country": "AE" }
  }'

التعليق والنتائج النهائية

حالات حدث AML

قد تكون حالة حدث AML: CLEAR أو ALERTED أو HELD أو APPROVED أو REJECTED. استخدم HELD عندما يحتاج المنتج إلى إيقاف التنفيذ أثناء مراجعة الامتثال.

قرارات الفحص المتزامن

AUTO_CLEAR: أكمل التدفق مع حفظ سجل الفحص.
REVIEW: علّق العملية عند الحاجة وأنشئ حالة لمراجع الامتثال.
CONFIRMED: طبّق الإجراء المعتمد في سياسة الامتثال وسجل المبرر.

ما يجب أن يراه المراجع

اعرض الاسم المدخل، الاسم المطابق، درجة الثقة، مصدر القائمة، سبب العقوبة، المدن، تواريخ الميلاد (كاملة أو سنة فقط)، والروابط أو الملاحظات المتاحة. لا تعرض درجة مجردة بدون سياق.

استعلام النتائج

GET /api/v1/aml/events/:externalEventId

curl https://api.naiza.ai/api/v1/aml/events/transfer_98765 \
  -H "x-api-key: naiza_api_sk_live_..."

سياسة الاستعلام الدوري

ابدأ بفاصل قصير ثم زد المدة تدريجيًا.
ضع حدًا أقصى للمدة وعدد المحاولات.
توقف فور وصول حالة نهائية.
سجل آخر حالة ومعرف الحدث لتسهيل الاسترداد.

الطريقة	المسار	الاستخدام
POST	/api/v1/aml/screen	فحص متزامن لفرد أو كيان.
GET	/api/v1/aml/screenings/:id	قراءة تفاصيل فحص سابق.
POST	/api/v1/aml/events	إنشاء حدث مكافحة غسل الأموال.
GET	/api/v1/aml/events/:externalEventId	متابعة نتيجة الحدث بالمعرف الخارجي.