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

# التحقق من الهوية عبر API: أكثر من 14,000 مستند

> توفر Didit التحقق من الهوية عبر 220+ دولة و14,000+ مستند و54 لغة. بسعر $0.15 لكل فحص، و$10 شهرياً مجاناً، واستدلال في sub-2s.

تقرأ خدمة التحقق من الهوية من Didit المستندات الثبوتية الصادرة عن الجهات الحكومية وتصادق عليها، مثل جوازات السفر، وبطاقات الهوية، ورخص القيادة، وتصاريح الإقامة، عبر 220+ دولة و14,000+ نوع مستند. تفحص المستند للكشف عن التلاعب والاحتيال، ثم تستخرج بياناته باستخدام تقنية OCR المدعومة بالذكاء الاصطناعي؛ وحيثما تسمح الدولة بذلك، يمكن للأفراد التحقق دون الحاجة إلى مستند عبر البحث في قاعدة البيانات أو محفظة الهوية الرقمية ([ثلاث طرق للتحقق](#ثلاث-طرق-للتحقق)).يصل درس الأكاديمية حول قراءة نتيجة التحقق إلى التحقق من الهوية عند الدقيقة 3:47 ويوضح سبب إجراء فحوصات الأصالة قبل استخراج البيانات.[التحقق من الهوية: الأصالة قبل البيانات — أكاديمية Didit](https://www.youtube.com/embed/7htTWCWsl60?start=227\&rel=0\&playsinline=1)

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



      
      

\<pre>

\````# Goal
Integrate Didit ID Verification (OCR + document authenticity) into your app. Pick ONE of the two delivery modes below.

\# Mode A — Session-based (recommended for user-facing flows)
Use this when the user uploads / photographs their document in a hosted Didit flow. The feature is configured on a workflow and runs as part of /v3/session/.

1\. Create a workflow with the ID_VERIFICATION feature (Business Console or POST /v3/workflows/). Canonical feature enum: "OCR" (legacy) or "ID_VERIFICATION".
2\. Create a session — POST /v3/session/ with { workflow_id, vendor_data, callback }. See /sessions-api/create-session.
3\. Open the returned session.url for the user OR mount the Web/Mobile SDK.
4\. After completion fetch the decision — GET /v3/session/{sessionId}/decision/ (or subscribe to the session.status.updated webhook).

The decision response surfaces the result under the plural array `id_verifications[]` (one entry per document collected in the workflow).

\# Mode B — Standalone API (server-to-server)
Use when you already have one or two document images and want a one-shot OCR + checks call.

POST https://verification.didit.me/v3/id-verification/
multipart/form-data — x-api-key: YOUR_API_KEY

Required: front_image. Required for dual-sided docs (ID cards, driver licences): back_image.
Allowed extensions: tiff/jpg/jpeg/png/webp/pdf. Max 5 MB per file. Images must be uncropped — all 4 corners visible.

curl example:
\```bash
curl -X POST 'https://verification.didit.me/v3/id-verification/' \
-H 'x-api-key: YOUR_API_KEY' \
-F 'front_image=@./id_front.jpg' \
-F 'back_image=@./id_back.jpg' \
-F 'perform_document_liveness=true' \
-F 'minimum_age=18' \
-F 'expiration_date_not_detected_action=DECLINE' \
-F 'invalid_mrz_action=DECLINE' \
-F 'inconsistent_data_action=DECLINE' \
-F 'preferred_characters=latin' \
-F 'save_api_request=true' \
-F 'vendor_data=user-123'
\```
Returns: { request_id, id_verification: { status, full_name, document_type, document_number, date_of_birth, expiration_date, parsed_address, mrz, barcodes, portrait_image, front_document_image, back_document_image, warnings: [...] } }.

\# Status enum (per id_verifications[].status)
"Not Started" | "In Progress" | "Approved" | "In Review" | "Declined" | "Abandoned" | "Kyc Expired"

\# Warnings (LogWarningChoices.ID_VERIFICATION)
The warnings[] array on each id_verification carries risk codes including:
DOCUMENT_EXPIRED, INVALID_MRZ, INCONSISTENT_DATA, COULD_NOT_RECOGNIZE_DOCUMENT, DOCUMENT_LIVENESS_FAILED, MIN_AGE_NOT_REACHED, MAX_AGE_EXCEEDED, EXPIRATION_DATE_NOT_DETECTED, DUPLICATED_DOCUMENT, FRAUD_RISK_FROM_OCR, COUNTRY_NOT_ALLOWED, DOCUMENT_TYPE_NOT_ALLOWED.
Full catalogue: /core-technology/id-verification/warnings-id-verification.

\# Failure modes to handle
\- HTTP 403 "You don't have enough credits..." — insufficient balance.
\- HTTP 400 with multipart validation errors (missing back_image on dual-sided docs, file > 5 MB, unsupported extension).
\- status="Declined" with one or more terminal warnings (DOCUMENT_EXPIRED, DOCUMENT_LIVENESS_FAILED, COULD_NOT_RECOGNIZE_DOCUMENT, etc.) — surface the first warning's long_description to the user and stop the flow.
\- status="In Review" with a DOCUMENT_LIVENESS_NOT_COMPUTED warning — the requested forgery check produced no usable score (provider error or crash); treat the document as unchecked and route it to your manual-review queue.
\- status="In Review" — route to your manual-review queue; do not approve the user.

\# See also
\- Canonical schema: /reference/data-models#id-verification
\- Full integration playbook: /integration/integration-prompt
\- Risk catalogue: /core-technology/id-verification/warnings-id-verification
\- Per-feature report: /core-technology/id-verification/report-id-verification````

\</pre>



      
      

الصق في

![خطوات التحقق من الهوية في Didit بدءاً من التقاط المستند وحتى التحليل واتخاذ القرار المدعوم بالذكاء الاصطناعي](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/id-verification-steps.png?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=42c64546f3495000d7ea3b10c4b5fa50)**1. الالتقاط الذكي**ابدأ عملية التحقق بسهولة باستخدام نظام الالتقاط الذكي والبديهي المعتمد على الذكاء الاصطناعي. يقوم المستخدمون برفع مستندات الهوية أو تصويرها مع إرشادات فورية:* **الكشف التلقائي** عن نوع المستند ودولة الإصدار
* **إرشادات بصرية فورية** لضبط الموضع والإضاءة والتركيز بشكل مثالي
* **التقاط تلقائي** عند توفر الظروف المثالية — دون الحاجة إلى إعادة المحاولة يدوياً
* دعم **جوازات السفر**، و**رخص القيادة**، و**بطاقات الهوية الوطنية**، و**تصاريح الإقامة**> [!NOTE]
>
> *أهمية ذلك*: يقلل نظام الالتقاط الذكي من الصعوبات التي تواجه المستخدم ويضمن إرسال مستندات عالية الجودة من المحاولة الأولى، مما يعزز معدلات التحويل والثقة.**2. معالجة البيانات المتقدمة**استخراج بيانات الهوية والتحقق منها بدقة لا مثيل لها.**استخراج البيانات** — تقنية متطورة تعالج جميع الحقول الأساسية:| القدرة | التفاصيل |
| - | - |
| **استخراج الحقول** | الاسم الكامل، تاريخ الميلاد، رقم المستند، تاريخ الإصدار/الانتهاء، الجنسية، والمزيد |
| **OCR** | التعرف الضوئي عالي الدقة على النصوص |
| **تحليل MRZ** | فك ترميز المنطقة المقروءة آلياً |
| **فك ترميز الرمز الشريطي** | استخراج بيانات الباركود تلقائياً |**التحقق من صحة البيانات**:* المطابقة المرجعية للبيانات بين المناطق المرئية، وMRZ، والباركود للتأكد من اتساقها
* التحقق التشفيري من الباركود الموقّع من الجهة المصدرة، حيثما تنشر سلطة الإصدار الشهادات اللازمة للتحقق منه. بطاقات الهوية الوطنية الفرنسية مغطاة حالياً: يتم التحقق من باركود ANTS 2D-Doc الخاص بها عبر شهادة الموقّع المرتبطة بسلسلة ثقة تصل إلى قائمة الثقة الخاصة بـ ANTS، وبالتالي يتم اكتشاف أي باركود لم توقّعه الجهة حتى لو بدت محتوياته متسقة
* مطابقة التنسيق والأنماط لكشف الحالات الشاذة
* استعلامات فورية في قواعد البيانات الحكومية (حيثما كان مسموحاً) للتحقق الموثوق> [!NOTE]
>
> *أهمية ذلك*: تضمن المعالجة الشاملة للبيانات الدقة وتزيل الأخطاء، مما يمنحك الثقة في كل عملية تحقق.**3. التحليل المتقدم**يجري نظامنا المدعوم بالذكاء الاصطناعي فحوصات شاملة لضمان سلامة المستند وأصالته:- التحقق من **أصالة المستند**
- **كشف التلاعب** وتحليل سلامة الصورة
- **كشف حيوية المستند** لمنع الاحتيال الناتج عن:
  * لقطات الشاشة للمستندات الرقمية
  * صور المستندات المعروضة على الشاشات
  * النسخ المطبوعة من المستندات
  * المستندات المتلاعب بها ذات الصور الشخصية المعدلة
- **التحقق من ميزات الأمان** (الهولوغرام، والعلامات المائية، وغيرها)
- **مطابقة القوالب** مع قاعدة بيانات معتمدة**4. نتائج سلسة وتكامل سلس**احصل على رؤى قابلة للتنفيذ على الفور مع خيارات تسليم مرنة.**نتائج فورية**:- تحديثات فورية عبر لوحة تحكم سهلة الاستخدام
- إشعارات webhook فورية لتدفقات سير العمل المؤتمتة
- RESTful API لتكامل سلس مع أنظمتك الحالية**تقارير شاملة**:* تقارير PDF مفصلة تتضمن نتائج التحقق والأدلة
* مسارات تدقيق للامتثال والاحتفاظ بالسجلات
* خيارات قابلة للتخصيص لتتوافق مع احتياجاتك التشغيلية> [!NOTE]
>
> *أهمية ذلك*: تمكّن النتائج السريعة وسهلة الوصول فريقك من اتخاذ الإجراءات بسرعة مع الحفاظ على عملية آمنة وقابلة للتدقيق.***## ثلاث طرق للتحققيُعد تصوير المستند إحدى [طرق التحقق من الهوية](https://docs.didit.me/ar/core-technology/id-verification/verification-methods.md) الثلاث. يمكنك أيضاً، في كل دولة، السماح للأفراد بإثبات هوياتهم دون أي مستند على الإطلاق:- **[البحث دون مستند](https://docs.didit.me/ar/core-technology/id-verification/non-doc-lookup.md)** — يدخل المستخدم رقم هويته الوطنية بالإضافة إلى بعض التفاصيل الشخصية ونتحقق منها بمقارنتها بسجل حكومي أو مصدر موثوق آخر، محدد لكل دولة. وحيثما يُرجع ذلك المصدر صورة شخصية، يتم تضمين صورة سيلفي، وكشف الحيوية السلبي، ومطابقة الوجه.
- **[محافظ الهوية الرقمية](https://docs.didit.me/ar/core-technology/id-verification/digital-id-wallets.md)** — يسجل المستخدم الدخول باستخدام هوية رقمية حكومية أو بنكية مثل MitID أو BankID أو itsme، وتشارك المحفظة مجموعة موقّعة من السمات.يصف كل ما في هذه الصفحة عملية التقاط المستندات، والتي تظل كما هي دون تغيير: فسير العمل الذي لا يحدد طرقاً يظل مقتصراً على التقاط المستندات فقط.***## متطلبات المستنداتلتحقيق أفضل نتائج للتحقق، يجب أن تستوفي المستندات المعايير التالية:#### المتطلبات العامة- صادرة عن جهة حكومية وسارية المفعول خلال فترة صلاحيتها المحددة
- سليمة مادياً (خالية من التلف أو الخدوش أو البقع التي قد تحجب التفاصيل)
- جميع المعلومات الأساسية (الاسم الكامل، تاريخ الميلاد، MRZ، إلخ) مقروءة بوضوح
- اتساق البيانات في جميع المستندات المقدمة#### متطلبات الصورة- صورة أصلية ملتقطة في الوقت الفعلي (ليست لقطات شاشة أو مسحاً ضوئياً أو نسخاً رقمية)
- التنسيقات المدعومة: JPG، وJPEG، وPNG، وPDF
- الحد الأقصى لحجم الملف: 5MB
- صورة ملونة بالكامل مع ظهور جميع زوايا المستند
- خالية من الوهج والظلال، والتعديل الرقمي، أو التلاعب
- يُشترط وجود مستندات مادية (لا تُدعم الهويات الرقمية إلا في مناطق محددة معترف بها رسمياً)## إعدادات إضافية بحسب الدولة ونوع المستندقم بتهيئة قواعد دقيقة لكل دولة ونوع مستند مباشرةً من لوحة التحكم. تتيح لك عناصر التحكم هذه تخصيص معايير القبول وتفضيلات نسخ البيانات وفقاً لاحتياجات الامتثال لديك.![Didit ID verification additional settings panel for per-country expiration and acceptance rules](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/id-additional-settings.jpeg?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=4238b10a404795a61926fbdf1a3adc20)* **وضع انتهاء الصلاحية**: اختر كيفية التعامل مع المستندات التي مضت تواريخ انتهاء صلاحيتها.

  * **رفض منتهي الصلاحية**: إذا كان تاريخ انتهاء صلاحية المستند يسبق تاريخ اليوم، فسيتم تعليمه كمنتهي الصلاحية ورفضه.
  * **السماح بالمنتهي**: عدم تمييز أو حظر المستندات ذات تاريخ انتهاء الصلاحية السابق.

  يتحكم هذا الإعداد أيضاً في المراقبة بعد الموافقة، والتي تكون مفعّلة افتراضياً: مع **رفض منتهي الصلاحية** تنتقل الجلسة المقبولة إلى `"Kyc Expired"` عند حلول تاريخ انتهاء المستند لاحقاً، ويتم إطلاق الحدث `status.updated`؛ ومع **السماح بالمنتهي** تظل مقبولة ولا تخضع للمراقبة أبداً. راجع [مراقبة المستندات](https://docs.didit.me/ar/core-technology/id-verification/document-monitoring-id-verification.md).
  في API الخاص بسير العمل، يقبل إعداد المستند الخاص بكل دولة `expiration_check_mode` كلاً من `strict` (**رفض منتهي الصلاحية**)، و`allow_expired` (**السماح بالمنتهي**)، و`local_regulation`.
  يتبع `local_regulation` القاعدة الخاصة بالدولة حيثما توفرت لدى Didit، ويرفض المستندات منتهية الصلاحية في كل مكان آخر.
  يتم رفض أي قيمة أخرى.
* **تنسيق الأحرف المفضل**: حدد كيفية توحيد الأسماء والحقول المستخرجة.
  * **تفضيل الأحرف اللاتينية (A–Z)**: مثال: "Mohammed"
  * **تفضيل نظام الكتابة الأصلي (غير اللاتيني)**: مثال: "محمد"
* **الدعم الإقليمي والأنواع الفرعية**: فعّل المستندات بحسب المنطقة وحدد الأنواع الفرعية المقبولة عندما يتضمن نوع المستند العديد من الاختلافات.
  * مثال: بالنسبة لرخص القيادة في الولايات المتحدة، حدد الأنواع الفرعية الدقيقة التي تقبلها (مثل Arizona Commercial Driver License، وIndiana Operator License (REAL ID)، وNew York Enhanced Driver License، وغيرها).
  * استخدم عنصر التحكم "الأنواع الفرعية المقبولة" لتضمين/استبعاد العديد من المتغيرات بسرعة (مثل "تم تحديد 128").> تلميح: تنطبق هذه الإعدادات بحسب الدولة ونوع المستند، مما يتيح لك أن تكون صارماً في بعض الأسواق بينما تكون أكثر مرونة في أسواق أخرى.## قيود العمر بحسب الدولةفرض متطلبات الحد الأدنى والأقصى للعمر على أساس كل دولة أثناء التحقق من الهوية. يستخرج النظام تاريخ ميلاد المستخدم من المستند المقدّم ويقارنه بحدود العمر المحددة لدولة إصدار المستند.### التهيئةيتم تهيئة قيود العمر كجدول مخصص لكل دولة مباشرةً من لوحة التحكم:| العمود | الوصف |
| - | - |
| **الدولة** | دولة إصدار المستند (ISO 3166-1 alpha-3). تُعرض فقط الدول المفعّلة في قائمة المستندات المسموح بها لديك. |
| **الحد الأدنى للعمر** | الحد الأدنى للعمر المطلوب. يؤدي كون المستخدمين أصغر من هذه القيمة إلى تفعيل الإجراء المحدّد (رفض أو مراجعة). |
| **الحد الأقصى للعمر** | الحد الأقصى للعمر المسموح به. يؤدي كون المستخدمين أكبر من هذه القيمة إلى تفعيل الإجراء المحدّد. اتركه فارغاً لعدم تعيين حد أقصى. |
| **تجاوزات الولاية/المنطقة** | بالنسبة للدول التي تختلف فيها الأعمار باختلاف المناطق الإدارية (مثل الولايات المتحدة والمكسيك)، افتح أيقونة الإعدادات لتهيئة الحد الأدنى والأقصى للعمر لكل ولاية، مما يتجاوز الإعدادات الافتراضية على مستوى الدولة. |### الإعدادات الافتراضية لسن الرشدتتضمن لوحة التحكم زر **"تطبيق سن الرشد"** الذي يملأ تلقائياً الحد الأدنى لعمر كل دولة بسن الرشد القانوني المعروف (18 في معظم الدول، مع استثناءات مثل 19 في كوريا الجنوبية، و21 في الإمارات العربية المتحدة، و20 في نيوزيلندا، وغيرها). يمكنك بعد ذلك تعديل الدول بشكل فردي أو إضافة تجاوزات على مستوى الولاية حسب الحاجة.### تجاوزات الولاية/المنطقةتعتمد بعض الدول حدوداً قانونية مختلفة للعمر بحسب الولاية أو المنطقة. عند مسح المستند، يستخرج نظام OCR المنطقة (مثل "Mississippi"، أو "Alabama"، أو "Jalisco") من المستند. إذا تم تهيئة تجاوز ولاية لتلك المنطقة، فستكون له الأولوية على إعداد العمر على مستوى الدولة.على سبيل المثال، إذا كان الحد الأدنى للعمر في الولايات المتحدة هو 18، ولكن تم ضبط تجاوز لولاية ميسيسيبي ليكون 21، فسيتم التحقق من المستخدم الذي يقدم رخصة قيادة من ولاية ميسيسيبي مقابل الحد الأدنى للعمر البالغ 21.### الإجراءات القابلة للتهيئةعندما يقع عمر المستخدم خارج النطاق المحدّد لدولة المستند (أو الولاية)، يمكنك اختيار الإجراء:* **رفض**: يتم رفض الجلسة تلقائياً.
* **المراجعة**: يتم تمييز الجلسة لإجراء مراجعة يدوية.> [!NOTE]
>
> تعمل قيود العمر بحسب الدولة أيضاً مع مسارات عمل **التحقق من العمر التكيفي**. عندما تُطلق حالة غير محسومة خيار التحقق من الهوية كبديل احتياطي، يستخدم فحص العمر هذه الإعدادات الخاصة بكل دولة لاتخاذ القرار النهائي بناءً على دولة إصدار المستند ومنطقته.


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