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

# شبكة الثقة الفنلندية (FTN): دليل التكامل

> اضبط التحقق من الهوية في فنلندا عبر شبكة الثقة الفنلندية مع Didit: تسجيل الدخول المصرفي، إعداد سير العمل، والنتائج المؤكدة.

تتيح شبكة Finnish Trust Network (FTN) للمستخدمين المؤهلين التحقق من هويتهم باستخدام هوية بنكية فنلندية أو شهادة هاتف محمول مدعومة.
استخدم [Finnish Trust Network API](https://docs.didit.me/ar/api-reference/digital-id-wallets/ftn.md) لبدء المصادقة البنكية من تطبيقك الخاص دون الحاجة إلى سير عمل.
يعمل FTN أيضًا داخل خطوة **التحقق من الهوية** في سير عمل Didit، باستخدام معرّف المحفظة `ftn` ورمز الدولة `FIN`.
بالنسبة للتكامل المستضاف الموضح أدناه، استخدم نفس خطوات إنشاء الجلسة ونتائج الجلسة وwebhook المستخدمة في عمليات سير العمل الأخرى في Didit.

> [!NOTE]
>
> **شبكة Finnish Trust Network متاحة في فنلندا.**
> فعّل `ftn` ضمن المحافظ المقبولة في سير العمل الخاص بك لرمز `FIN`.
> السعر المعلن هو **\$0.25 لكل عملية تحقق مكتملة**.
> راجع [تغطية المحافظ والأسعار](https://docs.didit.me/ar/core-technology/id-verification/digital-id-wallets.md#الأسعار) للاطلاع على جميع المحافظ المدعومة.

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

1. يختار المستخدم فنلندا وFinnish Trust Network من بين طرق التحقق من الهوية التي يقبلها سير العمل لديك.
2. يحدد بنكًا مشاركًا أو شهادة هاتف محمول مدعومة.
3. يُجري المصادقة لدى تلك الخدمة ويمنح الإذن للتحقق من الهوية.
4. يعود إلى جلسة Didit، والتي تتحقق من صحة نتيجة الهوية وتتابع سير العمل.

يحتاج الشخص إلى هوية نشطة لدى الخدمة التي يختارها وإمكانية الوصول إلى طريقة المصادقة الخاصة بها.
يُدخل المستخدم بيانات الاعتماد البنكية ورموز الموافقة داخل تجربة المصادقة الخاصة بتلك الخدمة فقط.
لا تطلب Didit كلمة مرور الحساب البنكي في نموذج التحقق الخاص بها.

تستخدم شاشات اختيار الطريقة وشاشات العودة في Didit إعدادات العلامة التجارية والنطاق المخصص الخاصة بالجلسة.
يتحكم البنك أو خدمة الهوية المحددة في شاشات المصادقة الخاصة بها.

## تكوين سير العمل

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

فيما يلي جزء من تكوين `methods`، وليس طلب سير عمل كاملاً:

```json theme={null}
{
  "FIN": {
    "document": { "enabled": true },
    "wallet": {
      "enabled": true,
      "providers": ["ftn"],
      "on_failure": "fallback_to_document"
    }
  }
}
```

ترفض المنصة حفظ سير العمل في حال كانت المحفظة غير متاحة.
راجع [تكوينات ميزات سير العمل](https://docs.didit.me/ar/management-api/workflows/feature-configs.md#ocr-/-التحقق-من-الهوية) لمعرفة عقد API الكامل و[تكوين لوحة التحكم](https://docs.didit.me/ar/console/id-verification-methods.md) للإعداد المرئي.

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

يعيد فحص FTN المكتمل نتيجة تحقق من المحفظة بمستوى ضمان `cryptographic`.
تتضمن الهوية التي تم التحقق منها اسم المستخدم، وتاريخ الميلاد، والمعرّف الشخصي عندما تعيدها طريقة الهوية المحددة.
لا يعيد FTN صورة شخصية.
تحقق من النتيجة الفعلية بدلاً من افتراض وجود كل حقل اختياري من حقول الهوية.

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

## الإلغاء والبديل الاحتياطي بالمستندات

إذا ألغى المستخدم العملية، أو انتهت صلاحية الطلب، أو فشل التحقق، فإن Didit تطبق إعداد `wallet.on_failure` الخاص بالدولة.
يبدأ خيار `fallback_to_document` التقاط المستند عند تفعيل التحقق من المستندات لفنلندا.
يرفض خيار `decline` خطوة التحقق من الهوية.
لا يمكن لطريقة المستندات المعطلة أن تعمل كبديل احتياطي.
لتوجيه المستخدمين إلى Finnish Trust Network أولاً وإظهار التقاط المستندات فقط بعد الفشل، اضبط `document.fallback_only` على `true`.
راجع [إتاحة التقاط المستندات كبديل احتياطي فقط](https://docs.didit.me/ar/core-technology/id-verification/verification-methods.md#إتاحة-التقاط-المستندات-كإجراء-بديل-فقط).

إعادة التوجيه أو ظهور شاشة اختيار البنك لا يعني نجاح التحقق من الهوية.
انتظر نتيجة الجلسة التي تم التحقق منها أو webhook قبل منح حق الوصول.
تعامل مع تسليم webhook المكرر باستخدام المعالجة التي تدعم idempotency بالطريقة نفسها المتبعة في بقية التكامل لديك.

## الاختبار والإطلاق

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

تبلغ تكلفة FTN **\$0.25 لكل عملية تحقق مكتملة** وفقًا للسعر الأساسي المعلن.
لا تترتب على محاولات المحفظة الملغاة أو المنتهية الصلاحية أو الفاشلة أي رسوم على عملية تحقق مكتملة من المحفظة.
تُحتسب رسوم البديل المكتمل بالمستندات بشكل منفصل بموجب أسعار التحقق من المستندات.
راجع [أسعار المحافظ](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)
* [تكامل Smart-ID وMobile-ID](https://docs.didit.me/ar/core-technology/id-verification/smart-id-mobile-id.md)
* [طرق التحقق من الهوية](https://docs.didit.me/ar/core-technology/id-verification/verification-methods.md)
* [تكامل webhook](https://docs.didit.me/ar/integration/webhooks.md)


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