B2BROKERB2BROKER
MCP
B2COREB2CORE IBB2TRADERB2CONNECTB2TRANSLATEB2BROKER
إدارة خيارات التحقق

كيفية استخدام SumSub

تعرّف على كيفية ربط SumSub وتكوينه كمزوّد KYC وKYT في B2CORE، بما في ذلك إعداد المستندات ومستويات التحقق والتدفقات وإعدادات webhook

توفّر هذه المقالة إرشادات حول كيفية تكوين B2CORE لاستخدام مزوّد KYC وKYT، SumSub.

قبل متابعة الإرشادات، يجب أن تكون قد سجّلت في SumSub ولديك حساب نشط. لإجراء عمليات التحقق من KYT، يجب أيضًا تمكين SumSub Fraud Prevention وتكوينه بشكل صحيح.

كيفية تكوين اتصال بـ SumSub

يمكن للمسؤولين المعيّنين بصلاحيات إدارة الاتصالات الخارجية فقط إعداد اتصال بـ SumSub.

لإعداد اتصال:

في B2CORE Back Office، انتقل إلى System > External connections.

انقر على +Create في الزاوية العلوية اليمنى من الصفحة.

في صفحة Create connection، املأ الحقول التالية:

  • في حقل Name، أدخل اسمًا تريد استخدامه للاتصال.
  • في حقل Caption، أدخل تسمية توضيحية ستُطبّق على الاتصال في Back Office.
  • في القائمة المنسدلة Provider، اختر SumSubstance.

انقر على Save لإنشاء الاتصال.

في قائمة الاتصالات، ابحث عن اتصال SumSub الذي أنشأته وانقر على Edit لإدخال تفاصيل الاتصال.

في صفحة Edit connection، حدّد الإعدادات التالية:

  • في حقل Service Location، حدّد https://api.sumsub.com/.
  • في حقل Client ID، حدّد اسم حسابك في SumSub. لعرض اسم حسابك، في واجهة SumSub، انتقل إلى Settings > Account Details.
  • في حقل Webhook Secret Key، حدّد سر webhook. يجب إنشاء webhook في واجهة SumSub. للقيام بذلك، في واجهة SumSub، انتقل إلى Dev space > Webhooks (للاطلاع على تكوين webhook المطلوب، راجع تكوين webhook في SumSub).
  • اترك حقلي Login وPassword فارغين.
  • في حقلي Token وToken Secret، حدّد رمزًا وقيمة مفتاح سري تم إنشاؤهما في واجهة SumSub. لإنشائهما، في واجهة SumSub، انتقل إلى Dev space > App Tokens.
  • لتطبيق تدفقات تحقق مختلفة على العملاء الأفراد و_الشركات_، اختر Enabled من القائمة المنسدلة Client Resetting Mode.

عند تمكين خيار Client Resetting Mode، فهذا يعني أن التحقق المتكرر مطلوب للعملاء الذين تم تغيير نوعهم من فرد إلى شركة، أو العكس. بعد تغيير النوع، يحدث ما يلي:

  • في B2CORE Back Office، يُعاد تعيين مستوى تحقق العميل إلى Level 0، وهو مستوى التحقق الافتراضي.
  • يتم رفض جميع طلبات العميل المعلّقة للحصول على مستوى تحقق أعلى تلقائيًا.
  • في نظام SumSub، يُعاد المتقدم إلى المستوى الأولي، وتُلغى صلاحية جميع المستندات التي تم تحميلها مسبقًا لهذا المتقدم.

ستظل جميع الملفات والمستندات التي تم تحميلها مسبقًا لهذا العميل في B2CORE Back Office متاحة.

في قسم Transaction monitoring، قم بتكوين إعدادات عمليات التحقق من KYT باستخدام SumSub Fraud Prevention. تُدعم هذه العمليات حاليًا للإيداعات والسحوبات بالعملات النقدية والعملات الرقمية.

  • في القائمة المنسدلة Enabled، اختر:

    • Yes — لتمكين مراقبة المعاملات عبر SumSub واستلام النتائج في B2CORE.
    • No — لتعطيل مراقبة المعاملات عبر SumSub.

  • في القائمة المنسدلة Currency Filter:

    • اختر عملة واحدة أو أكثر لمراقبة المعاملات بالعملات المحددة فقط.
    • اترك القائمة فارغة لمراقبة المعاملات بجميع العملات.

