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

# حالات KYB: مرجع الجلسات والميزات وAML

> أسماء حالات جلسات KYB والميزات وفحوص سجل الشركات وAML في Didit بالنص الدقيق. الأسعار من $2.00 لكل عملية تحقق حسب الدولة والمستوى.

يتتبع التحقق من الشركات (KYB) الحالة على عدة مستويات: **الجلسة**، والميزات الفردية، وعملية البحث في السجل، ونتيجة AML. تُعد هذه الصفحة المرجع لكل حالة.

تعيد الواجهة البرمجية قيم الحالة كتسميات دقيقة حساسة لحالة الأحرف، مثل `"In Progress"` و`"Not Finished"`، وهي نفس السلاسل النصية التي تحملها webhook. طابِق هذه السلاسل، لا الأسماء المكتوبة بالأحرف الكبيرة.

## حالة الجلسة

الحالة الإجمالية لجلسة التحقق من الشركات (KYB)، وهي الحقل الذي ستستخدمه غالبًا لتحديد الإجراء.

| الحالة | المعنى |
| - | - |
| `"Not Started"` | أُنشئت الجلسة، لكن الشركة لم تفتح الرابط المستضاف بعد. |
| `"In Progress"` | التدفق المستضاف نشط، وعمليات البحث في السجلات أو رفع المستندات أو فحص AML قيد التنفيذ. |
| `"Awaiting User"` | في انتظار أن يتخذ المستخدم النهائي إجراءً، وعادةً إرسال قائمة الأشخاص الرئيسيين أو الاستجابة لطلب إعادة التقديم. تنتقل الجلسة تلقائيًا بعد أن يُكمل المستخدم الإجراء المعلّق. |
| `"Approved"` | اجتازت جميع الميزات المطلوبة. الشركة متحقَّق منها. |
| `"Declined"` | فشل فحص حرج (شركة منحلّة، أو كيان خاضع للعقوبات، أو مُدرج في قائمة الحظر)، أو رفضت قاعدة سير العمل الجلسة. |
| `"In Review"` | تتطلب ميزة واحدة أو أكثر مراجعة يدوية من محلل. |
| `"Resubmitted"` | أُعيد إرسال جلسة سبق رفضها أو طلب إعادة تقديمها ببيانات محدّثة. |
| `"Abandoned"` | لم تُكمل الشركة التدفق أبدًا (انتهت المهلة). |
| `"Expired"` | انتهت صلاحية الجلسة قبل أن تُكملها الشركة. |

> [!NOTE]
>
> `"Awaiting User"` حالة مؤقتة، ولا تحتاج إلى نقل الجلسات منها يدويًا. بمجرد أن يُكمل المستخدم النهائي الإجراء المعلّق (مثلًا بإرسال قائمة الأشخاص الرئيسيين أو بإعادة رفع مستند مطلوب)، يعيد Didit تقييم الجلسة وينقلها تلقائيًا إلى `"In Review"` أو `"Approved"` أو `"Declined"` بحسب النتيجة.

## حالة الميزة

لكل ميزة من ميزات KYB حالتها الخاصة، وتُجمَّع هذه الحالات في حالة الجلسة.

| الحالة | المعنى |
| - | - |
| `"Not Finished"` | لم تبدأ الميزة بعد، أو هي قيد التشغيل. |
| `"Approved"` | اجتازت الميزة. |
| `"Declined"` | فشلت الميزة (فشل حرج). |
| `"In Review"` | تتطلب الميزة اهتمامًا من محلل. |
| `"Resub Requested"` | يجب على الشركة إعادة التقديم لهذه الميزة (مثلًا إعادة رفع مستند). |
| `"Awaiting User"` | الميزة في انتظار إجراء من المستخدم النهائي. تنطبق على ميزة الأشخاص الرئيسيين بينما يتعين على المستخدم إرسال الأطراف. تنتقل تلقائيًا عند الإرسال. |

### أسماء ميزات KYB

هذه هي قيم `features` في جلسة KYB وفي webhook:

* `KYB_REGISTRY`: البحث في سجل الشركات.
* `AML`: فحص AML على مستوى الشركة.
* `KYB_DOCUMENTS`: جمع المستندات والتعرف الضوئي على الحروف (OCR).
* `KYB_KEY_PEOPLE`: الأشخاص الرئيسيون: UBOs والمساهمون والمديرون والممثلون والمسؤولون الآخرون.

## حالة السجل (من المزوّد)

الحالة الرسمية للشركة كما تم الحصول عليها من مصادر السجل المعتمدة. تعكس الوضع القانوني أو التنظيمي للكيان كما يُبلغ عنه السجل الخاص بكل ولاية قضائية، لذلك تختلف القيم الدقيقة بحسب المصدر. تظهر داخل قرار KYB ضمن `company.registry_status`.

