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

# مستندات المستخدم: الهوية وإثبات العنوان والملفات الداعمة

> الهويات وإثباتات العنوان والملفات الداعمة في كيانات المستخدم في Didit: ما يُجمع، وكيفية استرجاعه، وكيفية رفعه من لوحة التحكم.



مستندات المستخدم
        نسخ الموجّه إلى الحافظة



      
      

\<pre>

\````# Goal — retrieve user documents and generate compliance PDFs

Documents (ID images, MRZ data, selfies, proof-of-address scans, NFC chip reads) are attached to the **session** that captured them, not directly to the User entity. There is no public "upload document to user" API — capture flows through sessions. You can however list sessions for the user, retrieve each session's decision, and pull signed URLs to the document images.

\## Pattern — list sessions for a user, then read each decision

\```bash
\# 1) List sessions tied to the User entity
curl -G https://verification.didit.me/v3/sessions/ \
-H "x-api-key: $DIDIT_API_KEY" \
\--data-urlencode "vendor_data=user-42" \
\--data-urlencode "page_size=50"

\# 2) For each session, retrieve the full decision (V3 plural arrays)
curl https://verification.didit.me/v3/session/$SESSION_ID/decision/ \
-H "x-api-key: $DIDIT_API_KEY"
\```

\## Where documents appear in the V3 decision

Inspect these plural arrays (every per-feature result is plural in V3):

\| Array | Contains |
\|---|---|
\| `id_verifications[]` | Government ID images, OCR fields, MRZ, expiry, issuing country |
\| `liveness_checks[]` | Selfie frames, passive liveness score |
\| `nfc_verifications[]` | NFC chip data, ICAO certificate chain |
\| `proof_of_address_checks[]` | POA document images, extracted address |

Image URLs are short-lived signed URLs — cache the bytes if you need them long-term, or re-fetch the decision when they expire.

\## Generate a PDF report

For a human-readable compliance export (used for SARs, audits, regulator requests):

\```bash
curl https://verification.didit.me/v3/session/$SESSION_ID/generate-pdf/ \
-H "x-api-key: $DIDIT_API_KEY" \
-o session-report.pdf
\```

The PDF includes session details, per-feature results, and embedded document images.

\## Re-verification / new document collection

To collect fresh documents (e.g. expired ID), create a new session for the same `vendor_data` — the new session attaches to the existing User entity:

\```bash
curl -X POST https://verification.didit.me/v3/session/ \
-H "x-api-key: $DIDIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"workflow_id": "$WORKFLOW_ID", "vendor_data": "user-42"}'
\```

\## Failure modes

\- `404` — wrong `session_id` or wrong `vendor_data` casing.
\- Expired signed image URL — re-fetch the decision to get fresh URLs.
\- `403` on PDF — your API key's role lacks PDF export permission.
\- Document monitoring is on by default and sends no warning before a document expires: when the ID's expiry date passes, the Approved session moves to "Kyc Expired" — see /core-technology/id-verification/document-monitoring-id-verification.

\## Response shape

See /reference/data-models for the full per-feature schema. Each plural-array item carries its own `status`, `document_images[]`, OCR extract, and decision metadata.

\## Sources of truth

\- /sessions-api/retrieve-session — decision schema
\- /reference/data-models — V3 plural-array contract
\- /core-technology/id-verification/overview — ID capture behaviour
\- /core-technology/proof-of-address/overview — POA capture
\- /integration/integration-prompt — canonical end-to-end prompt````

\</pre>



      
      

الصق في

كل مستند يرفعه المستخدم أثناء التحقق مرتبط بشكل دائم بكيان المستخدم (User). تشرح هذه الصفحة ما يتم جمعه، وكيفية استرجاعه، وكيفية رفع مستندات إضافية يدويًا.## ما الذي يجمعه Didit| نوع المستند | وقت الجمع | الحقول المستخرجة |
| - | - | - |
| **الهوية الحكومية** (جواز السفر، الهوية الوطنية، رخصة القيادة، تصريح الإقامة) | خطوة [التحقق من الهوية](https://docs.didit.me/ar/core-technology/id-verification/overview.md) | الاسم، تاريخ الميلاد، رقم المستند، دولة الإصدار، تاريخ الانتهاء، MRZ عند توفره |
| **صورة سيلفي / إطارات كشف الحيوية** | خطوة [كشف الحيوية](https://docs.didit.me/ar/core-technology/liveness/overview.md) | أكبر صورة مقتصّة للوجه، درجة الحيوية السلبية |
| **إثبات العنوان (POA)** | خطوة [POA](https://docs.didit.me/ar/core-technology/proof-of-address/overview.md) | الاسم، العنوان، الجهة المُصدِرة، تاريخ المستند |
| **قراءة شريحة NFC** | خطوة [التحقق عبر NFC](https://docs.didit.me/ar/core-technology/nfc-verification/overview.md) | بيانات الشريحة، سلسلة شهادات ICAO، المطابقة مع OCR |
| **مستندات إضافية** | طلب من المحلل أو خطوات سير عمل مخصصة | OCR عند الاقتضاء، وإلا فتُخزَّن كما هي |تغطي [أنواع المستندات المدعومة](https://docs.didit.me/ar/core-technology/id-verification/supported-documents-id-verification.md) المصفوفة الكاملة للدول × أنواع المستندات (14,000+ مستند عبر 220+ دولة).## استرجاع المستنداتترتبط المستندات بـ**الجلسة** التي جُمعت فيها، وليس بالمستخدم مباشرةً. لعرض جميع مستندات مستخدم معيّن:**1. اعرض جلسات المستخدم**```bash theme={null}
curl -G https://verification.didit.me/v3/sessions/ \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "vendor_data=user-42"
```**2. اجلب قرار كل جلسة**يتضمن قرار كل جلسة روابط للمستندات التي تم جمعها.```bash theme={null}
curl https://verification.didit.me/v3/session/{session_id}/decision/ \
  -H "x-api-key: YOUR_API_KEY"
