كيفية التحقق من هوية العميل مرة أخرى باستخدام Toden

Charles Archibong, المؤسس المشارك
اطلب من المتقدم الحالي إعادة التحقق من عملية التحقق المكتملة، إما بالكامل أو لخطوات محددة فقط. يُحفظ رقم التحقق عند إعادة التحقق، ويتم تسجيل محاولة جديدة ليتمكن فريقك من شرح التغييرات.

أهم النقاط
- تؤدي إعادة تنفيذ خطوة محددة إلى الحفاظ على معرف التحقق.
- يرى مقدم الطلب رسالة التصحيح.
- لا تزال المحاولات القديمة متاحة، ولا يمكن للروابط القديمة أن تنافس.
- لا يؤدي إشعار المحاولة القديمة المتأخرة إلى استبدال النتيجة الجديدة.
اطلب من المتقدم الحالي إعادة التحقق من عملية التحقق المكتملة، إما بالكامل أو لخطوات محددة فقط. يُحفظ رقم التحقق عند إعادة التحقق، ويتم تسجيل محاولة جديدة ليتمكن فريقك من شرح التغييرات.
قبل أن تبدأ
مرجع العميل الحالي
إذن بطلب أو مراجعة عملية التحقق
استخدم أحد أعضاء الفريق المصرح له بالتحكم في هذا الخيار. تحقق من المؤسسة والبيئة قبل تغيير أي إعداد. راجع السعر الحالي قبل إجراء أي عملية دفع أو تجديد الاشتراك. تُظهر لقطات الشاشة مثالاً لمساحة عمل أو مرجع تكامل عام؛ ولا تُظهر عميلاً حقيقياً أو عملية دفع مكتملة.
قم بإعداد واستخدام هذه الإمكانية
الخطوة 1: العثور على التحقق المكتمل
افتح بيانات العميل في قسم العملاء ← الأفراد أو الشركات ، ثم افتح عملية التحقق ذات الصلة. تحقق من بيانات العميل وبيئته ومعرّفه قبل اتخاذ أي إجراء. استخدم "التحقق" مرة أخرى لإتمام عملية التحقق القائمة على سير العمل. قد تُظهر عملية التحقق غير المكتملة نتيجة، لذا لا تُعِدْها أثناء معالجتها. يتطلب التحقق الذي لا يتوفر له سير عمل مسار بدء جديد موثق.

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

مرجع التكامل: أعد فقط ما فشل
الخطوة 3: اختر إصدار سير العمل بعناية
اختر السياسة الأصلية لتشغيل لقطة سير العمل الأصلية، أو اختر أحدث سياسة لاستخدام النسخة المنشورة حاليًا. في حال عدم اختيارك، سيتم تطبيق إعدادات إعادة تشغيل سير العمل الخاصة به. تحقق مما إذا كان تغيير السياسة الحالية يؤثر على ما يجب على مقدم الطلب تقديمه. لا تفترض أن مساري العمل، الأصلي والأحدث، يطلبان نفس الأدلة.

مرجع التكامل: نص الطلب
الخطوة الرابعة: إنشاء الرابط الجديد وإرساله
من الواجهة الخلفية، اتصل POST /api/kyc/verifications/{id}/rerun باستخدام مفتاح سري والخطوات والرسالة والسياسة المحددة. أضف البريد الإلكتروني فقط إذا كنت ترغب في ذلك Toden لإرسال الرابط، احتفظ برابط الجلسة (session.url) خاصًا بالمتقدم المقصود فقط؛ فهو بمثابة بيانات اعتماد. تحقق من نتيجة الإرسال. لا يؤدي فشل إرسال البريد الإلكتروني إلى إبطال الرابط المُعاد، لذا يمكنك استخدامه عبر مسار الإرسال المُصرّح به.

مرجع التكامل: تم إنشاء الاستجابة 201
الخطوة 5: إبقاء المتقدم على آخر محاولة
تنتقل عملية التحقق إلى حالة "بانتظار إعادة التقديم" . تتوقف الروابط السابقة لنفس عملية التحقق عن العمل. اعرض على مقدم الطلب الرابط الجديد بدلاً من إرسال عدة روابط متضاربة. إذا قرر مراجع آخر عملية التحقق أو بدأ إعادة تقديم لاحقة، فقم بتسوية الحالة الحالية. لا يُعد الرابط المستبدل سببًا لإنشاء سجل عميل جديد.

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

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

Charles Archibong
المؤسس المشارك
شارك تشارلز أرتشيبونغ في تأسيس شركة Toden. وهو يكتب عن التحقق من الهوية، والتكنولوجيا المالية، والعمل العملي لبناء خدمات رقمية موثوقة.


