كيفية تأكيد بيانات الاتصال مع Toden
Charles Archibong, المؤسس المشارك
تحقق من إمكانية الوصول إلى جهات الاتصال باستخدام البريد الإلكتروني أو رمز الهاتف. استخدم خطوة سير العمل لرحلات جمع البيانات، أو واجهة برمجة التطبيقات المستقلة عندما يحتاج تطبيقك إلى فحص منفصل لجهات الاتصال.
أهم النقاط
- تتخذ الرموز الصحيحة والخاطئة والمنتهية الصلاحية مسارات مختلفة.
- يمكن التوفيق بين التحدي الذي تم التحقق منه بعد فقدان الاستجابة.
- يجب احترام حدود معدل الإرسال المتكرر.
- يتم تسجيل الاتصال المؤكد فقط مع العميل المقصود.
تحقق من إمكانية الوصول إلى جهة الاتصال باستخدام البريد الإلكتروني أو رمز الهاتف. استخدم خطوة سير العمل لرحلات جمع البيانات، أو بشكل مستقل. API عندما يحتاج تطبيقك إلى فحص منفصل لجهات الاتصال.
قبل أن تبدأ
قناة التوصيل المدعومة
إمكانية وصول العميل إلى عنوان البريد الإلكتروني أو رقم الهاتف
استخدم أحد أعضاء الفريق المصرح له بالتحكم في هذا الخيار. تحقق من المؤسسة والبيئة قبل تغيير أي إعداد. راجع السعر الحالي قبل إجراء أي عملية دفع أو تجديد الاشتراك. تُظهر لقطات الشاشة مثالاً لمساحة عمل أو مرجع تكامل عام؛ ولا تُظهر عميلاً حقيقياً أو عملية دفع مكتملة.
قم بإعداد واستخدام هذه الإمكانية
الخطوة 1: اختر سير العمل أو التحقق المستقل
لإتمام عملية التحقق، افتح سير العمل الخاص بك وفعّل التحقق عبر البريد الإلكتروني ، أو التحقق عبر الهاتف ، أو كليهما. استخدم سير عمل مُخصّصًا لجهة اتصال مُحدّدة عندما تحتاج فقط إلى تحديث جهات اتصال عميل حالي. أما بالنسبة لشاشة إدخال رمز مستقلة في تطبيقك، فاستخدم جهة اتصال مستقلة. API في نظامك الخلفي. لا تخلط إثباته مع فاتورة منفصلة. SDK خطوة الاتصال.
مثال على لوحة التحكم: اختر سير العمل أو التحقق المستقل
الخطوة الثانية: تهيئة خطوة رمز سير العمل
حدد التحقق من البريد الإلكتروني ← الإعداد . راجع " مطلوب للمتابعة" ، و "طول الرمز" ، و "الحد الأقصى للمحاولات" ، و "نمط إدخال الرمز" . اضبط خطوة الهاتف المُفعّلة بشكل منفصل. أبقِ حد المحاولات واستعادة صلاحية الرمز واضحين للعملاء. راجع القواعد الخاصة بكل جهة اتصال، مثل نتائج البريد الإلكتروني المؤقت، ثم احفظ وانشر سير العمل قبل إنشاء جلسات جديدة.
مثال على لوحة المعلومات: تكوين خطوة رمز سير العمل
الخطوة 3: إرسال رمز مستقل من الواجهة الخلفية الخاصة بك
يتصل POST /api/kyc/contact/verifications مع ضبط القناة على البريد الإلكتروني أو الهاتف والوجهة . أضف البلد لتنسيقات الهاتف الوطنية ومعرّف المستخدم الخارجي الثابت عند تسجيل إثبات هوية عميل حالي. خزّن معرّف التحدي المُسترجع والوجهة الموحدة وتاريخ انتهاء الصلاحية. لا يرسل Sandbox رسالة حقيقية؛ قناة التسليم الخاصة به تجريبية.
مرجع التكامل: أرسل رمزًا
الخطوة الرابعة: تحقق من الكود مقابل التحدي الخاص به
اطلب من الشخص إدخال الرمز، ثم اتصل POSTاستخدم رمز التحقق من خلال الرابط /api/kyc/contact/verifications/{id}/check . استخدم معرّف التحدي الذي تم إرجاعه من خلال استدعاء الإرسال. لا تُعلّم جهة الاتصال بأنها مُؤكدة عند إرسال رسالة. تحقق من الحالة: مُؤكدة . في بيئة الاختبار، يكون الرمز عبارة عن أصفار فقط بالطول المُحدد. لا تُفصح أبدًا عن مفتاح سري في شاشة إدخال الرمز.
مرجع التكامل: راجع الكود
الخطوة 5: معالجة انتهاء الصلاحية والرموز الخاطئة والغموض
تدوم الرموز خمس دقائق. اعرض المحاولات المتبقية للرمز الخاطئ؛ يتطلب التحدي المستنفد أو المنتهي الصلاحية إرسالًا جديدًا. بعد فقدان استجابة التحقق، استرجعها. GET استخدم /api/kyc/contact/verifications/{id} للمطابقة. إعادة التحقق من التحدي الذي تم التحقق منه لا يترتب عليه رسوم إضافية. تجنب إرسال الطلبات بشكل متكرر إلى نفس الوجهة؛ فالحدود الزمنية المحددة لكل ساعة منفصلة عن محاولات إدخال رمز خاطئ.
مرجع التكامل: اقرأ التحدي
الخطوة 6: تخزين بيانات الاتصال المؤكدة وتفسير الإشارات
قم بتخزين الوجهة الموحدة والطابع الزمني المُتحقق منه في تطبيقك. وباستخدام كيان موجود مطابق، يسمح externalUserId للخدمة بتسجيل البيانات. OTP تم التحقق من وجود أدلة؛ ولا يؤدي ذلك إلى إنشاء كيان مفقود. استخدم الإشارات المؤقتة والافتراضية وغيرها فقط عند توفرها. لا يُعد امتلاك صندوق بريد أو هاتف دليلاً قاطعاً على الهوية. راجع السعر الحالي قبل استخدام الإنتاج.
مرجع التكامل: ما تخبرك به الإشارات
استفد أكثر من هذه الإمكانية
حافظ على ربط الإرسال والتحدي والعميل معًا بحيث لا يمكن لرمز التحقق من جهة اتصال عميل آخر.
تعامل مع نوع الخط غير المعروف أو أدلة MX على أنها غير معروفة. اعتمد سياسات مكافحة الحرائق على النتائج المسجلة، وليس على القيم المفقودة.
استخدم خطوات الاتصال في سير العمل قبل عمليات التحقق المكلفة من عملية الاستحواذ عندما يتناسب هذا التسلسل مع سياسة التوظيف الخاصة بك.
اختبر قبل الاعتماد عليه
قم بتشغيل سيناريوهات بيئة الاختبار أو المحاكاة المدعومة لهذا المنتج. في حال كانت الأداة مخصصة للإنتاج فقط، تحقق من صلاحيات الوصول ونطاقها أولاً، ثم استخدم اختبار إنتاج مسموح به وخضع لمراجعة دقيقة. لا تُعد لقطة شاشة من الوثائق أو تحميل الصفحة بنجاح اختبار تكامل شامل.
تتخذ الرموز الصحيحة والخاطئة والمنتهية الصلاحية مسارات مختلفة.
يمكن التوفيق بين التحدي الذي تم التحقق منه بعد فقدان الاستجابة.
يجب احترام حدود معدل الإرسال المتكرر.
يتم تسجيل الاتصال المؤكد فقط مع العميل المقصود.
استكشاف الأخطاء وإصلاحها
لم تصل رسالة Sandbox
هذا متوقع. يستخدم Sandbox قناة تسليم الاختبار ورمزًا برمجيًا صفريًا بالكامل.
رقم الهاتف الوطني غير صالح
أدخل رمز الدولة الصحيح المكون من حرفين أو استخدم تنسيق رمز الاتصال الدولي.
جهة الاتصال غير مسجلة في سجل العميل
تحقق من معرّف المستخدم الخارجي وتأكد من وجود العميل بالفعل في نفس المؤسسة والبيئة.
افتح مراجع الإعداد والتكامل
سير العمل المفتوح (يفتح في علامة تبويب جديدة)
اقرأ مرجع التكامل (يفتح في علامة تبويب جديدة)
العودة إلى الحلول (يفتح في علامة تبويب جديدة) . اختر الخاصية التي تريد تفعيلها، ثم اتبع الدليل الخاص بها.
المصادر
Charles Archibong
المؤسس المشارك
شارك تشارلز أرتشيبونغ في تأسيس شركة Toden. وهو يكتب عن التحقق من الهوية، والتكنولوجيا المالية، والعمل العملي لبناء خدمات رقمية موثوقة.
