تجاوز إلى المحتوى الرئيسي
الإصدار: 1.x

PAYMENT999: خطأ دفع غير متوقع

ماذا يعني هذا

واجهت معالجة الدفع مشكلة غير متوقعة.

تأكد مما إذا كانت الدفعة قد تمت قبل إعادة المحاولة. صدّر التشخيصات وتواصل مع الدعم إذا كان الأمر غير واضح.

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

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

بياناتك

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

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

  1. تأكد مما إذا كانت الدفعة قد تمت قبل إعادة المحاولة: شاشة جهاز الدفع، ولوحة تحكم المزوّد، والطلب في WP Admin.
  2. وسّع إدخال السجل للاطلاع على رمز الحدث والسياق — فهذا الرمز العام يعني أن السبب ليس له رمز مخصص بعد.
  3. إذا ظلت النتيجة غير واضحة أو تكرر الرمز، فصدّر معلومات التصحيح وتواصل مع الدعم.

أين تبحث

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

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

  • لوحة تحكم مزوّد الدفع: سجل مزوّد جهاز الدفع نفسه (على سبيل المثال Stripe Dashboard → Payments، أو لوحة تحكم Square) هو المرجع الحاسم لمعرفة ما إذا كانت عملية الخصم قد تمت — راجعه قبل إعادة محاولة أي دفعة.
  • فاحص الشبكة (Network) (الويب وسطح المكتب): افتح أدوات المطوّر — اضغط F12 في المتصفح، أو متقدّم → تبديل أدوات المطوّر في قائمة تطبيق سطح المكتب — ثم اختر تبويب Network. اتبع إرشادات إعادة المحاولة الواردة في هذه الصفحة أولًا؛ ولا تُعِد تنفيذ الإجراء إلا عندما تؤكد تلك الخطوات أن ذلك آمن. ويعرض الطلب الفاشل حالة HTTP ونص الاستجابة الخام، بما في ذلك صفحات الأخطاء التي لا تصل إلى سجل POS أبدًا.

التفاصيل

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