CHECKOUT101: فشل إتمام البيع مع سلامة السلة

ماذا يعني هذا

لم يكتمل إتمام البيع، ولا تزال السلة سليمة لإعادة المحاولة.

راجع السلة وأعد محاولة إتمام البيع؛ فمحتويات السلة الحالية محفوظة.

ما الذي ينبغي فعله

جرّب الإجراء مرة أخرى. لا يعيد WCPOS محاولة هذا من تلقاء نفسه — أعد المحاولة عندما تكون مستعدًا.

بياناتك

الطلب نفسه سليم ولم يتغير.

استكشاف الأخطاء

1. راجع السلة — فهي لم تتغير — ثم جرّب إتمام البيع مرة أخرى.
2. إذا فشل بالطريقة نفسها، فوسّع إدخال السجل: إذ يبيّن serverCode والحالة ما إذا كان المتجر قد رفض الطلب ولماذا.
3. العطل المتكرر بحالة من فئة 500 هو مشكلة في الموقع — راجع WooCommerce → الحالة → السجلات بحثًا عن خطأ PHP في وقت حدوث العطل.
4. إذا حدد السبب بندًا معينًا، فأزله، وأتمم عملية البيع، ثم تحقق من ذلك المنتج بعد ذلك.

أين تبحث

عندما يتمكن WCPOS من حفظ هذا الخطأ، يُسجَّل على الجهاز الذي أثاره. افتح صحة المتجر → السجلات (رمز نبض القلب أسفل درج التنقل)، وابحث عن الإدخال المعلَّم بهذا الرمز ووسّعه: يعرض الصف الموسّع السبب بلغة واضحة والسياق الذي التُقط لحظة حدوث العطل. وفي حالة طلب موجّه إلى المتجر، قد يشمل ذلك السياق رمز الخطأ الخاص بالخادم (serverCode)، أو حالة HTTP (status)، أو نقطة النهاية (endpoint)؛ وتعتمد الحقول المعروضة على موضع حدوث العطل. وعند الإبلاغ عن مشكلة، استخدم نسخ معلومات التصحيح أعلى شاشة السجلات (مشاركة معلومات التصحيح على الهواتف والأجهزة اللوحية) بدلًا من لقطات الشاشة: فهي تجمع إصدار التطبيق وحالة الاتصال وأحدث الأخطاء. وتُحفظ السجلات لمدة أقصاها 30 يومًا، لذا اجمعها بينما المشكلة لا تزال حديثة. وانسخ أيضًا أي خطأ في وحدة تحكم المتصفح ظهر قبل أن يتمكن POS من كتابة إدخال السجل الخاص به.

إلى جانب السجل داخل التطبيق، قد يترك هذا العطل أثرًا في:

• فاحص الشبكة (Network) (الويب وسطح المكتب): افتح أدوات المطوّر — اضغط F12 في المتصفح، أو متقدّم → تبديل أدوات المطوّر في قائمة تطبيق سطح المكتب — ثم اختر تبويب Network. اتبع إرشادات إعادة المحاولة الواردة في هذه الصفحة أولًا؛ ولا تُعِد تنفيذ الإجراء إلا عندما تؤكد تلك الخطوات أن ذلك آمن. ويعرض الطلب الفاشل حالة HTTP ونص الاستجابة الخام، بما في ذلك صفحات الأخطاء التي لا تصل إلى سجل POS أبدًا.
• سجلات POS على الخادم: في WP Admin، افتح POS → الإعدادات → الأدوات → السجلات. تسجّل هذه الصفحة التحذيرات والأخطاء المتعلقة بـ POS التي تنشأ على الخادم نفسه، وقد لا تظهر داخل التطبيق أبدًا. وتعني الشارة الحمراء على القائمة وجود أخطاء غير مقروءة على الخادم.
• WooCommerce → الحالة → السجلات: في موقع WordPress، راجع أحدث ملف fatal-errors-*.log بحثًا عن أعطال PHP، إضافة إلى أي مصدر سجل يحمل اسم إضافة متورطة في العطل. فالخطأ من فئة 500 القادم من المتجر يترك سببه هنا في معظم الحالات.

التفاصيل

• الرمز: CHECKOUT101 (CHECKOUT_FAILED_CART_SAFE)
• الخطورة: خطأ
• أُضيف في: WCPOS 1.10.0