VibeFox ePay.bg for OpenCart — المساعدة

المتطلبات

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

PHP: الإصدار 8.0 أو أحدث.

العملة: ليف بلغاري (BGN) أو يورو (EUR) أو دولار أمريكي (USD). يُخصم الطلب بعملته الخاصة بمنزلتين عشريتين. وعندما يُكمل العميل الشراء بعملة أخرى، تُخفى طريقة الدفع.

حساب ePay.bg: تحتاج إلى رقم العميل (MIN) والمفتاح السري من ملف التاجر لديك في ePay.bg: الحقيقيان من www.epay.bg، والتجريبيان من demo.epay.bg (يُسجَّل حساب الاختبار بشكل منفصل). وتحتاج أيضًا إلى إدخال عنوان URL لإشعارات متجرك في ملف التاجر.

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

التثبيت

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

OpenCart 3

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

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

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

4. أدخل MIN والمفتاح السري التجريبي و/أو الحقيقي (انظر الإعدادات).

5. انسخ عنوان URL المعروض في قسم Payment notifications (IPN) إلى الحقل URL for receiving notifications في ملف التاجر لدى ePay.bg، في الملف التجريبي والملف الحقيقي معًا. بدونه لن يحصل أي طلب على حالة.

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

OpenCart 4

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

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

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

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

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

الإعدادات

توجد جميع الإعدادات في صفحة الإضافة: Extensions > Extensions > Payments > VibeFox ePay.bg Gateway > Edit. تُدرج الأقسام على اليسار؛ وزر Save أسفل القائمة يحفظ الصفحة كاملةً. وفوق الإعدادات تعرض الصفحة خطأً عندما لا تكون العملة الافتراضية للمتجر هي BGN أو EUR أو USD؛ وتعرض تحذيرًا عندما تكون طريقة الدفع مفعّلة لكن MIN أو المفتاح السري للوضع المحدد فارغ (وعندئذٍ تُخفى في الدفع، ويظهر التحذير نفسه عند الحفظ)؛ وTest mode is on: payments go to demo.epay.bg and no real money is charged. طالما وضع الاختبار مفعّل. وبدون صلاحية تعديل الإضافة تعرض الصفحة الإعدادات لكن لا يمكنها حفظها.

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

ePay.bg

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

Title: اسم طريقة الدفع الذي يراه العملاء في الدفع. وهو أيضًا اسم طريقة الدفع المحفوظ في الطلب. الافتراضي: ePay.bg. مطلوب.

Description: النص الذي يُعرض للعميل في خطوة Confirm Order. الافتراضي: Pay securely via ePay.bg with a bank card or your ePay.bg account.

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

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

Total: إجمالي الدفع، بالعملة الافتراضية للمتجر، الذي يجب أن يبلغه الطلب قبل عرض ePay.bg. اتركه فارغًا لعرض ePay.bg لأي إجمالي.

حساب ePay.bg

يظهر رقم العميل (MIN) والمفتاح السري في ملف التاجر لديك على www.epay.bg (الحقيقي) وdemo.epay.bg (حساب الاختبار، ويُسجَّل بشكل منفصل).

Test Mode: يفعّل وضع الاختبار. يُرسَل العملاء إلى البيئة التجريبية لـ ePay.bg، وتُوقَّع الطلبات ببيانات الاعتماد التجريبية. الافتراضي: مفعّل. وطالما هو مفعّل يرى العملاء في خطوة Confirm Order الرسالة Test mode (demo.epay.bg): no real payment is taken.

Test Merchant ID (MIN): رقم العميل (MIN) لحساب التاجر التجريبي لديك على demo.epay.bg.

Test Secret Key: المفتاح السري لحساب التاجر التجريبي لديك على demo.epay.bg (64 حرفًا).

Live Merchant ID (MIN): رقم العميل (MIN) لحساب التاجر لديك على www.epay.bg.

Live Secret Key: المفتاح السري لحساب التاجر لديك على www.epay.bg (64 حرفًا)، ويُستخدم لتوقيع HMAC-SHA1.

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

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

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

يُبلغ ePay.bg بهذه النتائج لكل فاتورة:

