VibeFox PayPlug for OpenCart — المساعدة

المتطلبات

OpenCart: ‏3.0.x (تم اختباره على 3.0.5.0) أو 4.0.2 وما بعده (تم اختباره على 4.1.0.3).

PHP: ‏8.0 أو أحدث.

العملة والمبالغ: اليورو (EUR)، من 0.99 إلى 20,000.00 لكل دفعة، وهي القيم الافتراضية لـ PayPlug. يجب تفعيل اليورو في System > Localisation > Currencies واختياره من قِبل العميل. مع عملة دفع أخرى أو خارج هذه الحدود تُخفى طريقة الدفع.

حساب PayPlug: تحتاج إلى المفاتيح السرية لحساب PayPlug: مفتاح الاختبار (sk_test_...) و/أو مفتاح الإنتاج (sk_live_...). لا حاجة إلى مفاتيح أخرى، ولا يلزم إعداد أي إشعار في PayPlug. يجب أن يكون متجرك متاحًا من الإنترنت لاستلام الإشعارات؛ وإلا تُؤكَّد الطلبات عندما يعود العميل من PayPlug.

مفتاح ترخيص VibeFox: يُشترى من vibefox.net. يعمل المفتاح الواحد على نطاق واحد.

التثبيت

التنزيل ملف zip واحد يحتوي على الحزم لكلا إصدارَي OpenCart. فُكّ ضغطه على حاسوبك. يحتوي على README.txt، وحزمة OpenCart 3 wcp_payplug_gateway-oc3-(version).ocmod.zip، وحزمة OpenCart 4 wcp_payplug_gateway.ocmod.zip. ثبّت الحزمة الخاصة بإصدار OpenCart لديك فقط. مفتاح الترخيص هو نفسه لكلا الإصدارين.

OpenCart 3

1. في لوحة الإدارة، انتقل إلى Extensions > Installer، وانقر على Upload، ثم اختر الملف wcp_payplug_gateway-oc3-(version).ocmod.zip. لا تحتوي الإضافة على تعديلات OCMOD، لذلك لا يلزم تحديث Extensions > Modifications. وبدلًا من المثبّت، يمكنك نسخ محتويات المجلد upload الموجود في هذه الحزمة إلى المجلد الجذري لمتجرك.

2. انتقل إلى Extensions > Extensions واختر النوع Payments. ابحث عن VibeFox PayPlug Gateway وانقر على Install (الزر الأخضر +). يحتاج مستخدم المدير لديك إلى صلاحية تعديل قائمة إضافات الدفع.

3. انقر على Edit (زر القلم) لفتح صفحة الإعدادات. أدخل مفتاح ترخيص VibeFox في الحقل License key الموجود في كتلة الترخيص أعلى الصفحة، ثم انقر على Activate (انظر مفتاح الترخيص).

4. الصق مفاتيحك السرية من بوابة PayPlug (انظر الإعدادات).

5. فعّل Enable/Disable وانقر على Save. اختبر دفعة مع تفعيل Test Mode، ثم أوقفه لقبول المدفوعات الحقيقية.

OpenCart 4

1. في لوحة الإدارة، انتقل إلى Extensions > Installer، وانقر على Upload، ثم اختر الملف wcp_payplug_gateway.ocmod.zip. لا تُغيّر اسم الملف: يأخذ OpenCart 4 رمز الإضافة من اسم الملف، والحزمة التي يُغيَّر اسمها لا تعمل.

2. تظهر الحزمة في قائمة الإضافات المثبّتة في الصفحة نفسها. انقر على Install (الزر الأخضر +) بجانبها.

3. انتقل إلى Extensions > Extensions واختر النوع Payments. ابحث عن VibeFox PayPlug Gateway، وانقر على Install (الزر الأخضر +)، ثم على Edit (زر القلم).

4. أدخل مفتاح الترخيص والمفاتيح السرية لـ PayPlug كما في الخطوات من 3 إلى 5 لـ OpenCart 3. صفحة الإعدادات وحقولها متطابقة في الإصدارين. الفرق الوحيد هو عنوان الإشعار (انظر الإشعارات).

تبدأ عملية التثبيت الجديدة وطريقة الدفع معطّلة ووضع الاختبار مفعّلًا.

الإعدادات

