كيفية إضافة التحقق إلى تطبيقك باستخدام Toden
Charles Archibong, المؤسس المشارك
أضف خاصية التحقق إلى تطبيقك باستخدام سير عمل منشور وحزمة تطوير برمجية مدعومة أو جلسة مستضافة. احتفظ بعملية جمع البيانات ضمن رحلة العميل، ومعالجة النتائج النهائية في نظامك الخلفي.
أهم النقاط
- يفتح التطبيق سير العمل المنشور المقصود.
- تبقى بيانات الاعتماد السرية في النظام الخلفي.
- يتم التعامل مع الرحلات الملغاة والمنتهية الصلاحية والمهجورة.
- تتوافق النتائج النهائية مع العميل المستهدف.
- يستخدم الإنتاج سير العمل الخاص به، والمفاتيح، والمستقبل.
أضف خاصية التحقق إلى تطبيقك باستخدام سير عمل منشور ومدعوم SDK أو جلسة مستضافة. احتفظ بعملية التسجيل في رحلة العميل ومعالجة النتيجة النهائية في نظامك الخلفي.
قبل أن تبدأ
سير عمل منشور
الدعم SDK أو مسار الجلسة المستضافة
يقوم خادمك باسترجاع النتيجة النهائية
استخدم أحد أعضاء الفريق المصرح له بالتحكم في هذا الخيار. تحقق من المؤسسة والبيئة قبل تغيير أي إعداد. راجع السعر الحالي قبل إجراء أي عملية دفع أو تجديد الاشتراك. تُظهر لقطات الشاشة مثالاً لمساحة عمل أو مرجع تكامل عام؛ ولا تُظهر عميلاً حقيقياً أو عملية دفع مكتملة.
قم بإعداد واستخدام هذه الإمكانية
الخطوة 1: نشر سير العمل الذي يجب على العملاء استخدامه
افتح الإعدادات ← سير العمل في بيئة الاختبار. أنشئ أو افتح سير العمل المناسب (فردي، أو خاص بالعمل، أو محدد النطاق). اضبط فقط عمليات التحقق المطلوبة لالتقاط البيانات ومراجعتها. احفظه وانشره، ثم انسخ معرّف سير العمل. تحقق من المؤسسة والبيئة قبل الدمج. سير العمل غير المنشور ليس إعدادًا قابلاً لإعادة الاستخدام لالتقاط البيانات مباشرةً.
مثال على لوحة المعلومات: انشر سير العمل الذي يجب على العملاء استخدامه
الخطوة الثانية: اختر التقاطًا مضمنًا أو جلسة مستضافة
استخدم الإنترنت SDK لالتقاط الصور من المتصفح، استخدم React Native أو Flutter لالتقاط الصور من الأجهزة المحمولة مباشرةً، وجلسة مُستضافة عند الحاجة إلى رابط لمتقدم معروف. ميزات حصرية للتطبيقات الأصلية مثل: NFC يتطلب الأمر مسارًا أصليًا. يخدم رابط سير العمل المشترك العديد من المتقدمين، بينما تخص الجلسة التي ينشئها الخادم متقدمًا واحدًا فقط. اختر المسار الذي يتوافق مع منتجك بدلًا من خلط بيانات اعتمادهم.
مرجع التكامل: ثلاث طرق لتشغيل سير العمل
الخطوة 3: تثبيت الإصدار المدعوم حاليًا SDK وقم بضبط إعدادات الالتقاط
اتبع إرشادات منصتك SDK دليل الحزمة المدعومة، والتبعيات المطلوبة، وتصريحات الأذونات. مرر معرّف سير العمل (workflowId) ، ومفتاح API القابل للنشر المطابق ، ومعرّف المستخدم الثابت (userId ). يوفر سير العمل الخطوات المُكوّنة؛ وتبقى بيانات المستخدم في وقت التشغيل مع تطبيقك. تحقق من الحد الأدنى الموثق لإصدار سير العمل المُفعّل قبل استكشاف أخطاء تدفق يتجاهل معرّف سير العمل وإصلاحها.
مرجع التكامل: سير العمل
الخطوة الرابعة: بالنسبة لعملية الالتقاط المستضافة، قم بإنشاء الجلسة على الواجهة الخلفية الخاصة بك
يتصل POST /api/kyc/sessions مع مفتاح سري، ومعرّف سير العمل المنشور، ومعرّف المستخدم الخارجي المقصود. أضف البيانات المُسبقة والبيانات الوصفية المسموح بها فقط عند الحاجة. خزّن مرجع الجلسة وأعطِ الخاص URL للمتقدم المقصود. يتم تثبيت لقطة سير العمل عند وقت الإنشاء. لا تضع مفتاحًا سريًا في WebView أو إصدار الهاتف المحمول أو حزمة المتصفح.
مرجع التكامل: الطلب
الخطوة 5: سجل عملية الإرسال، ثم انتظر النتيجة
ال SDK يُحدد رد الاتصال الخاص بتقديم الطلب عملية التقديم، ولكنه ليس رد الاتصال الخاص بالموافقة النهائية. خزّن مرجع التحقق الخاص به في نظامك الخلفي. اقرأ الحالة الحالية باستخدام الصلاحيات الممنوحة. API أو استلام إشعارات الويب الموقعة. حافظ على فصل مراحل المعالجة، والمراجعة البشرية، وانتظار إعادة الإرسال، والخطأ، والنتائج النهائية. اقرأ الحالة النهائية باستخدام checkStatus وشرحها، خاصةً عندما ينتظر اتخاذ القرار نتائج فحوصات أخرى.
مرجع التكامل: الولايات
الخطوة السادسة: اختبار الرحلة الكاملة وإعداد الإنتاج بشكل منفصل
استخدم معرّفات بيئة الاختبار المدعومة ووحدات الاختبار لالتقاط البيانات، وحالة النظام، واستقبال البيانات. نفّذ اختبارات رفض الأذونات، والتخلي عن العملية، وإعادة المحاولات، والمراجعة، والرفض. بالنسبة لبيئة الإنتاج، احصل على موافقة الإدارة، وانشر سير العمل الخاص بها، وقم بتهيئة المفاتيح ومستقبل النتائج المتوافقة مع البيئة، وراجع الأسعار الحالية. يُؤكد اجتياز بيئة الاختبار صحة إجراءاتك، ولكنه لا يُعدّ دليلاً على أن كل عملية فحص أو جهاز يعمل بشكل صحيح.
مرجع التكامل: قائمة التحقق لبدء التشغيل
استفد أكثر من هذه الإمكانية
اسمح بتغيير إعدادات التقاط تغييرات نشر سير العمل دون تكرار هذه الإعدادات في كل إصدار من التطبيق.
استخدم البيانات الوصفية للربط المسموح به مثل مرجع التطبيق، مع الحفاظ عليها ضمن الحدود الموثقة.
اختبر عملية تسليم الهاتف، واستعادة الأذونات، والأحداث المستضافة على المتصفح للرحلة التي تقوم بتنفيذها فعليًا.
اختبر قبل الاعتماد عليه
قم بتشغيل سيناريوهات بيئة الاختبار أو المحاكاة المدعومة لهذا المنتج. في حال كانت الأداة مخصصة للإنتاج فقط، تحقق من صلاحيات الوصول ونطاقها أولاً، ثم استخدم اختبار إنتاج مسموح به وخضع لمراجعة دقيقة. لا تُعد لقطة شاشة من الوثائق أو تحميل الصفحة بنجاح اختبار تكامل شامل.
يفتح التطبيق سير العمل المنشور المقصود.
تبقى بيانات الاعتماد السرية في النظام الخلفي.
يتم التعامل مع الرحلات الملغاة والمنتهية الصلاحية والمهجورة.
تتوافق النتائج النهائية مع العميل المستهدف.
يستخدم الإنتاج سير العمل الخاص به، والمفاتيح، والمستقبل.
استكشاف الأخطاء وإصلاحها
ال SDK يتجاهل معرف سير العمل
تحقق من إصدار الحزمة المثبتة مقابل الحد الأدنى الموثق وتحقق من سير العمل المنشور.
لم يتم العثور على سير العمل
تطابق المفتاح، والمنظمة، والبيئة، والمعرف المنشور.
تم تسجيل تطبيقي فورًا بعد عملية الإرسال.
انتظر الحالة الرسمية النهائية بدلاً من اعتبار تقديم طلب التقاط البيانات بمثابة موافقة.
افتح مراجع الإعداد والتكامل
سير العمل المفتوح (يفتح في علامة تبويب جديدة)
اقرأ مرجع التكامل (يفتح في علامة تبويب جديدة)
العودة إلى الحلول (يفتح في علامة تبويب جديدة) . اختر الخاصية التي تريد تفعيلها، ثم اتبع الدليل الخاص بها.
المصادر
Charles Archibong
المؤسس المشارك
شارك تشارلز أرتشيبونغ في تأسيس شركة Toden. وهو يكتب عن التحقق من الهوية، والتكنولوجيا المالية، والعمل العملي لبناء خدمات رقمية موثوقة.