تُرفض الإشعارات التي لا تحمل مجموع تحقق صالحًا، ويواصل ePay.bg إرسالها. يُتحقَّق من مجموع التحقق بالمفتاح السري لكل وضع لديه مفتاح، لذلك تستمر تأكيد المدفوعات التي بدأت قبل التبديل بين الاختبار والإنتاج. ويجب أن تصل الدفعة في الوضع الذي أُجري فيه الطلب؛ وإلا ينتقل الطلب إلى حالة التعليق (on hold). وبدون عنوان URL للإشعارات في ملف التاجر لا يحصل أي طلب على حالة.

طلب الدفع

Invoice Prefix: أرقام فقط (حتى 10)، تُوضع قبل معرّف طلب OpenCart لتكوين رقم فاتورة ePay.bg، مثل 00001 + 123 = 00001123. استخدم بادئات مختلفة لمتاجر مختلفة على حساب ePay.bg واحد. تُحذف الرموز الأخرى عند الحفظ مع تحذير يعرض البادئة المحفوظة. وتغيير البادئة لاحقًا آمن: تُعثر طلبات الدفع المفتوحة عبر الفاتورة المحفوظة لكل منها. الافتراضي: 00001.

Expiration Time: الوقت الذي بعده تنتهي صلاحية طلب دفع غير مدفوع؛ فيُبلغ عنه ePay.bg حينئذٍ بأنه منتهٍ، ولا يحصل الطلب على أي حالة. اختر 1 أو 3 أو 6 أو 12 أو 24 أو 48 أو 72 ساعة. يُرسل الوقت بتوقيت بلغاريا، بصرف النظر عن المنطقة الزمنية لمتجرك. الافتراضي: 24 ساعة.

Language: لغة صفحة الدفع في ePay.bg، الإنجليزية أو البلغارية. الافتراضي: English.

الطلبات

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

Order Status After Payment: الحالة التي تُضبط بعد الدفع الناجح.

Processing status: حالة OpenCart لـ Default وProcessing. الافتراضي: Processing.

Completed status: حالة OpenCart لـ Completed. الافتراضي: Complete.

On Hold status: حالة OpenCart لـ On Hold وللمدفوعات التي تحتاج إلى مراجعة يدوية: تغيّر إجمالي الطلب أو العملة بعد طلب الدفع، أو وصل الإشعار في الوضع الآخر، أو تغيّرت حالة الطلب قبل وصول الدفعة (مثلًا أُلغي). لا يُعلَّم هذا الطلب كمدفوع؛ وتشرح ملاحظة السبب. الافتراضي: Pending، لأن OpenCart لا يملك حالة On hold. يمكنك إنشاء حالتك الخاصة من System > Localisation > Order Statuses واختيارها هنا.

متقدم

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

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

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

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

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

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

الدفع

في خطوة Payment Method يختار العميل طريقة الدفع (افتراضيًا ePay.bg). وفي خطوة Confirm Order يرى العميل وصفك والملاحظة You will be redirected to ePay.bg to pay with a bank card or your ePay.bg account. ينشئ OpenCart الطلب في هذه الخطوة، ولا يزال بدون حالة. وعندما ينقر العميل على Confirm Order ترسله الإضافة إلى ePay.bg بطلب دفع موقَّع لإجمالي الطلب بعملة الطلب، مع رقم الفاتورة ووقت انتهاء الصلاحية. ويظهر الدفع في ePay.bg باسم Order ورقم الطلب. وفي ePay.bg يدفع العميل ببطاقة مصرفية أو بحساب ePay.bg. وفي OpenCart 4 يختار العميل طريقة الدفع بزر Choose في كتلة طريقة الدفع، في النافذة Payment method options، وينقر على Confirm Order أسفل صفحة الدفع.

بعد الدفع يعود العميل إلى متجرك. لا يُعلَّم الطلب كمدفوع إلا بعد أن يؤكد ePay.bg ذلك بالإشعار الموقَّع. ثم يحصل الطلب على حالته بالطريقة المعتادة في OpenCart، مع رسائل البريد الإلكتروني المعتادة للطلب وتحديث المخزون. وإذا كان الإشعار قد وصل بالفعل، يرى العميل صفحة نجاح الطلب في OpenCart. وإذا لم يصل بعد، تعرض صفحة Payment confirmation الرسالة Thank you. Your payment is being confirmed by ePay.bg — your order is confirmed as soon as ePay.bg reports the payment. مع الزرين Check again وBack to checkout.