جميع الإعدادات موجودة في صفحة الإضافة: Extensions > Extensions > Payments > VibeFox PayPlug Gateway > Edit. تُدرج الأقسام على اليسار؛ وزر Save أسفل القائمة يحفظ الصفحة بأكملها. وفوق الإعدادات تُظهر الصفحة تحذيرًا عندما تكون طريقة الدفع مفعّلة لكن المفتاح السري للوضع الحالي فارغ، وعندما لا تكون العملة الافتراضية للمتجر هي EUR. وفي كلتا الحالتين تُخفى طريقة الدفع عند الدفع (مع عملة افتراضية أخرى، ما دامت تلك العملة مختارة). وبدون صلاحية تعديل الإضافة تعرض الصفحة الإعدادات لكنها لا تستطيع حفظها.

عند الحفظ، يجب أن يكون Title بين 1 و128 حرفًا، ويجب أن يكون Sort Order عددًا صحيحًا، ويجب أن يكون Total رقمًا يساوي 0 أو أكبر، ويجب أن تكون حالات الطلب موجودة؛ وإلا لا يُحفظ شيء وتعرض الصفحة الأخطاء. لا يُحفظ المفتاح السري ذو التنسيق الخاطئ، لكن الإعدادات الأخرى تُحفظ: تعرض الصفحة Settings saved, except the secret key shown in red. وعلى سبيل المثال Test Secret Key must start with "sk_test_". The previous value was kept.

Checkout

Enable/Disable: Enable PayPlug Gateway يفعّل طريقة الدفع أو يوقفها. الافتراضي: معطّل.

Title: اسم طريقة الدفع الذي يراه العملاء عند الدفع. وهو أيضًا اسم طريقة الدفع المحفوظ في الطلب. الافتراضي: PayPlug. مطلوب، حتى 128 حرفًا.

Description: النص الذي يراه العميل في خطوة Confirm Order، فوق زر التأكيد. الافتراضي: Pay securely by card via PayPlug.

Sort Order: موضع PayPlug بين طرق الدفع عند الدفع. اتركه فارغًا أو أدخل عددًا صحيحًا.

Geo Zone: اعرض PayPlug فقط لعناوين الدفع الواقعة في المنطقة الجغرافية المختارة. الافتراضي: All zones. تُعدّ المناطق الجغرافية في System > Localisation > Geo Zones.

Total: إجمالي الدفع، بعملة المتجر الافتراضية، الذي يجب أن يبلغه الطلب قبل عرض PayPlug. اتركه فارغًا لعرض PayPlug لأي إجمالي. يقبل PayPlug بذاته من 0.99 إلى 20,000.00 EUR لكل دفعة.

مفاتيح API

اعثر على مفاتيحك السرية في بوابة PayPlug، ضمن Developers > API keys. يحتوي هذا القسم على رابط إلى البوابة.

Test Mode: يستخدم المفتاح السري للاختبار للدفعات الجديدة. لا تُعالج أي دفعة حقيقية. تواصل الدفعات التي تمت في الوضع الآخر استخدام مفتاح وضعها للتحقق من الحالة وللاستردادات. الافتراضي: مفعّل. وطالما هو مفعّل يرى العميل Test mode: no real payment will be made. في خطوة Confirm Order.

Test Secret Key: مفتاحك السري للاختبار في PayPlug. يبدأ بـ sk_test_.

Live Secret Key: مفتاحك السري للإنتاج في PayPlug. يبدأ بـ sk_live_.

لا تُعرض المفاتيح المحفوظة مرة أخرى. يبقى الحقل فارغًا ويعرض Saved — leave empty to keep it. أدخل قيمة جديدة فقط إذا أردت تغييرها. لحذف مفتاح محفوظ، فعّل Clear the saved key on save أسفل الحقل، ثم انقر على Save.

الإشعارات

Notification URL: العنوان الذي ترسله الإضافة إلى PayPlug مع كل دفعة. في OpenCart 3 يبدو هكذا: https://your-store/index.php?route=extension/payment/wcp_payplug_gateway/webhook، وفي OpenCart 4: https://your-store/index.php?route=extension/wcp_payplug_gateway/payment/wcp_payplug_gateway.webhook. ويُبنى من عنوان الواجهة الأمامية لتثبيت OpenCart الخاص بك. لا يلزم إدخال أي شيء في بوابة PayPlug. يُتحقق من كل إشعار بقراءة الدفعة مرة أخرى من واجهة PayPlug البرمجية، لذلك تُؤكَّد الدفعات حتى إذا لم يعد العميل إلى المتجر. يجب أن يكون هذا العنوان متاحًا من الإنترنت؛ وإلا لا تُؤكَّد الطلبات إلا عندما يعود العميل من PayPlug.

