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

المتطلبات

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

PHP: 8.0 أو أحدث، مع امتداد cURL.

العملة: AUD أو NZD أو SGD أو HKD أو MYR. بالنسبة لعملات الدفع الأخرى تُخفى طريقة الدفع في صفحة الدفع. ويُخصم المبلغ بعملة الطلب.

حساب eWAY: تحتاج إلى حساب تاجر في eWAY مع صلاحية الوصول إلى Rapid API، ومفتاح Rapid API وكلمة المرور الخاصة به، وتجدهما في MyeWAY ضمن Settings، API Key. ولإجراء الاختبارات تحتاج إلى حساب sandbox في eWAY بمفتاح وكلمة مرور خاصين به. مفاتيح sandbox والمفاتيح الحية مختلفة. لا يلزم إعداد أي شيء في MyeWAY: يُرسل عنوان الإرجاع مع كل دفعة.

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

التثبيت

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

OpenCart 3

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

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

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

4. أدخل مفتاح وكلمة مرور API الخاصين بـ sandbox، واترك Sandbox Mode مفعّلًا، وفعّل Enable/Disable، وانقر على Save، ثم ضع طلبًا تجريبيًا.

5. أدخل مفتاح وكلمة مرور API الحيين، وأوقف Sandbox Mode، وانقر على Save.

6. اختياريًا، أضف عنوان URL الخاص بـ cron المعروض في صفحة الإعدادات إلى مهام cron على خادمك (انظر الإعدادات).

OpenCart 4

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

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

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

4. أدخل مفتاح الترخيص ومفاتيح eWAY وعنوان cron URL كما في الخطوات من 3 إلى 6 الخاصة بـ OpenCart 3. صفحة الإعدادات وحقولها متطابقة في الإصدارين، ويختلف عنوان cron URL فقط (انظر Re-check of lost returns (cron)).

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

الإعدادات

توجد جميع الإعدادات في صفحة الإضافة: Extensions > Extensions > Payments > VibeFox eWAY Payment Gateway > Edit. تظهر الأقسام في الجهة اليسرى؛ وزر Save أسفل القائمة يحفظ الصفحة بأكملها. وفوق الإعدادات تعرض شارة الوضع: SANDBOX — payments go to the eWAY sandbox, no real money is charged. أو LIVE — real payments are taken with the live API key. وتنبّهك الصفحة عندما يكون مفتاح API أو كلمة المرور الخاصان بالوضع الحالي مفقودين (وعندئذٍ لا تظهر طريقة الدفع في صفحة الدفع)، أو عندما لا يدعم eWAY العملة الافتراضية للمتجر. وبدون صلاحية تعديل الإضافة، تعرض الصفحة الإعدادات لكنها لا تستطيع حفظها.

عند الحفظ، يجب أن يتراوح طول Title بين حرف واحد و128 حرفًا، وأن يكون Sort Order عددًا صحيحًا، وأن يكون Total عددًا غير سالب، وأن توجد المنطقة الجغرافية وحالات الطلب المحددة. وإلا فلن يُحفظ أي شيء، وتعرض الصفحة ما يجب تصحيحه.

eWAY

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

Title: اسم طريقة الدفع الذي يراه العميل في صفحة الدفع. وهو أيضًا اسم طريقة الدفع المحفوظ في الطلب. الافتراضي: Credit Card (eWAY). مطلوب، حتى 128 حرفًا.

Description: النص الذي يراه العميل في خطوة Confirm Order، أعلى زر التأكيد. الافتراضي: Pay securely using your credit card via eWAY. You will be redirected to the eWAY secure payment page.

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

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

Total: إجمالي الطلب في صفحة الدفع، بالعملة الافتراضية للمتجر، الذي يجب أن يبلغه الطلب حتى يُعرض eWAY. اتركه فارغًا لعرض eWAY مهما كان الإجمالي.

بيانات اعتماد API

