نموذج بيانات الشركات: مخطط KYB

توثّق هذه الصفحة كل حقل في كيان الشركة وكيفية تعبئة Didit لكل حقل منها.

الحقول التعريفية

الحقل	النوع	الوصف
`uuid`	UUID	المفتاح الأساسي الذي تعيّنه Didit. ثابت وفريد.
`didit_internal_id`	string	معرّف داخلي قابل للقراءة البشرية.
`vendor_data`	string	معرّفك للشركة. فريد لكل تطبيق. اقرأ المزيد.
`display_name`	string	اسم مخصص يتجاوز الاسم المعروض في لوحة التحكم. الافتراضي هو `legal_name` أو `vendor_data`.
`legal_name`	string	الاسم القانوني المسجّل للشركة، ويُنقل من نتيجة البحث في السجل ضمن آخر جلسة تحقق من الشركات (KYB) مقبولة.
`registration_number`	string	رقم التسجيل الرسمي للشركة، ويُنقل من السجل.
`country_code`	string (ISO 3166-1 alpha-3)	بلد التأسيس.

legal_name وregistration_number وcountry_code للقراءة فقط عندما تُشتق من بحث موثّق في السجل. يمكن تجاوزها يدويًا في لوحة التحكم أو عبر PATCH /v3/businesses/{vendor_data}/، لكن التجاوزات تُعلَّم في سجل التدقيق.

الحالة

الحقل	النوع	القيم	الوصف
`status`	enum	`ACTIVE`, `FLAGGED`, `BLOCKED`	تتحكم في تطبيق القيود على الجلسات والمعاملات المستقبلية. راجع دورة الحياة.

حقول تجميع الجلسات

الحقل	النوع	الوصف
`session_count`	int	إجمالي جلسات التحقق من الشركات (KYB) التي أُنشئت لهذه الشركة على الإطلاق
`approved_count`	int	الجلسات المنتهية بحالة `Approved`
`declined_count`	int	الجلسات المنتهية بحالة `Declined`
`in_review_count`	int	الجلسات الحالية في حالة `In Review`
`features`	object	حالة التحقق الأحدث للشركة، ضمن المفتاح `KYB`

خريطة `features`

{
  "KYB": "Approved"
}

تحتوي الخريطة على مفتاح واحد، وهو KYB، ويحمل حالة أحدث عملية تحقق للشركة: "Not Finished" أو "Approved" أو "Declined" أو "In Review" أو "Resub Requested". لمعرفة حالة كل ميزة KYB على حدة، اقرأ قرار الجلسة. استخدم خريطة features كمسار سريع للتحقق مما إذا كانت الشركة موثّقة بالكامل الآن، دون المرور على جميع الجلسات.

الطوابع الزمنية للنشاط

الحقل	النوع	يتم التحديث عند
`first_session_at`	طابع زمني بتنسيق ISO	إنشاء أول جلسة تحقق من الشركات (KYB)
`last_session_at`	طابع زمني بتنسيق ISO	إنشاء أحدث جلسة أو تحديثها
`last_activity_at`	طابع زمني بتنسيق ISO	أي تغيير: جلسة، أو معاملة، أو حالة، أو ملف تعريف، أو ملاحظات
`created_at`	طابع زمني بتنسيق ISO	إنشاء صف الكيان
`updated_at`	طابع زمني بتنسيق ISO	آخر تحديث لصف الكيان

البيانات الوصفية

الحقل	النوع	الوصف
`metadata`	object (JSON)	بيانات JSON حرة تتحكم بها
`tags[]`	array	وسوم تُدار من لوحة التحكم أو عبر API

العلاقات (غير مخزّنة في صف الشركة)

العلاقة	طريقة الوصول
جلسات التحقق من الشركات (KYB)	`GET /v3/sessions?vendor_data=<value>`
المستخدمون المرتبطون (المسؤولون، والمستفيدون الحقيقيون (UBO)، والمديرون)	تظهر في صفحة تفاصيل الشركة في لوحة التحكم، وتُشتق من آخر جلسة تحقق من الشركات (KYB) مقبولة
المعاملات (بصفة مقدّم الطلب أو الطرف المقابل)	صفِّ المعاملات حسب `vendor_data` للشركة
المستندات	عبر قرارات جلسات التحقق من الشركات (KYB)
نتائج AML	عبر قرارات جلسات التحقق من الشركات (KYB)

مثال على الاستجابة

{
  "uuid": "f7a9c1b2-4e6d-4f8a-9c5d-2a1b3c4d5e6f",
  "didit_internal_id": "B-2026-00018",
  "vendor_data": "biz-acme",
  "display_name": "Acme Corp",
  "legal_name": "Acme Corporation Limited",
  "registration_number": "12345678",
  "country_code": "GBR",
  "status": "ACTIVE",
  "session_count": 2,
  "approved_count": 1,
  "declined_count": 0,
  "in_review_count": 1,
  "features": {
    "KYB": "Approved"
  },
  "first_session_at": "2025-09-01T12:00:00Z",
  "last_session_at": "2026-04-01T09:00:00Z",
  "last_activity_at": "2026-04-16T10:00:00Z",
  "metadata": { "partner": "Acme Holdings" }
}

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

العمليات

إنشاء الشركة وتحديثها وتغيير حالتها وحذفها.

سجل التحقق من الشركات (KYB)

استرداد كل جلسة مرتبطة بالشركة.

مرجع API

مخطط GET /v3/businesses//.

آخر تعديل في ٧ نوفمبر ٢٠٢٦

نظرة عامة

الأسعار

سير العمل والتحقق

المراجعة والعمليات

الكيانات (المستخدمون والشركات)

الإعدادات والتخصيص

الأمان والامتثال

Didit Academy

الموارد

نموذج بيانات الشركات: مخطط KYB

الحقول التعريفية

الحالة

حقول تجميع الجلسات

خريطة `features`

الطوابع الزمنية للنشاط

البيانات الوصفية

العلاقات (غير مخزّنة في صف الشركة)

مثال على الاستجابة

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

العمليات

سجل التحقق من الشركات (KYB)

مرجع API

​الحقول التعريفية

​الحالة

​حقول تجميع الجلسات

​خريطة features

​الطوابع الزمنية للنشاط

​البيانات الوصفية

​العلاقات (غير مخزّنة في صف الشركة)

​مثال على الاستجابة

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

العمليات

سجل التحقق من الشركات (KYB)

مرجع API

الحقول التعريفية

الحالة

حقول تجميع الجلسات

خريطة `features`

الطوابع الزمنية للنشاط

البيانات الوصفية

العلاقات (غير مخزّنة في صف الشركة)

مثال على الاستجابة

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