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

تقدّم هذه المقالة تعليمات لتهيئة B2CORE لاستخدام مزوّد التحقق من هوية العميل Persona. باستخدام Persona، يتحقق العملاء من هوياتهم عبر مسار Persona الذي يُفتح في واجهة B2CORE أو تطبيق الهاتف المحمول: يلتقطون صورة لوثيقة هوية حكومية وصورة شخصية، ثم يتحقق Persona منهما. يتلقى B2CORE النتيجة، ويُنزّل صور الوثائق إلى ملف العميل، ويحدّث بياناته، ويوافق على طلب التحقق أو يرفضه.

كيف يعمل التحقق

1. يبدأ العميل التحقق لمستوى يستخدم Persona. ينشئ B2CORE استعلامًا في Persona باستخدام قالب الاستعلام المخصّص لهذا المستوى، ويملأ مسبقًا اسم العميل وبريده الإلكتروني ورقم هاتفه.
2. يُفتح مسار Persona في واجهة B2CORE أو تطبيق الهاتف المحمول. يرفع العميل الوثائق ويلتقط صورة شخصية مباشرةً في Persona، ولا تمر الملفات عبر B2CORE.
3. بعد أن ينتهي العميل، ينشئ B2CORE طلب تحقق للمستوى.
4. يتخذ Persona قرارًا بشأن الاستعلام، إما تلقائيًا باستخدام سير عمل Persona أو يدويًا بواسطة فريق الامتثال لديك، ويرسل ويب هوك إلى B2CORE.
5. يُنزّل B2CORE صور الوثائق، ويحدّث ملف العميل، ويوافق على الطلب أو يرفضه. وعند الموافقة على الطلب، يحصل العميل على مستوى التحقق.

إذا أغلق العميل المتصفح أو التطبيق قبل عودة المسار إلى B2CORE، فإن الويب هوك يُنهي معالجة الطلب رغم ذلك، فلا تُفقد أي بيانات.

إعداد Persona

أكمل الخطوات التالية في لوحة تحكم Persona. ستحتاج إلى القيم التي تحصل عليها هنا لتهيئة الاتصال في B2CORE.

إنشاء قوالب الاستعلام

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

انسخ معرّف كل قالب (يبدأ بـ itmpl_). يمكنك العثور عليه في إعدادات القالب بلوحة تحكم Persona.

إعداد اتخاذ القرارات

أنشئ سير عمل في Persona يوافق على الاستعلامات التي تجتاز جميع الفحوص ويرفض الاستعلامات التي لا تجتازها. ومن دونه، تبقى الاستعلامات في الحالة completed أو failed في Persona، ولا تُقبل أو تُرفض أبدًا.

الحصول على مفتاح API

أنشئ مفتاح API في لوحة تحكم Persona. تبدأ مفاتيح بيئة الاختبار بـ persona_sandbox_، وتبدأ مفاتيح بيئة الإنتاج بـ persona_production_. عنوان URL الخاص بواجهة API هو نفسه في البيئتين؛ والمفتاح هو ما يحدد البيئة المستخدمة.

الحصول على معرّف البيئة

انسخ معرّف بيئة Persona التي تستخدمها (يبدأ بـ env_). للعثور عليه، انتقل في لوحة تحكم Persona إلى المؤسسة > المعلومات.

إنشاء ويب هوك

أنشئ ويب هوك في لوحة تحكم Persona بالإعدادات التالية:

• عنوان URL: https://{your-B2CORE-back-office-domain}/api/v2/my/verification-persona/webhook
• الأحداث:
  • inquiry.created
  • inquiry.completed
  • inquiry.failed
  • inquiry.approved
  • inquiry.declined
  • inquiry.marked-for-review

بعد إنشاء الويب هوك، انسخ الرمز السري الخاص به (يبدأ بـ wbhsec_).

كيفية تهيئة اتصال بـ Persona

لا يمكن إعداد اتصال بـ Persona إلا للمسؤولين الممنوحين صلاحيات إدارة الاتصالات الخارجية.

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

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

