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

​
كيفية عمل كل طريقة

​
التقاط الوثيقة

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

​
استعلام بدون مستند

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

​
محفظة

يسجل المستخدم الدخول باستخدام هوية رقمية يمتلكها بالفعل، مثل الهوية الإلكترونية الوطنية (eID) أو الهوية المصرفية. تقوم المحفظة بمصادقة المستخدم، ثم تشارك سمات الهوية الموقعة مع Didit. وفقاً للمحفظة، قد يُدخل المستخدم رمز تعريف شخصي أو رقم هاتف؛ ولا يلزم التقاط صورة مستند لفحص المحفظة. تعتمد تجربة تسجيل الدخول على المحفظة: إما من خلال الانتقال إلى تطبيق آخر، أو رمز QR، أو رمز مقارنة يتم تأكيده على هاتف المستخدم. يستخدم Smart-ID وMobile-ID رمز مقارنة. تتوفر السمات الخاصة بكل محفظة، والتوفر في بيئة الإنتاج، ودلالات الفشل في محافظ الهوية الرقمية.

​
مستويات الضمان

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

​
تهيئة الطرق لكل دولة

توجد الطرق تحت المفتاح methods في تهيئة ميزة التحقق من الهوية (OCR)، ومفتاحها هو رمز الدولة وفقاً لمعيار ISO 3166-1 alpha-3. إذا حذفت المفتاح، أو حذفت دولة، أو حذفت طريقة داخل دولة، فستقتصر تلك الدولة على التقاط الوثيقة فقط.
كلتا الدولتين أعلاه مُدرجتان بالحالة available للاستعلام في الدليل المنشور. يُبقي المثال المحافظ معطَّلة حتى لا يعتمد على تفعيل محفظة معينة في بيئتك. سيتم رفض أي سير عمل يفعّل محفظة تم وضع علامة قريباً عليها، بما في ذلك التهيئة الأخرى الموجودة في عملية الحفظ تلك. بمجرد أن يحدد الدليل محفظة ما بالحالة available في دولة معينة، فإن كتلة المحفظة لتلك الدولة ستبدو كالتالي:
تحقق من الدليل قبل الإرسال. متطلب مسبق: أن تظهر المحفظة بالحالة «متاحة» لتلك الدولة، كما هو موضح في محافظ الهوية الرقمية. قاعدتان تفرضهما API عند الحفظ:
  • التوافر محدد من الخادم. يتم رفض أي طريقة أو محفظة لا يحددها دليل الإمكانات بالحالة available لتلك الدولة. اقرأ الدليل أولاً — عبر علامة التبويب الدول في لوحة التحكم، أو باستخدام أداة MCP المسماة didit_workflow_get_id_verification_methods_catalog.
  • المحافظ قائمة قبول وليست ترتيباً. يحدد الحقل providers المحافظ التي يجوز لدولة ما تقديمها. الترتيب الذي ترسله ليس له أي معنى، ويُوحَّد تلقائياً ولا يُحتفظ بترتيبه؛ والمستخدم النهائي هو من يختار.
يتوفر المرجع الكامل حقلاً بحقل، بما في ذلك القيم الافتراضية وعمليات التحقق، في تهيئة ميزات سير العمل.

​
الإجراء البديل: ماذا يحدث عند عدم نجاح طريقة غير قائمة على المستندات

