> ## 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، مثل تخطي قراءة الشريحة أو عدم التحقق منها، وعدم تطابق OCR، وانتهاء صلاحية الشهادة، مع السبب والشدة والحل.

## نظرة عامة

تُشير التحذيرات في تقرير NFC إلى كل حالة لاحظتها Didit أثناء قراءة الشريحة والتحقق من صحتها. وتظهر في مصفوفة `warnings[]` لكل عنصر في `nfc_verifications[]` (انظر [تقرير NFC](https://docs.didit.me/ar/core-technology/nfc-verification/report-nfc-verification.md))، مع تعيين `feature` إلى `"NFC"`. يتبع كل إدخال شكل [عنصر التحذير](https://docs.didit.me/ar/reference/data-models.md#كائن-التحذير) المشترك: `feature` و`risk` و`additional_data` و`log_type` و`short_description` و`long_description` و`node_id`.

يتكون كل تحذير من ثلاث طبقات:

1. **رمز `risk`** — معرّف ثابت يمكنك مطابقته برمجياً في الكود الخاص بك (الرموز الموضحة أدناه).
2. **نوع السجل `log_type`** — إما `information` أو `warning` أو `error`. وهو مشتق من الإجراء الذي يحدده سير العمل الخاص بك لهذا الخطر: **لا يوجد إجراء** ← `information`، **المراجعة** ← `warning`، **رفض** ← `error`.
3. **التأثير على القرار** — يحدد الإجراء الذي تم تكوينه نفسه أيضاً قيمة `status` لتقرير NFC: يؤدي إجراء المراجعة إلى نقله إلى `In Review`، بينما يؤدي إجراء الرفض إلى نقله إلى `Declined`.

يمكن تكوين أربعة مخاطر لـ NFC بهذه الطريقة (`SKIPPED_NFC_VALIDATION` و`NFC_CHIP_NOT_VERIFIED` و`NFC_TRUST_ANCHOR_MISSING` و`NFC_AND_OCR_DATA_NOT_SAME`)، بالإضافة إلى المخاطر الخمسة الخاصة بـ [بطاقة My Number اليابانية](#بطاقة-my-number-اليابانية-jpki)، ولكل منها إعداد خاص به. يُعدّ خطرَا الشهادة (`DSC_CERTIFICATE_REVOKED` و`DSC_CERTIFICATE_EXPIRED`) **لأغراض إعلامية فقط**: فهما يحملان دائماً `log_type: "information"` ولا يغيران حالة NFC بمفردهما أبداً.

فيما يلي المجموعة الكاملة لرموز المخاطر التي تنشئها وحدة NFC. ولا توجد أي رموز مخاطر أخرى لـ NFC.

## التحذيرات الناتجة

| `risk` | السبب | مستوى الخطورة (`log_type`) | هل يؤثر على الحالة؟ | المعالجة |
| - | - | - | - | - |
| `SKIPPED_NFC_VALIDATION` | تم تخطي قراءة الشريحة — سير العمل يسمح بالتخطي (`allow_nfc_skip`) وضغط المستخدم على تخطي، أو قام العميل بالتخطي لأنه لم يتمكن من قراءة NFC. يتم تسجيل السبب الدقيق في `additional_data.skip_reason` (راجع [أسباب التخطي](#أسباب-التخطي)) وهو ما يحدد `long_description` للتحذير. | يتبع إعداد **skip NFC action** (`skip_nfc_action`): information / warning / error. | قابل للتهيئة — لا إجراء (No action)، أو مراجعة (Review)، أو رفض (Decline). | إذا كانت سياستك تتطلب NFC، فاضبط إجراء التخطي على الرفض (أو امنع التخطي تماماً) واطلب من المستخدم إعادة المحاولة من جهاز يدعم NFC. بخلاف ذلك، اتركه على لا إجراء للرجوع إلى التحقق عبر OCR فقط. |
| `NFC_CHIP_NOT_VERIFIED` | تمت قراءة الشريحة، ولكن فشل التحقق التشفيري لها لسبب آخر غير فقدان مرساة الثقة المحددة بوضوح. لم يتم التحقق من تجزئة مجموعة بيانات، أو توقيع SOD، أو فحص آخر للمصادقة السلبية. | يتبع إعداد **unverified chip action** (`unverified_chip_action`). | قابل للتهيئة — لا إجراء (No action)، أو مراجعة (Review)، أو رفض (Decline). | تعامل مع هذا على أنه شريحة يحتمل أن تكون غير صالحة أو تم التلاعب بها. افحص `authenticity` و `certificate_summary.validation` لمعرفة الفحص الذي فشل. |
| `NFC_TRUST_ANCHOR_MISSING` | تنتمي شهادة مُوقّع المستند (DSC) الخاصة بالشريحة إلى جيل من هيئة تصديق توقيع الدولة (CSCA) غير متوفر في مخزن الثقة التابع لـ Didit (أي أن `certificate_summary.validation.csca_missing` قيمته `true`). وبالتالي لا تستطيع Didit إنشاء سلسلة الثقة لـ SOD. | يتبع إعداد **unverified chip action** (`unverified_chip_action`). | قابل للتهيئة — لا إجراء (No action)، أو مراجعة (Review)، أو رفض (Decline). | هذه فجوة في تغطية مخزن الثقة، وليست دليلاً على التلاعب بالشريحة. راجع المستند من خلال فحوصاتك الاحتياطية وتواصل مع دعم Didit مع تزويدهم بدولة الإصدار حتى يتسنى التحقيق في CSCA المفقودة. |
| `NFC_AND_OCR_DATA_NOT_SAME` | لا تتطابق بيانات MRZ المقروءة من الشريحة مع بيانات MRZ المستخرجة عبر OCR من الجانب المرئي للمستند (تتم المقارنة بعد التسوية، مع تجاهل رمز الملء `<`). إشارة قوية على التلاعب. | يتبع إعداد **data inconsistency action** (`inconsistent_data_action`) — وهو نفس الإعداد الذي يحكم فحوصات اتساق بيانات التحقق من الهوية. | قابل للتهيئة — لا إجراء (No action)، أو مراجعة (Review)، أو رفض (Decline). | تعامل معها كحالة تلاعب ما لم يثبت العكس؛ وعادةً ما يتم ضبط الإعداد على الرفض (Decline). يتضمن payload الخاص بـ `additional_data` أسطر OCR MRZ (`ocr_mrz`، مصفوفة) و MRZ الخاص بالشريحة (`nfc_mrz`، سلسلة نصية واحدة) للمقارنة اليدوية. |
| `DSC_CERTIFICATE_REVOKED` | تظهر شهادة مُوقّع المستند (DSC) التي وقّعت هذه الشريحة في قائمة إلغاء الشهادات (CRL) الخاصة بدولة الإصدار. | دائماً `information`. | لا — لا يغير حالة NFC بمفرده أبداً. | إشارة قوية على أن مفتاح التوقيع ربما تم اختراقه؛ وجّه هذه الجلسات إلى مراجعة يدوية عبر المنطق الخاص بك إذا لزم الأمر. تجدر الإشارة إلى أن الشريحة ستؤدي عادةً أيضاً إلى تشغيل `NFC_CHIP_NOT_VERIFIED`، وهو أمر قابل للتهيئة. |
| `DSC_CERTIFICATE_EXPIRED` | انقضت فترة صلاحية DSC (أي أن `certificate_summary.validation.dsc_expired` قيمته `true`). | دائماً `information`. | لا — لا يغير حالة NFC بمفرده أبداً. | أمر شائع مع المستندات القديمة. وكما هو الحال مع الإلغاء، تفشل شهادة DSC منتهية الصلاحية أيضاً في التحقق الكامل من SOD، لذا يتم تشغيل `NFC_CHIP_NOT_VERIFIED` جنباً إلى جنب معها ويطبق الإجراء الذي قمت بتهيئته. |
| `JPKI_CERTIFICATE_INVALID` | بطاقة My Number Card اليابانية: شهادة مقروءة من البطاقة لا ترتبط بسلسلة هيئة مصادقة JPKI من نوعها، أو تقع خارج فترة صلاحيتها، أو ليست شهادة My Number Card من ذلك النوع. يسرد `additional_data.certificate_types` الشهادات التي فشلت؛ ويوضح `jpki.certificates[].failure` السبب. | يتبع `jpki_certificate_invalid_action` (افتراضياً الرفض Decline). | قابل للتهيئة: لا إجراء (No action)، أو مراجعة (Review)، أو رفض (Decline). | تعامل معها كبطاقة غير صالحة أو تم التلاعب بها. تندرج شهادة البطاقة منتهية الصلاحية هنا أيضاً: يقوم حاملها بتجديدها لدى بلديته. |
| `JPKI_SIGNATURE_INVALID` | بطاقة My Number Card اليابانية: لا يتم التحقق من توقيع البطاقة على التحدي المخصص لمرة واحدة مقابل شهادتها، وبالتالي لا يتم إثبات حيازة البطاقة ومعرفة رقم PIN الخاص بها. يتم إطلاقه أيضاً عندما تنتهي خطوة NFC دون قراءة أي بطاقة (تكون قيمة `additional_data.certificate_types` فارغة حينها). | يتبع `jpki_signature_invalid_action` (افتراضياً الرفض Decline). | قابل للتهيئة: لا إجراء (No action)، أو مراجعة (Review)، أو رفض (Decline). | لا تقبل قراءة البطاقة كإثبات. اطلب من الشخص إعادة المحاولة باستخدام البطاقة الفعلية. |
| `JPKI_CERTIFICATE_REVOKED` | بطاقة My Number Card اليابانية: يبلغ فحص الإلغاء عن شهادة ملغاة، على سبيل المثال بسبب الإبلاغ عن فقدان البطاقة أو تغيير تسجيل حاملها (`jpki.revocation_status` تكون `revoked`). | يتبع `jpki_certificate_revoked_action` (افتراضياً الرفض Decline). | قابل للتهيئة: لا إجراء (No action)، أو مراجعة (Review)، أو رفض (Decline). | لا تقبل البطاقة. |
| `JPKI_REVOCATION_UNCHECKED` | بطاقة My Number Card اليابانية: تم التحقق من الشهادات والتوقيع، ولكن لم تتوفر استجابة للإلغاء (`jpki.revocation_status` تكون `unchecked`)، لذلك لا يمكن استبعاد كون البطاقة ملغاة. لا يتم إطلاقه عندما تكون السلسلة أو التوقيع قد فشلا بالفعل. | يتبع `jpki_revocation_unchecked_action` (افتراضياً مراجعة Review). | قابل للتهيئة: لا إجراء (No action)، أو مراجعة (Review)، أو رفض (Decline). | حدد مدى قيمة البطاقة التي تم التحقق منها دون استجابة إلغاء بالنسبة لك، واضبط الإجراء وفقاً لذلك. |
| `JPKI_AND_OCR_DATA_NOT_SAME` | بطاقة My Number Card اليابانية: يختلف الاسم، أو تاريخ الميلاد، أو الجنس، أو العنوان في شهادة التوقيع عن البيانات المقروءة من صورة نفس البطاقة. يحدد `additional_data.fields` السمات التي تختلف، دون ذكر قيمها مطلقاً. | يتبع `jpki_inconsistent_data_action` (افتراضياً مراجعة Review). | قابل للتهيئة: لا إجراء (No action)، أو مراجعة (Review)، أو رفض (Decline). | قارن `jpki.attributes` ببيانات التحقق من الهوية قبل اتخاذ القرار. قد يختلف الاسم الذي يحتوي على حرف غير شائع لأن الشهادة تحتوي على حرف بديل (`jpki.attributes.name_substitute_characters`). |

> [!NOTE]
>
> يتنافى `SKIPPED_NFC_VALIDATION` مع `NFC_CHIP_NOT_VERIFIED` و`NFC_TRUST_ANCHOR_MISSING`: لا يتم تقييم تحذيرات التحقق من الشريحة إلا عندما لا يتم تخطي قراءة الشريحة. كما أن تحذيري التحقق من الشريحة متنافيان أيضاً.

## سلاسل الوصف الدقيقة

تُرجع API سلاسل `short_description` و`long_description` الدقيقة هذه لكل خطر:

| `risk` | `short_description` | `long_description` |
| - | - | - |
| `SKIPPED_NFC_VALIDATION` | تخطي التحقق عبر NFC | يختلف حسب السبب — راجع [أسباب التخطي](#أسباب-التخطي). يعود إلى "لم تكتمل عملية التحقق من شريحة الاتصال قريب المدى (NFC)، وقد يكون ذلك بسبب مشكلات فنية أو عدم توفر دعم NFC." في الجلسات القديمة المسجلة قبل وجود أسباب التخطي. |
| `NFC_CHIP_NOT_VERIFIED` | لم يتم التحقق من شريحة NFC | فشلت شريحة الاتصال قريب المدى (NFC) في المصادقة السلبية لسبب آخر غير عدم توفر مرسى ثقة محدد بوضوح. قد تكون بيانات الشريحة أو التوقيع غير صالحة أو تم التلاعب بها. |
| `NFC_TRUST_ANCHOR_MISSING` | مرسى الثقة لـ NFC غير متوفر | تعذر التحقق من شريحة الاتصال قريب المدى (NFC) لأن مرسى الثقة لهيئة التصديق لتوقيع الدولة (CSCA) التابعة لدولة الإصدار غير متوفر. هذه فجوة في تغطية مخزن الثقة، وليست دليلاً على التلاعب بالشريحة. |
| `NFC_AND_OCR_DATA_NOT_SAME` | بيانات NFC وOCR غير متطابقة | لا تتطابق بيانات شريحة الاتصال قريب المدى (NFC) وبيانات OCR، مما يشير إلى احتمال التلاعب بالمستند أو عدم اتساق البيانات. |
| `DSC_CERTIFICATE_REVOKED` | تم إلغاء شهادة موقّع المستند | تم إلغاء شهادة موقّع المستند (DSC) المستخدمة لتوقيع بيانات شريحة جواز السفر الإلكتروني بواسطة قائمة إلغاء الشهادات (CRL) التابعة لدولة الإصدار، مما يشير إلى احتمال اختراق مفتاح التوقيع. |
| `DSC_CERTIFICATE_EXPIRED` | انتهت صلاحية شهادة موقّع المستند | انتهت صلاحية شهادة موقّع المستند (DSC) المستخدمة لتوقيع بيانات شريحة جواز السفر الإلكتروني، مما يعني أن فترة صلاحية الشهادة قد انقضت. |
| `JPKI_CERTIFICATE_INVALID` | شهادة My Number Card غير صالحة | الشهادة المقروءة من شريحة My Number Card غير صالحة: لا تمتد سلسلة الثقة فيها إلى هيئة تصديق البنية التحتية للمفتاح العام اليابانية (JPKI)، أو أنها خارج فترة صلاحيتها، أو أنها ليست شهادة My Number Card من النوع المطلوب. |
| `JPKI_SIGNATURE_INVALID` | توقيع My Number Card غير صالح | التوقيع الذي أنشأته My Number Card على تحدي التحقق لمرة واحدة لا يمكن التحقق منه باستخدام شهادة البطاقة، وبالتالي لم يتم إثبات حيازة البطاقة ومعرفة رمز PIN الخاص بها. |
| `JPKI_CERTIFICATE_REVOKED` | تم إلغاء شهادة My Number Card | يُفيد فحص الإلغاء بأنه تم إلغاء شهادة مقروءة من My Number Card، على سبيل المثال بسبب الإبلاغ عن فقدان البطاقة أو تغيير تسجيل حاملها. |
| `JPKI_REVOCATION_UNCHECKED` | لم يتم التحقق من حالة إلغاء My Number Card | تم التحقق من شهادة وتوقيع My Number Card، ولكن تعذر التحقق من حالة إلغائها، لذا لا يمكن استبعاد كون البطاقة ملغاة. |
| `JPKI_AND_OCR_DATA_NOT_SAME` | بيانات شريحة My Number Card وOCR غير متطابقة | الاسم أو تاريخ الميلاد أو الجنس أو العنوان في شهادة توقيع My Number Card لا يتطابق مع البيانات المقروءة من صورة البطاقة (OCR)، مما يشير إلى احتمال استبدال أو عدم اتساق في البيانات. |

## أسباب التخطي

تحمل تحذيرات `SKIPPED_NFC_VALIDATION` الحقل `additional_data.skip_reason`، وهو أحد سبعة رموز ثابتة توضح بدقة سبب عدم تشغيل NFC (في الجلسات المسجلة قبل وجود أسباب التخطي، قد تكون قيمة `additional_data` هي `null` — تعامل مع الحقل على أنه اختياري عند معالجة القرارات السابقة). يظهر التصنيف نفسه على مستوى الجلسة كـ `nfc_skip_reason` في payload القرار — بما في ذلك الجلسات التي تعذر فيها تشغيل NFC على الإطلاق (مستند بدون شريحة، أو تكامل عبر الويب) وبالتالي لا يوجد لها تقرير أو تحذير NFC.

| `skip_reason` | المعنى | `long_description` |
| - | - | - |
| `USER_SKIPPED` | عُرض التحقق عبر NFC على جهاز متوافق واختار المستخدم تخطيه. | عُرضت خطوة قراءة شريحة NFC على جهاز متوافق، لكن المستخدم اختار تخطيها (التخطي مسموح به وفقاً لتكوين سير العمل). |
| `DOCUMENT_WITHOUT_CHIP` | لا يحتوي تصميم المستند على شريحة NFC قابلة للقراءة (ليس مستنداً إلكترونياً متوافقاً مع ICAO 9303). | تعذر إجراء التحقق عبر NFC لأن هذا المستند لا يحتوي على شريحة NFC قابلة للقراءة: فهو ليس مستنداً إلكترونياً متوافقاً مع ICAO 9303. |
| `CHIP_CERTIFICATE_UNAVAILABLE` | الشريحة موجودة، لكن لا توجد شهادة توقيع من دولة الإصدار (CSCA) تغطي فترة إصدار المستند، لذا لا يمكن التحقق من التوقيع. | تعذر إجراء التحقق عبر NFC لأن شهادة التوقيع الخاصة بدولة الإصدار (CSCA) التي تغطي فترة إصدار هذا المستند غير متوفرة، لذا لا يمكن التحقق من توقيع الشريحة. |
| `DEVICE_WITHOUT_NFC` | أبلغت حزمة SDK الأصلية أن الهاتف لا يحتوي على قارئ NFC متاح. | تعذر إجراء التحقق عبر NFC لأن جهاز المستخدم أبلغ أنه لا يحتوي على قارئ NFC متاح. |
| `INTEGRATION_WITHOUT_NFC_ACCESS` | تم تشغيل التحقق بدون حزمة SDK أصلية (على سبيل المثال في متصفح ويب)، والتي لا تملك وصولاً إلى قارئ NFC بالهاتف. | تعذر إجراء التحقق عبر NFC لأن التحقق لم يعمل عبر حزمة SDK أصلية للهاتف المحمول، وبالتالي لم يكن هناك وصول إلى قارئ NFC بالهاتف (لا يمكن لمتصفحات الويب قراءة شرائح NFC). |
| `MRZ_KEY_UNAVAILABLE` | تعذر اشتقاق مفتاح الوصول إلى الشريحة (بذرة BAC/PACE) من منطقة القراءة الآلية (MRZ) الخاصة بالمستند. | تعذر إجراء التحقق عبر NFC لتعذر اشتقاق مفتاح الوصول إلى الشريحة من منطقة القراءة الآلية (MRZ) الخاصة بالمستند. |
| `JPKI_UNAVAILABLE` | المستند عبارة عن بطاقة My Number يابانية، وتتم قراءة شريحتها عبر JPKI، ولم تكن JPKI متاحة لعملية التحقق هذه: فهي غير مُمكّنة، أو أن إصدار حزمة SDK الأصلية للتطبيق لا يمكنه قراءة بطاقات My Number. تحصل بطاقة My Number التي تم التحقق منها في متصفح على `INTEGRATION_WITHOUT_NFC_ACCESS`، بينما تحصل البطاقة على هاتف لا يدعم NFC على `DEVICE_WITHOUT_NFC`، كما هو الحال مع أي شريحة. | تعذر إجراء التحقق عبر NFC لأن بطاقة My Number هذه تُقرأ عبر JPKI، والتي لم تكن متاحة لعملية التحقق هذه: فهي غير مُمكّنة، أو أن حزمة SDK الخاصة بالتطبيق لا يمكنها قراءة بطاقات My Number. |

> [!NOTE]
>
> لا يوجد تقرير NFC وتحذير `SKIPPED_NFC_VALIDATION` الخاص به إلا عندما يصل العميل إلى خطوة NFC ويتخطاها صراحةً (عادةً `USER_SKIPPED`، أو `DEVICE_WITHOUT_NFC` عندما يتضح أن القارئ غير متاح في وقت المسح). عندما يتم تجاوز خطوة NFC قبل أن يتسنى عرضها على الإطلاق — مستند بدون شريحة، أو شهادة مفقودة، أو عدم الإبلاغ عن إمكانية NFC، أو مفتاح MRZ غير قابل للقراءة، أو عدم توفر JPKI — لا يتم إنشاء أي تقرير أو تحذير ويظهر السبب فقط في حقل `nfc_skip_reason` على مستوى الجلسة، دون التأثير على حالة الجلسة.

## التكوين

تتحكم ثلاثة إعدادات في سير العمل في كيفية توجيه تحذيرات NFC. يمكن تعيين كل منها إلى **لا يوجد إجراء**، أو **المراجعة**، أو **رفض**:

1. **إجراء تخطي NFC** (`skip_nfc_action`) — ينطبق على `SKIPPED_NFC_VALIDATION`. لا يُعرض التخطي على المستخدمين إلا عند تمكين `allow_nfc_skip`.
2. **إجراء الشريحة غير المتحقق منها** (`unverified_chip_action`) — ينطبق على كل من `NFC_CHIP_NOT_VERIFIED` و`NFC_TRUST_ANCHOR_MISSING`، بحيث يظل سلوك حالة الجلسة كما هو بينما يوضح رمز المخاطر سبب فشل التحقق.
3. **إجراء عدم تطابق البيانات** (`inconsistent_data_action`) — ينطبق على `NFC_AND_OCR_DATA_NOT_SAME`. هذا هو نفس إعداد عدم تطابق البيانات المستخدم في التحقق من الهوية.

لا يحتوي الخطَران `DSC_CERTIFICATE_*` على إعداد إجراء — فهما دائماً لأغراض معلوماتية فقط. تحتوي مخاطر بطاقة My Number اليابانية على خمسة إعدادات إضافية، مذكورة في القسم التالي.

## بطاقة My Number اليابانية (JPKI)

تتم قراءة بطاقة My Number اليابانية عبر JPKI بدلاً من ICAO 9303 (`chip_protocol: "jpki"`)، لذا لا تُفعَّل مخاطر ICAO المذكورة أعلاه معها مطلقاً. وتثير قراءتها هذه المخاطر الخمسة بدلاً من ذلك، ولكل منها إعدادها الخاص في عقدة NFC:

| الإعداد | الخطر | الافتراضي |
| - | - | - |
| `jpki_certificate_invalid_action` | `JPKI_CERTIFICATE_INVALID` | رفض |
| `jpki_signature_invalid_action` | `JPKI_SIGNATURE_INVALID` | رفض |
| `jpki_certificate_revoked_action` | `JPKI_CERTIFICATE_REVOKED` | رفض |
| `jpki_revocation_unchecked_action` | `JPKI_REVOCATION_UNCHECKED` | المراجعة |
| `jpki_inconsistent_data_action` | `JPKI_AND_OCR_DATA_NOT_SAME` | المراجعة |

تؤدي قراءة بطاقة My Number المتخطاة إلى إثارة `SKIPPED_NFC_VALIDATION` وتتبع `skip_nfc_action`، تماماً مثل أي شريحة. راجع [بطاقة My Number اليابانية (JPKI)](https://docs.didit.me/ar/core-technology/nfc-verification/overview.md#بطاقة-ماي-نمبر-اليابانية-jpki) لمعرفة كيفية عمل القراءة.

> [!WARNING]
>
> قراءة بطاقة My Number عبر JPKI غير مُمكّنة في الإنتاج بعد. وإلى أن يتم ذلك، تتخطى بطاقة My Number خطوة NFC مع سبب التخطي `JPKI_UNAVAILABLE` ولا يُثار أي من هذه المخاطر.

## أمثلة

### قيد المراجعة — تعذر التحقق من الشريحة

```json theme={null}
{
  "warnings": [
  {
    "feature": "NFC",
    "risk": "NFC_CHIP_NOT_VERIFIED",
    "additional_data": null,
    "log_type": "warning",
    "short_description": "NFC chip not verified",
    "long_description": "The Near Field Communication (NFC) chip failed passive authentication for a reason other than an explicitly identified missing trust anchor. The chip data or signature could be invalid or altered.",
    "node_id": "nfc_primary"
  },
  {
    "feature": "NFC",
    "risk": "DSC_CERTIFICATE_EXPIRED",
    "additional_data": null,
    "log_type": "information",
    "short_description": "Document Signer Certificate expired",
    "long_description": "The Document Signer Certificate (DSC) used to sign the ePassport chip data has expired, meaning the certificate's validity period has passed.",
    "node_id": "nfc_primary"
  }
]
}
```

هنا تم ضبط إجراء الشريحة غير المتحقق منها على Review، لذا يحمل `NFC_CHIP_NOT_VERIFIED` القيمة `log_type: "warning"` وتكون حالة تقرير NFC هي `In Review`. ويُعد إدخال شهادة DSC منتهية الصلاحية إعلامياً بحتاً.

### مرفوضة — عدم تطابق بين الشريحة وOCR

```json theme={null}
{
  "warnings": [
  {
    "feature": "NFC",
    "risk": "NFC_AND_OCR_DATA_NOT_SAME",
    "additional_data": {
      "ocr_mrz": ["P<ESPDOE<<JOHN<<<<<<<<<<<<<<<<<<<<<<<<<<<<<", "AAB000123ESP9005154M3001017<<<<<<<<<<<<<<04"],
      "nfc_mrz": "P<ESPDOE<<JOHN<<<<<<<<<<<<<<<<<<<<<<<<<<<<<AAB000254ESP9005154M3001017<<<<<<<<<<<<<<06"
    },
    "log_type": "error",
    "short_description": "NFC and OCR data not same",
    "long_description": "The Near Field Communication (NFC) chip data and the OCR data don't match, indicating potential document tampering or data inconsistency.",
    "node_id": "nfc_primary"
  }
]
}
```

هنا تم ضبط إجراء عدم اتساق البيانات على Decline، لذا يحمل التحذير القيمة `log_type: "error"` وتكون حالة تقرير NFC هي `Declined`. لاحظ أن `ocr_mrz` عبارة عن مصفوفة من أسطر MRZ بينما `nfc_mrz` هو سلسلة MRZ نصية واحدة مدمجة خاصة بالشريحة.

### قيد المراجعة: بطاقة My Number دون إجابة بشأن الإلغاء

```json theme={null}
{
  "warnings": [
  {
    "feature": "NFC",
    "risk": "JPKI_REVOCATION_UNCHECKED",
    "additional_data": null,
    "log_type": "warning",
    "short_description": "My Number Card revocation status not checked",
    "long_description": "The certificate and signature of the My Number Card were verified, but its revocation status could not be checked, so a revoked card cannot be ruled out.",
    "node_id": "nfc_primary"
  }
]
}
```

هنا يحتفظ `jpki_revocation_unchecked_action` بقيمته الافتراضية، Review، لذا يحمل التحذير القيمة `log_type: "warning"` وتكون حالة تقرير NFC هي `In Review`. وقد تم إثبات صحة البطاقة نفسها: كلٌّ من `jpki.chain_valid` و`jpki.signature_valid` يحملان القيمة `true`.

## أنواع التحذيرات

يتم تعيين مستوى خطورة لكل خطر بناءً على تهيئة تطبيقك. ومستويات الخطورة الثلاثة هي:

## مواضيع ذات صلة

* [تقرير NFC](https://docs.didit.me/ar/core-technology/nfc-verification/report-nfc-verification.md) — مخطط التقرير الكامل وحالاته.
* [Webhooks](https://docs.didit.me/ar/integration/webhooks.md) — يتم إطلاق `status.updated` عند تغيير حالة الجلسة؛ ويتم إرفاق payload القرار (بما في ذلك تحذيرات NFC) عندما تصل الجلسة إلى Approved أو Declined أو In Review أو Abandoned.
* [نماذج البيانات — التحقق عبر NFC](https://docs.didit.me/ar/reference/data-models.md#التحقق-عبر-nfc) — المخطط المرجعي حقلاً بحقل.
* [نماذج البيانات — كائن التحذير](https://docs.didit.me/ar/reference/data-models.md#كائن-التحذير) — بنية كل إدخال في `warnings[]`.


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