التحقق من مستندات الشركات (KYB): واجهة برمجة التطبيقات

التحقق من الشركات يتضمن جمع المستندات بشكل منظم للتحقق من معلومات الشركة بما يتجاوز ما هو متاح في سجلات الشركات.

الأسعار

تكلّف عملية جمع مستندات KYB $0.20 لكل خطوة في سير العمل، بغض النظر عن عدد المستندات المرفوعة في تلك الخطوة. إعادة رفع مستند في الخطوة نفسها لا تضيف رسومًا أخرى، أما خطوة جمع مستندات منفصلة فلها رسومها الخاصة.

مجموعات المستندات

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

المجموعة (`document_group`)	الوصف	الأنواع الفرعية المعترف بها
الوجود القانوني (`LEGAL_PRESENCE`)	مستندات تثبت أن الشركة موجودة قانونيًا	`CERTIFICATE_OF_INCORPORATION`, `CERTIFICATE_OF_GOOD_STANDING`, `CERTIFICATE_OF_INCUMBENCY`, `REGISTRY_EXCERPT`, `BUSINESS_LICENSE`, `TAX_REGISTRATION`
تفاصيل الشركة (`COMPANY_DETAILS`)	مستندات تصف التفاصيل الحالية للشركة	`CONFIRMATION_STATEMENT`, `ANNUAL_RETURN`, `STATEMENT_OF_INFORMATION`
هيكل الملكية (`OWNERSHIP_STRUCTURE`)	مستندات تثبت سلسلة الملكية	`SHAREHOLDER_REGISTRY`, `MEMORANDUM_OF_ASSOCIATION`, `ARTICLES_OF_ASSOCIATION`
تفويض الممثلين (`REPRESENTATIVES_AUTHORIZATION`)	مستندات تثبت الصلاحية للتصرف نيابة عن الشركة	`DIRECTOR_REGISTRY`, `POWER_OF_ATTORNEY`, `TRUST_AGREEMENT`
أخرى (`OTHER`)	أي شيء لا تستطيع Didit تصنيفه بثقة	`UNKNOWN`

تتابع كل مجموعة تقدمها عبر عدادات خاصة بها: total، وapproved، وpending، وdeclined، وin_review، وother، وmissing. وتُجمّع حالة المستندات الإجمالية لجلسة الشركة البيانات عبر جميع المجموعات.

أنواع المستندات

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

سير عمل المستندات

الطلبات التلقائية

بناءً على إعداد سير العمل لديك، تحدد Didit تلقائيًا المستندات المطلوبة للتحقق من الشركة. ثم تُعرض أنواع المستندات المطلوبة على الشركة لرفعها.

الرفع

تُرفع المستندات عبر تدفق التحقق المستضاف، أو من خلال Business Console، أو من واجهتك الأمامية باستخدام endpoint رفع المستندات. الصيغ المقبولة هي PDF وJPG وJPEG وPNG وTIFF وWebP، أو أرشيف ZIP يحتوي عليها. يمكن أن يصل حجم ملفات PDF إلى 50 MB، والصور إلى 6 MB قبل الضغط. بالنسبة إلى ملف PDF محمي بكلمة مرور، أرسل كلمة المرور في document_passwords عند الرفع عبر API.

استخراج البيانات عبر OCR

تستخرج Didit البيانات المنظمة من المستندات المرفوعة باستخدام OCR:

اسم الشركة ورقم التسجيل من الشهادات
بيانات العنوان من فواتير الخدمات
الأرقام المالية من الكشوفات
الأسماء والأدوار من سجلات المساهمين

المقارنة المتقاطعة

تُقارن البيانات المستخرجة مع:

بيانات السجل من البحث عن الشركة
المعلومات المقدمة عند إنشاء الجلسة
البيانات من المستندات الأخرى المرفوعة

تُوضع علامة على التناقضات لمراجعتها من قبل المحلل.

المراجعة

يراجع المحللون المستندات المرفوعة في Business Console، ويتحققون من صحتها، ويقبلون أو يرفضون كل مستند على حدة.

طلبات المستندات من المحللين

أثناء عملية المراجعة، يمكن للمحللين طلب مستندات إضافية:

انتقل إلى جلسة الشركة في Business Console
انقر على طلب مستند وحدد نوع المستند والوصف
تُخطَر الشركة ويمكنها رفع المستند المطلوب
يظهر المستند في الجلسة بحالة مطلوب حتى يتم رفعه

يتيح ذلك للمحللين جمع أدلة إضافية دون رفض جلسة الشركة بالكامل.

حالات المستندات

يستخدم كل مستند والتحقق الإجمالي document_verifications[] مجموعة الحالات القياسية لميزات KYB:

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

نتائج المطابقة المتقاطعة

عند معالجة مستند، يقارن Didit البيانات المستخرجة عبر OCR مع البيانات التي قدمها المستخدم المُرسلة في مسار الأشخاص الرئيسيين (وأي بيانات مؤكدة أثناء مراجعة السجل)، إضافةً إلى المستندات الأخرى المرفوعة. تُنتج المطابقة نتائج منظمة:

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

تُعرض نتائج المطابقة المتقاطعة في Business Console إلى جانب معاينة المستند، فتمنح المحللين صورة واضحة عمّا يتطابق وما يحتاج إلى انتباه.

استرجاع المستندات عبر API

تُرفق المستندات بجلسة التحقق من الشركات (KYB). استرجعها من قرار الجلسة:

curl https://verification.didit.me/v3/session/{session_id}/decision/ \
  -H "x-api-key: YOUR_API_KEY"

تتضمن الاستجابة مصفوفة document_verifications[]. يحتوي كل عنصر فيها على status وnode_id وitems[] (ويحتوي كل منها على file_url موقّع وdocument_group وdocument_subtype وبيانات مستخرجة عبر OCR)، إضافةً إلى groups وrequired_groups. راجع مخطط الاستجابة للاطلاع على البنية الكاملة.

البدء

الميزات

ملفات الشركات

المرجع

Console

التحقق من مستندات الشركات (KYB): واجهة برمجة التطبيقات

الأسعار

مجموعات المستندات

أنواع المستندات

سير عمل المستندات

طلبات المستندات من المحللين

حالات المستندات

نتائج المطابقة المتقاطعة

استرجاع المستندات عبر API

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

مخطط الاستجابة

Business Console

​الأسعار

​مجموعات المستندات

​أنواع المستندات

​سير عمل المستندات

​طلبات المستندات من المحللين

​حالات المستندات

​نتائج المطابقة المتقاطعة

​استرجاع المستندات عبر API

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

مخطط الاستجابة

Business Console

الأسعار

مجموعات المستندات

أنواع المستندات

سير عمل المستندات

طلبات المستندات من المحللين

حالات المستندات

نتائج المطابقة المتقاطعة

استرجاع المستندات عبر API

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