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

المتطلبات

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

PHP: 8.0 أو أحدث.

حساب EveryPay: تحتاج إلى اسم مستخدم واجهة برمجة التطبيقات (API)، والسر الخاص بها (API secret)، واسم حساب المعالجة (processing account) لمتجرك الإلكتروني. تظهر هذه البيانات في EveryPay Merchant Portal ضمن إعدادات المتجر الإلكتروني. لكل من البوابة التجريبية (وضع الاختبار) والبوابة الحية بيانات اعتماد منفصلة. طرق الدفع التي يمكن للعميل استخدامها (البطاقات، وApple Pay، وGoogle Pay، والروابط المصرفية) هي التي فُعّلت لحساب EveryPay الخاص بك.

العملة: يحصّل حساب المعالجة الواحد بعملة واحدة فقط. يبدأ اسم الحساب برمز عملته، فمثلًا يحصّل الحساب EUR3D1 باليورو. لا تُعرض خدمة EveryPay إلا عندما يدفع العميل بتلك العملة.

الموقع العام: يجب أن يكون عنوان URL لرد الاتصال (callback) الخاص بمتجرك متاحًا من الإنترنت، ولا تحجبه المصادقة الأساسية أو جدار الحماية.

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

التثبيت

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

OpenCart 3

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

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

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

4. أدخل اسم مستخدم واجهة برمجة التطبيقات التجريبية، والسر التجريبي، واسم حساب المعالجة من البوابة التجريبية. انسخ Callback notification URL إلى EveryPay Merchant Portal (انظر الإعدادات).

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

OpenCart 4

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

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

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

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

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

الإعدادات

توجد جميع الإعدادات في صفحة الإضافة: Extensions > Extensions > Payments > VibeFox EveryPay Payment > Edit. تظهر الأقسام في الجهة اليسرى؛ وزر Save أسفل القائمة يحفظ الصفحة بأكملها. وفوق الإعدادات تعرض الصفحة Test mode is on: payments go to the EveryPay demo environment, no real money is charged. طالما أن وضع الاختبار مفعّل. وتنبّهك الصفحة عندما تكون طريقة الدفع مفعّلة لكن اسم مستخدم API أو السر أو حساب المعالجة الخاص بالوضع الحالي مفقود (وعندئذٍ تكون طريقة الدفع مخفية في صفحة الدفع)، وعندما تختلف عملة حساب المعالجة عن العملة الافتراضية لمتجرك. وبدون صلاحية تعديل الإضافة، تعرض الصفحة الإعدادات لكنها لا تستطيع حفظها.

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

EveryPay

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

Title: اسم طريقة الدفع الذي يراه العميل في صفحة الدفع. وهو أيضًا اسم طريقة الدفع المحفوظ في الطلب. حتى 128 حرفًا؛ إذا تُرك فارغًا، يرى العميل EveryPay. الافتراضي: EveryPay.

Description: النص الذي يراه العميل في خطوة Confirm Order، أعلى زر التأكيد. الافتراضي: Pay securely by card or bank link on the EveryPay payment page.

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

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

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

حساب EveryPay

تظهر بيانات واجهة برمجة التطبيقات (اسم المستخدم والسر) واسم حساب المعالجة في EveryPay Merchant Portal (إعدادات المتجر الإلكتروني): البوابة التجريبية لوضع الاختبار، والبوابة الحية للمدفوعات الفعلية (يتضمن القسم روابط للاثنتين). لبيئتي الاختبار والإنتاج بيانات اعتماد منفصلة.

Test Mode: تُرسل المدفوعات إلى بيئة EveryPay التجريبية ببيانات الاعتماد التجريبية؛ ولا يُخصم أي مبلغ حقيقي. الافتراضي: مفعّل. أوقفه لاستلام المدفوعات الحقيقية ببيانات الاعتماد الحية. وطالما أنه مفعّل، يرى العميل في خطوة Confirm Order العبارة TEST MODE: EveryPay demo environment, no real money is charged.

Test API Username: اسم مستخدم واجهة برمجة التطبيقات الخاص بالبيئة التجريبية.

Test API Secret: السر الخاص بواجهة برمجة التطبيقات في البيئة التجريبية.