عندما تعدّل الاتصال لاحقًا، اترك حقلي مفتاح API والرمز السري للويب هوك فارغين للاحتفاظ بالقيم المحفوظة.

الموافقة على الفحوص المنتهية دون قرار من Persona

• No (موصى به) — ينتظر B2CORE حتى يوافق Persona على الاستعلام أو يرفضه.
• Yes — تتم الموافقة على الاستعلام الذي أكمله العميل، ويُرفض الاستعلام الذي فشل، من دون انتظار قرار من Persona.

بادئة المعرّف المرجعي

يعتبر Persona المعرّف المرجعي الواحد شخصًا واحدًا. ويرسل B2CORE معرّف العميل بوصفه المعرّف المرجعي. على سبيل المثال، مع البادئة brand-، يُرسل العميل ذو المعرّف 454 بالمعرّف brand-454.

• إذا كانت عدة نسخ مثبتة من B2CORE تستخدم مؤسسة Persona نفسها (مثل بيئة الإنتاج وبيئة الاختبار، أو علامتين تجاريتين)، فخصّص بادئة فريدة لكل نسخة. وإلا فسيُدمج عملاء مختلفون يحملون المعرّف نفسه في شخص واحد في Persona.
• إذا كانت مؤسسة Persona لديك مستخدمة فقط بواسطة نسخة B2CORE هذه، فاترك الحقل فارغًا. عندئذٍ يرسل B2CORE معرّف العميل من دون بادئة.
• يمكن أن يصل طول البادئة إلى 32 حرفًا، ويمكن أن تحتوي على أحرف لاتينية وأرقام والرموز _ و. و: و-.

مزامنة الصور الشخصية

• Yes (الافتراضي) — تُحفظ الصورة الشخصية التي التقطها العميل في Persona ضمن وثائق العميل بجانب صور وثيقة الهوية.
• No — تُحفظ صور وثيقة الهوية فقط. وتبقى الصورة الشخصية في Persona.

كيفية إنشاء مستويات تحقق لـ Persona

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

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

مجموعات الوثائق وأنواعها ليست مطلوبة لـ Persona: فالوثائق التي يجب على العملاء تقديمها تُحدَّد في قالب استعلام Persona.

تحتفظ المستويات التي تستخدم معالجات أخرى بمزوّدها الحالي.

ما يحدث بعد التحقق

يرسل Persona ويب هوك إلى B2CORE عندما تتغير حالة استعلام. يعالج B2CORE الويب هوك على النحو التالي:

ملاحظات:

• يحفظ B2CORE صور وثيقة الهوية، وكذلك الصورة الشخصية ضمن وثائق العميل إذا ضُبط خيار مزامنة الصور الشخصية على Yes.
• بعد الموافقة، يحدّث B2CORE الاسم الأول والأوسط واسم العائلة وتاريخ الميلاد والبلد والعنوان للعميل باستخدام البيانات التي استخرجها Persona من الوثائق. ولا يُحدَّث رقم الهاتف.
• إذا اتخذ مسؤول امتثال قرارًا يدويًا في المكتب الخلفي، فتكون لهذا القرار الأولوية على قرار Persona.
• لا تسبّب رسائل الويب هوك المكررة أو التي تصل بغير ترتيبها مشكلة: يقرأ B2CORE دائمًا الحالة الحالية للاستعلام من Persona.
• إذا فُقد ويب هوك، يعيد B2CORE معالجة الاستعلامات التي انتظرت قرارًا لأكثر من 6 ساعات (يُجرى الفحص يوميًا).
• الاستعلامات التي بدأها العميل ولم يقدّمها لا تُنشئ طلبات تحقق.

الانتقال من SumSub

1. هيّئ اتصال Persona وفعّله.
2. لكل مستوى يجب أن يستخدم Persona، اختر قالب الاستعلام، ثم غيّر المعالج الخاص بالمستوى إلى PersonaSDK.
3. عطّل اتصال SumSub.

يحتفظ العملاء بمستويات التحقق الحالية الخاصة بهم.

استكشاف الأخطاء وإصلاحها

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