المستخدمون والشركات: الكيانات في Didit

ينظّم Didit كل ما يحدث في تطبيقك حول نوعين أساسيين من الكيانات:

الكيان	يمثل	مرتبط بـ
مستخدم	شخصاً طبيعياً	جلسات التحقق من المستخدمين (KYC)، والبيانات البيومترية للوجه، والمعاملات (بصفتها مقدمة طلب أو طرفاً مقابلاً)، وقوائم الحظر
شركة	كياناً قانونياً (شركة، أو شركة ذات مسؤولية محدودة، أو مؤسسة فردية، أو صندوقاً)	جلسات التحقق من الشركات (KYB)، والمسؤولين، والمستفيدين الحقيقيين (UBO)، والمعاملات (بصفتها مقدمة طلب أو طرفاً مقابلاً)، وقوائم الحظر

يمكن ربط كل جلسة تحقق وكل معاملة وكل إدخال في قائمة الحظر بكيان. وبمجرد الربط، يصبح الكيان ملفاً دائماً يجمع السجل وإشارات المخاطر وحالة الامتثال عبر الزمن.

الكيان مقابل الجلسة

الكيان والجلسة شيئان مختلفان.

المفهوم	النطاق	مدة البقاء	مثال
الجلسة	حدث تحقق واحد	مسار واحد (من دقائق إلى أيام أثناء المراجعة)	محاولة KYC واحدة
كيان	ملف تعريف دائم	يبقى ما دام المستخدم أو الشركة موجوداً على منصتك	العميل “Jane Doe” مع 3 جلسات تحقق من المستخدمين (KYC) على مدى سنتين

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

الإنشاء التلقائي مقابل الإنشاء اليدوي المسبق

يُنشأ الكيان بإحدى ثلاث طرق:

منشأ تلقائياً من جلسة

عند إنشاء جلسة بمعرّف vendor_data ولا يوجد كيان مطابق، ينشئ Didit الكيان تلقائياً. هذا هو المسار الأكثر شيوعاً.

curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{ "workflow_id": "wf_kyc_standard", "vendor_data": "user-42" }'

يُنشأ كيان مستخدم للمعرّف user-42 لحظة بدء الجلسة.

منشأ مسبقاً عبر Management API

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

curl -X POST https://verification.didit.me/v3/users/create/ \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{ "vendor_data": "user-42", "display_name": "Jane Doe" }'

منشأ من لوحة التحكم

يمكن لفريق الامتثال لديك إنشاء مستخدمين أو شركات مباشرة من Business Console، ويفيد ذلك في التسجيل اليدوي، وعمليات الاستيراد، وسير عمل المعالجة.

كيف تربط الكيانات كل شيء

حقل vendor_data هو مفتاح الربط. عند تمرير vendor_data في أي جلسة أو معاملة، يوجّهه Didit إلى الكيان المطابق. اطلع على المزيد في دليل ربط vendor_data.

ما يمكنك فعله بالكيان

لكل كيان من نوع مستخدم أو شركة، يمكنك ما يلي:

العملية	الغرض
إنشاء / تحديث	تعيين بيانات ملف الكيان أو تغييرها (الاسم، والدولة، والبيانات الوصفية المخصصة)
تغيير الحالة	عيّن حالته إلى `ACTIVE` أو `FLAGGED` أو `BLOCKED`، ويمتد تطبيق ذلك إلى الجلسات والمعاملات المستقبلية
إرفاق البيانات البيومترية	ارفع مرجعاً للوجه للبحث 1:N، أو لكشف التكرار، أو للإضافة إلى قائمة الحظر
مراجعة سجل KYC/KYB	استرجع كل جلسة مرتبطة بالكيان، مع نتائج كل ميزة على حدة
مراجعة سجل المعاملات	استرجع كل معاملة يكون فيها الكيان مقدم طلب أو طرفاً مقابلاً
الإضافة إلى قائمة الحظر	احظر الجلسات والمعاملات المستقبلية التي تتضمن هذا الكيان
الاستيراد / التصدير	ارفع الكيانات دفعة واحدة من ملفات CSV، أو صدّرها إلى أدوات امتثال خارجية
حذف	احذف الكيان (يُحفظ السجل لأغراض التدقيق)

تتوفر الشروح التفصيلية في المستخدمون والشركات.

العلاقات بين المستخدم ↔ الشركة

يمكن ربط مستخدم واحد بشركة واحدة أو بعدة شركات. ويحدث ذلك بشكل طبيعي أثناء KYB:

قد يكون المستخدم مديراً لشركة، ومستفيداً حقيقياً (UBO) لشركة أخرى.
يمكن ربط جلسة التحقق من المستخدم (KYC) بجلسة التحقق من الشركة (KYB) عبر مسار الأشخاص الرئيسيون.

يحافظ Didit على هذه العلاقات. فعند فحص كيان شركة، يمكنك رؤية كل مستخدم مرتبط بها، وعند فحص كيان مستخدم، يمكنك رؤية كل شركة مرتبطة به.

دورة الحياة والحالات

لكل كيان حالة تحدد ما إذا كان Didit يفرض الحظر على النشاط الجديد:

الحالة	الأثر
`ACTIVE`	عادية: تستمر الجلسات والمعاملات وفق ما تحدده سير العمل والقواعد
`FLAGGED`	تُسمح الجلسات والمعاملات، لكن تُوجَّه تلقائياً إلى مراجعة يدوية
`BLOCKED`	تُرفض الجلسات والمعاملات تلقائياً، ولا يمكن إنشاء جلسات جديدة

اطلع على دورة حياة الكيان الكاملة للاطلاع على الانتقالات وأحداث webhook.

الخطوات التالية

دورة الحياة

الحالات والانتقالات وأحداث دورة الحياة لكل كيان.

ربط vendor_data

كيف يربط vendor_data الجلسات والمعاملات والكيانات.