الطلبات

ينشئ OpenCart الطلب في خطوة Confirm Order بدون حالة (طلب مفقود). لا يحصل الطلب على حالة إلا بعد أن تُبلغ PayPlug عن الدفعة، سواء بالإشعار أو بعودة العميل؛ وتُقرأ الدفعة دائمًا من PayPlug. يسرد كل حقل أدناه حالات طلبات OpenCart لديك.

Order Status After Payment: الحالة التي تُعيَّن بعد نجاح الدفع، مثل Processing أو Complete. الافتراضي: Processing.

PayPlug Payment On Hold Status: تحتاج الدفعة إلى مراجعتك (انظر حالات الطلب). الافتراضي: Pending، لأن OpenCart لا يملك حالة On hold. يمكنك إنشاء حالتك الخاصة في System > Localisation > Order Statuses واختيارها هنا.

Payment Error Status: فشلت الدفعة المعتمدة لطلب معلّق أو أُلغيت. الافتراضي: Failed.

Refunded Status: تُعيَّن بعد استرداد الدفعة بالكامل من صفحة الطلب. الافتراضي: Refunded.

متقدم

Logging: يسجّل استدعاءات API والإشعارات في ppg_debug.log.php داخل مجلد السجلات في OpenCart (storage/logs). لا يمكن فتح الملف من الويب. تُسجَّل الأخطاء والتحذيرات دائمًا. لا تُسجَّل المفاتيح السرية وبيانات البطاقة وبيانات العميل أبدًا. الافتراضي: معطّل.

Log: يعرض حجم السجل وآخر إدخالاته. انقر على Clear log لتفريغه.

Delete Data on Uninstall: عند التفعيل، تُحذف إعدادات الإضافة وسجلها عند إلغاء تثبيتها. تبقى سجلات الدفع والاسترداد في PayPlug الخاصة بالطلبات محفوظة دائمًا. الافتراضي: معطّل.

الاستيراد / التصدير

Export: يحفظ Download JSON الإعدادات في ملف JSON. لا تُصدَّر المفاتيح السرية.

Import: ألصق ملف JSON مُصدَّرًا سابقًا وانقر على Import لاستعادة الإعدادات. تبقى المفاتيح السرية المحفوظة كما هي.

الدفع

في خطوة Payment Method يختار العميل طريقة الدفع (افتراضيًا PayPlug). وفي خطوة Confirm Order يرى العميل وصفك والملاحظة You will be redirected to the secure PayPlug payment page to pay by card.؛ وفي وضع الاختبار يرى أيضًا Test mode: no real payment will be made. وينشئ OpenCart الطلب في هذه الخطوة، ولا يزال بلا حالة. في OpenCart 4 يختار العميل طريقة الدفع بزر Choose في كتلة طريقة الدفع، داخل النافذة Payment method options، وينقر على Confirm Order في أسفل صفحة الدفع. وعندما ينقر العميل على Confirm Order، تنشئ الإضافة دفعة PayPlug بإجمالي الطلب بالسنتات، وتنقل العميل إلى صفحة دفع PayPlug. تُمرَّر عناوين الفوترة والتوصيل والبريد الإلكتروني ولغة الطلب إلى PayPlug. وهناك يدفع العميل بالبطاقة.

بعد الدفع يعود العميل إلى متجرك. لا يُعلَّم الطلب كمدفوع إلا بعد أن تؤكده PayPlug: تقرأ الإضافة الدفعة من واجهة PayPlug البرمجية عند وصول الإشعار وعند عودة العميل. ثم يحصل الطلب على حالته بالطريقة المعتادة في OpenCart، مع رسائل الطلب المعتادة وتحديث المخزون، ويرى العميل صفحة نجاح الطلب في OpenCart مع الرسالة Your payment with PayPlug has been received. وإذا كان الطلب معلّقًا تقول الصفحة We are confirming your payment with PayPlug. The order will be updated automatically — please do not pay again. وإذا كان الطلب في حالة خطأ الدفع تقول الصفحة Your PayPlug payment was not completed. Please contact us about this order. وإذا تعذر الاستعلام من PayPlug عند عودة العميل، تعرض صفحة Payment confirmation النص نفسه "جارٍ التأكيد" وزر Check again؛ ويضبط الإشعار حالة الطلب فور وصوله.

