> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

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

> المستخدمون والشركات هما الكيانان الأساسيان في Didit، يجمع كل منهما جلسات KYC والمعاملات والمستندات والمخاطر في ملف واحد.

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

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

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

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

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

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

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

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

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

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

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

```bash theme={null}
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` لحظة بدء الجلسة.

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

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

```bash theme={null}
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" }'
```

**3. منشأ من لوحة التحكم**

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

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

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

```mermaid theme={null}
flowchart LR
    VD["vendor_data:<br/>user-42"] --> U[User entity]
    S1[User Verification (KYC) session #1] --> VD
    S2[User Verification (KYC) session #2] --> VD
    T1[Transaction #1] --> VD
    T2[Transaction #2] --> VD
    F[Face biometric] --> VD
    D[Documents] --> VD
    BL[Blocklist entry] --> VD
```

اطلع على المزيد في [دليل ربط `vendor_data`](https://docs.didit.me/ar/entities/vendor-data-linking).

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

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

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

تتوفر الشروح التفصيلية في [المستخدمون](https://docs.didit.me/ar/entities/users/overview.md) و[الشركات](https://docs.didit.me/ar/entities/businesses/overview.md).

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

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

* قد يكون المستخدم **مديراً** لشركة، و**مستفيداً حقيقياً (UBO)** لشركة أخرى.
* يمكن ربط جلسة التحقق من المستخدم (KYC) بجلسة التحقق من الشركة (KYB) عبر مسار [الأشخاص الرئيسيون](https://docs.didit.me/ar/business-verification/key-people.md).

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

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

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

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

اطلع على [دورة حياة الكيان](https://docs.didit.me/ar/entities/lifecycle.md) الكاملة للاطلاع على الانتقالات وأحداث webhook.

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

> [card] [دورة الحياة](https://docs.didit.me/ar/entities/lifecycle.md)
>
> الحالات والانتقالات وأحداث دورة الحياة لكل كيان.

> [card] [ربط vendor\_data](https://docs.didit.me/ar/entities/vendor-data-linking.md)
>
> كيف يربط `vendor_data` الجلسات والمعاملات والكيانات.

> [card] [المستخدمون](https://docs.didit.me/ar/entities/users/overview.md)
>
> شرح معمّق لكيانات المستخدمين وعملياتها وسير العمل في لوحة التحكم.

> [card] [الشركات](https://docs.didit.me/ar/entities/businesses/overview.md)
>
> شرح معمّق لكيانات الشركات وعملياتها وسير العمل في لوحة التحكم.

> [card] [webhook الخاصة بالكيانات](https://docs.didit.me/ar/entities/webhooks.md)
>
> أحداث فورية لكل تغيير في الكيانات.

> [card] [قائمة الحظر](https://docs.didit.me/ar/console/blocklist-users.md)
>
> كيف تتفاعل إدخالات قائمة الحظر مع كيانات المستخدمين والشركات.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.