> ## 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 عبر API: التحقق القابل لإعادة الاستخدام

> تتيح Didit مشاركة بيانات التحقق بأمان بين الشركاء عبر API، متفادية تكرار KYC عبر الخدمات المتكاملة باستخدام tokens مشاركة قصيرة الأجل.

## كيفية العمل

لنفترض أن مستخدماً `A` قد اجتاز التحقق من المستخدمين في `Service X` ويسجل الآن لدى الشريك `Service Y`. إذا وافقت `Service X` على مشاركة المعلومات الخاصة بـ `A` مع `Service Y`، فيمكن إجراء ذلك على النحو التالي:

1. **إنشاء token للمشاركة (`Service X`)**: تُجري `Service X` استدعاء API لإنشاء `share_token` آمن وقصير الأجل لجلسة تحقق خاصة بمستخدم معين. هذا الـ token مخصص للاستخدام بواسطة `Service Y` فقط. راجع مرجع API: [Share Session API](https://docs.didit.me/ar/sessions-api/share-session/share.md).

2. **تمرير الـ Token إلى الشريك (`Service X` -> `Service Y`)**: تنقل `Service X` الـ `share_token` المُنشأ بأمان إلى `Service Y` عبر قناة خلفية مُعدّة مسبقاً.

3. **استيراد الجلسة (`Service Y`)**: تستخدم `Service Y` الـ `share_token` المستلَم لإجراء استدعاء API لاستيراد بيانات المستخدم. يؤدي هذا إلى إنشاء نسخة كاملة من جلسة التحقق، بما في ذلك جميع المستندات والفحوصات، داخل بيئة `Service Y` الخاصة. راجع مرجع API: [Import Shared Session API](https://docs.didit.me/ar/sessions-api/share-session/import.md).

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

عند استيراد جلسة، تمتلك `Service Y` التحكم في كيفية معالجة النتائج:

* **`trust_review`**: يحدد هذا المعامل المنطقي ما إذا كانت `Service Y` تثق في المراجعة والحالة النهائية (`Approved`/`Declined`) الصادرة من `Service X`.
  * `true`: يتم نسخ الجلسة بالحالة الأصلية. ويتم تسجيل المستخدم (أو رفضه) على الفور في `Service Y`.
  * `false`: يتم نسخ بيانات الجلسة، ولكن يتم تعيين الحالة تلقائياً إلى `In Review`. يتيح ذلك لـ `Service Y` استخدام المستندات والبيانات المجمعة مع إجراء عملية المراجعة الداخلية الخاصة بها لاتخاذ القرار النهائي.
* **`workflow_id`**: يجب على `Service Y` تحديد أي من مسارات سير العمل الخاصة بالتحقق لديها سيتم ربطه بالجلسة المستوردة.
* **`vendor_data`**: يمكن لـ `Service Y` تعيين معرّف المستخدم الداخلي الخاص بها للجلسة المستوردة.

### اعتبارات مهمة

* **الجلسات المكتملة فقط**: لا يمكن إنشاء token للمشاركة إلا للجلسات التي لها حالة منتهية (`Approved`، `Declined`، `In Review`).
* **عدم التكرار**: لا يمكن استيراد جلسة معينة إلا مرة واحدة في تطبيق شريك محدد. سيتم رفض المحاولات اللاحقة.

***

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

على الرغم من أن كلتا الميزتين تُيسّران إعادة استخدام الهوية، إلا أنهما تخدمان أغراضاً مختلفة:

| الميزة | KYC القابل لإعادة الاستخدام الذي يتحكم فيه المستخدم | مشاركة KYC عبر API (مشاركة B2B) |
| - | - | - |
| **من يبدأ الإجراء؟** | المستخدم النهائي، أثناء التسجيل. | الشركة، عبر استدعاء API من خادم إلى خادم. |
| **الموافقة** | يوافق المستخدم صراحة على مشاركة بياناته لكل عملية إعادة استخدام. | تتم معالجة الموافقة عادةً في شروط الخدمة الخاصة بالمستخدم مع الشركة الأولى. يُشترط وجود اتفاقية واضحة لمشاركة البيانات بين الشركات الشريكة. |
| **تدفق البيانات** | يُيسّر Didit ID الخاص بالمستخدم مشاركة البيانات مباشرة مع التطبيق الجديد. | تشارك `Service X` البيانات مع `Service Y` عبر token آمن. |
| **حالة الاستخدام** | مستخدم يرغب في التسجيل السريع في خدمات متعددة وغير مرتبطة ببعضها. | منظومات الشركاء، أو مجموعات الخدمات المالية، أو التكتلات التجارية حيث يلزم أن تكون هوية المستخدم قابلة للنقل عبر منصات مترابطة. |

***

> ## ❗️ هام: قيود مشاركة البيانات
>
> تخضع مشاركة البيانات الشخصية للمستخدم بين مؤسسات مختلفة لمتطلبات قانونية وتنظيمية صارمة. قبل استخدام هذه الميزة، تتحمل مؤسستك مسؤولية التأكد من امتثالك الكامل لجميع قوانين حماية البيانات المعمول بها، مثل GDPR في الاتحاد الأوروبي وUK GDPR في المملكة المتحدة.
>
> يجب عليك:
>
> 1. **تحديد أساس قانوني**: تأكد من أن لديك أساساً قانونياً مشروعاً لمشاركة البيانات. يتطلب هذا غالباً اتفاقية واضحة لمشاركة البيانات بينك وبين المؤسسة الشريكة لك.
> 2. **ضمان موافقة المستخدم**: تحقق من إبلاغ المستخدمين بشكل صحيح وموافقتهم على مشاركة بياناتهم مع شركائك، كما هو موضح في شروط الخدمة وسياسة الخصوصية الخاصة بك.
> 3. **التعامل مع عمليات النقل الدولي بشكل ملائم**: إذا كانت البيانات تُنقل عبر الحدود (على سبيل المثال، من الاتحاد الأوروبي إلى دولة خارج الاتحاد الأوروبي)، فيجب عليك التأكد من تطبيق الضمانات المناسبة وفقاً لما يقتضيه القانون.
>
> توفر Didit الإمكانية التقنية لمشاركة البيانات، ولكن تتحمل مؤسستك وشركاؤك وحدهم المسؤولية عن جميع الالتزامات القانونية والتزامات الامتثال المتعلقة بالبيانات التي تشاركها. نوصي بشدة باستشارة مستشارك القانوني قبل تنفيذ هذه الميزة.


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