Live API Username: اسم مستخدم واجهة برمجة التطبيقات الخاص بالبيئة الحية.

Live API Secret: السر الخاص بواجهة برمجة التطبيقات في البيئة الحية.

Processing Account Name: حساب المعالجة الخاص بك في EveryPay، مثل EUR3D1. يحدد الحساب العملة التي تُخصم بها المدفوعات: تُعرض طريقة الدفع فقط للطلبات بتلك العملة.

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

إشعارات الدفع (callback)

يخبر رد الاتصال متجرك بأن الدفعة قد اكتملت، لتُؤكَّد الطلبات حتى لو أغلق العميل المتصفح. انسخ العنوان الظاهر في Callback notification URL إلى حقل عنوان رد الاتصال لمتجرك الإلكتروني في EveryPay Merchant Portal، سواء في البوابة التجريبية أو البوابة الحية. على OpenCart 3 يبدو العنوان هكذا: https://your-store/index.php?route=extension/payment/wcp_everypay_payment/callback، وعلى OpenCart 4 هكذا: https://your-store/index.php?route=extension/wcp_everypay_payment/payment/wcp_everypay_payment.callback. ويُبنى من عنوان واجهة متجرك في تثبيت OpenCart الخاص بك. انسخ العنوان تمامًا كما تعرضه الإعدادات.

لا يحمل رد الاتصال سوى مراجع الدفع. ولا تثق الإضافة به وحده أبدًا: فهي تسأل واجهة برمجة تطبيقات EveryPay عن حالة الدفع باستخدام بيانات اعتماد الوضع الذي تمت فيه الدفعة. ويُرفض أي رد اتصال لدفعة لم ينشئها هذا المتجر دون أي طلب إلى EveryPay. ويعمل رد الاتصال أيضًا أثناء وجود المتجر في وضع الصيانة، لأن OpenCart 3 يسمح بمرور طلبات إضافات الدفع، وتضيف الإضافة في OpenCart 4 إجراءً عند بدء التشغيل (startup action) لهذا الغرض (ولعودة العميل أيضًا). وبدون رد الاتصال، يحصل الطلب على حالته عندما يعود العميل إلى المتجر، أو عندما تنقر على Check EveryPay payment status في صفحة الطلب.

الطلبات

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

Order Status After Payment: حالة الطلب التي تُعيَّن بعد دفعة مُتحقَّق منها بأنها مُسوّاة أو مُصرَّح بها. الافتراضي: قيد المعالجة.

Manual Review Status: تمت الدفعة، لكن المبلغ أو العملة لا يطابقان الطلب، أو أُلغي الطلب في الأثناء، أو أنه يستخدم طريقة دفع أخرى. تشرح ملاحظة السبب، ولا يُعلَّم الطلب كمدفوع. الافتراضي: قيد الانتظار، لأن OpenCart لا يملك حالة On hold. يمكنك إنشاء حالة خاصة بك في System > Localisation > Order Statuses واختيارها هنا.

Cancelled Order Status: أي دفعة تصل لطلب بهذه الحالة توضع للمراجعة اليدوية بدلًا من سداد الطلب. الافتراضي: ملغى.

متقدم

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

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

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

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

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

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

الدفع

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

بعد الدفع، يعود العميل إلى متجرك. لا يُعلَّم الطلب كمدفوع إلا بعد أن تؤكده EveryPay: تسأل الإضافة واجهة برمجة EveryPay عن حالة الدفع عند عودة العميل وعند رد الاتصال. ثم يحصل الطلب على حالته بالطريقة القياسية في OpenCart، مع رسائل الطلب المعتادة وتحديث المخزون، ويرى العميل صفحة نجاح الطلب في OpenCart. وإذا كانت EveryPay لا تزال تعالج الدفعة، أو تعذر الوصول إلى واجهتها البرمجية في تلك اللحظة، تعرض صفحة Payment confirmation الرسالة Your payment is being confirmed by EveryPay. You will receive an e-mail as soon as the order is confirmed. مع زر Check again؛ ويضبط رد الاتصال حالة الطلب بمجرد أن تؤكد EveryPay الدفع.