تحدد أربعة مفاتيح تبديل ما يحدث بعد ذلك. يقبل كل منها إما fallback_to_document (توجيه المستخدم إلى التقاط المستندات) أو decline (إنهاء الجلسة مع رفض التحقق من الهوية)؛ كما يقبل wallet.on_failure أيضاً القيمة retry، الموضحة أدناه. والقيمة الافتراضية لجميع المفاتيح الأربعة هي fallback_to_document. يقبل wallet.on_failure أيضاً قيمة ثالثة، وهي retry، بالنسبة لدولة تقبل المحفظة فقط (إيقاف تشغيل التقاط المستندات): الخيار retry مخصص للمحفظة فقط: تأخذ مفاتيح تبديل البحث القيمة fallback_to_document أو decline، لأن السجل الذي أجاب بـ “عدم وجود تطابق” لا يوجد ما يمكن إعادة محاولته معه. ويُرفض استخدامه مع document.fallback_only، الذي يتطلب فشلاً يؤدي إلى التقاط المستندات. يُعد تسجيل الدخول عبر المحفظة، الذي أعاد بيانات تفشل في فحوصات سير العمل لديك (العمر، مطابقة الاسم، وما إلى ذلك)، تسجيل دخول تم التحقق منه: وتحدد قواعد سير العمل القرار، ولا ينطبق wallet.on_failure. يُعتبر تسجيل الدخول الذي يكون الـ token الخاص به أصلياً ولكنه غير مقبول (مستوى ضمان خاطئ، توقيع غير صالح، مطالبات مطلوبة مفقودة) بمثابة فشل ويتبع wallet.on_failure. المعامل id_lookup.max_attempts (من 1 إلى 5، والقيمة الافتراضية 1) يحدد عدد عمليات البحث المُجاب عليها المتاحة للمستخدم قبل تفعيل مفتاح التبديل. والرقم الذي يفشل في فحص التنسيق من جانب العميل لا يصل أبداً إلى السجل، وبالتالي لا يستهلك أي محاولة — يُطلب من المستخدم ببساطة تصحيحه. لا يمكن للمحفظة أو البحث اللجوء إلى التقاط المستندات كإجراء بديل إلا عند تمكين التقاط المستندات لتلك الدولة وقبول نوع مستند واحد على الأقل فيها. عند إيقاف تشغيل التقاط المستندات، أو في حال عدم قبول أي نوع من المستندات للدولة، فإن تسجيل الدخول الفاشل أو البحث الذي لا يتطابق يؤدي إلى رفض الجلسة، حتى إذا كان مفتاح التبديل محدداً بـ fallback_to_document. الاستثناء هو wallet.on_failure: retry، والذي لا يرفض أبداً: يظل المستخدم في خطوة المحفظة. لا يوجد خيار بديل يمكن اللجوء إليه. أي طريقة أنتجت النتيجة: fallback_from يحدد verification_method دائماً الطريقة التي أنتجت النتيجة المتحقق منها: wallet أو id_lookup أو document. ويوضح fallback_from سبب عدم إنهاء الطريقة غير القائمة على المستندات خطوة التحقق من الهوية، في كلتا النتيجتين:
  • استخدام الإجراء البديل. يتم توجيه المستخدم إلى التقاط المستندات. وتحمل عملية التحقق من المستند التالية القيمة verification_method: "document" مع تحديد fallback_from للطريقة التي فشلت، على سبيل المثال { "method": "wallet", "reason": "cancelled", "action": "fallback_to_document" }. أما الجلسة التي تم التحقق منها عبر المحفظة فتحمل verification_method: "wallet" وfallback_from: null.
  • الرفض. إذا كان مفتاح التبديل هو decline، أو إذا لم يكن هناك مستند يمكن اللجوء إليه كإجراء بديل. وتحمل عملية التحقق من الهوية المرفوضة حقل fallback_from مع "action": "decline".
الحقل method يكون wallet أو id_lookup، والحقل reason هو النتيجة التي أنهت العملية (cancelled أو timeout أو no_match أو provider_error وما إلى ذلك). وتصل الحقول نفسها في قرار الجلسة وفي webhook status.updated. السجل الذي لا يجيب (بسبب انتهاء المهلة أو انقطاع الخدمة) هو الاستثناء: فهو لا يرفض المستخدم بمفرده أبداً. لا تتم فوترة عملية البحث ولا تُستهلك أي محاولة؛ ويُطلب من المستخدم إعادة المحاولة. بعد ثلاث عمليات بحث دون إجابة في الخطوة، ينطبق id_lookup.on_provider_error: يؤدي الخيار decline إلى رفض الجلسة، بينما يوجه fallback_to_document المستخدم إلى التقاط المستندات. عندما يكون مفتاح التبديل هذا هو fallback_to_document ولكن لا يتوفر في الدولة مستند يمكن اللجوء إليه، يظل البحث مفتوحاً ويمكن للمستخدم متابعة المحاولة؛ ولا يتم رفض الجلسة.