يوجد مفتاح Rapid API وكلمة المرور في MyeWAY ضمن Settings، API Key. ولدى eWAY أدلة لمفاتيح الإنتاج ومفاتيح sandbox، وهي مرتبطة في هذا القسم. مفاتيح sandbox والمفاتيح الحية مختلفة. يستخدم وضع sandbox بيانات الاعتماد الخاصة بـ sandbox فقط، ويستخدم الوضع الحي بيانات الاعتماد الحية فقط.

Sandbox Mode: تُرسل المدفوعات إلى sandbox الخاص بـ eWAY بالمفتاح وكلمة المرور الخاصين بـ sandbox؛ ولا يُخصم أي مبلغ حقيقي. الافتراضي: مفعّل. أوقفه لاستلام المدفوعات الحية بالمفتاح الحي. وطالما أنه مفعّل، يرى العميل في خطوة Confirm Order العبارة Test mode: no real payment is taken.

Live API Key: مفتاح Rapid API لحساب eWAY الحي الخاص بك.

Live API Password: كلمة مرور Rapid API لحساب eWAY الحي الخاص بك.

Sandbox API Key: مفتاح Rapid API لحساب sandbox الخاص بـ eWAY (حساب الشريك/المطوّر).

Sandbox API Password: كلمة مرور Rapid API لحساب sandbox الخاص بـ eWAY.

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

Return URL: يعرض عنوان الإرجاع الخاص بالإضافة. يُرسل تلقائيًا إلى eWAY مع كل دفعة، مع الطلب ومفتاح عشوائي لمحاولة الدفع، لذلك لا يلزم إعداد أي شيء في MyeWAY. تُقرأ نتيجة الدفع دائمًا من eWAY بتقنية خادم إلى خادم.

Re-check of lost returns (cron): عنوان URL اختياري لـ cron، ويظهر أسفل عنوان الإرجاع. استدعِه من مهمة cron على الخادم كل 15 دقيقة، مثلًا باستخدام curl. إذا دفع العميل ثم أغلق المتصفح قبل العودة إلى المتجر، يُستعلم عن الدفعة من eWAY بعد نحو 60 دقيقة من إرسال العميل إلى eWAY، ويُحدَّث الطلب. وإذا تعذّر الوصول إلى eWAY، يُعاد الفحص حتى ثلاث مرات. أبقِ هذا العنوان سريًا: فهو يتضمن رمزًا سريًا أُنشئ عند التثبيت، والاستدعاء برمز خاطئ يُرد عليه بـ Forbidden. وفي OpenCart 4 يبدو عنوان URL هكذا: https://your-store/index.php?route=extension/wcp_eway_payment_gateway/payment/wcp_eway_payment_gateway.cron&token=(token).

الطلبات

ينشئ OpenCart الطلب في خطوة Confirm Order دون حالة (طلب مفقود). ولا يحصل الطلب على حالة إلا بعد أن تؤكد eWAY الدفع. تعرض كل خانة من الخانات التالية حالات طلباتك في OpenCart.

Order Status on Success: الحالة التي تُعيَّن عندما تؤكد eWAY الدفع. الافتراضي: قيد المعالجة.

eWAY payment on hold status: الحالة الخاصة بدفعة مُعتمدة تحتاج إلى مراجعتك: المبلغ أو العملة لا يطابقان الطلب، أو اعتُمدت الدفعة بعد أن ضغط العميل Cancel في صفحة eWAY، أو كان للطلب حالة أخرى من قبل. تشرح ملاحظة في سجل الطلب السبب. الافتراضي: قيد الانتظار، لأن OpenCart لا يملك حالة On hold. يمكنك إنشاء حالة خاصة بك في System > Localisation > Order Statuses واختيارها هنا.

Refunded order status: الحالة بعد استرداد الدفعة بالكامل من صفحة الطلب. الافتراضي: مسترد.

متقدم

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

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

Delete all extension data on uninstall: عند التفعيل، يؤدي إلغاء تثبيت الإضافة إلى حذف إعدادات البوابة والسجل. تُحفظ سجلات دفعات eWAY والاستردادات الخاصة بالطلبات دائمًا. الافتراضي: متوقف.

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

