دمج واجهة فحص AML دون أن يتعطل تسجيل العملاء

التكاملات البطيئة هي التي تعامل الفحص كمهمة خلفية منفصلة. ينتهي العميل من KYC، ويبقى الحساب معلّقًا، ويلصق أحدهم الاسم في بوابة الامتثال. التكامل الذي لا يعيق المسار يعامل الفحص كخدمة قرار: عندك اسم قانوني، تستدعي الواجهة، تحفظ المعرف، والمنتج يعرف ماذا يفعل بـ AUTO_CLEAR وREVIEW وCONFIRMED.

اربط نيزا بالهوية التي جمعتها أثناء التسجيل. عندما يتوفر الاسم القانوني ومعرف externalId ثابت، استدعِ الفحص من الخادم واحفظ النتيجة على سجل العميل.

ماذا ترسل، ومتى

اجمع الاسم القانوني وexternalId من نظامك قبل POST /api/v1/aml/screen. أضف تاريخ الميلاد والجنسية والأسماء البديلة ومعرفات الوثائق عندما تتوفر. الحقول الاختيارية تحسّن المطابقة، لكنها لا تغني عن ملف KYC، ولا ينبغي أن يتأخر الفحص الأول بسببها إذا كان KYC ما زال يستكمل وثيقة ثانوية.

أصدر externalId في خدمة العملاء لديك، لا عند مورّد AML. إذا انتهت مهلة الفحص يبقى لديك مفتاح للربط لاحقًا. وإذا أعاد KYC المحاولة أعد استخدام المعرف نفسه حتى لا تُنشئ سجل عميل مكررًا منفصلًا عن الحالة الأولى.

POST /api/v1/aml/screen
x-api-key: naiza_api_sk_live_...

{
  "inputName": "John Michael Smith",
  "externalId": "cust_123456",
  "entityType": "INDIVIDUAL",
  "inputDob": "1985-04-12"
}

احفظ معرّف الفحص الذي يعيده الطلب على سجل العميل أو التسجيل، فسيحتاجه الدعم والامتثال. وإذا اكتفيت بحفظه في سجلات تُحذف بعد أسبوعين، فستضطر إلى إعادة بناء الحالة من الذاكرة.

كيف تبدو النتائج الثلاث في المنتج

AUTO_CLEAR هو المسار السهل: إذا اكتمل باقي التسجيل ففعّل الحساب. لا تُضف مرحلة انتظار ثانية لفحص لم يُظهر أي تطابق، فهكذا يعتاد العملاء ربط الفحص بالتأخير حتى حين لا يسبب أي تأخير.

تعني REVIEW إحالة تطابق محتمل إلى التحقيق. علّق التفعيل أو الصرف وفق مسارك، وافتح حالة بحقول الإدخال ومعرف الفحص، وقارن أدلة الهوية الداعمة.

CONFIRMED تعني إيقاف الحساب أو إبقاءه معلقًا حتى يسجّل الامتثال قراره. يجب أن تكون حالة المنتج بسيطة وواضحة: بانتظار مراجعة الامتثال، لا «حدث خطأ ما».

وهو الفصل نفسه الموضح في KYC مقابل فحص AML: KYC يثبت الاسم، والفحص يقيّم صاحبه. يجب أن ينتظر التسجيل نتيجة الفحص كما ينتظر تفويض الدفعة: معرّف واحد وحالة واحدة ومسؤول واحد.

انتهاء المهلة وإعادة المحاولة وقائمة المراجعة

إذا انتهت مهلة طلب الفحص فتحقق من حالته قبل إعادة إرساله. إذا وصلك معرّف الفحص فاسترجع النتيجة عبر GET /api/v1/aml/screenings/:id. وإن لم يصلك المعرّف فأبقِ العميل في حالة انتظار وتحقق من حالة الطلب قبل إرسال طلب ثانٍ، ليظل لكل عميل فحص واحد وحالة REVIEW واحدة.

استخدم الفحص المتزامن عند التسجيل وأول صرف وفحص طرف مقابل جديد. تعيد نيزا فحص العملاء تلقائيًا عند تحديث القوائم وتدعم مراقبة المعاملات الكاملة بجانب ذلك. تجد حقول الطلب واستعلام الأحداث في دليل تكامل AML، وتغطية القوائم ونتائج المطابقة في صفحة واجهة فحص AML.

وجّه AUTO_CLEAR إلى استمرار التسجيل دون تذكرة، وREVIEW إلى حالة مراجعة واحدة لا حالة لكل إعادة محاولة، وCONFIRMED إلى فريق الامتثال مباشرة.

إذا لم تكن جاهزًا لتعليق العملاء فشغّل الاستدعاء نفسه في وضع المراقبة: احفظ النتيجة دون تغيير التفعيل. الواجهة واحدة، ويتغير وضع التشغيل فقط. انتقل إلى التطبيق الفعلي عندما يتمكن فريقك من معالجة حجم المراجعة اليومي.

يجب ألا يمر العميل بأكثر من مرحلة انتظار واحدة، والأفضل ألا ينتظر إطلاقًا؛ لا انتظار لـ KYC ثم للفحص ثم رسالة «ما زلنا نراجع القوائم» دون معرّف يمكن لأحد الرجوع إليه. وإذا لم يجد الدعم معرّف الفحص في صفحة الحساب فالتكامل غير مكتمل، حتى لو كان المسار المعتاد سريعًا.