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

المتطلبات

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

PHP: ‏8.0 أو أحدث.

العملة: اليورو (EUR). لا تحصّل Eupago إلا باليورو، لذلك يجب تفعيل اليورو في متجرك؛ وعندما يدفع العميل بعملة أخرى، تُخفى طريقة الدفع عند الدفع.

حساب Eupago: تحتاج إلى مفتاح API لقناة Eupago الخاصة بك ومفتاح Webhook 2.0 تنشئه في لوحة إدارة Eupago (انظر الإعدادات). لوحة الإنتاج هي clientes.eupago.pt، ولوحة sandbox هي sandbox.eupago.pt. الـ sandbox والإنتاج حسابان منفصلان بمفاتيح منفصلة.

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

التثبيت

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

OpenCart 3

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

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

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

4. أدخل مفتاح API لقناة Eupago الخاصة بك، وأنشئ Webhook 2.0 في لوحة إدارة Eupago، then الصق مفتاحه (انظر الإعدادات).

5. اختر Payment Method، وفعّل Enable/Disable، ثم انقر على Save. أنشئ طلب اختبار في وضع sandbox، ثم أوقف Sandbox Mode.

OpenCart 4

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

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

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

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

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

الإعدادات

توجد جميع الإعدادات في صفحة الإضافة: Extensions > Extensions > Payments > VibeFox Eupago Gateway > Edit. تُعرض الأقسام على اليسار؛ وزر Save أسفل القائمة يحفظ الصفحة كاملة. عندما تكون طريقة الدفع مفعّلة، تحذّرك الصفحة فوق الإعدادات إذا كان مفتاح API للوضع الحالي فارغًا (فتُخفى طريقة الدفع عند الدفع)، أو تعرض Sandbox mode: no real payments are taken. أثناء تفعيل وضع sandbox. وبدون صلاحية تعديل الإضافة، تعرض الصفحة الإعدادات لكنها لا تستطيع حفظها.

عند الحفظ، يجب ألا يكون العنوان فارغًا ولا أطول من ‏128 حرفًا، ويجب اختيار طريقة دفع، ويجب أن يكون Sort Order عددًا صحيحًا، وTotal رقمًا غير سالب، ويجب أن توجد المنطقة الجغرافية وحالات الطلب. وإلا فستوضح رسالة الخطأ المشكلة، مثل Enter a title for the payment method (1 to 128 characters).، ولا يُحفظ أي شيء.

Eupago

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

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

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

Payment Method: طريقة Eupago الوحيدة المعروضة عند الدفع.

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

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

Total: إجمالي الدفع، بالعملة الافتراضية للمتجر، الذي يجب أن يبلغه الطلب قبل عرض Eupago. اتركه فارغًا لعرض Eupago مهما كان المجموع. وبصرف النظر عن هذا الحقل، لا يُعرض Eupago إلا عندما يدفع العميل باليورو، ولا يُعرض Multibanco إلا لمبالغ من 1 € إلى 999 999.99 €.

حساب Eupago

احصل على مفتاح API لقناتك ومفتاح Webhook 2.0 من لوحة إدارة Eupago: clientes.eupago.pt (الإنتاج) أو sandbox.eupago.pt (sandbox). الـ sandbox والإنتاج حسابان منفصلان بمفاتيح منفصلة.

Sandbox Mode: يستخدم sandbox.eupago.pt ومفاتيح sandbox. لا تُحصَّل دفعات حقيقية. الافتراضي: مفعّل. أوقفه لتحصيل دفعات حقيقية بمفاتيح الإنتاج. أثناء تفعيله يرى العملاء SANDBOX / TEST MODE في خطوة Confirm Order.

Live API Key: مفتاح API لقناة Eupago الإنتاجية الخاصة بك (clientes.eupago.pt).

Live Webhook Key: مفتاح التشفير لـ Webhook 2.0 الإنتاجي. مطلوب: الإشعارات التي لا تحمل توقيعًا صالحًا تُرفض.

Sandbox API Key: مفتاح API لقناة sandbox الخاصة بك (sandbox.eupago.pt).

Sandbox Webhook Key: مفتاح التشفير لـ Webhook 2.0 الخاص بـ sandbox.

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

عنوان URL للـ Webhook