Export: Download JSON يحفظ الإعدادات في ملف JSON. لا تُصدَّر المفاتيح وكلمات المرور الخاصة بواجهة البرمجة.

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

الدفع

في خطوة Payment Method يختار العميل طريقة الدفع (افتراضيًا Credit Card (eWAY)). وفي خطوة Confirm Order يرى العميل وصفك والملاحظة You will be redirected to the secure eWAY payment page to pay by card. ينشئ OpenCart الطلب في هذه الخطوة، ولا يزال بدون حالة. وفي OpenCart 4 يختار العميل طريقة الدفع بزر Choose في كتلة طريقة الدفع، في النافذة Payment method options، وينقر على Confirm Order في أسفل صفحة الدفع. وعندما ينقر العميل على Confirm Order، تطلب الإضافة من eWAY صفحة دفع لإجمالي الطلب بعملة الطلب، مع OC- ورقم الطلب كمرجع للفاتورة، ومع عنوان الدفع والبريد الإلكتروني للعميل، ثم توجّه العميل إلى صفحة الدفع الآمنة في eWAY (Responsive Shared Page). وهناك يدفع العميل بالبطاقة. ويُحصَّل المبلغ فورًا.

بعد الدفع، يعود العميل إلى متجرك. لا تثق الإضافة بالمتصفح: فهي تسأل eWAY، بتقنية خادم إلى خادم، عن نتيجة صفحة الدفع التي أُنشئت لهذا الطلب. ولا يُعلَّم الطلب كمدفوع إلا عندما تؤكد eWAY ذلك ويطابق المبلغ والعملة المعتمدان الطلب. ثم يحصل الطلب على حالته بالطريقة القياسية في OpenCart، مع رسائل الطلب المعتادة وتحديث المخزون، ويرى العميل صفحة نجاح الطلب في OpenCart. وبالنسبة للطلب المعلّق، تعرض الصفحة أيضًا Your payment was received and is being reviewed by the store. We will contact you if anything is needed.

إذا تعذّر الاستعلام من eWAY في تلك اللحظة، تعرض صفحة Payment confirmation الرسالة We have not received the confirmation of your payment from eWAY yet. If you completed the payment, this order will be updated shortly — please do not pay again. مع زر Check again وزر Back to checkout. ويحصل الطلب على حالته عندما يتحقق العميل مرة أخرى، أو عندما يُنفَّذ عنوان URL الخاص بـ cron.

إذا رُفض الدفع، يعود العميل إلى صفحة الدفع مع السبب، مثل Your payment was declined: D4451 Insufficient funds. Please try again or use a different payment method. ويبقى الطلب بلا حالة. وإذا نقر العميل Cancel في صفحة eWAY، فإن الإضافة تتحقق أولًا من eWAY أنه لم يُدفع شيء (مثلًا في علامة تبويب أخرى). ثم يرى العميل You cancelled the payment on the eWAY page. Your order has not been paid — you can try again. وإذا لم يكتمل الدفع، فالرسالة هي The payment was not completed. Please try again. وتبقى السلة محفوظة في جميع الحالات. وفي OpenCart 4 تظهر هذه الرسائل أعلى صفحة الدفع.

يمكن للعميل المحاولة مرة أخرى. ينشئ OpenCart 3 طلبًا جديدًا في كل مرة تُعرض فيها خطوة Confirm Order، ويحدّث OpenCart 4 طلب الدفع، فتفتح المحاولة الجديدة صفحة دفع جديدة من eWAY للطلب نفسه، لذلك قبل إنشاء صفحة دفع جديدة تُراجَع صفحات الدفع السابقة لهذا الطلب ولطلبات أخرى من السلة نفسها عبر eWAY. فإذا كانت إحداها مدفوعة بالفعل، يُؤكَّد ذلك الدفع بدلًا من تحصيل مبلغ ثانٍ. وإذا تعذّر الاستعلام من eWAY عنها، يرى العميل We could not check the status of your previous payment attempt. Please try again in a moment. وإذا تعذّر على eWAY إنشاء صفحة الدفع، يبقى العميل في خطوة Confirm Order مع رسالة قصيرة، مثل Payment error: Unable to connect to eWAY. Please try again. أو eWAY could not start the payment مع رموز أخطاء eWAY.

