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

# KYC القابل لإعادة الاستخدام عبر Share Session API

> KYC وKYB القابلان لإعادة الاستخدام: شارك الجلسات الموثقة مع الشركاء الموثوقين عبر رموز محددة المدة في Didit. تجنّب إعادة التحقق وقلّل التكاليف.

تتيح واجهة Share Session API مشاركة **KYC وKYB القابلين لإعادة الاستخدام** بأمان، أي مشاركة بيانات الجلسة المُتحقَّق منها بين مؤسسات شريكة موثوقة. تعمل مع جلسات التحقق من المستخدمين (KYC) وجلسات التحقق من الشركات (KYB). يُرمّز رمز المشاركة القيمة `session_kind`، فيُعيد التطبيق المستقبِل إنشاء النوع نفسه عند الاستيراد.

## نقاط النهاية

> [card] [مشاركة الجلسة](https://docs.didit.me/ar/sessions-api/share-session/share.md)
>
> `POST /v3/session/{sessionId}/share/` — إنشاء رمز مشاركة محدود المدة لجلسة مُتحقَّق منها.

> [card] [استيراد الجلسة المشتركة](https://docs.didit.me/ar/sessions-api/share-session/import.md)
>
> `POST /v3/session/import-shared/` — استيراد جلسة شاركها شريك باستخدام رمز مشاركة.

## آلية العمل

**1. الشريك A يشارك جلسة**

بعد أن يُكمل المستخدم التحقق على منصة الشريك A، يستدعي الشريك A واجهة **Share Session** مع معرّف الجلسة ومعرّف تطبيق الشريك المستهدف. تُعيد Didit رمز `share_token` محدود المدة.

**2. يُرسَل رمز المشاركة إلى الشريك B**

يرسل الشريك A الرمز `share_token` إلى الشريك B عبر قناته الآمنة الخاصة (استدعاء API أو webhook أو غيرهما).

**3. الشريك B يستورد الجلسة**

يستدعي الشريك B واجهة **Import Shared Session** باستخدام الرمز `share_token`. تُنشئ Didit نسخة من الجلسة المُتحقَّق منها في حساب الشريك B مع بيانات التحقق كاملة.

## المتطلبات

| المتطلب | التفاصيل |
| - | - |
| **حالة الجلسة** | لا يمكن مشاركة إلا الجلسات المنتهية (`"Approved"` و`"Declined"` و`"In Review"`) |
| **معرّف تطبيق الشريك** | معرّف تطبيق الشريك المستهدف (يُوجد في إعدادات Business Console) |
| **مدة صلاحية الرمز** | قابلة للضبط من 60 ثانية إلى 86,400 ثانية (24 ساعة). القيمة الافتراضية: 3,600 ثانية (ساعة واحدة) |
| **المصادقة** | يجب أن يُصادق كل شريك باستخدام مفاتيح API الخاصة به |

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

* **البنوك → التكنولوجيا المالية**: يمكن للمستخدم الذي تحقّق منه بنك ما الوصول إلى شريك من شركات التكنولوجيا المالية دون إعادة التحقق
* **السوق الإلكتروني → مزوّد الدفع**: يمكن للبائعين الذين تحقّق منهم سوق إلكتروني التسجيل لدى مزوّد الدفع فورًا
* **التأمين → الرعاية الصحية**: مشاركة التحقق بين شركاء موثوقين من قطاعات مختلفة
* **شركات المجموعة**: مشاركة بيانات التحقق بين عدة تطبيقات داخل المؤسسة نفسها

> [!NOTE]
>
> اطّلع على مزيد من المعلومات حول ميزة KYC القابل لإعادة الاستخدام في [دليل مشاركة KYC عبر API](https://docs.didit.me/ar/core-technology/reusable-kyc/share-kyc-via-api.md).


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