إذا فشل الدفع، يعود العميل إلى صفحة الدفع مع الرسالة Your EveryPay payment was not successful. Please try again or choose another payment method. وإذا غادر العميل صفحة الدفع دون أن يدفع، فالرسالة هي The EveryPay payment was not completed. You can try again or choose another payment method. ويبقى السلة محفوظة، ويبقى الطلب بلا حالة. وفي OpenCart 4 تُعرض هذه الرسائل أعلى صفحة الدفع.

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

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

إذا تعذّر على EveryPay بدء الدفع، يبقى العميل في خطوة Confirm Order مع رسالة قصيرة أعلى الزر، مثل EveryPay is temporarily unavailable. Please try again in a moment or choose another payment method. وتفاصيل ذلك موجودة في السجل.

تقبل الإضافة الدفعات الفردية فقط. لا توجد استردادات أو تحصيلات (capture) من المتجر، ولا بطاقات محفوظة أو دفعات بنقرة واحدة، ولا اشتراكات أو دفعات متكررة، ولا حقول بطاقة مدمجة، ولا تعدد عملات.

الطلبات

حالات الطلب

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

Order Status After Payment (default Processing): أبلغت EveryPay بأن الدفعة مُسوّاة أو مُصرَّح بها. تعرض ملاحظة المبلغ والعملة ومرجع الدفع. وبالنسبة للدفعة المُصرَّح بها، تذكر الملاحظة أن المبلغ محجوز: إذا لم يكن حسابك يحصّل تلقائيًا، فحصّل الدفعة في EveryPay Merchant Portal. وعندما تُسوّى لاحقًا، تنبّه ملاحظة واحدة إلى ذلك.

Manual Review Status (default Pending): تحتاج الدفعة إلى مراجعة يدوية. المبلغ المدفوع أو العملة لا يطابقان الطلب، أو كان الطلب بحالة Cancelled Order Status قبل وصول الدفعة، أو أن الطلب يستخدم طريقة دفع أخرى الآن. تشرح الملاحظة ذلك وتذكر أن الطلب لم يُعلَّم كمدفوع. تحقّق من الدفعة في Merchant Portal ثم نفّذ الطلب أو استرد المبلغ يدويًا. ولا تُكمل رسائل الاتصال اللاحقة لهذه الدفعة الطلب تلقائيًا؛ لكن دفعة صحيحة من محاولة أخرى للطلب نفسه تسدده.

إذا اكتملت دفعة ثانية لطلب مدفوع بالفعل، فلا يتغير الطلب. وتطلب منك ملاحظة رد الدفعة المكررة في EveryPay Merchant Portal. الملاحظات مدخلات في History الخاص بالطلب، ولا يراها العميل.

علامة تبويب VibeFox EveryPay Payment

في Sales > Orders افتح طلبًا مدفوعًا عبر EveryPay. في أسفل صفحة الطلب، بجوار History وAdditional، تعرض علامة التبويب VibeFox EveryPay Payment الخانات EveryPay payments of this order لكل محاولة: Payment reference، وOrder reference، وMode (اختبار أو حي)، وAmount، وEveryPay state، وResult، وDate. وأسفلها EveryPay notes الخاصة بالطلب. وتُعرض العلامة للمستخدمين الذين لديهم صلاحية الوصول إلى الإضافة.

Check EveryPay payment status: يقرأ الزر الموجود في العلامة حالة كل دفعة EveryPay للطلب من واجهة البرمجة، من الأحدث إلى الأقدم، باستخدام بيانات اعتماد وضع كل دفعة، ويطبّق النتيجة كما هو موضح أعلاه، ويضيف ملاحظة واحدة تتضمن حالة كل دفعة. ثم تُعاد تحميل العلامة. تحتاج إلى صلاحية تعديل الطلبات (System > Users > User Groups)؛ ولا تحتاج إلى صلاحية تعديل الإضافة. استخدمه عندما لا يصل رد اتصال أبدًا، مثلًا لرؤية تحصيل أو استرداد لاحق. وتُسجَّل الحالة التي يعيّنها هذا الزر كتغيير يدوي للحالة في لوحة الإدارة، دون رسائل الطلب وتحديث المخزون الخاصين بصفحة الدفع.