إذا ألغى العميل في صفحة PayPlug، تُغلق صفحة الدفع لدى PayPlug، فلا يمكن دفعها لاحقًا عن طريق الخطأ. يعود العميل إلى الدفع مع رسالة: You cancelled the PayPlug payment. You can try again or choose another payment method. أو The PayPlug payment session has expired. Please try again or choose another payment method. أو The PayPlug payment failed. Please try again or choose another payment method. أو، إذا بقيت الدفعة مفتوحة، Your PayPlug payment was not completed. You can try again or choose another payment method. وتبقى السلة محفوظة. في OpenCart 4 تُعرض هذه الرسائل أعلى صفحة الدفع.

ينشئ OpenCart 3 طلبًا جديدًا في كل مرة تُعرض فيها خطوة Confirm Order، بينما يُحدّث OpenCart 4 طلب الدفع نفسه (المحاولة الجديدة هي دفعة PayPlug جديدة للطلب نفسه)، لذلك تفحص الإضافة أولًا المحاولات السابقة للسلة نفسها. إذا دُفعت إحداها في هذه الأثناء، تُستخدم تلك الدفعة دون إنشاء دفعة جديدة، وينتقل العميل إلى صفحة النجاح. وإذا كانت محاولة هذا الطلب ما تزال مفتوحة بالمبلغ نفسه، تُعاد استخدام صفحة الدفع نفسها. وإلا تُغلق الصفحة القديمة لدى PayPlug وتُنشأ دفعة جديدة. وتبقى الدفعة المتأخرة على صفحة مغلقة مسجلة. يُعامل تغيير السلة، بما في ذلك الكمية الجديدة، كسلة جديدة تحتاج دفعة خاصة بها.

في OpenCart 4 يبقى الطلب في الدفع حتى تُعرض صفحة النجاح. إذا أُغلق هذا الطلب دون دفع في هذه الأثناء (مثلًا ألغيته، أو فشلت دفعته المعتمدة)، يعود العميل إلى الدفع مع الرسالة Your previous order was cancelled or refunded. Please confirm the order again to pay with a new order. وينشئ Confirm Order التالي دفعة لطلب جديد. وإذا كان هذا الطلب قد دُفع لسلة سابقة وتغيّرت السلة منذ ذلك الحين، يعود العميل إلى الدفع، ويدفع Confirm Order التالي طلبًا جديدًا للسلة الحالية. لا يظهر الطلب المغلق أبدًا كمدفوع.

إذا تعذر على PayPlug بدء الدفعة، يبقى العميل في خطوة Confirm Order مع رسالة قصيرة، مثل PayPlug could not accept your billing details (postcode). Please check them and try again. أو The payment provider could not be reached. Please try again in a moment. ويُكتب السبب التقني في السجل.

يعمل الإشعار أيضًا أثناء وضع الصيانة للمتجر، لأن OpenCart يسمح بمرور طلبات إضافات الدفع (في OpenCart 4 تضيف الإضافة إجراء بدء خاصًا بها لهذا الغرض، يسمح أيضًا بعودة العميل من PayPlug).

تُخصم المدفوعات فورًا. لا تتضمن الإضافة أقساط Oney، ولا البطاقات المحفوظة بنقرة واحدة، ولا نموذج الدفع المضمّن، ولا الاشتراكات، ولا الخصم المؤجل.

الطلبات والاسترداد

حالات الطلب

بدون حالة (طلب مفقود): أُرسل العميل إلى PayPlug ولم يدفع، أو لم تؤكد PayPlug الدفعة بعد. في Sales > Orders لا تظهر هذه الطلبات إلا عند ضبط فلتر Order Status على Missing Orders. إذا فشلت الدفعة تُغلق المحاولة ويمكن للعميل الدفع من جديد.