يحتفظ OpenCart 4 بالطلب في صفحة الدفع حتى تُعرض صفحة النجاح. وإذا أُغلق ذلك الطلب دون دفع في الأثناء (على سبيل المثال إذا ألغيته)، يُعاد العميل إلى صفحة الدفع مع Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order.، وفي الخطوة التالية Confirm Order يُدفع طلب جديد من السلة. وإذا كان ذلك الطلب مدفوعًا بالفعل لكن السلة تغيّرت منذ ذلك، بما في ذلك تغيّر الكمية، فالرسالة هي Your previous order #(number) has already been placed. Your cart has changed: please confirm the new order to pay for it. ولا يُعرض الطلب المدفوع أبدًا على أنه مدفوع لسلة مختلفة.

تعمل عناوين URL الخاصة بالإرجاع وcron أيضًا أثناء وجود المتجر في وضع الصيانة، لأن OpenCart 3 يسمح بمرور طلبات إضافات الدفع، وتضيف الإضافة في OpenCart 4 إجراء startup لهذه الطلبات.

لا ترسل eWAY إشعارات بتقنية خادم إلى خادم للصفحة المشتركة (Shared Page): تُؤخذ النتيجة عندما يعود العميل وعبر عنوان URL الخاص بـ cron. ولا تحتوي الإضافة على حقول بطاقات في موقعك، ولا بطاقات محفوظة أو اشتراكات، ولا تفويض بدون تحصيل ولا تحصيل لاحق، ولا تقيّم درجات الاحتيال من Beagle (فالمعاملات التي تحجبها قواعد eWAY لمكافحة الاحتيال يرفضها eWAY نفسه).

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

حالات الطلب

No status (missing order): أُرسل العميل إلى eWAY ولم يدفع، أو ألغى، أو رُفضت الدفعة، أو لم يمكن الحصول على النتيجة بعد. وفي Sales > Orders لا تظهر هذه الطلبات إلا عند ضبط الفلتر Order Status على Missing Orders.

Order Status on Success (default Processing): اعتُمدت الدفعة. تعرض ملاحظة معرّف معاملة eWAY، ورمز التفويض، والاستجابة، والوضع (sandbox أو حي).

eWAY payment on hold status (default Pending): اعتمدت eWAY مبلغًا أو عملة مختلفين عن الطلب (مثلًا Approved for partial amount)، أو اعتُمدت الدفعة بعد أن ألغاها العميل في صفحة eWAY، أو اعتُمدت لطلب سبق أن أعطيته حالة، مثلًا Canceled. يُسجَّل المبلغ الذي حصّلته eWAY فعليًا، وتشرح الملاحظة ذلك. تحقّق من الطلب ثم نفّذه أو استرد الدفعة.

Refunded order status (default Refunded): استُردّت الدفعة بالكامل عبر الإضافة.

إذا اعتُمدت دفعة ثانية لطلب مدفوع بالفعل، أو لطلب آخر من السلة نفسها، فلا يتغير الطلب المدفوع. وتطلب منك ملاحظة استرداد النسخة المكررة في MyeWAY. ولا تُطبَّق دفعة معتمدة لمرجع فاتورة آخر على الطلب أبدًا.

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

علامة تبويب VibeFox eWAY Payment Gateway

في Sales > Orders افتح طلبًا مدفوعًا عبر eWAY. في أسفل صفحة الطلب، بجوار History وAdditional، تعرض علامة التبويب VibeFox eWAY Payment Gateway معرّف eWAY transaction مع الوسم Sandbox أو Live، وAuth code، وResponse من eWAY، وInvoice reference، وStatus الدفعة، والمبالغ Paid / refunded، ونموذج الاسترداد، وسجل الاستردادات، وeWAY notes الخاصة بالطلب. وتُعرض العلامة للمستخدمين الذين لديهم صلاحية الوصول إلى الإضافة.

الاسترداد

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

