> ## 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. # تقرير التحقق عبر NFC: بيانات الشريحة والموثوقية > تعرّف على كيفية قراءة تقرير التحقق عبر NFC وجواز السفر الإلكتروني من Didit: بيانات الشريحة، موثوقية الشهادات، ونماذج payload عبر API. ## نظرة عامة يسجل **تقرير التحقق عبر NFC** ما قرأته Didit وتحققت منه من شريحة NFC الخاصة بالمستند — سواء كان جواز سفر إلكتروني، أو بطاقة هوية إلكترونية، أو مستنداً إلكترونياً آخر متوافقاً مع معيار ICAO 9303. ويتضمن البيانات البيوغرافية للشريحة، وعمليات التحقق التشفيرية من سلامة البيانات (تجزئات SOD وتجزئات مجموعات البيانات)، وملخصاً لشهادة موقِّع المستند (DSC) المستخدمة من قبل دولة الإصدار. يتم إصدار التقرير بعد إتمام المستخدم لخطوة NFC في سير العمل. تقرأ Didit مجموعات البيانات للشريحة على جهاز المستخدم، وتتحقق من توقيع كائن أمان المستند (SOD) مقابل شهادة CSCA الخاصة بدولة الإصدار، وتفحص تجزئة كل مجموعة بيانات مقابل القيم الموقعة في SOD، وتطابق MRZ الخاص بالشريحة مع MRZ المستخرج عبر تقنية OCR من الوجه الظاهر للمستند. تتم قراءة بطاقة My Number اليابانية عبر JPKI بدلاً من ذلك (`chip_protocol: "jpki"`): حيث يتضمن تقريرها عمليات التحقق من الشهادة والتوقيع والإلغاء وبيانات الحامل تحت `jpki`، بينما تظل حقول ICAO فارغة `null`. راجع [Japan My Number Card (JPKI)](#بطاقة-my-number-اليابانية-jpki). يحمل كل تقرير قيمة `status` خاصة به — بشكل مستقل عن حالة الجلسة الإجمالية — تعكس نتيجة خطوة NFC وحدها: * **مقبولة** — تمت قراءة الشريحة ولم يُطلق أي من التحذيرات التي تم إعدادها لتوجيه الخطوة إلى المراجعة أو الرفض. * **قيد المراجعة** — تم إطلاق تحذير واحد على الأقل إجراءه المُعدّ هو **المراجعة** (على سبيل المثال `NFC_CHIP_NOT_VERIFIED` أو `NFC_TRUST_ANCHOR_MISSING` عند تعيين إجراء الشريحة غير المتحقق منها إلى المراجعة، أو `JPKI_REVOCATION_UNCHECKED` مع الإجراء الافتراضي الخاص به). * **مرفوضة** — تم إطلاق تحذير واحد على الأقل إجراءه المُعدّ هو **الرفض** (على سبيل المثال `NFC_AND_OCR_DATA_NOT_SAME` عند تعيين إجراء عدم تطابق البيانات إلى الرفض). * **لم تكتمل** — لم يُكمل المستخدم خطوة NFC إطلاقاً؛ إما أنه تُركت محاولة قراءة الشريحة أو أن الجهاز لا يدعم NFC. * **طُلبت إعادة الإرسال** — طلب أحد المراجعين من المستخدم إعادة الإرسال؛ وسيتم استبدال التقرير بمحاولة جديدة. ## أين يظهر في استجابات API يأتي تقرير NFC داخل المصفوفة `nfc_verifications[]` — **دائماً كمصفوفة JSON**، وليس ككائن `nfc` فردي مطلقاً. تظهر عناصر متعددة عندما يشغّل سير العمل خطوة NFC أكثر من مرة (على سبيل المثال في مسار ترقية مستوى التحقق)؛ ويحمل كل عنصر قيمة `node_id` خاصة به. * **واجهة API لقرار الجلسة** — يظهر كـ `nfc_verifications[]` في المستوى الأعلى لـ `GET /v3/session/{sessionId}/decision/`. راجع [استرداد قرار الجلسة](https://docs.didit.me/ar/sessions-api/retrieve-session.md). * **webhook** — تتضمن payload الخاص بـ `status.updated` نفس المصفوفة `nfc_verifications[]` بمجرد أن تُنتج خطوة NFC بيانات. راجع [webhook](https://docs.didit.me/ar/integration/webhooks.md). * **NFC المستقل** — للإرسال المباشر لبيانات الشريحة، راجع [نظرة عامة على NFC](https://docs.didit.me/ar/core-technology/nfc-verification/overview.md). عندما يتضمن سير العمل خطوة NFC تم تخطيها أو تجاوزها، يحمل payload القرار أيضاً حقلاً في المستوى الأعلى باسم `nfc_skip_reason` يوضح السبب بدقة — سواء كان المستند لا يحتوي على شريحة، أو شهادة دولة الإصدار غير متوفرة، أو الجهاز لا يحتوي على قارئ NFC، أو تم التحقق دون استخدام SDK أصلي (لا يوجد وصول لـ NFC من المتصفح)، أو تعذر اشتقاق مفتاح الوصول إلى الشريحة من MRZ، أو تعذرت قراءة بطاقة My Number عبر JPKI، أو اختار المستخدم التخطي. ويظل الحقل `null` للنتائج الخارجة عن هذا التصنيف — والأكثر شيوعاً هو المستخدم الذي ترك المحاولة في منتصفها (حالة التقرير `Not Finished`) أو الجلسة التي لا تزال خطوة NFC فيها قيد الانتظار. راجع [أسباب التخطي](https://docs.didit.me/ar/core-technology/nfc-verification/warnings-nfc-verification.md#أسباب-التخطي) لمعرفة القيم الدقيقة. > [!NOTE] > > أشارت الوثائق القديمة إلى حقل `nfc` فردي. هذا الشكل **غير موجود** على endpoint قرار v3 — يظهر فقط في الوجهات المثبتة صراحة على webhook في الإصدار V2، حيث يحمل أيضاً `chip_protocol` و`jpki`. احرص دائماً على قراءة `response.nfc_verifications[0]` والتكرار عبر عناصر المصفوفة. ## المخطط يوجد المخطط المرجعي الكامل، حقلاً بحقل، في صفحة مرجع [نماذج البيانات](https://docs.didit.me/ar/reference/data-models.md#التحقق-عبر-nfc). تعكس الحقول أدناه ذلك المخطط المرجعي. | الحقل | النوع | الوصف | | - | - | - | | `status` | `"Not Finished" \| "Approved" \| "Declined" \| "In Review" \| "Resub Requested"` | حالة خطوة NFC (انظر المعاني أعلاه). | | `node_id` | string \| null | عقدة مخطط سير العمل التي أنتجت هذا التقرير. تتيح لك التمييز بين عمليتي فحص NFC في سير عمل متعدد الخطوات. | | `is_nfc_skipped` | boolean | تكون `true` عند تخطي خطوة NFC هذه صراحةً بدلاً من قراءتها. | | `skip_reason` | string \| null | سبب تخطي الخطوة — يُعيَّن فقط عندما تكون قيمة `is_nfc_skipped` هي `true`. نفس قيم `nfc_skip_reason` على مستوى الجلسة؛ راجع [أسباب التخطي](https://docs.didit.me/ar/core-technology/nfc-verification/warnings-nfc-verification.md#أسباب-التخطي). | | `chip_protocol` | `"icao"` \| `"jpki"` | كيفية قراءة الشريحة. `icao`: شريحة جواز سفر إلكتروني أو بطاقة هوية إلكترونية متوافقة مع ICAO 9303. `jpki`: بطاقة My Number Card اليابانية، وتكون نتيجتها ضمن `jpki`؛ وتكون حقول ICAO أدناه (`portrait_image` و`signature_image` و`chip_data` و`authenticity` و`certificate_summary`) بقيمة `null` في هذه الحالة. تُعيَّن أيضاً في الخطوات المتخطاة. | | `jpki` | object \| null | ما أثبتته قراءة بطاقة My Number Card؛ راجع [حقول JPKI](#حقول-jpki). تكون `null` لشرائح ICAO، وللخطوات التي تم تخطيها، وعند إغلاق الخطوة دون قراءة أي بطاقة. | | `portrait_image` | string (signed URL) \| null | الصورة الشخصية المستخرجة من الشريحة (DG2). رابط موقّع مسبقاً قصير الأجل — نزّله على الفور؛ أعد جلب القرار للحصول على رابط جديد. | | `signature_image` | string (signed URL) \| null | صورة توقيع حامل الوثيقة من الشريحة (DG7)، عند توفرها. ينطبق عليها نفس سلوك الرابط الموقّع مسبقاً قصير الأجل. | | `chip_data` | object \| null | كائن مسطح يحتوي على البيانات البيوغرافية المحللة من الشريحة. يتوفر دائماً بعد قراءة ناجحة: `dgs` (قائمة بمجموعات البيانات المقروءة)، `surname`، `name`، `country`، `nationality`، `birth_date` (`YYYY-MM-DD`)، `expiry_date` (`YYYY-MM-DD`)، `sex` (`M`/`F`)، `document_type` (رمز مستند MRZ، مثل `P`)، `document_number`، `optional_data`، أرقام التحقق لـ MRZ (`birth_date_hash`، `expiry_date_hash`، `document_number_hash`، `optional_data_hash`، `final_hash`)، `mrz_string`، و`mrz_type` (`TD1`/`TD2`/`TD3`). عندما تحمل الشريحة DG11، يُضاف `place_of_birth` و`address` (بالإضافة إلى `full_name` / `full_name_non_latin` للمستندات التي تحمل اسماً بغير الحروف اللاتينية)؛ وتكون هذه المفاتيح **غير موجودة** (وليست null) في غير ذلك. تكون `null` عند تخطي خطوة NFC. | | `authenticity` | object \| null | نتائج المصادقة السلبية لـ ICAO، أدناه. تكون `null` لقراءة JPKI. | | `authenticity.sod_integrity` | boolean | تكون `true` عندما ترتبط سلسلة توقيع SOD بمرجع CSCA صالح لدولة الإصدار، ولا تكون شهادة DSC ملغاة أو منتهية الصلاحية. | | `authenticity.dg_integrity` | boolean | تكون `true` عندما تتطابق قيمة التجزئة لكل مجموعة بيانات مع القيمة الموقعة في كائن SOD. تعني القيمة `false` أنه تم التلاعب ببيانات الشريحة أو قراءتها جزئياً. | | `certificate_summary` | object \| null | ملخص لشهادة DSC التي وقّعت هذه الشريحة: `issuer`، `subject`، `serial_number`، `not_valid_before`، `not_valid_after` (طوابع زمنية بصيغة `YYYY-MM-DD HH:MM:SS`)، بالإضافة إلى كائن `validation` بنتائج الفحوصات الفردية (`csca_verified`، `csca_missing`، `dsc_revoked`، `dsc_expired`، `csca_expired`). تكون قيمة `csca_missing` هي `true` عندما لا تتوفر مرساة الثقة CSCA لدولة إصدار DSC. تكون `null` عندما يتعذر تحميل SOD أو عند تخطي الخطوة. | | `warnings[]` | array | تحذيرات على مستوى الوحدة، يحتوي كل منها على `feature` و`risk` و`additional_data` و`log_type` و`short_description` و`long_description` و`node_id` — راجع [تحذيرات NFC](https://docs.didit.me/ar/core-technology/nfc-verification/warnings-nfc-verification.md). | ## قيم الحالة | الحالة | المعنى | التأثير اللاحق | | - | - | - | | `Approved` | تمت قراءة الشريحة ولم يصدر أي تحذير مقترن بإجراء مراجعة أو رفض — بما في ذلك الحالة التي صدرت فيها تحذيرات ولكن الإجراء المضبوط لها هو "بلا إجراء". | تُحتسب كعملية فحص NFC ناجحة؛ ولن تنقل الجلسة بمفردها إلى قيد المراجعة. | | `In Review` | صدر تحذير يكون الإجراء المضبوط له هو المراجعة (`SKIPPED_NFC_VALIDATION` أو `NFC_CHIP_NOT_VERIFIED` أو `NFC_TRUST_ANCHOR_MISSING` أو `NFC_AND_OCR_DATA_NOT_SAME` أو أحد تحذيرات `JPKI_*`، وفقاً لإعداداتك). | تنتقل الجلسة أيضاً إلى `In Review` حتى يتخذ المراجِع إجراءً. | | `Declined` | صدر تحذير يكون الإجراء المضبوط له هو الرفض. | تُرفض الجلسة ما لم يستوفِ فرع آخر مقبول متطلبات سير العمل. | | `Not Finished` | ترك المستخدم خطوة NFC، أو أن الجهاز لا يدعم NFC، أو لم تكتمل قراءة الشريحة أبداً. | لم ينتج عن فرع NFC أي نتيجة؛ تحقق من المسارات البديلة في سير العمل. | | `Resub Requested` | طلب المراجِع إعادة إرسال هذه الخطوة. | تحل محاولة جديدة محل هذا التقرير بمجرد أن يعيد المستخدم المحاولة. | > [!NOTE] > > تحذيرا الشهادة (`DSC_CERTIFICATE_REVOKED` و`DSC_CERTIFICATE_EXPIRED`) هما للعلم فقط: يظهران في `warnings[]` لكنهما لا يغيران قيمة `status` لـ NFC بمفردهما أبداً. راجع [تحذيرات NFC](https://docs.didit.me/ar/core-technology/nfc-verification/warnings-nfc-verification.md) للاطلاع على مصفوفة السلوك الكاملة. ## أمثلة ### Approved — تمت قراءة الشريحة وهي صالحة تشفيرياً ```json theme={null} { "nfc_verifications": [ { "status": "Approved", "node_id": "nfc_primary", "portrait_image": "https:///.../epassport/_face.jpg?signature=...", "signature_image": "https:///.../epassport/_signature.jpg?signature=...", "chip_data": { "dgs": ["DG1", "DG2", "DG7", "DG11"], "surname": "DOE", "name": "JOHN", "country": "ESP", "nationality": "ESP", "birth_date": "1990-05-15", "expiry_date": "2030-01-01", "sex": "M", "document_type": "P", "document_number": "AAB000123", "optional_data": "", "birth_date_hash": "4", "expiry_date_hash": "7", "document_number_hash": "3", "optional_data_hash": "", "final_hash": "4", "mrz_string": "P/.../epassport/_face.jpg?signature=...", "signature_image": null, "chip_data": { "dgs": ["DG1", "DG2"], "surname": "DOE", "name": "JOHN", "country": "ESP", "nationality": "ESP", "birth_date": "1990-05-15", "expiry_date": "2030-01-01", "sex": "M", "document_type": "P", "document_number": "AAB000254", "optional_data": "", "birth_date_hash": "4", "expiry_date_hash": "7", "document_number_hash": "6", "optional_data_hash": "", "final_hash": "6", "mrz_string": "P [!WARNING] > > قراءة بطاقة My Number عبر JPKI ليست مفعّلة في بيئة الإنتاج بعد. وحتى تفعيلها، تتخطى بطاقة My Number خطوة NFC مع سبب التخطي `JPKI_UNAVAILABLE`. ### حقول JPKI | الحقل | النوع | الوصف | | - | - | - | | `jpki.certificate_types` | صفيف من `"user_authentication"` \| `"signature"` | شهادات البطاقة المقروءة. تُقرأ شهادة `user_authentication` (رقم PIN المكوّن من 4 أرقام) دائماً؛ بينما تُقرأ `signature` (رقم PIN للتوقيع) عندما يكون إعداد `jpki_request_attributes` لعقدة NFC مفعّلاً، وهو الإعداد الافتراضي. | | `jpki.chain_valid` | boolean | تكون `true` عندما ترتبط كل شهادة بسلسلة ثقة مع سلطة التصديق التابعة لـ JPKI من نوعها، وتكون ضمن فترة صلاحيتها، وتكون شهادة بطاقة My Number من ذلك النوع. | | `jpki.signature_valid` | boolean | تكون `true` عندما يجري التحقق بنجاح من كل توقيع أجرته البطاقة على التحدي المستخدم لمرة واحدة. لا توقّع البطاقة إلا بعد إدخال رقم PIN الخاص بها، لذا يثبت هذا أن الشخص يحمل البطاقة ويعرف رقم PIN. | | `jpki.revocation_status` | `"good"` \| `"revoked"` \| `"unchecked"` | `good`: تم التأكد من عدم إبطال أي شهادة. `revoked`: تم إبطال شهادة، على سبيل المثال بسبب الإبلاغ عن فقدان البطاقة. `unchecked`: لم تكن هناك استجابة متاحة بشأن الإبطال، لذا لا يمكن استبعاد كون البطاقة ملغاة؛ ولا تُعامل أبداً على أنها `good`. لا يتم التحقق من الإبطال إلا بعد التأكد من صحة السلسلة والتوقيع. | | `jpki.ca_generation` | string \| null | جيل سلطة التصديق لـ JPKI التي أصدرت الشهادات، على سبيل المثال `"2023"`. وتكون `null` عندما لا ترتبط أي شهادة بسلسلة ثقة مع إحداها. | | `jpki.certificate_expires_at` | string (ISO 8601) \| null | أقرب تاريخ انتهاء صلاحية من بين الشهادات المقروءة. | | `jpki.certificates[]` | صفيف | إدخال واحد لكل شهادة مقروءة: `type`، و`chain_valid`، و`signature_valid`، و`ca_generation`، و`not_valid_before`، و`not_valid_after`، و`failure`. يكون `failure` بقيمة `null` عندما تكون السلسلة صالحة، وإلا فسيكون واحداً من `unreadable_certificate` أو `untrusted_issuer` أو `expired` أو `not_yet_valid` أو `wrong_policy` (ليست شهادة بطاقة My Number من ذلك النوع) أو `key_usage`. | | `jpki.attributes` | كائن \| null | بيانات حامل البطاقة من شهادة التوقيع، بمجرد التحقق من صحة سلسلتها: `full_name` (كما هو مسجل، عادةً بنظام الكتابة الياباني)، و`date_of_birth` (`YYYY-MM-DD`)، و`gender` (`M` أو `F` أو `null`)، و`address`، و`name_substitute_characters` / `address_substitute_characters`، والتي توضح الأحرف التي تم استبدالها ببديل لوقوعها خارج مجموعة الأحرف القياسية (`null` عند عدم وجود أي منها). تكون `null` عندما لا تُطلب شهادة التوقيع أو تكون سلسلتها غير صالحة. | | `jpki.attributes_match_ocr` | boolean \| null | تكون `true` عندما تتطابق السمات مع البيانات المقروءة من صورة البطاقة نفسها، و`false` عندما يختلف أي منها (`JPKI_AND_OCR_DATA_NOT_SAME`)، و`null` عندما يتعذر إجراء أي مقارنة، بما في ذلك الحالات التي تكون فيها `attributes` بقيمة `null`. | | `jpki.mismatched_attributes` | صفيف من string | السمات التي تختلف عن بيانات الصورة (`full_name`، `date_of_birth`، `gender`، `address`)، دون قيمها إطلاقاً. | لا يحمل التقرير أبداً الشهادات نفسها، أو أرقامها التسلسلية، أو التوقيعات، أو الرقم الفردي (My Number) المكوّن من 12 رقماً للبطاقة، والذي لا تقرأه خطوة NFC مطلقاً. ### مثال: قراءة بطاقة My Number ```json theme={null} { "nfc_verifications": [ { "status": "Approved", "node_id": "nfc_primary", "portrait_image": null, "signature_image": null, "chip_data": null, "is_nfc_skipped": false, "skip_reason": null, "chip_protocol": "jpki", "jpki": { "certificate_types": ["user_authentication", "signature"], "chain_valid": true, "signature_valid": true, "revocation_status": "good", "ca_generation": "2023", "certificate_expires_at": "2029-05-15T14:59:59Z", "certificates": [ { "type": "user_authentication", "chain_valid": true, "signature_valid": true, "ca_generation": "2023", "not_valid_before": "2024-06-03T01:12:40+00:00", "not_valid_after": "2029-05-15T14:59:59+00:00", "failure": null }, { "type": "signature", "chain_valid": true, "signature_valid": true, "ca_generation": "2023", "not_valid_before": "2024-06-03T01:12:40+00:00", "not_valid_after": "2029-05-15T14:59:59+00:00", "failure": null } ], "attributes": { "full_name": "山田 太郎", "date_of_birth": "1990-05-15", "gender": "M", "address": "東京都千代田区千代田1番1号", "name_substitute_characters": null, "address_substitute_characters": null }, "attributes_match_ocr": true, "mismatched_attributes": [] }, "authenticity": null, "certificate_summary": null, "warnings": [] } ] } ``` عند تعذر التحقق من الإبطال لإحدى القراءات، يتضمن التقرير نفسه `revocation_status: "unchecked"`، وتحذيراً بقيمة `JPKI_REVOCATION_UNCHECKED`، و`status: "In Review"` وفقاً للإعدادات الافتراضية. راجع [تحذيرات NFC](https://docs.didit.me/ar/core-technology/nfc-verification/warnings-nfc-verification.md#بطاقة-my-number-اليابانية-jpki). ## ملاحظة أمنية يتم توقيع بيانات شريحة NFC بواسطة جهة الإصدار، لذا فإن التقرير المقبول الذي يحتوي على `sod_integrity: true` و`dg_integrity: true` يمثل أقوى إثبات هوية يمكن لـ Didit تقديمه. تعامل مع روابط الصور الموقعة (`portrait_image`، و`signature_image`) على أنها قصيرة الأجل: نزّلها فوراً ولا تخزنها مؤقتاً بصورة عامة — أعد طلب القرار عندما تحتاج إلى روابط جديدة. ## مواضيع ذات صلة * [تحذيرات NFC](https://docs.didit.me/ar/core-technology/nfc-verification/warnings-nfc-verification.md) — قائمة قيم التحذيرات الكاملة، وأسبابها، وطرق معالجتها. * [webhook](https://docs.didit.me/ar/integration/webhooks.md) — الاستماع إلى حدث `status.updated` لتلقي تقرير NFC. * [نماذج البيانات — التحقق عبر NFC](https://docs.didit.me/ar/reference/data-models.md#التحقق-عبر-nfc) — المخطط الأساسي متضمناً كل حقل. * [المستندات المدعومة](https://docs.didit.me/ar/core-technology/nfc-verification/supported-documents-nfc-verification.md) — المستندات الإلكترونية التي يمكن لـ Didit قراءتها عبر NFC. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.