انقر على Save لتطبيق الإعدادات.

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

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

لإنشاء مجموعة مستندات:

في B2CORE Back Office، انتقل إلى Verification > Document groups.

انقر على +Create في الزاوية العلوية اليمنى من الصفحة.

في صفحة Create document group، املأ الحقول التالية:

  • في حقل Name، حدّد اسم مجموعة المستندات.

تأكد من تحديد أسماء مجموعات المستندات تمامًا كما هي أسماء أنواع المستندات المدعومة من SumSub، مثل ID_CARD وPASSPORT وDRIVERS وRESIDENCE_PERMIT وغيرها.

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

  • في حقل Caption، حدّد تسمية توضيحية لمجموعة المستندات ستُعرض في واجهة مستخدم B2CORE.
  • في القائمة المنسدلة Type، اختر One.
  • في حقل Description، حدّد وصفًا لمجموعة المستندات يُستخدم في Back Office.

تأكد من اختيار Yes في القائمة المنسدلة Enabled.

انقر على Save لإنشاء مجموعة المستندات.

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

لكل مجموعة مستندات أنشأتها، أنشئ نوع مستند.

لإنشاء نوع مستند:

في B2CORE Back Office، انتقل إلى Verification > Document types.

انقر على +Create في الزاوية العلوية اليمنى من الصفحة.

في صفحة Create document type، املأ الحقول التالية:

  • في حقل Name، حدّد اسم نوع المستند.

يجب أن تكون أسماء أنواع المستندات مطابقة لأسماء مجموعات المستندات التي تم إنشاؤها مسبقًا. على سبيل المثال، ID_CARD وPASSPORT وDRIVERS وRESIDENCE_PERMIT وغيرها.

  • في حقل Caption، حدّد تسمية توضيحية لنوع المستند ستُعرض في واجهة مستخدم B2CORE.
  • في حقل Description، حدّد وصفًا لنوع المستند سيُعرض في واجهة مستخدم B2CORE.
  • في القائمة المنسدلة Group، اختر مجموعة المستندات التي يجب ربط نوع المستند بها.
  • في حقل Max files، حدّد الحد الأقصى لعدد الملفات التي يمكن للعملاء تحميلها لهذا النوع من المستندات.

في القائمة المنسدلة Status، اختر Enabled.

انقر على Save لإنشاء نوع المستند.

كيفية إنشاء مستويات التحقق لـ SumSub في B2CORE Back Office

يمكنك إنشاء مستويات تحقق أو تعديل المستويات الحالية لاستخدام SumSub للتحقق.

لإنشاء مستوى تحقق:

في B2CORE Back Office، انتقل إلى Verification > Levels.

انقر على +Create في الزاوية العلوية اليمنى من الصفحة.

في صفحة Create verification level، املأ الحقول التالية:

  • في حقل Index، حدّد قيمة عدد صحيح غير صفرية.

    يُعيّن الفهرس صفر (0) دائمًا إلى مستوى التحقق الافتراضي. بالنسبة إلى مستويات التحقق الأخرى، يجب أن يكون الفهرس أكبر من صفر، مثل 1 للمستوى 1 و2 للمستوى 2 وهكذا.

  • في القائمة المنسدلة Wizard، اختر SnsWizardSDK.

  • في حقل Caption، حدّد اسم مستوى سيُعرض في واجهة مستخدم B2CORE وتطبيق الجوال، مثل Level 1. إذا لزم الأمر، حدّد خصائص الترجمة لهذا الحقل بالنقر على الزر الموجود على الجانب الأيمن من الحقل.

  • في حقل Desktop Description، حدّد وصفًا للمستوى ليتم عرضه في واجهة مستخدم B2CORE. يمكن أن يتضمن هذا الوصف الصلاحيات الممنوحة للعملاء بمجرد حصولهم على هذا المستوى.

    يمكن تحديد وصف واجهة مستخدم B2CORE بتنسيق HTML. إذا لزم الأمر، حدّد خصائص الترجمة لهذا الحقل.

  • في حقل Mobile Description، حدّد وصفًا للمستوى ليتم عرضه في تطبيق الجوال.

    يمكن تحديد وصف تطبيق الجوال بتنسيق JSON. إذا لزم الأمر، حدّد خصائص الترجمة لهذا الحقل.

  • في القائمة المنسدلة Visible، اختر Yes.

  • في القائمة المنسدلة Default، اختر No. (Level 0 هو دائمًا مستوى التحقق الافتراضي).

  • في القائمة المنسدلة Assigned Client Right، اختر مستوى صلاحية يحدد مجموعة الصلاحيات التي تريد منحها لعملائك بعد الحصول على مستوى التحقق هذا (للتفاصيل، راجع صلاحيات العميل).

  • في القائمة المنسدلة Document groups، اختر مجموعة مستندات مطلوبة واحدة أو أكثر. على سبيل المثال، يمكنك اختيار ID_CARD وRESIDENCE_PERMIT إذا كنت تريد أن يقدّم عملاؤك بطاقات الهوية وتصاريح الإقامة الخاصة بهم للتحقق للحصول على هذا المستوى.

  • في القائمة المنسدلة Client tests، اختر اختياريًا اختبار اعتماد واحدًا أو أكثر إذا كنت تريد إلزام عملائك باجتياز هذه الاختبارات قبل أن يتمكنوا من تقديم مستنداتهم للتحقق. تتضمن قائمة الاختبارات المتاحة جميع الاختبارات التي تم تعيين ظهورها إلى Yes، والتي تُعرض في صفحة اختبارات العميل.

