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

​

البنية

​

المصادقة

​

إنشاء الجلسة

​

تسليم الرابط المستضاف

• أرسله بالبريد الإلكتروني من منصتك.
• ضمّنه في واجهة التسجيل لديك كرابط.
• افتحه في webview داخل التطبيق (iOS / Android / React Native).

​

الاستطلاع مقابل webhooks

• استطلع GET /v3/session/{id}/decision/ بتأخير متزايد أسياً (كل 10 ثوانٍ في البداية، ويصل إلى 60 ثانية).
• أوقف الاستطلاع عندما تكون status إحدى القيم "Approved" أو "Declined" أو "In Review".

​

التعامل مع webhooks

• status.updated: تغيّرت حالة الجلسة. صفِّ بـ session_kind === "business" لجلسات KYB.
• data.updated: قام مراجع بتعديل بيانات السجل أو الأشخاص الرئيسيين في Business Console، أو أبلغ السجل عن تغيير. لا يُرسل هذا الحدث عندما يرفع المتقدم مستنداً أو يرسل الأشخاص الرئيسيين، لذا تابع status.updated في تلك الحالة. ينطبق الفلتر نفسه session_kind.
• business.status.updated / business.data.updated: تغيّر كيان الشركة المرتبط.

​

التعامل مع القرارات

switch (decision.status) {
  case 'Approved':
    await onboardBusiness(decision);
    break;
  case 'Declined':
    // The KYB decision has no single reason code: collectWarnings is your helper
    // that flattens warnings[] from registry_checks, document_verifications,
    // key_people_checks and aml_screenings
    await logRejection(collectWarnings(decision), decision);
    break;
  case 'In Review':
    // Wait for analyst decision — another webhook will fire
    await markPending(decision);
    break;
  case 'Resubmitted':
    // The business was asked to re-upload a document
    await notifyBusiness(decision);
    break;
}

​

تدفق إعادة الإرسال

• إعادة إرسال الرابط url نفسه. يواصل التدفق المستضاف من النقطة التي تلزم فيها إعادة الإرسال.
• إعادة إصدار رابط شخص رئيسي غير صالح: يحصل الطرف الذي حُذفت جلسة KYC الفرعية الخاصة به، أو انتهت صلاحيتها قبل أن يبدأها الشخص، على جلسة جديدة باستخدام إعادة إنشاء جلسة KYC للأشخاص الرئيسيين.
• فتح حالة في Business Console لتتبع التواصل المتبادل داخلياً.

​

تنفيذ الخطوات من واجهتك الأمامية

1. رفع المستندات المؤسسية بينما تكون الجلسة في خطوة مستندات KYB.
2. قراءة الأطراف المذكورة في المستندات، بما في ذلك المساهمون ونسب الملكية، وعرضها على المتقدم.
3. إنشاء وتعديل وحذف مسودات الأطراف. المسودة غير مُعلنة ولا تكلّف شيئاً.
4. إرسال المسودات. يحدد Didit الأطراف الذين يجب التحقق منهم، وينشئ جلسة KYC لكل منهم، ويعيد kyc_session_url الخاص بها لترسله أو تضمّنه.
5. اقرأ القرار الموحد من الجلسة، كما في التدفق المستضاف.

​

تجميع ملف الشركة

• تُلحق تدفقات إعادة التحقق الدورية من الشركات بالملف نفسه.
• تحمل المعاملات المراقبة بالقيمة vendor_data نفسها سياق المخاطر الخاص بالشركة.
• يُربط المستفيدون الحقيقيون والمسؤولون بكيانات المستخدمين، فتُنشأ علاقات بين الكيانات.

​

أفضل الممارسات

​

معالجة الأخطاء

​

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