يُخبر الـ webhook متجرك بأن دفعة قد تمّت. في لوحة إدارة Eupago أنشئ Webhook 2.0 باستخدام عنوان URL المعروض في هذا القسم، والطريقة POST، مع تفعيل التشفير. في OpenCart 3 يبدو عنوان URL هكذا: https://your-store/index.php?route=extension/payment/wcp_eupago_gateway/webhook، وفي OpenCart 4 هكذا: https://your-store/index.php?route=extension/wcp_eupago_gateway/payment/wcp_eupago_gateway.webhook ويُبنى من عنوان واجهة المتجر في تثبيت OpenCart الخاص بك. انسخ عنوان URL تمامًا كما تعرضه الإعدادات. أنشئ webhook في لوحة sandbox وآخر في لوحة الإنتاج.

انسخ مفتاح كل webhook إلى Sandbox Webhook Key أو Live Webhook Key. تُرفض الـ webhooks التي لا تحمل توقيعًا صالحًا. ولا يُقبل webhook غير مشفّر إلا إذا وقّعته Eupago، لذا أبقِ التشفير مفعّلًا. يجب توقيع الإشعار بمفتاح الوضع الذي بدأت فيه الدفعة، لذلك لا يدفع إشعار sandbox دفعة إنتاج أبدًا. تتفاعل الإضافة مع حالات الإشعارات التالية:

لا تتطلب الحالات الأخرى أي إجراء. يُقبل أيضًا callback GET القديم من Eupago إلى العنوان نفسه؛ وهو يُصادَق عليه بمفتاح API ويُبلغ دائمًا عن دفعة. وبدون الإشعارات لا تُعلَّم الطلبات كمدفوعة أبدًا: فالإضافة لا تستعلم من Eupago، ولا تسدّد عودة العميل أي طلب. ويعمل الـ webhook أيضًا أثناء وضع الصيانة للمتجر، لأن OpenCart 3 يسمح بطلبات إضافات الدفع، وتضيف الإضافة على OpenCart 4 إجراء بدء تشغيل لها (وكذلك لعودة العميل من صفحة البطاقة).

الطلبات

ينشئ OpenCart الطلب في خطوة Confirm Order بدون حالة (طلب مفقود). مع Multibanco وMB WAY يحصل الطلب على حالة الانتظار بمجرد أن تُصدر Eupago المرجع أو طلب MB WAY. مع البطاقة لا يحصل الطلب على حالة إلا من إشعار Eupago. ولا يُعلَّم الطلب كمدفوع إلا عندما يصل إشعار موثّق ويتطابق وضعه ومرجعه ومبلغه وعملته مع الطلب. وتعرض كل الحقول أدناه حالات طلبات OpenCart لديك.

Order Status After Payment: حالة الطلب التي تُعيَّن عند تأكيد الدفع. الافتراضي: Processing.

Awaiting payment status: صدر مرجع Multibanco أو طلب MB WAY، ولا يزال على العميل أن يدفع. تُرسل تفاصيل Multibanco مع هذه الحالة (في بريد الطلب وفي سجل طلبات العميل). الافتراضي: Pending.

Manual review status: أبلغت Eupago عن دفعة لا تطابق الطلب (المبلغ، العملة، المرجع)، أو عن دفعة بعد إلغاء الطلب، أو عن دفعة لطلب كانت سلته مدفوعة بالفعل. توضح ملاحظة السبب. الافتراضي: Pending، لأن OpenCart لا يملك حالة On hold. يمكنك إنشاء حالتك الخاصة في System > Localisation > Order Statuses واختيارها هنا.

Cancelled status: أبلغت Eupago بأن الدفعة الحالية لطلب معلّق قد أُلغيت أو انتهت صلاحيتها. الافتراضي: Canceled.

Failed status: أبلغت Eupago بأن الدفعة الحالية لطلب معلّق قد فشلت (ERROR). الافتراضي: Failed.

متقدم

Debug Log: يكتب استدعاءات API والإشعارات في eupago_p_debug.log.php داخل مجلد سجلات OpenCart (storage/logs). لا يمكن فتح الملف من الويب، وعند بلوغه 5 MB يُنقل إلى eupago_p_debug.old.log.php. لا تُسجَّل المفاتيح ولا عناوين البريد الإلكتروني ولا أرقام الهواتف الكاملة. وتُسجَّل الأخطاء دائمًا. الافتراضي: معطّل.

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

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

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

