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

ادمج فحص AML في منتجك: افحص العملاء والأطراف المقابلة مقابل قوائم العقوبات والأشخاص السياسيين المعرضين للمخاطر عند التسجيل والدفع.

تنزيل Markdown

الأدلة مرجع 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. تطابق القاعدة لا يوقف العملية تلقائيًا؛ أوقفها فقط إذا كانت سياستكم تقضي بتعليق العمليات ذات الحالة ALERTED. ولا تتضمن الواجهة حالة تعليق مستقلة، فقرار التعليق يعود لسياستكم.

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

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	متابعة نتيجة الحدث بالمعرف الخارجي.