Order Status After Payment (الافتراضي Processing): تم تأكيد الدفعة. تعرض ملاحظة دفعة PayPlug ووضعها.

PayPlug Payment On Hold Status (الافتراضي Pending): المبلغ المدفوع أو العملة يختلفان عن الطلب (ملاحظة amount/currency mismatch)؛ أو جرت دفعة تجريبية بينما المتجر في وضع الإنتاج، لذلك لم يُستلم أي مال؛ أو وصلت الدفعة بعد أن حصل الطلب على حالة أخرى، مثلًا أُلغي؛ أو الدفعة معتمدة لكنها غير محصّلة (حصّلها في بوابة PayPlug؛ يُعلَّم الطلب كمدفوع عندما تُبلغ PayPlug بأنها مدفوعة). تشرح الملاحظة ما يجب فحصه.

Payment Error Status (الافتراضي Failed): فشلت دفعة معتمدة لطلب معلّق أو أُلغيت. يُبلغ OpenCart العميل بهذا التغيير.

Refunded Status (الافتراضي Refunded): استُرجعت الدفعة بالكامل عبر الإضافة.

إذا دُفع طلب آخر من سلة مدفوعة بالفعل، يبقى ذلك الطلب بلا حالة ولا يتغير الطلب المدفوع. تطلب ملاحظة على الطلب المدفوع منك استرداد الدفعة المكررة في بوابة PayPlug. ولا يُعاد فتح طلب مدفوع أو مسترد بإشعار لاحق.

الملاحظات هي إدخالات في History الطلب، ولا يراها العميل.

تبويب VibeFox PayPlug Gateway

في Sales > Orders افتح طلبًا دُفع عبر PayPlug. في أسفل صفحة الطلب، بجانب History وAdditional، يعرض التبويب VibeFox PayPlug Gateway معرّف الدفعة PayPlug payment ID مع الوسم Test mode لدفعات الاختبار، وStatus الدفعة، والمبالغ Paid / refunded، ونموذج الاسترداد، وسجل الاسترداد (مع وضع كل عملية استرداد)، وPayPlug notes الخاصة بالطلب. يظهر التبويب للمستخدمين الذين لديهم صلاحية الوصول إلى الإضافة.

الاسترداد

في تبويب VibeFox PayPlug Gateway أدخل Amount (يُملأ المبلغ الذي لم يُسترد بعد)، واختياريًا Reason (optional)، ثم انقر على Refund via PayPlug. أكّد السؤال Refund this amount through PayPlug? This cannot be undone. يُدعم الاسترداد الكامل والجزئي. تحتاج إلى صلاحية تعديل الإضافة (تُضبط في System > Users > User Groups). تتم الاستردادات حتى المبلغ الذي حصّلته PayPlug فعليًا، لذلك بعد اختلاف المبلغ يمكنك استرداد ما دفعه العميل، لا إجمالي الطلب. يذهب الاسترداد إلى الدفعة التي سدّدت الطلب فعليًا، باستخدام المفتاح السري للوضع (الاختبار أو الإنتاج) الذي تم فيه، لذلك يجب أن يكون ذلك المفتاح مضبوطًا. إذا رفضت PayPlug الاسترداد، يعرض التبويب الخطأ ولا يُسجَّل أي استرداد. يُضاف الاسترداد الناجح إلى سجل الاسترداد والملاحظات مع معرّف الاسترداد في PayPlug والسبب. يضبط الاسترداد الكامل الطلب على Refunded Status دون إشعار العميل ودون إعادة المنتجات إلى المخزون، كما يحدث عند تغيير الحالة يدويًا. لا يغيّر الاسترداد الجزئي الحالة. تتوفر الاستردادات بعد أن تُبلغ PayPlug بأن الدفعة مدفوعة.

لا ترسل مرتجعات المنتجات في Sales > Returns أموالًا عبر PayPlug.

تصل الاستردادات التي تتم في بوابة PayPlug عبر الإشعار، وتُضاف إلى الملاحظات مرة واحدة. تُدرج في سجل الاسترداد، لكنها لا تُحسب كاستردادات للإضافة ولا تغيّر حالة الطلب. سجّلها يدويًا عند الحاجة.

مفتاح الترخيص

