> ## 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.

# Smart-ID وMobile-ID: دليل التكامل

> اضبط التحقق من الهوية عبر Smart-ID وMobile-ID مع Didit، بما يشمل تغطية الدول والمصادقة والسمات المعتمدة وخيارات الاحتياط.

يتيح Smart-ID وMobile-ID للمستخدمين التحقق من هويتهم من خلال الموافقة على طلب عبر هواتفهم.
استخدم [Smart-ID API](https://docs.didit.me/ar/api-reference/digital-id-wallets/smart-id.md) أو [Mobile-ID API](https://docs.didit.me/ar/api-reference/digital-id-wallets/mobile-id.md) لبدء التحقق من تطبيقك الخاص دون استخدام سير عمل.
تعمل كلتا الطريقتين أيضاً داخل خطوة سير عمل **التحقق من الهوية** في Didit، مما يعيد نتيجة تحقق من المحفظة مع مستوى ضمان `cryptographic`.
بالنسبة لتكامل سير العمل المستضاف الموضح أدناه، استخدم آلية إنشاء الجلسة نفسها وتكامل webhook نفسه المستخدَمَين في سير عمل Didit الأخرى لديك.

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

## الدول والمتطلبات الأساسية

يغطي هذا التكامل Smart-ID في إستونيا (`EST`) ولاتفيا (`LVA`) وليتوانيا (`LTU`) وبلجيكا (`BEL`).
يغطي Mobile-ID إستونيا (`EST`) وليتوانيا (`LTU`)؛ ولا يتوفر Mobile-ID في لاتفيا.
تصف رموز الدول هذه المسارات المتكاملة، وليست تعهداً بتفعيل كل مسار في بيئتك.

بالنسبة لـ Smart-ID، يحتاج المستخدم إلى هوية Smart-ID نشطة ومؤهلة، ورمز التعريف الشخصي الخاص بها، والوصول إلى التطبيق.
بالنسبة لـ Mobile-ID، يحتاج المستخدم إلى هوية Mobile-ID نشطة، ورمز التعريف الشخصي الخاص بها، ورقم الهاتف المرتبط بها.
أدخل رقم هاتف Mobile-ID بالتنسيق الدولي: `+372` لإستونيا أو `+370` لليتوانيا.
يجب أن تتطابق الدولة المحددة مع الهوية المستخدمة.

لا تُعيد أي من الطريقتين صورة شخصية.
إذا كان سير العمل لديك يتطلب صورة سيلفي، فاحتفظ بخطوتي [كشف الحيوية](https://docs.didit.me/ar/core-technology/liveness/overview.md) و[مطابقة الوجه](https://docs.didit.me/ar/core-technology/face-match/overview.md) المناسبتين مُعدتين بشكل منفصل.

## ما يراه المستخدم

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

يستخدم نموذج الهوية وشاشة رمز المقارنة نفس التصميم المستخدم في طرق التحقق الأخرى.
عند تفعيل تخصيص العلامة البيضاء، فإنهما يرثان ألوان الجلسة والخطوط وتنسيق الأزرار وشعار العميل، ويظلان على نطاق الجلسة.
يؤدي تحديث الصفحة إلى استعادة رمز المقارنة النشط دون بدء طلب موافقة آخر.

لا يُدخل المستخدم أبداً رمز PIN الخاص بمحفظته على صفحة التحقق.
إذا كانت الرموز مختلفة أو لم يبدأ المستخدم الطلب، فعليه إلغاؤه.
يعمل تدفق رمز المقارنة مع متصفح سطح المكتب أو الهاتف ولا يتطلب رمز QR.
تنتظر الصفحة النتيجة تلقائياً وتوفر خياراً للإلغاء.
يجب أن تجتاز الموافقة على الهاتف عمليات التحقق من الهوية والتوقيع قبل أن تعتبر Didit التحقق من المحفظة ناجحاً.

## إعداد سير العمل

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

> [!WARNING]
>
> ما يلي هو جزء من إعداد `methods`، وليس طلباً كاملاً لسير العمل.
> استخدمه فقط عندما يكون **كلا** `smart_id` و`mobile_id` مُعيَّنين على `available` لإستونيا في بيئتك.
> تؤدي المحفظة غير المتاحة إلى رفض حفظ سير العمل بأكمله.

```json theme={null}
{
  "EST": {
    "document": { "enabled": true },
    "wallet": {
      "enabled": true,
      "providers": ["smart_id", "mobile_id"],
      "on_failure": "fallback_to_document"
    }
  }
}
```

مصفوفة `providers` هي قائمة قبول: يختار المستخدمون بين محافظها، ولا يحدد ترتيب المصفوفة محفظة مفضلة.
بالنسبة لليتوانيا، استخدم `LTU` مع نفس معرّفات المحافظ عندما يكون كلاهما متاحاً.
بالنسبة للاتفيا أو بلجيكا، استخدم `LVA` أو `BEL` مع `smart_id` فقط، مع مراعاة فحص التوفر نفسه.
تحتفظ الدول غير المدرجة بسلوك التقاط المستندات الافتراضي الحالي.
يتوفر عقد الإعداد الكامل في [إعدادات ميزات سير العمل](https://docs.didit.me/ar/management-api/workflows/feature-configs.md#ocr-/-التحقق-من-الهوية).

## قراءة النتيجة التي تم التحقق منها

اقرأ بيانات الجلسة المكتملة من خلال [API قرار الجلسة](https://docs.didit.me/ar/sessions-api/retrieve-session.md) أو [تكامل webhook](https://docs.didit.me/ar/integration/webhooks.md) لديك.
يسجل فحص المحفظة الناجح `verification_method: "wallet"` و`assurance: "cryptographic"` و`wallet_provider: "smart_id"` أو `"mobile_id"`.
يحدد كائن `wallet_verification` المحفظة، ودولة الإصدار، ووقت التحقق، ومستوى الضمان، وحكم التوقيع.
تكشف نتيجة التحقق من الهوية عن حقلي `full_name` و`date_of_birth` المعياريين.
بالنسبة لهاتين المحفظتين، يحمل `wallet_verification.attributes` كلاً من `given_name` و`family_name` و`birthdate` و`personal_code` من الهوية التي تم التحقق من صحتها.
تحدد دولة الإصدار مسار الهوية؛ ولا تُثبت جنسية الشخص.
تُعيد Didit حكم التوقيع، وليس الإقرار الموقع الأساسي.
لا يتم إرجاع أي صورة شخصية أو رمز PIN للمحفظة.

في لوحة التحكم، تعرض بطاقة **بيانات الاعتماد** الخاصة بالجلسة المحفظة والأدلة التي تم التحقق منها.
يُكمل فحص المحفظة الناجح خطوة التحقق من الهوية؛ ومع ذلك تظل الفحوصات اللاحقة في سير العمل تحدد القرار النهائي للجلسة.
راجع [نموذج بيانات التحقق من الهوية](https://docs.didit.me/ar/reference/data-models.md#التحقق-من-الهوية) لمعرفة أنواع الحقول والتمييز بين نتيجة الفحص وقرار الجلسة الإجمالي.

## التعامل مع الإلغاء والفشل

إذا ألغى المستخدم أو انتهت مهلة الجلسة أو تعذر عليه إكمال المصادقة، تطبق Didit إعداد `wallet.on_failure` الخاص بتلك الدولة.
يبدأ `fallback_to_document` التقاط المستند عندما يكون مفعلاً لتلك الدولة.
يرفض خيار `decline` خطوة التحقق من الهوية.
إذا كان التقاط المستندات معطلاً، فلن يتوفر أي بديل احتياطي للمستندات.

فقط فحص المحفظة المكتمل والمتحقق منه يترتب عليه رسوم التحقق من المحفظة.
أما محاولات المحفظة الملغاة والمنتهية الصلاحية والفاشلة فلا يترتب عليها ذلك.
البديل الاحتياطي المكتمل للمستند فحصٌ منفصل بموجب [أسعار التحقق من المستندات](https://docs.didit.me/ar/getting-started/pricing.md).
راجع [جدول أسعار المحافظ](https://docs.didit.me/ar/core-technology/id-verification/digital-id-wallets.md#الأسعار) لمعرفة الأسعار المنشورة؛ ويجب عدم التعامل مع أي طريقة لا يتوفر لها سعر منشور على أنها مجانية.

## الاختبار قبل الإنتاج

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

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

## محافظ الهوية الرقمية الأخرى

يتضمن [دليل محافظ الهوية الرقمية](https://docs.didit.me/ar/core-technology/id-verification/digital-id-wallets.md) من Didit مدى التوفر في بيئة الإنتاج والمحافظ القادمة، بما في ذلك Finnish Trust Network المتاحة وتكاملات BankID و EUDI Wallet القادمة.
إن إدراج المحفظة أو السعر المنشور أو نموذج التسجيل المكتمل لا يعني بحد ذاته تفعيل المصادقة في بيئة الإنتاج.
استخدم الدليل ولوحة تحكم بيئتك لتحديد ما يمكنك تفعيله اليوم.

راجع أيضاً [Finnish Trust Network لفنلندا](https://docs.didit.me/ar/core-technology/id-verification/finnish-trust-network.md).


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