> ## 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.

# المستخدمون لدى المورّد: سجل KYC دائم

> مستخدمو المورّد هم سجل الهوية الدائم في Didit: سجل KYC والبيانات البيومترية والمستندات والمعاملات وحالة القائمة المحظورة، كلها في ملف تعريف واحد.

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

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

## ما يتضمنه المستخدم

| الفئة | الحقول / الكائنات |
| - | - |
| **الهوية** | `vendor_data`, `uuid`, `display_name`, `full_name`, `date_of_birth`, `portrait_image` |
| **الحالة** | `ACTIVE`, `FLAGGED`, `BLOCKED` |
| **مجاميع الجلسات** | `session_count`, `approved_count`, `declined_count`, `in_review_count`, خريطة `features` |
| **جهات الاتصال المتحقَّق منها** | `approved_emails[]`, `approved_phones[]` |
| **التوزيع الجغرافي** | `issuing_states[]` (من مستندات الهوية المتحقَّق منها) |
| **النشاط** | `first_session_at`, `last_session_at`, `last_activity_at` |
| **القياسات الحيوية** | سجلات الوجوه المرفقة (للبحث وكشف التكرار وقائمة الحظر) |
| **المستندات** | مستندات الهوية وإثباتات العنوان وصور السيلفي من الجلسات |
| **العلاقات** | كيانات الشركات المرتبطة (إذا كان المستخدم مديراً أو UBO لشركات تم التحقق منها في تطبيقك) |
| **البيانات الوصفية** | أي بيانات JSON خاصة بك |

راجع [نموذج بيانات المستخدم](https://docs.didit.me/ar/entities/users/data-model.md) الكامل للاطلاع على الأنواع والفهارس والحالات الحدّية.

## متى يُنشأ المستخدم

**1. تلقائياً: عند أول جلسة بقيمة vendor\_data جديدة**

هذه هي الحالة الأكثر شيوعاً. تستدعي `POST /v3/session/` بقيمة `vendor_data` لم يسبق لـ Didit أن رآها. يُنشأ كيان المستخدم في حالة `ACTIVE` ويُربط بتلك الجلسة.

**2. صراحةً عبر POST /v3/users/create/**

تنشئ المستخدم مسبقاً قبل تشغيل أي جلسة. وهذا مفيد لتعبئة البيانات الوصفية، أو تحديد الحالة الأولية، أو تسجيل العملاء دفعةً واحدة من قاعدة بيانات موجودة.

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

ينشئ مشغّل الامتثال المستخدم من صفحة المستخدمين، على سبيل المثال عند تسجيل عميل تم التحقق منه يدوياً.

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

| العملية | الطريقة |
| - | - |
| [عرض المستخدمين](https://docs.didit.me/ar/entities/users/operations.md#عرض-المستخدمين) | `GET /v3/users/` مع عوامل التصفية (الحالة، التاريخ، الدولة) |
| [جلب مستخدم](https://docs.didit.me/ar/entities/users/operations.md#الحصول-على-مستخدم) | `GET /v3/users/{vendor_data}/` |
| [إنشاء مستخدم](https://docs.didit.me/ar/entities/users/operations.md#إنشاء-مستخدم) | `POST /v3/users/create/` |
| [تحديث الملف الشخصي](https://docs.didit.me/ar/entities/users/operations.md#تحديث-مستخدم) | `PATCH /v3/users/{vendor_data}/` |
| [تغيير الحالة](https://docs.didit.me/ar/entities/users/operations.md#تغيير-الحالة) | `PATCH /v3/users/{vendor_data}/update-status/` |
| [حذف المستخدمين](https://docs.didit.me/ar/entities/users/operations.md#حذف-المستخدمين-دفعات) | `POST /v3/users/delete/` (على دفعات) |
| [إرفاق الوجوه والبحث عنها](https://docs.didit.me/ar/entities/users/faces-and-biometrics.md) | وحدة التحكم + Lists API لقوائم الحظر |
| [عرض المستندات](https://docs.didit.me/ar/entities/users/documents.md) | عبر قرارات الجلسات |
| [إضافة إلى قائمة الحظر](https://docs.didit.me/ar/entities/users/blocklist.md) | وحدة التحكم + Lists API |
| [مراجعة سجل KYC](https://docs.didit.me/ar/entities/users/kyc-history.md) | `GET /v3/sessions?vendor_data=...` |
| [مراجعة المعاملات](https://docs.didit.me/ar/entities/users/transactions.md) | `GET /v3/transactions/?vendor_data=...` |
| [الاستيراد / التصدير](https://docs.didit.me/ar/entities/users/import-export.md) | وحدة التحكم فقط (CSV) |
| [إدارة المستخدمين في وحدة التحكم](https://docs.didit.me/ar/entities/users/console.md) | جولة كاملة في الواجهة |

## المستخدمون والشركات

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

## العلاقة بين المستخدم والجلسة

```mermaid theme={null}
flowchart LR
    U[User entity<br/>vendor_data = user-42]
    S1["User Verification (KYC) session #1<br/>(approved 2025-01)"]
    S2["User Verification (KYC) session #2<br/>(resubmit, in review)"]
    S3["User Verification (KYC) session #3<br/>(re-verification 2026-01)"]
    S1 --> U
    S2 --> U
    S3 --> U
```

يجمع المستخدم أحدث حالة لكل ميزة عبر جميع الجلسات. فإذا فشل فحص `aml` في أحدث جلسة، فسيظهر ذلك في الحقل `features.aml` الخاص بالمستخدم، حتى وإن كانت الجلسات الأقدم قد قُبلت.

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

> [card] [نموذج البيانات](https://docs.didit.me/ar/entities/users/data-model.md)
>
> كل حقل ونوع وفهرس.

> [card] [العمليات](https://docs.didit.me/ar/entities/users/operations.md)
>
> الإنشاء والتحديث وتغيير الحالة والحذف.

> [card] [الوجوه والقياسات الحيوية](https://docs.didit.me/ar/entities/users/faces-and-biometrics.md)
>
> إرفاق وجه للبحث والإدراج في قوائم الحظر.

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

> [card] [سجل KYC](https://docs.didit.me/ar/entities/users/kyc-history.md)
>
> كل جلسة مرتبطة بالمستخدم.

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


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