Export: يحفظ Download JSON الإعدادات في ملف JSON. لا تُصدَّر مفاتيح API ومفاتيح الـ webhook.

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

الدفع

في خطوة Payment Method يختار العميل طريقة الدفع (افتراضيًا Eupago). ينشئ OpenCart الطلب في خطوة Confirm Order، ولا يزال بدون حالة. في OpenCart 4 يختار العميل طريقة الدفع بزر Choose في كتلة طريقة الدفع، في نافذة Payment method options، وينقر على Confirm Order أسفل صفحة الدفع. وما يحدث عندما ينقر العميل على Confirm Order يعتمد على Payment Method.

Multibanco: يرى العميل You will receive Multibanco payment details after placing the order. تُنشئ الإضافة مرجع Multibanco لإجمالي الطلب باليورو، ويحصل الطلب على Awaiting payment status. يتلقى بريد الطلب وسجل طلبات العميل التعليق Multibanco Payment Details مع الكيان والمرجع والمبلغ. وتعرض صفحة نجاح الطلب التفاصيل نفسها. يدفع العميل من جهاز الصراف الآلي أو عبر الخدمات المصرفية الإلكترونية.

MB WAY: يُدخل العميل MB WAY Phone Number، وهو مُعبّأ برقم هاتف الطلب. ويمكن إدخال الأرقام البرتغالية بدون +351. في OpenCart 4 لا يُطلب الهاتف افتراضيًا، لذلك يكون الحقل فارغًا في العادة ويُدخل العميل الرقم. ويعرض الرقم الخاطئ Please enter a valid MB WAY phone number (e.g. 912 345 678 or +351 912 345 678). تُرسل الإضافة طلب الدفع إلى تطبيق MB WAY، ويحصل الطلب على Awaiting payment status. وتطلب صفحة النجاح من العميل فتح تطبيق MB WAY على رقم الهاتف المُخفى والموافقة على الطلب خلال 5 دقائق. وإذا رفضت Eupago الطلب، يبقى العميل في خطوة Confirm Order مع The MB WAY payment could not be started. Check that the phone number is associated with MB WAY and try again.

Credit Card: يرى العميل You will be redirected to a secure payment page to enter your card details. يُرسل العميل إلى صفحة بطاقة Eupago، بالبرتغالية أو الإسبانية أو الإنجليزية حسب لغة المتجر. ويبقى الطلب بدون حالة، وتُحفظ السلة. وإذا وصل الإشعار عند عودة العميل، يرى صفحة نجاح الطلب في OpenCart. وإلا تعرض صفحة Payment confirmation العبارة Your card payment is being confirmed by Eupago. You will receive an e-mail as soon as it is confirmed. مع الزرين Check again وBack to checkout. وإذا فشل الدفع بالبطاقة أو تُرك، يعود العميل إلى الدفع مع The card payment was not completed. You can try again or choose another payment method. أو The card payment was cancelled. You can try again or choose another payment method. وفي OpenCart 4 تُعرض هذه الرسائل فوق صفحة الدفع.

لكل طريقة، لا يُعلَّم الطلب كمدفوع إلا بعد أن تؤكد Eupago الدفعة بإشعار موثّق. ثم يحصل الطلب على حالته بالطريقة القياسية في OpenCart، مع تحديث المخزون. وتظهر تفاصيل الدفع في صفحة النجاح فقط أثناء انتظار الطلب للدفع. وإذا كانت Eupago قد أبلغت بالفعل بأن الدفعة أُلغيت أو انتهت صلاحيتها أو فشلت، تعرض صفحة النجاح Your Eupago payment was not completed. Please contact us about this order.

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

يحتفظ OpenCart 4 بالطلب في الدفع حتى تُعرض صفحة النجاح. إذا أُغلق ذلك الطلب دون أي دفعة في هذه الأثناء (مثلًا انتهت صلاحية مرجع Multibanco، أو رُفض طلب MB WAY، أو ألغيت الطلب)، يُعاد العميل إلى صفحة الدفع مع Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order.، ويدفع Confirm Order التالي طلبًا جديدًا للسلة. وإذا كان ذلك الطلب مدفوعًا بالفعل أو بانتظار دفعه، لكن السلة تغيّرت بعد ذلك، بما في ذلك كمية جديدة، فالرسالة Your previous order is already paid or awaiting its payment. Please confirm the order again: the cart will be paid with a new order.، ولا يظهر الطلب المدفوع أبدًا كمدفوع لسلة مختلفة.