انقر على Save لإنشاء المستوى.

كيفية إنشاء المستويات والتدفقات في واجهة SumSub

يدعم B2CORE Back Office نوعين من العملاء: الأفراد و_الشركات_. يوفّر نظام SumSub إمكانية إعداد تدفق تحقق منفصل لكل نوع. لاستخدام هذا الخيار، تأكد من تمكين Client Resetting Mode عند تكوين اتصال بـ SumSub.

لإضافة مستوى جديد:

في واجهة SumSub، انتقل إلى Integrations > Applicant Levels.

انقر على Add new level.

اختر الخطوات المطلوبة.

يجب تحديد أسماء المستويات بالتنسيقات التالية:

  • للعملاء الأفراد: level1 وlevel2 وهكذا.
  • للعملاء الشركات: level3corporate وlevel4corporate وهكذا.

تضمن هذه التنسيقات التعيين الصحيح بين المستويات في SumSub وB2CORE. يستند التعيين إلى Index المعيّن لكل مستوى تحقق في B2CORE. يمكنك العثور على الفهارس في العمود المعني على صفحة Verification > Levels في B2CORE Back Office واستخدامها في أسماء المستويات لـ SumSub. على سبيل المثال:

  • يطابق level1 في SumSub المستوى الذي تكون قيمة Index فيه = 1 في B2CORE
  • يطابق level2 في SumSub المستوى الذي تكون قيمة Index فيه = 2 في B2CORE
  • يطابق level3corporate في SumSub المستوى الذي تكون قيمة Index فيه = 3 في B2CORE
  • يطابق level4corporate في SumSub المستوى الذي تكون قيمة Index فيه = 4 في B2CORE وهكذا.

لإضافة تدفق جديد:

في واجهة SumSub، انتقل إلى Integrations > Verification Flow.

انقر على Add new.

اختر الخيارات المطلوبة. لكل تدفق، اختر مستوى متوافقًا.

تكوين webhook في SumSub

تمت المراجعة

  • الاسم: REVIEWED
  • المستلم: HTTP Endpoint
  • الهدف: https://{your-Back-Office-URL}/api/v1/verification-sns/handle
  • النوع: Applicant reviewed (applicantReviewed)
  • المفتاح السري: المفتاح السري الذي تم إنشاؤه في SumSub

تأكد من استبدال {your-Back-Office-URL} بنطاق B2CORE Back Office الخاص بك، وليس واجهة مستخدم B2CORE. على سبيل المثال، قد يبدو الهدف الخاص بـ webhooks على النحو التالي: https://example.com/api/v1/verification-sns/handle.

آخر تحديث في

Previousكيفية استخدام مُنشئ KYCNextكيفية استخدام ShuftiPro

في هذه الصفحة

كيفية تكوين اتصال بـ SumSubكيفية إنشاء مجموعات مستندات للتحقق عبر SumSubكيفية إنشاء أنواع المستندات للتحقق عبر SumSubكيفية إنشاء مستويات التحقق لـ SumSub في B2CORE Back Officeكيفية إنشاء المستويات والتدفقات في واجهة SumSubتكوين webhook في SumSub