تعمل الإضافة مع مفتاح ترخيص VibeFox من vibefox.net. كتلة الترخيص License — VibeFox PayPlug Gateway هي أول كتلة في صفحة Extensions > Extensions > Payments > VibeFox PayPlug Gateway > Edit، فوق الإعدادات. الصق المفتاح في License key وانقر على Activate. بعد ذلك تعرض الكتلة المفتاح مقنّعًا، والحالة (مثل تاريخ انتهاء الترخيص ونطاقك)، والأزرار Check now لإعادة التحقق من الحالة، وChange key لإدخال مفتاح آخر، وRemove key لإزالة المفتاح من هذا المتجر. وتحتها السطر Product: opencart-payment-payplug والرابط Manage licenses and domains in your account الذي يفتح حسابك في vibefox.net. لا يستطيع تغيير المفتاح إلا مستخدمو المدير الذين لديهم صلاحية Modify للإضافة. تتبع نصوص الكتلة لغة لوحة الإدارة (وتشمل الإنجليزية والروسية).

إذا لم يُقبل المفتاح، تذكر الكتلة السبب، مثل Key not found أو This key belongs to another product أو Domain limit reached أو License expired on مع تاريخ. بعد تغيير عنوان المتجر، أو بعد تحرير خانة نطاق في حسابك، انقر على Check now. إذا تعذّر الوصول إلى خادم التراخيص، تواصل الإضافة العمل بآخر حالة معروفة.

المفتاح الواحد يعمل على نطاق واحد: عنوان المتجر من إعدادات OpenCart. إزالة المفتاح من المتجر لا تحرّر خانة النطاق. حرّر الخانة من حسابك في vibefox.net.

بدون مفتاح نشط لا يُعرض PayPlug للعملاء عند الدفع. إذا بدأت دفعة رغم ذلك، يرى العميل This payment method is not available. Please choose another one. ويظل المستخدم المدير الذي سجّل الدخول إلى لوحة الإدارة في المتصفح نفسه يرى طريقة الدفع في المتجر، مع الوسم (unlicensed — visible to admins only)، حتى تتمكن من إعداد الإضافة واختبارها قبل شراء مفتاح. في OpenCart 4 هذه المعاينة غير متاحة: لا يرى المتجر تسجيل دخول المدير، لذلك تُخفى طريقة الدفع عن الجميع بدون مفتاح نشط. بعد أن تفتح صفحة Edit مرة واحدة، يظهر تذكير في Dashboard لوحة الإدارة. أغلقه بالزر × ليُخفى لمدة 7 أيام. لا تتأثر الطلبات الحالية: تبقى الدفعات التي بدأت مؤكدة، وتعمل الاستردادات.

عندما تنتهي صلاحية الترخيص، تواصل الإضافة العمل، لكن التحديثات والدعم تحتاج إلى تجديد. تُعاد مراجعة الحالة تلقائيًا عند فتح Dashboard لوحة الإدارة أو صفحة Edit: مرة في اليوم خلال أول 14 يومًا بعد إدخال المفتاح، ثم مرة في الأسبوع. لا حاجة إلى مهمة cron. إلغاء تثبيت الإضافة يزيل دائمًا مفتاح الترخيص وحالة الترخيص.

استكشاف الأخطاء وإصلاحها

لا يظهر PayPlug عند الدفع: تحقق من أن الترخيص نشط، وأن Enable/Disable مفعّل، وأن الوضع الحالي لديه مفتاح سري (Test Secret Key في وضع الاختبار، وLive Secret Key في وضع الإنتاج)، وأن عملة الدفع هي EUR، وأن إجمالي الطلب بين 0.99 و20,000.00 EUR. وتحقق أيضًا من أن عنوان الدفع ضمن Geo Zone المختارة، وأن الطلب يبلغ Total المحدد في الإعدادات. يمكن للمطورين تغيير العملات والحدود عبر أحداث OpenCart ppg_supported_currencies وppg_amount_limits (القيم بالسنتات)، وطلب الدفع عبر ppg_payment_data.

تمت الدفعة لكن الطلب يبقى بلا حالة: لم يصل الإشعار إلى متجرك ولم يعد العميل. تحقق من أن متجرك متاح من الإنترنت عند Notification URL الظاهر في الإعدادات، وأن جدار حماية أو حماية بكلمة مرور لا يحجبه. فعّل Logging وراجع حقل Log للإشعارات المرفوضة.