إذا تعذّر على Eupago بدء الدفع، يبقى العميل في خطوة Confirm Order مع رسالة قصيرة، مثل The payment could not be started because Eupago is temporarily unavailable. Please try again in a few minutes or choose another payment method. ويبقى الطلب بدون حالة، وتُكتب التفاصيل في السجل.

تقدّم الإضافة طريقة Eupago واحدة لكل تثبيت. ولا تدعم الاسترداد من المتجر، ولا البطاقات المحفوظة، ولا الاشتراكات أو التفويض المسبق، ولا PayShop أو Cofidis Pay أو Bizum أو طرق Eupago الأخرى، ولا التذكيرات عبر الرسائل النصية، ولا تاريخ انتهاء Multibanco، ولا الاستعلام عن الحالات.

الطلبات

حالات الطلب

No status (missing order): بدأت دفعة بالبطاقة ولم تؤكدها Eupago بعد، أو فشلت. وفي Sales > Orders لا تظهر هذه الطلبات إلا مع الفلتر Order Status مضبوطًا على Missing Orders.

Awaiting payment status (default Pending): أُنشئ مرجع Multibanco أو طلب MB WAY. تعرض الملاحظة الكيان والمرجع أو الهاتف المُخفى.

Order Status After Payment (default Processing): تم تأكيد الدفع. تعرض ملاحظة الطريقة ومعرّف معاملة Eupago والمرجع.

Manual review status (default Pending): أبلغت Eupago عن دفعة بمبلغ أو عملة مختلفين، أو بمرجع لم يُنشأ لهذا الطلب، أو عن طلب أُلغي أو فشل في هذه الأثناء (مثل مرجع Multibanco دُفع متأخرًا)، أو عن طلب كانت سلته قد دُفعت بالفعل بطلب آخر. توضح الملاحظة ذلك. تحقّق من الدفعة والمخزون، ثم أكمل الطلب يدويًا أو أعد المبلغ إلى العميل. ولن تُكمل الإشعارات اللاحقة لهذه الدفعة الطلب من تلقاء نفسها دون علمك.

Cancelled status (default Canceled): أبلغت Eupago بأن الدفعة الحالية لطلب معلّق قد أُلغيت أو انتهت صلاحيتها.

Failed status (default Failed): أبلغت Eupago بوجود خطأ في محاولة الدفع الحالية لطلب معلّق.

إذا أبلغت Eupago عن دفعة أخرى لطلب مدفوع بالفعل (مثلًا دُفع مرجع Multibanco أقدم أيضًا)، فلن يتغير الطلب. وتطلب منك ملاحظة التحقق من الدفع المكرر وإعادة المبلغ في لوحة إدارة Eupago. ولا يعيد إشعار دفع فتح طلب دُفع ثم أُلغي أو أُعيد مبلغه. والملاحظات إدخالات في History الطلب التي لا يراها العميل.

تبويب VibeFox Eupago Gateway

في Sales > Orders افتح طلبًا مدفوعًا بواسطة Eupago. في أسفل صفحة الطلب، بجوار History وAdditional، يعرض تبويب VibeFox Eupago Gateway كل محاولة دفع للطلب: Date، وMethod (مع تسمية Sandbox لمدفوعات sandbox)، وAmount، وEntity / reference / phone، وEupago transaction ID، وStatus. وبالنسبة إلى طلب في المراجعة اليدوية يعرض التبويب تحذيرًا. وأسفله تعرض Eupago notes ملاحظات الإضافة على الطلب. التبويب للقراءة فقط ويظهر للمستخدمين الذين لديهم صلاحية الوصول إلى الإضافة.

المرتجعات

الاسترداد غير متاح في هذه الإضافة. استرد المبلغ للعميل في لوحة إدارة Eupago، ثم حدّث الطلب في OpenCart يدويًا. ولا ترسل المرتجعات للمنتجات في Sales > Returns أموالًا عبر Eupago.

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

