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

> يتيح Didit للمستخدمين التحقق من هويتهم مرة واحدة وإعادة استخدامها بأمان عبر عدة تطبيقات، ما يقلل احتكاك التسجيل ويلغي تكرار KYC. مجاناً مع Didit.

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

تعليمات تكامل KYC القابل لإعادة الاستخدام
        نسخ الموجّه إلى الحافظة



      
      

\<pre>

\````# Goal
Integrate Didit Reusable KYC — hand off a finished verification session from one Didit application to another without re-running the verification. Two endpoints: **share** on the source application, **import-shared** on the receiving application.

\# Delivery mode
Cross-application share flow. Both calls authenticate with each side's own application API key (`x-api-key`). Source session must already be in a finished status (Approved / Declined / In Review).

\# Step 1 — Mint a share token (source application)
POST https://verification.didit.me/v3/session/{sessionId}/share/
x-api-key: YOUR_API_KEY
Content-Type: application/json

\```bash
curl -X POST 'https://verification.didit.me/v3/session/11111111-2222-3333-4444-555555555555/share/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"for_application_id": "a5f3bca2-46e2-411e-90ef-a580900a57ee",
"ttl_in_seconds": 7200
}'
\```
Response: { share_token, for_application_id, session_kind: "user" | "business" }.

\`ttl_in_seconds` — min 60, max 86400 (24h), default 3600 (1h).

\# JWT payload (token contents)
The HS256-signed JWT carries:
\- `session_id` — UUID of the source session being shared.
\- `session_kind` — "user" (KYC) or "business" (KYB) — drives which related rows are cloned.
\- `from_application_id` — calling application UUID.
\- `for_application_id` — receiving application UUID — only this app can redeem.
\- `iat` / `exp` — issued-at and expiry epoch seconds.

The token is not idempotent (each call mints a fresh JWT) and cannot be revoked — it simply expires.

\# Step 2 — Redeem the token (receiving application)
POST https://verification.didit.me/v3/session/import-shared/

\```bash
curl -X POST 'https://verification.didit.me/v3/session/import-shared/' \
-H 'x-api-key: RECEIVING_APP_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"share_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"trust_review": false,
"workflow_id": "9f9b1234-aaaa-bbbb-cccc-1234567890ab",
"vendor_data": "user-1"
}'
\```
Required: share_token, trust_review, workflow_id (must exist on the receiving app). Optional: vendor_data (defaults to source).

\`trust_review`:
\- `true` — cloned session keeps the source status (Approved stays Approved).
\- `false` — cloned session is forced to "In Review" so your reviewers re-decide.

Response (201): the V3 decision payload for both kinds — KYC for user sessions, KYB for business sessions — the same shape as GET /v3/session/{sessionId}/decision/, discriminated by `session_kind`. The cloned session has a fresh session_id and `shared_from_session` pointing at the source for audit.

\# Failure modes to handle
\- 400 "Invalid share token." — malformed JWT / wrong signature.
\- 400 "Share token has expired." — past exp.
\- 400 "This token is not valid for this application." — JWT `for_application_id` doesn't match the receiving app.
\- 400 "Original session does not exist." — source session deleted between mint and redeem.
\- 403 "This session has already been shared with your application." — same token can only be redeemed once per receiving app. Mint a new token.
\- 404 "Workflow does not exist for this application." — `workflow_id` is from a different application.
\- Source status not finished — 400 "Only finished sessions (Approved, Declined, In Review) can be shared."

\# What gets cloned
\- session_kind="user": KYC, Face, Liveness, FaceMatch, AML, POA, Phone, Location, DatabaseValidation rows + activity log.
\- session_kind="business": KYBCompany, KYBKeyPeopleCheck, KYBDocument + shared feature rows (AML, Phone, Email, Location, QuestionnaireResponse) + activity log.

\# See also
\- Mint share token: /sessions-api/share-session
\- Redeem share token: /sessions-api/import-shared-session
\- Canonical decision schema: /reference/data-models#overview
\- Full integration playbook: /integration/integration-prompt````

\</pre>



      
      

الصق في

يبدأ هذا الفصل من درس KYB في Didit Academy عند التحقق من الأطراف وإعادة استخدام جلسات KYC.في درس KYB Academy، يوضح الفصل 7:04 التحقق من الأطراف من خلال إعادة استخدام جلسة KYC الحالية بدلاً من إلزام UBO بالتحقق مرتين.[التحقق من الأطراف وإعادة استخدام جلسات KYC — Didit Academy](https://www.youtube.com/embed/JEnW_sEe35Y?start=424\&rel=0\&playsinline=1)## كيف يعمل**1. التحقق الأولي**يُكمل المستخدم عملية KYC قياسية (التحقق من الهوية + التعرف على الوجه). تُشفر بيانات التحقق وتُخزن في Didit ID الخاص بالمستخدم، بما يتوافق مع eIDAS2.**2. إعادة الاستخدام في تطبيق جديد**عندما يستخدم المستخدم تطبيقاً آخر متكاملاً مع Didit، يختار خيار إعادة استخدام KYC الحالي الخاص به. يؤكد فحص سريع للتعرف على الوجه هويته، ويمنح موافقته على مشاركة بيانات محددة.**3. تسجيل فوري**يتلقى التطبيق الجديد معلومات KYC التي تم التحقق منها على الفور — دون الحاجة لإعادة رفع المستندات، ودون انتظار.## المزايا الرئيسية| للمستخدمين | للشركات | للامتثال |
| - | - | - |
| التحقق مرة واحدة، والاستخدام في أي مكان | تسجيل أسرع للمستخدمين | الحفاظ على المعايير التنظيمية |
| التحكم في مشاركة البيانات | تقليل معدلات التسرّب | سجل تدقيق كامل |
| ثوانٍ بدلاً من دقائق | معدلات تحويل أعلى | دعم عبر الاختصاصات القضائية |## الأمان والامتثال| المجال | التفاصيل |
| - | - |
| **التشفير** | تشفير طرف إلى طرف لجميع البيانات المخزنة والمنقولة |
| **إعادة المصادقة البيومترية** | التعرف على الوجه مطلوب لكل عملية إعادة استخدام |
| **التنظيم** | متوافق مع eIDAS2، ويدعم متطلبات AML/KYC |
| **عبر الحدود** | يعمل عبر الاختصاصات القضائية المختلفة |![مخطط سير عمل KYC القابل لإعادة الاستخدام من Didit يتيح للمستخدمين الذين تم التحقق منهم نقل هويتهم عبر الخدمات](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/reusable-kyc.png?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=12c89122aad772b3683a629343b6dabc)يتوفر KYC القابل لإعادة الاستخدام تلقائياً للمستخدمين الذين أكملوا عملية تحقق أولية. يمكن للمستخدمين اختيار إعادة استخدام KYC الخاص بهم أو إجراء فحص جديد في أي وقت.


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