كيفية التحقق من وجود العنوان ومراقبته باستخدام Toden
Charles Archibong, المؤسس المشارك
تحقق من وجود العنوان خلال فترة مراقبة مدعومة. قم بتهيئة عملية الالتقاط، وإعداد التقارير الأصلية، والحصول على موافقة العميل معًا، ثم ميّز الأدلة التي تم التحقق منها، والأدلة التي فشلت، والأدلة غير الحاسمة.
أهم النقاط
- تتميز الساعة التي لا تُظهر أي تقدم بمسار تشخيصي واضح.
- رفض الإذن له مسار أمامي أو مسار استرداد قابل للاستخدام.
- تبقى الكلمات "تم التحقق منها" و"فشلت" و"غير حاسمة" كلمات متميزة.
- لا يتم تقديم الساعة المضغوطة في Sandbox كدليل على الإقامة الحية.
- يتم توضيح التكلفة المتكررة وخيار إلغاء الاشتراك قبل التفعيل المستمر.
تحقق من وجود العنوان خلال فترة مراقبة مدعومة. قم بتهيئة عملية الالتقاط، وإعداد التقارير الأصلية، والحصول على موافقة العميل معًا، ثم ميّز الأدلة التي تم التحقق منها، والأدلة التي فشلت، والأدلة غير الحاسمة.
قبل أن تبدأ
عنوان مؤهل وموافقة العميل
إعلانات الموقع المدعومة على الهاتف المحمول
خيار منفصل للمراقبة المستمرة
استخدم أحد أعضاء الفريق المصرح له بالتحكم في هذا الخيار. تحقق من المؤسسة والبيئة قبل تغيير أي إعداد. راجع السعر الحالي قبل إجراء أي عملية دفع أو تجديد الاشتراك. تُظهر لقطات الشاشة مثالاً لمساحة عمل أو مرجع تكامل عام؛ ولا تُظهر عميلاً حقيقياً أو عملية دفع مكتملة.
قم بإعداد واستخدام هذه الإمكانية
الخطوة 1: ابدأ بعنوان مؤهل تم التقاطه
تأكد من أن العميل لديه رمز PIN مُصرّح به للعنوان ومرجع خارجي ثابت. في سير العمل، فعّل خاصية "ذكاء العنوان" وافتح "الحضور" . اختر فترة المراقبة المدعومة ومتطلبات الأدلة. يُعتبر رمز PIN لمرة واحدة بمثابة مطالبة؛ أما المراقبة لعدة أيام فتتطلب تقريرًا منفصلاً. لا يُمكن افتراض أن أماكن العمل والرحلات التي تتم عبر المتصفح فقط غير المدعومة تُنتج دليلًا على وجود سكني.
مرجع التكامل: التحقق من الحضور
الخطوة الثانية: تهيئة التطبيق الأصلي ومسار الموافقة
استخدم React Native أو Flutter SDK ومرر معرّف المستخدم الثابت. اتبع إعدادات موقع الخلفية لمنصتك عند تفعيل إعداد التقارير في الخلفية. يتطلب React Native التسجيل الموثق عند بدء التشغيل؛ بينما يتطلب Flutter ملفات البيان وInfo.plist. اشرح البيانات التي يتم جمعها، وامنح المستخدم التحكم في الأذونات. تفعيل مفتاح سير العمل دون إعداد التطبيق يُفقد الساعة بياناتها.
مرجع التكامل: ما يجب أن يفعله تطبيقك
الخطوة 3: الإبلاغ عن التواجد عند فتح التطبيق والعودة إلى وضع التشغيل الأمامي
استدعِ مُبلِّغ حالة التواجد الموثَّق لنفس مُعرِّف المستخدم الخارجي عند فتح التطبيق أو عودته إلى الواجهة الأمامية. يدعم هذا المستخدمين الذين يرفضون إذن الوصول إلى الخلفية والهواتف التي يُقيِّد مدير البطارية هذا الإذن. لا تُزوِّر إحداثيات أو تستبدل موقع IP. إذا تمَّ التقاط البيانات في مسار مُستضاف، فاستخدم عملية تسليم رمز PIN المُصرَّح به الموثَّقة قبل انتظار التقارير الأصلية.
مرجع التكامل: الإبلاغ عن حالة التواجد من تطبيقك
الخطوة الرابعة: تحقق من التقدم الفعلي للساعة
معلومات المخاطر المفتوحة ← التحقق من العنوان أو استرجاعه GET /api/kyc/address/presence/{externalUserId} . افحص الحالة والتقدم وعدد الملاحظات ومستوى الأدلة. لا تُرجع نقطة النهاية رمز PIN. يجب الإبلاغ عن استعادة حالة المراقبة العالقة عند الصفر. استخدم سبب المُبلِّغ و SDK يُستخدم وضع التواجد للتمييز بين فقدان رمز التعريف الشخصي، ورفض الإذن، وتعطيل خدمات الموقع.
مرجع التكامل: إظهار مكان وجود الشيك للشخص
الخطوة 5: تفسير مسارات الحل الثلاثة
تعني كلمة "تم التحقق" أن الأدلة المسجلة استوفت شروط السياسة. أما كلمة "فشل" فتتطلب وجود تناقض في سلامة البيانات، مثل دليل على موقع مزيف؛ ولا يُعدّ الغياب فشلاً. وتعني كلمة "غير حاسم" أن الفترة الزمنية انتهت دون أدلة كافية، ولا تُعتبر دليلاً ضد العميل. استخدم أحداث النتائج الموقعة لتحديث تطبيقك. يجب على متطلبات الخلفية فقط فحص أدلة السياسة المناسبة بدلاً من الاعتماد على إجمالي الأيام فقط.
مرجع التكامل: تأجيل القرار بشأنه
الخطوة 6: تفعيل الدورات المستمرة فقط عند الحاجة
لتأكيد العنوان بشكل مستمر، راجع إعدادات التشغيل الدائم، وتكرار العملية، والسعر السنوي. خيارات التكرار المتاحة هي 30، 60، 90، 180، أو 365 يومًا. احتفظ بفحص التواجد لمرة واحدة منفصلاً عن تغطية التجديد السنوي. إيقاف التجديد يوقف الدورات المستقبلية؛ أما الفحص الجاري فسيظل له حله الخاص. راجع الأذونات واستعادة الإلغاء في تطبيقك.
مرجع التكامل: المراقبة المستمرة
استفد أكثر من هذه الإمكانية
استخدم التقارير الأمامية كخيار احتياطي مدعوم وأظهر طبقة الأدلة قيد التشغيل بالفعل.
اختبر قيود البطارية الخاصة بالشركة المصنعة على أجهزة Android التي يستخدمها عملاؤك؛ استخدم خيار خدمة المقدمة الموثق فقط مع إعداد صريح وإفصاح مرئي للعميل.
أظهر التقدم المحرز دون الكشف عن عنوان الشخص أو مكان وجوده الحالي. أرسل إشعارات عبر تطبيقك عند حدوث تغيير في النتيجة المسجلة.
اختبر قبل الاعتماد عليه
قم بتشغيل سيناريوهات بيئة الاختبار أو المحاكاة المدعومة لهذا المنتج. في حال كانت الأداة مخصصة للإنتاج فقط، تحقق من صلاحيات الوصول ونطاقها أولاً، ثم استخدم اختبار إنتاج مسموح به وخضع لمراجعة دقيقة. لا تُعد لقطة شاشة من الوثائق أو تحميل الصفحة بنجاح اختبار تكامل شامل.
تتميز الساعة التي لا تُظهر أي تقدم بمسار تشخيصي واضح.
رفض الإذن له مسار أمامي أو مسار استرداد قابل للاستخدام.
تبقى الكلمات "تم التحقق منها" و"فشلت" و"غير حاسمة" كلمات متميزة.
لا يتم تقديم الساعة المضغوطة في Sandbox كدليل على الإقامة الحية.
يتم توضيح التكلفة المتكررة وخيار إلغاء الاشتراك قبل التفعيل المستمر.
استكشاف الأخطاء وإصلاحها
الأيام تبقى عند الصفر
تحقق من مكالمات المُبلِّغ، والرقم السري المُخزَّن، ومرجع المستخدم، والخدمات والأذونات.
توقف الإبلاغ عن المعلومات الخلفية
اقرأ النص الفعلي SDK استخدم مسار استعادة الإعدادات المدعومة. لا تُبقِ على تسميته "خلفية".
كانت النافذة غير حاسمة
اجمع الأدلة المسموح بها المفقودة أو قدّم وسيلة النقل البديلة المناسبة. الغياب لا يثبت صحة العنوان.
افتح مراجع الإعداد والتكامل
افتح أداة لوحة التحكم (يفتح في علامة تبويب جديدة)
اقرأ مرجع التكامل (يفتح في علامة تبويب جديدة)
العودة إلى الحلول (يفتح في علامة تبويب جديدة) . اختر الخاصية التي تريد تفعيلها، ثم اتبع الدليل الخاص بها.
المصادر
Charles Archibong
المؤسس المشارك
شارك تشارلز أرتشيبونغ في تأسيس شركة Toden. وهو يكتب عن التحقق من الهوية، والتكنولوجيا المالية، والعمل العملي لبناء خدمات رقمية موثوقة.