```افحص الحقول `id_verification.document_images` و`proof_of_address.document_images` و`liveness.images` في الاستجابة.**3. استخدم الروابط الموقّعة**روابط الصور في الاستجابة روابط موقّعة قصيرة الأمد. خزّنها مؤقتًا على جهة العميل طوال مدة استخدامها، أو أعد جلب القرار عند انتهاء صلاحيتها.## إنشاء تقرير PDFللحصول على تصدير مقروء لكل ما تم جمعه لجلسة معيّنة، بما في ذلك جميع المستندات، استخدم:**`GET /v3/session/{session_id}/generate-pdf/`**يُرجع ملف PDF يتضمن تفاصيل الجلسة، ونتائج الميزات، وصور المستندات المضمّنة. ويفيد في عمليات التدقيق الامتثالي، ومرفقات تقارير الأنشطة المشبوهة (SAR)، والإيداعات التنظيمية.## رفع المستندات من الكونسوليمكن لمشغلي الامتثال رفع مستندات إضافية لمستخدم معيّن أو لجلسة نشطة:1. انتقل إلى *المستخدمون ← \[المستخدم] ← المستندات ← رفع مستند*.
2. اختر نوع المستند (الهوية، إثبات العنوان، مخصص).
3. ارفع الملف؛ يعمل OCR تلقائيًا للأنواع المدعومة.
4. يرتبط المستند بأحدث جلسة (أو يمكنك إنشاء جلسة معالجة).> [!NOTE]
>
> واجهة رفع المستندات متاحة في الكونسول فقط، ولا يوجد endpoint عام لربط المستندات بالمستخدم مباشرةً. استخدم الجلسات كنقطة دخول لجميع عمليات جمع المستندات.## الربط المتبادل بين المستنداتعندما تجمع الجلسة عدة أنواع من المستندات، يقوم Didit بالربط المتبادل بينها:- **الهوية ↔ كشف الحيوية**: الوجه في الهوية يطابق صورة السيلفي في كشف الحيوية.
- **الهوية ↔ POA**: الاسم في إثبات العنوان يطابق الاسم المستخرج من الهوية.
- **الهوية ↔ NFC**: بيانات MRZ أو البيانات المرئية تطابق بيانات شريحة NFC.تُعرض التناقضات كتحذيرات في قرار الجلسة، ويمكن ضبطها لتُشغّل مراجعة يدوية.## مراقبة المستندات وإعادة التحققلحالات الاستخدام التي تتطلب صلاحية مستمرة للمستند (مثل الهويات المنتهية):- **انتهاء صلاحية المستند** يُتتبَّع لكل هوية مُتحقَّق منها. استعلم عن الحقل `expiration_date` في قرار الجلسة.
- **مراقبة المستندات**: مفعّلة افتراضيًا وتعمل تلقائيًا، ولا يلزم تفعيلها يدويًا. عندما يحلّ تاريخ انتهاء صلاحية الهوية، تنتقل الجلسة التي كانت بحالة `"Approved"` إلى `"Kyc Expired"`، ويضاف تحذير `DOCUMENT_EXPIRED` إلى نتيجة التحقق من الهوية، ويُرسل حدث webhook باسم `status.updated`. لا يُرسل أي تحذير قبل تجاوز التاريخ.
- **إيقافها**: اضبط **وضع انتهاء الصلاحية** على **السماح بالمستندات المنتهية الصلاحية** لتلك الدولة ونوع المستند في [إعدادات التحقق من الهوية](https://docs.didit.me/ar/core-technology/id-verification/overview.md). الوضع الافتراضي **رفض المستندات المنتهية الصلاحية** هو الوضع الذي يُفعّل المراقبة. المستند المقبول بوضع **السماح بالمستندات المنتهية الصلاحية** لا يخضع للمراقبة أبدًا.
- **إعادة التحقق**: شغّل جلسة جديدة بالقيمة نفسها لـ `vendor_data` لتحديث المستندات.## الموقع الجغرافي للمستنديقارن فحص [الموقع الجغرافي لمستند الهوية](https://docs.didit.me/ar/core-technology/id-verification/document-geolocation-id-verification.md) موقع عنوان IP لمن قدّم المستند مع دولة إصدار الهوية. تُرفق النتائج بقرار الجلسة.## الخصوصية والاحتفاظ بالبيانات- جميع المستندات مشفّرة أثناء التخزين.
- يتم الوصول إلى الصور عبر روابط موقّعة قصيرة الأمد.
- يخضع الاحتفاظ لسياسة [الاحتفاظ بالبيانات](https://docs.didit.me/ar/console/data-retention.md) الخاصة بالتطبيق.
- للمستخدمين الحق في طلب الحذف، وعند الحذف تُزال الصور ومستخرجات OCR وبيانات NFC.## الخطوات التالية> [card] [التحقق من الهوية](https://docs.didit.me/ar/core-technology/id-verification/overview.md)
>
> كيفية التقاط الهوية وإجراء OCR عليها.> [card] [إثبات العنوان](https://docs.didit.me/ar/core-technology/proof-of-address/overview.md)
>
> جمع مستندات إثبات العنوان (POA).> [card] [قرار الجلسة](https://docs.didit.me/ar/sessions-api/retrieve-session.md)
>
> مرجع GET /v3/session/{id}/decision/.


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