الاسترداد

لا تُدعم الاستردادات والتحصيلات من المتجر. استرد المبلغ في EveryPay Merchant Portal، ثم حدّث حالة الطلب في OpenCart. وعندما تبلغ EveryPay بأن دفعة قد استُردّت أو اعتُرض عليها (chargeback)، تضيف الإضافة ملاحظة إلى الطلب فقط؛ ولا تتغير حالة الطلب. ولا تعيد المرتجعات من المنتجات في Sales > Returns أي مبلغ عبر EveryPay.

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

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

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

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

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

EveryPay does not appear at checkout: تحقّق من أن الترخيص نشط، وأن Enable/Disable مفعّل، وأن اسم مستخدم واجهة البرمجة والسر وProcessing Account Name الخاصة بالوضع الحالي مُعبّأة، وأن العميل يدفع بعملة حساب المعالجة. تعرض صفحة الإعدادات تحذيرًا في هذه الحالات. تحقق أيضًا من أن عنوان الدفع يقع ضمن Geo Zone المحددة، وأن الطلب يبلغ Total المحدد في الإعدادات.

The payment went through, but the order stays without a status: رد الاتصال لا يعمل. تحقّق من أن عنوان Callback notification URL مُعدّ في Merchant Portal للوضع الذي تستخدمه (التجريبي أو الحي)، وأنه يُفتح من الإنترنت. ويحصل الطلب أيضًا على حالته عندما يعود العميل إلى المتجر بعد الدفع. انظر حقل Log في صفحة الإضافة: تُسجَّل الأخطاء دائمًا.

Callback answers Unknown payment, Unknown payment reference, Payment cannot be verified or Payment does not belong to this order: لم تُنشئ هذه الدفعة هذا المتجر أو لم تُنشأ لهذا الطلب، أو أن رد EveryPay لا يطابقها. لا يتغير أي شيء.

Callback answers Missing or invalid payment_reference: لم يحمل الطلب مرجع دفع صالحًا، مثلًا عند فتح العنوان في متصفح.

Callback answers Not configured: بيانات اعتماد البيئة التي أُنشئت فيها الدفعة مفقودة، مثلًا دفعة تجريبية بعد حذف بيانات الاختبار. أعد إدخالها؛ وستعيد EveryPay محاولة رد الاتصال.

Callback answers Payment status unavailable, Busy, please retry or Processing error, please retry: تعذّر الوصول إلى واجهة EveryPay البرمجية، أو كان الطلب قيد المعالجة بطلب آخر في الوقت نفسه، أو فشلت المعالجة. السبب موجود في السجل. وستعيد EveryPay محاولة رد الاتصال.

The customer sees This payment method is not available right now: بيانات اعتماد الوضع الحالي أو حساب المعالجة مفقودة.

The customer sees EveryPay is temporarily unavailable or Unable to start the EveryPay payment: رفضت EveryPay بيانات الاعتماد أو تعذّر الوصول إليها. تحقّق من اسم مستخدم واجهة البرمجة والسر الخاصين بالوضع الحالي.

The customer sees This payment method does not support the order currency: عملة الطلب تختلف عن عملة حساب المعالجة.

The customer stays on the Payment confirmation page: لم تُكمل EveryPay الدفع بعد. يحصل الطلب على حالته عبر رد الاتصال، أو عندما ينقر العميل على Check again بعد أن تؤكد EveryPay الدفع.

Order is in the review status: اقرأ EveryPay notes في علامة التبويب VibeFox EveryPay Payment. كان المبلغ أو العملة غير متطابقين، أو أُلغي الطلب قبل وصول الدفعة، أو أنه يستخدم طريقة دفع أخرى. تحقّق من الدفعة في Merchant Portal ثم نفّذ الطلب أو استرد المبلغ يدويًا.

للمطورين: قبل إنشاء الدفعة، تُطلق الإضافة أحداث OpenCart التالية: wc_evp_oneoff_request (تعديل طلب الدفع) وwc_evp_locale (تغيير لغة صفحة الدفع).

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

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

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

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