يرد الإشعار بـ Verification failed.: تعذّرت قراءة الدفعة من واجهة PayPlug البرمجية، مثلًا لأن PayPlug لم تستجب، أو لأن المفتاح السري لوضع الدفعة غير مضبوط. لا يتغير الطلب، وستعيد PayPlug إرسال الإشعار.

يرد الإشعار بـ Temporarily unavailable.: كانت السلة تُحدَّث بطلب آخر في اللحظة نفسها، مثل عودة العميل، أو تعذّر ضبط حالة الطلب. ستعيد PayPlug إرسال الإشعار. يعرض السجل السبب.

يرد الإشعار بـ Unknown payment. أو Payment does not belong to the order.: لم تُنشئ هذه الدفعة هذا المتجر أو لا تخص هذا الطلب، مثلًا دفعة من متجر آخر على حساب PayPlug نفسه. يُتجاهل الإشعار.

يعرض عنوان الإشعار Method not allowed. في المتصفح: هذا طبيعي. يقبل العنوان طلبات PayPlug فقط.

يرى العميل خطأ بعد Confirm Order: فعّل Logging وراجع حقل Log. المفتاح الخاطئ يعطي This payment method is temporarily unavailable. Please choose another payment method.؛ وتذكر الرسائل الأخرى حقل الفوترة الذي رفضته PayPlug.

يعود العميل ويرى Payment verification failed.: رابط العودة لا يطابق أي محاولة دفع للطلب، مثلًا لأنه فُتح في متصفح آخر. تحقق من الدفعة في بوابة PayPlug؛ لكن الإشعار ما يزال يضبط حالة الطلب.

الطلب معلّق بعد الدفع: اقرأ الملاحظات في تبويب VibeFox PayPlug Gateway (انظر حالات الطلب)، ثم عالج الطلب أو استرد الدفعة.

لا يوجد نموذج استرداد في التبويب: يذكر التبويب السبب: الدفعة غير مدفوعة بعد، أو مستردة بالكامل، أو مجموعة المستخدمين لديك لا تملك صلاحية تعديل الإضافة، أو المفتاح السري لوضع الدفعة غير مُعدّ.

يفشل الاسترداد بـ Unexpected response from PayPlug.: ردّت PayPlug دون استرداد صالح. لم يُسجَّل شيء. تحقق من الاسترداد في بوابة PayPlug قبل المحاولة مرة أخرى.

إلغاء التثبيت

انتقل إلى Extensions > Extensions، واختر النوع Payments، ثم انقر على Uninstall (الزر الأحمر −) بجانب VibeFox PayPlug Gateway. يُزال مفتاح ترخيص هذه الإضافة وحالة ترخيصها دائمًا. يحذف OpenCart دائمًا إعدادات الإضافة الخاصة به: Enable/Disable وSort Order وGeo Zone وTotal وحالات الطلبات في قسم Orders، وتعود هذه إلى قيمها الافتراضية عند إعادة التثبيت. ويُحذف أيضًا حدث OpenCart الخاص بالإضافة (وفي OpenCart 4 أحداثها وإجراء بدئها الذي يسمح بالإشعار وعودة العميل في وضع الصيانة). إذا كان Delete Data on Uninstall مفعّلًا، تُحذف الإعدادات الأخرى (العنوان، والوصف، ووضع الاختبار، والمفاتيح السرية، والتسجيل) والسجل. وإذا كان معطّلًا، تُحفظ لإعادة التثبيت لاحقًا. تبقى سجلات دفع PayPlug والاسترداد محفوظة دائمًا، لذلك يمكن استرداد الطلبات المدفوعة سابقًا بعد إعادة التثبيت. وتحتفظ الطلبات الحالية بملاحظات الدفع الخاصة بها.

في OpenCart 4، ولحذف ملفات الإضافة أيضًا، انتقل بعد إلغاء التثبيت إلى Extensions > Installer، وانقر على Uninstall (الزر البرتقالي −) بجانب VibeFox PayPlug Gateway في قائمة الإضافات المثبّتة، ثم على Delete (زر سلة المهملات الأحمر) لحذف الحزمة المرفوعة.

PayPlug علامة تجارية مملوكة لصاحبها. هذه الإضافة غير تابعة لـ PayPlug ولا معتمدة منها.