لا تعيد المرتجعات من المنتجات في Sales > Returns أي مبلغ عبر eWAY. ولا تُزامَن الاستردادات التي تُجرى في MyeWAY مع OpenCart. حدّث الطلب يدويًا عند الحاجة.

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

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

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

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

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

eWAY does not appear at checkout: تحقّق من أن الترخيص نشط، وأن Enable/Disable مفعّل، وأن مفتاح API وكلمة المرور الخاصين بالوضع الحالي مُعبّأان (حقول sandbox في وضع sandbox، والحقول الحية في الوضع الحي)، وأن عملة الدفع هي AUD أو NZD أو SGD أو HKD أو MYR. تعرض صفحة الإعدادات تحذيرًا عند غياب بيانات الاعتماد. تحقق أيضًا من أن عنوان الدفع يقع ضمن Geo Zone المحددة، وأن الطلب يبلغ Total المحدد في الإعدادات.

The payment went through, but the order stays without a status: لم يعد العميل من eWAY، أو تعذّر الاستعلام من eWAY في تلك اللحظة. لا ترسل eWAY إشعارات للصفحة المشتركة (Shared Page). اضبط عنوان URL الخاص بـ cron من Re-check of lost returns (cron): فهو يلتقط الدفعة بعد نحو ساعة. تحقّق من المعاملة في MyeWAY وانظر حقل Log في صفحة الإضافة.

The cron URL answers Forbidden: الرمز في عنوان URL غير صحيح. انسخ العنوان تمامًا كما تعرضه صفحة الإعدادات.

The customer sees This payment method is temporarily unavailable: مفتاح API أو كلمة المرور الخاصان بالوضع الحالي مفقودان، أو رفضتهما eWAY. تحقّق من بيانات الاعتماد الخاصة بالوضع الحالي.

The customer sees eWAY could not start the payment: أعادت eWAY رموز أخطاء تظهر في الرسالة. وغالبًا ما تكون بيانات الفوترة غير صالحة.

The customer sees eWAY cannot take payments in a currency: عملة الطلب ليست من العملات التي تقبلها eWAY. استخدم AUD أو NZD أو SGD أو HKD أو MYR.

The customer sees We could not match this payment to an order: رابط الإرجاع لا يعود إلى طلب في هذا المتجر، أو أن eWAY اعتمدت دفعة لمرجع فاتورة آخر. إذا خُصم المبلغ من العميل، فابحث عن الدفعة في MyeWAY.

The customer sees This payment method is not available: لم تعد جلسة الدفع متطابقة مع الطلب، أو أُوقفت طريقة الدفع في الأثناء. يعيد العميل تحميل صفحة الدفع.

Order is in the on hold status after payment: اقرأ eWAY notes في علامة التبويب VibeFox eWAY Payment Gateway (انظر حالات الطلب)، ثم نفّذ الطلب أو استرد الدفعة.

No refund form in the tab: تذكر العلامة السبب: لم يُعثر على معرّف معاملة eWAY للطلب، أو أن الطلب مُسترد بالكامل، أو أن مجموعة المستخدمين لا تملك صلاحية تعديل الإضافة، أو أن بيانات اعتماد API لوضع الدفعة غير مُعبّأة.

Refund fails with a message about the sandbox or live mode: دُفع الطلب في تلك البيئة، ومفتاح API وكلمة المرور الخاصان بها غير مُعبّأين. أدخلهما وأعد المحاولة.

Refund fails with at most … can be refunded: المبلغ أكبر من المبلغ الذي حصّلته eWAY مطروحًا منه الاستردادات التي تمت بالفعل.

للمطورين: تُطلق الإضافة أحداث OpenCart التالية: wcp_eway_payment_gateway_supported_currencies (إذا كان حسابك في eWAY مفعّلًا لعملات أخرى) وwcp_eway_payment_gateway_create_access_code_request (نص الطلب قبل إنشاء صفحة الدفع).

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

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

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

eWAY علامة تجارية مملوكة لصاحبها. هذه الإضافة غير تابعة لـ eWAY ولا تحظى بتأييدها.