​
إتاحة التقاط المستندات كإجراء بديل فقط

بشكل افتراضي، تعرض الدولة التي توفر محفظة أو بحثاً عن الهوية إلى جانب التقاط المستندات كلا الخيارين جنباً إلى جنب في الشاشة الأولى. اضبط document.fallback_only على true للإبقاء على تمكين التقاط المستندات للدولة دون تقديمه مسبقاً. يبدأ المستخدمون بمحفظة الدولة أو البحث عن الهوية. في حالة وجود محفظة واحدة، ينتقل المستخدم مباشرة إلى تلك المحفظة. ويتم توجيه المستخدمين فقط إلى التقاط المستندات إذا فشل تسجيل الدخول عبر المحفظة أو تم إلغاؤه أو انتهت مهلته، أو إذا لم يتطابق البحث. تحدد مفاتيح التبديل المذكورة أعلاه أياً من هذه النتائج يؤدي إلى التقاط المستندات، لذا يجب أن يكون أحدها على الأقل fallback_to_document.
المعامل fallback_only اختياري وقيمته الافتراضية false. ويتم رفضه ما لم يكن document.enabled مضبوطاً على true وتكون هناك محفظة واحدة على الأقل أو بحث هوية واحد في تلك الدولة يعتمد على التقاط المستندات كإجراء بديل. قم بتمكين أنواع المستندات التي يجب أن يقدمها الإجراء البديل في documents_allowed، على سبيل المثال جواز السفر وبطاقة الهوية لفنلندا.

​
تكلفة كل طريقة

هذه هي الأسعار المعلنة: ينطبق خصم الخطة الخاص بك على كلتا الطريقتين. يستخدم البحث أسعار التجزئة المعلنة لخدمة التحقق من قواعد البيانات للخدمات التي يُشغّلها؛ ويمكن لعدة خدمات أن تشترك في محاولة واحدة. تختار نيجيريا إما NIN أو BVN. يوضح جدول الدول السعر الكامل للمحاولة المهيأة، مع فوترة كل إعادة محاولة تمت الإجابة عليها بشكل منفصل.

​
قواعد الفوترة

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

​
التغطية

التقاط المستندات متاح في كل دولة تدعمها Didit ولا نكرر ذكره أدناه: $0.15 لكل فحص. يسرد هذا الجدول فقط الدول التي تتوفر فيها طريقة بدون مستندات. أي دولة غير مدرجة، أو أي خلية تنص على “غير مخطط له”، تقتصر على التقاط المستندات فقط.
يتم إنشاء التغطية من كتالوج الإمكانات الذي توفره الواجهة الخلفية، لذا فإن هذا الجدول هو نفس المصدر الذي تتحقق منه لوحة التحكم وAPI. تعني عبارة قريباً أن الإدخال مرئي في لوحة التحكم ولكن لا يمكن تفعيله بعد؛ فهو ليس إمكانية متاحة فعلياً ولا يحمل تاريخاً ملتزماً به.

​
ما يظهر في الجلسة

تحمل كل نتيجة من نتائج التحقق من الهوية الطريقة التي أنتجتها، ومستوى الضمان الخاص بها، و—عند تشغيل طريقة غير مستندية—كتلة أدلة خاصة بالطريقة. وتظهر جلسات المستندات تماماً كما كانت من قبل، مع ضبط المفاتيح الجديدة على null. تتوفر الأنواع لكل حقل مع الأمثلة لجميع الطرق الثلاث في نموذج بيانات التحقق من الهوية، وتصل المفاتيح نفسها مع حدث webhook‏ status.updated.

​
مواضيع ذات صلة

آخر تعديل في ٧ نوفمبر ٢٠٢٦