وإذا ألغى العميل في ePay.bg، يعود إلى صفحة الدفع مع الرسالة The ePay.bg payment was cancelled. You can try again or choose another payment method. وإذا أبلغ ePay.bg بأن الطلب مرفوض أو منتهٍ، فالرسالة هي The payment was not completed. You can try again or choose another payment method. ويبقى السلة محفوظة. وفي OpenCart 4 تظهر هذه الرسائل فوق صفحة الدفع. تستخدم المحاولة الجديدة للطلب نفسه رقم الفاتورة نفسه. وينشئ OpenCart 3 طلبًا جديدًا في كل مرة تُعرض فيها خطوة Confirm Order، بينما يحتفظ OpenCart 4 بطلب واحد للدفع ويحدّثه، فتكون المحاولة الجديدة طلب دفع جديدًا للطلب نفسه؛ وعندما يكون طلب آخر من السلة نفسها مدفوعًا بالفعل، ينتقل العميل إلى صفحة النجاح، ولا تبدأ أي عملية دفع جديدة.

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

وإذا تعذّر دفع الطلب عبر ePay.bg، يبقى العميل في خطوة Confirm Order مع رسالة قصيرة فوق الزر، مثل ePay.bg payments are temporarily unavailable. Please choose another payment method. أو أن ePay.bg لا يقبل المدفوعات بعملة الطلب.

يعمل الإشعار أيضًا عندما يكون المتجر في وضع الصيانة: يسمح OpenCart 3 بمرور طلبات إضافات الدفع، ويضيف الإضافة في OpenCart 4 إجراء بدء تشغيل (startup action) للإشعار. وتُقبل إشعارات المدفوعات التي بدأت بالفعل حتى إذا عطّلت طريقة الدفع.

لا تقبل الإضافة إلا المدفوعات لمرة واحدة عبر ePay.bg. ولا توجد استردادات من OpenCart، ولا بطاقات محفوظة، ولا اشتراكات أو مدفوعات متكررة، ولا رموز دفع نقدي عبر EasyPay أو B-Pay.

الطلبات

حالات الطلب

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

Processing, Completed أو On Hold status: تم تأكيد الدفع. تتبع الحالة Order Status After Payment. تعرض ملاحظة رقم الفاتورة وتاريخ الدفع وSTAN ورمز BORICA.

حالة On Hold بعد الدفع: وصلت الدفعة، لكن ليس لما يشير إليه الطلب الآن: تغيّر إجمالي الطلب أو العملة بعد طلب الدفع، أو وصل الإشعار في وضع مختلف (تجريبي أو حقيقي) عن الطلب، أو لم تعد طريقة دفع الطلب هي ePay.bg. لا تُسجَّل الدفعة كمدفوعة. ويحدث الشيء نفسه إذا كنت قد أعطيت الطلب حالة أخرى من قبل، مثل الإلغاء. وتشرح الملاحظة السبب. تحقّق من الدفعة في لوحة تاجر ePay.bg، ثم أكمل الطلب أو استرده يدويًا.

إذا وصلت دفعة لطلب مدفوع بالفعل، فلا تتغير الحالة، وتطلب منك ملاحظة التحقق من دفعة مكررة في لوحة تاجر ePay.bg. وإذا دفع العميل طلبين من السلة نفسها، فسيحصل الطلب الثاني على ملاحظة عن دفعة مكررة محتملة. ولا يغيّر إشعار الرفض أو الانتهاء المتأخر طلبًا مدفوعًا أبدًا؛ والطلب الذي له حالة بالفعل يحصل على ملاحظة فقط.

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

تبويب VibeFox ePay.bg Gateway