تعمل الإضافة بمفتاح ترخيص VibeFox من vibefox.net. كتلة الترخيص License — VibeFox Eupago Gateway هي الكتلة الأولى في Extensions > Extensions > Payments > VibeFox Eupago Gateway > Edit، فوق الإعدادات. الصق المفتاح في License key وانقر على Activate. بعد ذلك تعرض الكتلة المفتاح مخفيًا جزئيًا، والحالة (مثل تاريخ انتهاء الترخيص ونطاقك)، والأزرار Check now لإعادة التحقق من الحالة، وChange key لإدخال مفتاح آخر، وRemove key لإزالة المفتاح من هذا المتجر. وأسفلها السطر Product: opencart-payment-eupago والرابط 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.

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

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

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

Eupago does not appear at checkout: تحقق من أن الترخيص نشط، وأن Enable/Disable مفعّل، وأن مفتاح API للوضع الحالي مُعدّ (Sandbox API Key في وضع sandbox، وLive API Key في وضع الإنتاج). يجب أن يدفع العميل باليورو، ومع Multibanco يجب أن يكون مجموع الطلب بين 1 € و999 999.99 €. وتحقق أيضًا من أن عنوان الدفع داخل Geo Zone المحددة، وأن الطلب يبلغ Total المحدد في الإعدادات.

The payment went through, but the order stays in the awaiting status or without a status: لا يصل إشعار Eupago أو يُرفض. في لوحة إدارة Eupago للوضع الذي تستخدمه، تحقق من وجود Webhook 2.0، ومن أن عنوان URL الخاص به هو بالضبط المعروض في Webhook URL، ومن أن الطريقة POST وأن التشفير مفعّل. وتحقق من أن مفتاحه موجود في الحقل المناسب (Sandbox Webhook Key أو Live Webhook Key). فعّل Debug Log وانظر إلى الحقل Log في صفحة الإضافة. وإذا لم يصل أي إشعار، فتحقق من الدفعة في لوحة إدارة Eupago.

Webhook answers Invalid signature or Missing signature: مفتاح الـ webhook في الإضافة لا يطابق مفتاح الـ webhook، أو أن الـ webhook غير مشفّر وغير موقّع. انسخ المفتاح مرة أخرى وأبقِ التشفير مفعّلًا.

Webhook answers Webhook key not configured: لم يُعيَّن أي مفتاح webhook. تعيد Eupago محاولة الإشعار بعد أن تلصق المفتاح.

Webhook answers Decryption failed: التوقيع صالح، لكن تعذّر فك تشفير المحتوى. تحقق من إعدادات Webhook 2.0 في لوحة إدارة Eupago.

Webhook answers Environment mismatch: الإشعار مُوقَّع بمفتاح وضع غير الوضع الذي بدأت فيه الدفعة. ولا يدفع إشعار sandbox دفعة إنتاج أبدًا، والعكس صحيح. تحقق من عدم تبديل مفاتيح sandbox والإنتاج.

Webhook answers Order not found: الإشعار يخص طلبًا ليست له دفعة Eupago من هذا المتجر، مثل دفعة تمّت في متجر آخر عبر قناة Eupago نفسها.

Webhook answers Busy or Retry: كان الطلب قيد المعالجة من طلب آخر في اللحظة نفسها، أو فشلت المعالجة. تعيد Eupago محاولة الإشعار. والسبب موجود في السجل.

Legacy callback answers Invalid API key: مفتاح API الذي أرسلته Eupago لا يطابق Live API Key ولا Sandbox API Key. وتظهر الاستجابة نفسها إذا فتحت عنوان URL للـ webhook في المتصفح؛ وهذا طبيعي.

The customer sees This payment method is temporarily unavailable: مفتاح API للوضع الحالي مفقود. أدخله في الإعدادات.

The customer sees The MB WAY payment could not be started: تحقق من أن رقم الهاتف مرتبط بـ MB WAY، ثم حاول مرة أخرى.

Order is in the manual review status after payment: اقرأ Eupago notes في تبويب VibeFox Eupago Gateway. كان المبلغ أو العملة مختلفين، أو كان المرجع غير معروف، أو وصلت الدفعة بعد إلغاء الطلب، أو كانت السلة مدفوعة بالفعل بطلب آخر. تحقق من الدفعة في لوحة إدارة Eupago، ثم أكمل الطلب أو أعد المبلغ إلى العميل.

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

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

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

Eupago علامة تجارية مسجلة لمالكها. هذه الإضافة غير تابعة لـ Eupago ولا معتمدة من قبلها.