مخطط دورة الحياة
تفاصيل الحالات
يؤدي تغيير الحالة عبر
PATCH /v3/users/{vendor_data}/update-status/ أو PATCH /v3/businesses/{vendor_data}/update-status/ إلى إصدار webhook (user.status.updated / business.status.updated) حتى تتمكن الأنظمة التابعة من الاستجابة فورياً.مراحل دورة الحياة
الإنشاء
يُنشأ الكيان بإحدى ثلاث طرق:
- يُنشأ تلقائياً عند بدء جلسة مع
vendor_dataجديد. يُنشأ الكيان بالحالةACTIVE. - يُنشأ مسبقاً عبر API باستخدام
POST /v3/users/create/أوPOST /v3/businesses/create/. الحالة الافتراضية هيACTIVE. - يُنشأ في وحدة التحكم بواسطة مشغّل امتثال. تبدأ الحالة بـ
ACTIVEما لم يحدد المشغّل غير ذلك.
uuid يولده Didit ومعرّف vendor_data يملكه العميل.التحقق
تُرتبط الجلسات بالكيان عبر
vendor_data. تمرّ كل جلسة عبر سير العمل الذي ضبطته، ويشمل ذلك التحقق من الهوية، وكشف الحيوية، ومطابقة الوجه، وفحص AML، والمستندات، والبحث في السجل للتحقق من الشركات (KYB)، وغير ذلك.تحدّث الجلسات المكتملة العدادات الإجمالية للكيان:session_count،approved_count،declined_count،in_review_count- خريطة
features: آخر حالة لكل ميزة عبر جميع الجلسات (مثلاً{ "id_verification": "APPROVED", "aml": "IN_REVIEW" }) - تنتقل حقول الملف الشخصي من آخر جلسة مقبولة (مثل
full_nameوdate_of_birthوportrait_image).
الاستخدام النشط
بمجرد أن يصبح للكيان جلسة مقبولة واحدة أو أكثر، يمكنك:
- إرسال معاملات تشير إلى الكيان عبر
vendor_dataفي حمولة المعاملة - تشغيل مراقبة AML المستمرة: إعادة فحص دورية لقوائم العقوبات والأشخاص المعرّضين سياسياً والأخبار السلبية
- إعادة التحقق وفق جدول زمني: إنشاء جلسات جديدة للـ
vendor_dataنفسه على فترات منتظمة - تجميع إشارات المخاطر عبر الجلسات والمعاملات
انتقالات الحالة
تحدث تغييرات حالة الكيان تلقائياً أو يدوياً.الانتقالات التلقائية
ACTIVE → FLAGGEDعندما تتجاوز معاملة حد المراجعة، أو عندما تضيف قاعدة الكيان إلى قائمة مراقبة.ACTIVE → BLOCKEDعندما تطابق السمة البيومترية للوجه إدخالاً في قائمة الحظر.
USER (وهو vendor_data) إلى تعيين الحالة إلى BLOCKED.الانتقالات اليدوية تحدث عندما يغيّر محلل الحالة من وحدة التحكم، أو عندما تستدعي نقطة النهاية update-status.يُصدر كل انتقال webhook من نوع user.status.updated أو business.status.updated.الحذف
يُحذف الكيان عبر
POST /v3/users/delete/ أو POST /v3/businesses/delete/ (على دفعات). يُزال سجل الكيان بشكل دائم. وحذف المستخدم يحذف أيضاً كل القوالب البيومترية المحتفَظ بها له بعد حذف الجلسات، فيتوقف الشخص عن المطابقة في اكتشاف التكرار وفي البحث بالوجه.لا تشمل نقاط النهاية هذه جلسات التحقق، ولا المعاملات. احذف الجلسات باستخدام Delete Session أو Batch Delete Sessions، وتُحذف المعاملات من وحدة التحكم.الطوابع الزمنية للنشاط
تتتبع الكيانات نشاطها لمساعدتك على تحديد الملفات الشخصية الخاملة أو النشطة:
استخدم هذه الطوابع الزمنية لتصفية الكيانات الخاملة، أو جدولة عمليات إعادة التحقق، أو تشغيل المراقبة المستمرة.
الأحداث الصادرة خلال دورة الحياة
راجع webhooks الخاصة بالكيانات للاطلاع على بنية الحمولات ودلالات التسليم.
الخطوات التالية
ربط بيانات البائع
كيف يربط
vendor_data الجلسات والمعاملات والكيانات ببعضها.عمليات المستخدم
إنشاء كيانات المستخدمين وتحديثها وتغيير حالتها وحذفها.
عمليات الشركات
إنشاء كيانات الشركات وتحديثها وتغيير حالتها وحذفها.