> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# إعداد طرق التحقق من الهوية في لوحة تحكم Didit

> اختر طرق التحقق من الهوية الثلاث المسموح بها لكل دولة في Didit، واضبط مفاتيح البديل، واطّلع على الطريقة التي استخدمتها الجلسة فعلياً.

يحتوي خطوة [التحقق من الهوية](https://docs.didit.me/ar/core-technology/id-verification/verification-methods.md) في سير العمل على تبويب **الدول**. هنا تحدد، دولةً دولةً، أي طرق الهوية الثلاث يحق للشخص استخدامها، وما الذي يحدث عندما لا تنجح طريقة لا تعتمد على المستند. كل ما في التبويب يكتب المفتاح [`methods`](https://docs.didit.me/ar/management-api/workflows/feature-configs#ocr-/-التحقق-من-الهوية) في عقدة **التحقق من الهوية**، فالواجهة وواجهة Management API عرضان لكائن واحد.

## الدول وطرق الهوية المسموح بها

افتح سير عملٍ، ثم اختر عقدة **التحقق من الهوية**، ثم **الدول**. يعرض كل صف دولة الطرق التي تقبلها. اختر دولة لفتح محررها.

| القسم | ما الذي يتحكم فيه | الإعداد الذي يكتبه |
| - | - | - |
| **التقاط المستند** | هل يُقبل مستند مُلتقط بالصورة، بالإضافة إلى أنواع المستندات وأنواعها الفرعية وقواعد الالتقاط لتلك الدولة | `document.enabled`, `documents_allowed` |
| **استعلام بدون مستند** | هل يُعرض الاستعلام الذي لا يحتاج إلى مستند، وعدد المحاولات التي يمكن للمستخدم الإجابة عنها، وهل تُتخطى خطوات الكشف عن الحيوية ومطابقة الوجه اللاحقة في سير العمل بعد مطابقة مدعومة بصورة شخصية | `id_lookup.enabled`, `id_lookup.max_attempts`, `id_lookup.skip_liveness_and_face_match` |
| **المحافظ المقبولة** | محافظ الهوية الرقمية التي تعرضها تلك الدولة. هي قائمة قبول وليست ترتيباً، فالمستخدم يختار مما تحدده أنت | `wallet.enabled`, `wallet.providers` |
| **الرجوع إلى التقاط المستند عند…** | مفتاح تشغيل واحد لكل حالة فشل | `id_lookup.on_partial_match`, `id_lookup.on_no_match`, `id_lookup.on_provider_error`, `wallet.on_failure` |

تكون مفاتيح **الرجوع إلى التقاط المستند عند…** مغلقة دائماً عندما لا يكون لدى الدولة التقاط للمستندات، لأنه لا يوجد مكان للرجوع إليه. فعّل **التقاط المستند** للدولة لاستخدامها.

إذا أوقفت كل الطرق في دولة ما، يُرفض الحفظ مع الرسالة **No method enabled — nobody can verify here**، لأن هذا الإعداد لا يستطيع التحقق من أي شخص.

### عرض التقاط المستند كبديل احتياطي فقط

افتح دولة واختر **كيف يتحقق المستخدمون هنا**:

| الخيار | ما يراه المستخدمون |
| - | - |
| **المحفظة أولًا، والمستند عند الفشل** | المحفظة فقط (أو استعلام الهوية، عندما لا تكون محفظة مختارة). لا يُعرض التقاط المستند إلا إذا أُلغي تسجيل الدخول أو انتهت مهلته أو فشل، أو لم يتطابق الاستعلام. |
| **المحفظة فقط، بلا مستند** | المحفظة فقط (أو استعلام الهوية). يُوقف التقاط المستند للدولة، ويمكن إعادة المحاولة عند تسجيل دخول لم يكتمل: يبقى المستخدم في خطوة المحفظة مع الرسالة "حاول استخدام {wallet} مرة أخرى"، وتبقى الجلسة مفتوحة حتى يُنهيها أو تنتهي صلاحيتها. |
| **يختار المستخدم المحفظة أو المستند** | المحفظة أو الاستعلام إلى جانب التقاط المستند. |
| **المستند فقط** | التقاط المستند. لا تُعرض محفظة ولا استعلام. |

يكتب خيار **المحفظة أولاً** القيمة `document.fallback_only` ومفاتيح الاحتياط المطابقة (`wallet.on_failure`، ومفاتيح الاستعلام عندما يكون الاستعلام مفعّلاً) في خطوة واحدة. ويضبط خيار **المحفظة فقط** القيمة `document.enabled` على `false` والقيمة `wallet.on_failure` على `retry`: يمكن إعادة محاولة تسجيل دخول لم يكتمل، وتبقى الجلسة مفتوحة حتى ينهيها المستخدم أو تنتهي صلاحيتها.
يعمل ذلك بالطريقة نفسها مع أي محفظة في أي دولة.
الخياران غير متاحين حتى تختار محفظة نشطة (أو تفعّل استعلاماً).
لا يمكن للمحفظة التي تحمل علامة **قريباً** أن تكون الخيار الأول: طالما أن كل المحافظ في دولة ما تحمل علامة **قريبًا**، يبقى التقاط المستند أولاً.
تعرض قائمة الدول الخيار **المحفظة ثم المستند** تحت كل دولة تستخدمه، بينما تعرض المعاينة المحفظة وحدها.

الإعداد نفسه موجود ضمن **إعدادات إضافية** في شاشتي المحافظ والاستعلام بدون مستند، كمفتاح بعنوان **عرض التقاط المستند كبديل احتياطي فقط**.
كلا عنصري التحكم يعدّلان الإعداد نفسه.

### التوفر يحدده الخادم

يقرأ التبويب كتالوج القدرات نفسه الذي تتحقق منه الواجهة البرمجية، لذا لا يعرض عليك إلا ما تدعمه المنصة فعلاً:

* الطريقة التي لا يعرضها الكتالوج في تلك الدولة لا تظهر كخيار.
* المصدر أو المحفظة التي يحمل الكتالوج علامة **قريباً** تُدرج حتى تطّلع على خارطة الطريق، لكن لا يمكن تفعيلها.
* يُفعَّل تسجيل الدخول عبر المحافظ لكل بيئة على حدة. وطالما هو موقوف، تعرض كل محفظة علامة **قريباً** بغض النظر عما يقوله الكتالوج.

### تفعيل Smart-ID أو Mobile-ID

تتوفر Smart-ID وMobile-ID في الدول المدعومة لكل منهما.
راجع [كتالوج المحافظ](https://docs.didit.me/ar/core-technology/id-verification/digital-id-wallets.md) لمعرفة تغطية الدول.
تحقق من التوفر الظاهر في بيئتك الحالية قبل تعديل سير العمل.

1. افتح **سير العمل**، واختر سير العمل وعقدة **التحقق من الهوية** الخاصة به، ثم افتح **الدول**.
2. افتح محرر الدولة وابحث عن **المحافظ المقبولة**.
3. اختر **Smart-ID** أو **Mobile-ID** فقط إذا كانت متاحة، واترك التقاط المستند مفعّلاً إذا أردت بديلاً احتياطياً.
4. اختر ما ينبغي أن يحدث عند فشل تسجيل الدخول عبر المحفظة، ثم احفظ سير العمل وانشره.
5. ابدأ جلسة تحقق جديدة باستخدام سير العمل هذا، وافحص بطاقة **بيانات الاعتماد** في الجلسة المكتملة.

يسرد [دليل تكامل Smart-ID وMobile-ID](https://docs.didit.me/ar/core-technology/id-verification/smart-id-mobile-id.md) رموز الدول المدعومة وتدفق رمز المقارنة الذي يراه المستخدم.
لا يؤدي نجاح اختبار في بيئة التجهيز أو البيئة التجريبية إلى تفعيل المحفظة في بيئة الإنتاج.

### الطلب والاستجابة المتوقعان

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

### مفاتيح التبديل الجماعية

تفعّل **الإعدادات العامة** طريقة ما في كل دولة تدعمها، فلا تحتاج إلى المرور على الـ 36 دولة يدوياً. تظل إعدادات محرر الدولة هي الغالبة، أي لها الأولوية: فعّل الطريقة عالمياً، ثم أوقفها للدولة التي لا تريدها فيها.

## الأسعار في علامة التبويب

يعرض التقاط المستند سعره: \$0.15 لكل فحص. يعرض الاستعلام بدون مستند سعره لكل دولة، وأي سعر لم يُنشر بعد في كتالوج الأسعار يُوسم في علامة التبويب بأنه عنصر نائب ولا يُقدَّم كعرض سعر. يعرض صف المحفظة المحفظةَ وتغطيتها وتوفرها.

تشرح علامة التبويب أيضاً الأثر المالي لكل مفتاح تبديل للبديل الاحتياطي في الاستعلام، حتى تظهر تكلفة الإعداد قبل حفظه:

* السجل الذي أجاب يُحتسب على الاستعلام، وتُحتسب المطابقة وعدم المطابقة معاً، ثم يُحتسب التقاط المستند فوق ذلك عندما يرجع المستخدم إلى البديل.
* الاستعلام الذي لم يُرجع أي استجابة لا يُحتسب، لذا لا يكلفك الانقطاع إلا سعر المستند.
* عند إيقاف البديل الاحتياطي يُرفض أولئك المستخدمون، ولا يُحتسب أي مبلغ إضافي.

## قراءة الجلسة

تتضمن كتلة **التحقق من الهوية** في تفاصيل الجلسة شريحة للطريقة التي أنتجت نتيجة التحقق منها، وشريحة ثانية لـ[مستوى الضمان](https://docs.didit.me/ar/core-technology/id-verification/verification-methods.md#مستويات-الضمان) الخاص بها: **المستند / مستندي** أو **استعلام بدون مستند / مطابقة البيانات** أو اسم المحفظة مع **تشفيري**.

> [!NOTE]
>
> تُقرأ الجلسة التي انتقلت بشكل احتياطي من طريقة بدون مستند إلى التقاط المستند بوصفها جلسة **المستند / مستندي**. يسمّي [`fallback_from`](https://docs.didit.me/ar/reference/data-models#التحقق-من-الهوية) في التحقق من الهوية تلك الطريقة التي جُرّبت أولاً وسبب انتهائها (مثل `wallet` و`cancelled`)، مع `action: "fallback_to_document"`.

أسفل الشرائح، تعرض كل طريقة أدلتها الخاصة:

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

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

## ذات صلة

* [طرق التحقق من الهوية](https://docs.didit.me/ar/core-technology/id-verification/verification-methods.md): الطرق الثلاث والبديل الاحتياطي والفوترة
* [الاستعلام بدون مستند](https://docs.didit.me/ar/core-technology/id-verification/non-doc-lookup.md): الحقول حسب الدولة والموافقة
* [محافظ الهوية الرقمية](https://docs.didit.me/ar/core-technology/id-verification/digital-id-wallets.md): السمات ومستوى الضمان لكل محفظة
* [سير العمل](https://docs.didit.me/ar/console/workflows.md): بناء سير العمل ونشره
* [إعدادات ميزات سير العمل](https://docs.didit.me/ar/management-api/workflows/feature-configs.md#ocr-/-التحقق-من-الهوية): الإعدادات نفسها عبر API


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.