كيفية ربط سجلات عملائك بـ Toden
Charles Archibong, المؤسس المشارك
اربط العملاء الموجودين بالفعل في تطبيقك بسجلات Toden باستخدام مراجع ثابتة. احتفظ بما تعرفه عن مصدر التحقق الخاص بهم بدلاً من ترقية الادعاءات المستوردة إلى حقائق موثقة.
أهم النقاط
- يؤدي مرجع خارجي واحد إلى السجل المقصود.
- إن عملية تأكيد الاستيراد وإتمامها أمران منفصلان.
- تظل الصفوف الفاشلة قابلة للتفسير وإعادة المحاولة.
- تحتفظ الادعاءات المستوردة بمصدرها الصحيح.
- يتم ربط عملية استعادة النطاق بالعميل الحالي.
قم بربط العملاء الموجودين بالفعل في تطبيقك بـ Toden استخدم مراجع موثوقة لتسجيل البيانات. احتفظ بما تعرفه عن مصدر التحقق بدلاً من تحويل الادعاءات المستوردة إلى حقائق موثقة.
قبل أن تبدأ
مراجع عملاء مستقرة
الوصول المصرح به للاستيراد أو إدارة الملفات الشخصية
استخدم أحد أعضاء الفريق المصرح له بالتحكم في هذا الخيار. تحقق من المؤسسة والبيئة قبل تغيير أي إعداد. راجع السعر الحالي قبل إجراء أي عملية دفع أو تجديد الاشتراك. تُظهر لقطات الشاشة مثالاً لمساحة عمل أو مرجع تكامل عام؛ ولا تُظهر عميلاً حقيقياً أو عملية دفع مكتملة.
قم بإعداد واستخدام هذه الإمكانية
الخطوة 1: اختر مرجعًا موثوقًا للعميل
استخدم معرّف العميل أو الشركة الدائم من نظامك كمعرّف مستخدم خارجي . احتفظ بمرجع واحد لنفس الشخص عبر عمليات الاستيراد والتحقق والنشاط. حدّد ما إذا كان الشخص فردًا أم شركة. لا تستخدم بريدًا إلكترونيًا قابلًا للتغيير كمعرّف العميل الوحيد. احصل على تفويض لنقل بيانات الملف الشخصي الذي تنوي تسجيله.
مرجع التكامل: تسجيل أو تحديث كيان
الخطوة الثانية: اختر المصدر الصحيح
يستخدم UNVERIFIED لسجل لم يكتمل التحقق منه. استخدم EXTERNAL_VERIFIED فقط عندما يكون لديك تصريحك الخاص KYC تم التحقق من ذلك من خلال عملية التحقق من الهوية، باستخدام مصدر موثوق . لا تدّعي ذلك. MYAZA_VERIFIED لا يُستخدم سجل خارجي مستورد لمجرد فتح ميزة معينة. تعتمد روابط الهوية وأدلة المخاطر على عقودها الخاصة؛ ولا يُعدّ وجود محفظة مُطالب بها دليلاً على الملكية.
مرجع التكامل: KYC تحديد المصدر والهوية
الخطوة 3: تسجيل سجل واحد من الواجهة الخلفية
يتصل POST استخدم /api/identity/entities مع مفتاح سري ومعرف المستخدم الخارجي للعميل ونوعه وملفه الشخصي المسموح به. قدّم فقط التفاصيل المعروفة. يؤدي إعادة استخدام مرجع العميل نفسه إلى تحديث الكيان الحالي بدلاً من إنشاء كيان جديد. حافظ على دلالات استبدال البيانات الوصفية مدروسة، وخزّن معرف الكيان المُعاد مع سجل تطبيقك.
مرجع التكامل: الطلب
الخطوة الرابعة: اقرأ السجل مرة أخرى قبل إرسال النشاط
يسترد GET قم بمقارنة بيانات المستخدم المُسترجعة، ومصدرها ، وملفها الشخصي المسموح به مع السجل المطلوب. راجع عملية التسجيل في الفحص بشكل منفصل. INACTIVE يعني أن الفحص غير نشط؛ QUEUED لم يتم الانتهاء من الفحص. احتفظ بـ Toden معرفات الكيانات ومراجعك الخارجية مميزة بحيث تستخدم التقييمات اللاحقة شكل الموضوع المتوقع لنقطة النهاية.
مرجع التكامل: البحث عن كيان
الخطوة 5: استيراد كتاب أكبر باستخدام المهمة غير المتزامنة
للحصول على دفعة مدعومة، اتصل على POST استورد البيانات من 1 إلى 1000 مدخل باستخدام نموذج التسجيل الموثق في المسار /api/identity/entities/import . خزّن معرّف المهمة (jobId) المُسترجع من استجابة 202. راقب تقدم المهمة حتى تكتمل، ثم افحص عدد المدخلات الناجحة والفاشلة والمعلقة، بالإضافة إلى تفاصيل حالات الفشل المحددة. لا يُعدّ تأكيد الاستيراد دليلاً قاطعاً على نجاح جميع الصفوف.
مرجع التكامل: الاستيراد المجمع
الخطوة السادسة: إصلاح الأعطال وتوصيل الإمكانية التالية
قبل إعادة محاولة إدخال بيانات العملاء الفاشلة، تأكد من مطابقتها مع بيانات المصدر. لا تقم بإعادة استيراد السجلات الناجحة بقيم مُزوَّرة. بمجرد وجود سجل، اربط عملية الالتقاط باستخدام المرجع نفسه أو أرسل بيانات نشاط الحساب المدعومة. قد تتطلب تقييمات المخاطر والمراقبة الدقيقة مُعرِّف الكيان المُسترجع وتفعيلًا منفصلاً. احتفظ بأدلة الأخطاء على مستوى العميل وأدلة المهام للدعم.
مرجع التكامل: تقييم أو مراقبة عميل حالي
استفد أكثر من هذه الإمكانية
حافظ على ثبات مرجع العميل عند تغيير اسم الملف الشخصي أو البريد الإلكتروني.
استخدم مصادر خارجية موثوقة للتحقق من المصدر واحتفظ بالمصدر حتى يتمكن المراجعون من فهم الأصل.
تعامل مع عناوين المحافظ الإلكترونية كسمات مخاطر محددة النطاق، وليس كمفاتيح هوية عالمية أو إذن بالتحويل.
اختبر قبل الاعتماد عليه
قم بتشغيل سيناريوهات بيئة الاختبار أو المحاكاة المدعومة لهذا المنتج. في حال كانت الأداة مخصصة للإنتاج فقط، تحقق من صلاحيات الوصول ونطاقها أولاً، ثم استخدم اختبار إنتاج مسموح به وخضع لمراجعة دقيقة. لا تُعد لقطة شاشة من الوثائق أو تحميل الصفحة بنجاح اختبار تكامل شامل.
يؤدي مرجع خارجي واحد إلى السجل المقصود.
إن عملية تأكيد الاستيراد وإتمامها أمران منفصلان.
تظل الصفوف الفاشلة قابلة للتفسير وإعادة المحاولة.
تحتفظ الادعاءات المستوردة بمصدرها الصحيح.
يتم ربط عملية استعادة النطاق بالعميل الحالي.
استكشاف الأخطاء وإصلاحها
أعادت دفعة البيانات الرمز 202، لكن السجلات مفقودة.
اقرأ عن تقدم العمل المتين وإخفاقاته بدلاً من افتراض أن الإقرار يعني اكتماله.
تم رفض تعديل الملف الشخصي
تحقق من الحقول المسموح بها في العقد لهذا السجل الموثق. لا تقم باستبدال بيانات الهوية الموثقة من خلال تحديث عام.
لا يمكن للتقييم العثور على العميل
تحقق من المؤسسة والبيئة ونوع المرجع ومعرف الكيان المتوقع من قبل نقطة النهاية هذه.
افتح مراجع الإعداد والتكامل
افتح أداة لوحة التحكم (يفتح في علامة تبويب جديدة)
اقرأ مرجع التكامل (يفتح في علامة تبويب جديدة)
العودة إلى الحلول (يفتح في علامة تبويب جديدة) . اختر الخاصية التي تريد تفعيلها، ثم اتبع الدليل الخاص بها.
المصادر
Charles Archibong
المؤسس المشارك
شارك تشارلز أرتشيبونغ في تأسيس شركة Toden. وهو يكتب عن التحقق من الهوية، والتكنولوجيا المالية، والعمل العملي لبناء خدمات رقمية موثوقة.