| الحالة | المعنى |
| - | - |
| `ACTIVE` | الشركة نشطة وفي وضع جيد. |
| `DISSOLVED` | تم حلّ الشركة. |
| `DEREGISTERED` | تم إلغاء تسجيل الشركة. |
| `STRUCK_OFF` | تم شطب الشركة من السجل. |
| `CLOSED` | تم إغلاق الشركة. |
| `INACTIVE` | الشركة غير نشطة (لا تمارس نشاطًا تجاريًا). |
| `AUTHORISED` | مرخّصة (عادةً للكيانات الخاضعة للتنظيم). |
| `APPOINTED_REPRESENTATIVE` | ممثل معيَّن لشركة أخرى مرخّصة. |
| `UNAUTHORISED` | كانت مرخّصة سابقًا، وأصبحت الآن غير مرخّصة. |
| `NO_LONGER_AUTHORISED` | تم سحب الترخيص. |
| `SEE_FULL_DETAILS` | تتطلب الحالة فحصًا يدويًا. |

> [!NOTE]
>
> بما أن `registry_status` يعكس القيم الخام للسجل، استخدم `verification_status` أدناه عندما تحتاج إلى مؤشر متسق عبر الولايات القضائية لتوجيه منطق المنتج.

## حالة التحقق من الشركة

حالة موحّدة موجّهة للشركات لكل نتيجة خاصة بشركة. تُوحّد حالات السجلات والشركات المتباينة عبر الدول والمصادر المختلفة في مؤشر واحد متسق يمكن تفسيره مباشرةً داخل منتجك. تظهر داخل قرار KYB ضمن `company.verification_status`.

| الحالة | المعنى |
| - | - |
| `verified` | تبدو الشركة نشطة وصالحة. |
| `failed` | تبدو الشركة غير نشطة أو منحلّة، أو تم تحديد مشكلات فيها. |
| `unknown` | المعلومات غير كافية، أو الحالة ملتبسة. |

## حالة جلب بيانات الشركة

تشير إلى مدى تقدم استرجاع البيانات لسجل شركة محدد من السجلات الخارجية أو الرسمية. استخدمها لتحديد مدى اكتمال المعلومات المسترجعة لشركة معينة. تظهر داخل قرار KYB ضمن `company.fetch_status`.

| الحالة | المعنى |
| - | - |
| `pending` | لم يُسترجع في هذه المرحلة إلا جزء من معلومات الشركة، أو معلومات أساسية فقط. |
| `resolved` | تم استرجاع بيانات الشركة كاملة ومكتملة بنجاح من المصادر الرسمية. |

## حالة التحقق من AML

تُعاد لكل فحص (للشركة أو للشخص).

| الحالة | المعنى |
| - | - |
| `"Approved"` | لا توجد تطابقات تتجاوز الحد. |
| `"Declined"` | نتيجة عالية الخطورة (تطابق مؤكد مع العقوبات أو مع PEP). |
| `"In Review"` | توجد مطابقة تتطلب مراجعة من محلل. |
| `"Not Finished"` | لم يكتمل الفحص. |

## كيف يشرح القرار نفسه

لا يتضمن قرار KYB سلسلة نصية واحدة لرمز السبب.
تحمل كل مصفوفة ميزات (`registry_checks[]` و`document_verifications[]` و`key_people_checks[]` و`aml_screenings[]`) الحقل `warnings[]` الذي يتضمن وسوم `KYB_*` ووسوم AML، ويسجّل `decision_trace` كيفية التوصّل إلى القرار.
اقرأ الوسوم في [تحذيرات KYB](https://docs.didit.me/ar/business-verification/warnings.md)، وسجّلها بجانب حالة الجلسة.

عندما يضبط المراجِع الحالة يدوياً مقابل التجميع الخاص بالمنصة، يتضمن القرار `status_override` مع وقت `overridden_at` و`automatic_status`، وهي الحالة التي كانت المنصة ستضبطها تلقائياً.
راجع [مخطط الاستجابة](https://docs.didit.me/ar/business-verification/response-schema.md).

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

> [card] [مخطط الاستجابة](https://docs.didit.me/ar/business-verification/response-schema.md)
>
> مكان ظهور كل حالة في payload.

> [card] [تقييم المخاطر](https://docs.didit.me/ar/business-verification/risk-assessment.md)
>
> ما الذي يحدد نتيجة KYB.

> [card] [webhook](https://docs.didit.me/ar/business-verification/webhooks.md)
>
> الأحداث التي تُطلق عند تغيّر الحالة.


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