في Sales > Orders افتح طلبًا دُفع عبر ePay.bg. في أسفل صفحة الطلب، بجوار History وAdditional، يعرض تبويب VibeFox ePay.bg Gateway الفاتورة، والبيئة (التجريبية أو الحقيقية) مع تسمية Test mode للمدفوعات التجريبية، والمبلغ والعملة المطلوبان، وحالة طلب الدفع، ونتيجة الإشعار، وتاريخ الدفع، وSTAN، ورمز BORICA، وملاحظات ePay.bg notes الخاصة بالطلب. التبويب للقراءة فقط ويظهر للمستخدمين الذين لديهم صلاحية الوصول إلى الإضافة.

الاستردادات

لا تتوفر الاستردادات من OpenCart، لأن واجهة WEB API الخاصة بـ ePay.bg لا تحتوي على استدعاء للاسترداد. استرد الدفعة في لوحة تاجر ePay.bg، ثم حدّث حالة الطلب في OpenCart يدويًا. ولا تعيد مرتجعات المنتجات في Sales > Returns الأموال عبر ePay.bg.

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

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

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

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

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

لا تظهر ePay.bg في الدفع: تحقّق من أن الترخيص نشط، وأن Enable/Disable مفعّل، وأن MIN والمفتاح السري للوضع المحدد مضبوطان، وأن العميل يُكمل الشراء بـ BGN أو EUR أو USD. تعرض صفحة الإعدادات تحذيرًا عندما تكون بيانات الاعتماد مفقودة. وتحقّق أيضًا من أن عنوان الدفع ضمن Geo Zone المحددة، وأن الطلب يبلغ Total المضبوط في الإعدادات.

تمت عملية الدفع لكن الطلب بقي بدون حالة: لا يحصل الطلب على حالته إلا من إشعار ePay.bg. تحقّق من إدخال عنوان URL للإشعارات في ملف التاجر لدى ePay.bg للوضع الذي تستخدمه (التجريبي أو الحقيقي)، تمامًا كما يظهر في Notification URL، وأن المفتاح السري لذلك الوضع صحيح. انظر الحقل Log في صفحة الإضافة؛ وفعّل Logging لرؤية كل إشعار.

يرد الإشعار بـ ERR=Not valid CHECKSUM: لا يطابق أي مفتاح سري محفوظ ملف التاجر الذي أرسل الإشعار. يواصل ePay.bg المحاولة، لذلك سيحصل الطلب على حالته بمجرد أن يصبح المفتاح صحيحًا.

يرد الإشعار بـ ERR=Not configured: لا يوجد مفتاح سري محفوظ. أدخله.

يرد الإشعار بـ STATUS=NO لفاتورة: لم تصدر هذه الفاتورة عن هذا المتجر، مثلًا عن متجر آخر على حساب ePay.bg نفسه. امنح كل متجر Invoice Prefix خاصًا به.

يرد الإشعار بـ STATUS=ERR: خطأ مؤقت، مثل إشعارين لنفس الطلب في اللحظة نفسها، أو تعذّر ضبط حالة الطلب. يعيد ePay.bg إرسال الإشعار. والسبب موجود في السجل.

يعرض عنوان URL للإشعار ERR=Method not allowed in the browser: هذا طبيعي. يقبل العنوان الطلبات الصادرة من ePay.bg فقط.

يرى العميل This payment method is not available. Please reload the checkout page.: جلسة الدفع لم تعد تطابق الطلب، أو عُطّلت طريقة الدفع في الأثناء. على العميل إعادة تحميل صفحة الدفع.

يرى العميل This order has nothing to pay.: إجمالي الطلب يساوي صفرًا، فليس هناك ما يُرسل إلى ePay.bg.

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

تم تغيير بادئة الفاتورة عند الحفظ: يمكن أن تحتوي البادئة على أرقام فقط، حتى 10. تُحذف الرموز الأخرى.

للمطورين: قبل إرسال نموذج الدفع إلى ePay.bg، تُطلق الإضافة حدث OpenCart باسم epay_bp_form_fields مع حقول النموذج والطلب، مثلًا لاستخدام صفحة الدفع المباشر بالبطاقة (PAGE=credit_paydirect)؛ ولا يمكن تغيير البيانات الموقّعة ومجموع التحقق من خلاله.

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

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

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

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