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

المتطلبات

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

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

العملة: يجب أن تكون عملة الدفع EUR أو PLN. لأي عملة أخرى تُخفى طريقة الدفع في صفحة الدفع.

حساب Montonio: تحتاج إلى مفتاح الوصول (access key) والمفتاح السري (secret key) لمتجرك من Montonio Partner System. مفاتيح بيئة الاختبار (sandbox) ومفاتيح البيئة الفعلية مختلفة، لذا تحتاج إلى زوج منها لكل بيئة تستخدمها. لا يلزم إعداد أي شيء آخر في Montonio: يُرسل عنوان الإشعارات مع كل دفعة.

الموقع العام: يجب أن يكون متجرك متاحًا عبر الإنترنت لاستقبال إشعارات Montonio. وإلا فستظل الطلبات تحصل على حالتها عندما يعود العميل إلى المتجر.

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

التثبيت

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

OpenCart 3

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

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

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

4. في Montonio Partner System، افتح Stores > your store > API keys وانسخ مفتاح الوصول والمفتاح السري الخاصين بالبيئة التجريبية (sandbox). ألصقهما في الإعدادات، واترك Sandbox mode مفعّلًا.

5. فعّل Enable/Disable، واضغط Save، ثم اختبر دفعة في بيئة الاختبار على طلب بعملة EUR. بعد ذلك أدخل مفاتيح البيئة الفعلية وأوقف تشغيل Sandbox mode.

OpenCart 4

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

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

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

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

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

الإعدادات

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

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

Montonio

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

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

Description: النص الذي يراه العميل في خطوة Confirm Order، أعلى زر التأكيد. الافتراضي: Pay directly from your bank account. You will be redirected to Montonio to choose your bank.

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

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

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

مفاتيح API

احصل على المفاتيح من Montonio Partner System (تحتوي الصفحة على رابط إليه) ضمن Stores > your store > API keys. مفاتيح بيئة الاختبار ومفاتيح البيئة الفعلية مختلفة. تستخدم بيئة الاختبار مفاتيحها فقط، بينما يستخدم الوضع الفعلي المفاتيح الفعلية فقط.

Sandbox mode: يستخدم بيئة الاختبار في Montonio (دفعات تجريبية دون أي مبلغ حقيقي). ويبدّل عنوان واجهة Montonio البرمجية وزوج المفاتيح معًا. الافتراضي: مفعّل. أوقفه فقط بعد إدخال مفاتيح البيئة الفعلية. تستمر الدفعات التي أُجريت في البيئة الأخرى في استخدام مفاتيح بيئتها الخاصة للتأكيدات والاسترداد. وما دام مفعّلًا يرى العملاء في خطوة Confirm Order العبارة وضع بيئة الاختبار — دفعة تجريبية، لا يُخصم أي مبلغ حقيقي.

Sandbox access key: مفتاح الوصول (UUID) لمتجرك في بيئة اختبار Montonio.

Sandbox secret key: المفتاح السري لمتجرك في بيئة اختبار Montonio.

Live access key: مفتاح الوصول (UUID) لمتجرك في بيئة Montonio الفعلية.

Live secret key: المفتاح السري لمتجرك في بيئة Montonio الفعلية.

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

Notification URL: العنوان الذي ترسل إليه Montonio إشعارات الدفع. يبدو في OpenCart 3 كالتالي: https://your-store/index.php?route=extension/payment/wcp_montonio_payment/notification، وفي OpenCart 4 كالتالي: https://your-store/index.php?route=extension/wcp_montonio_payment/payment/wcp_montonio_payment.notification، ويُبنى من عنوان واجهة المتجر لتثبيت OpenCart الخاص بك. لا تحتاج إلى إدخاله في أي مكان: تُرسله الإضافة إلى Montonio مع كل دفعة.

الطلبات

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

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

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

Payment Failed Status: تُعيَّن عندما يرفض البنك دفعة كانت محجوزة كمعتمدة. الافتراضي: فشل.

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

متقدم

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

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

Delete data: عند التفعيل، يؤدي إلغاء تثبيت الإضافة إلى حذف إعدادات البوابة وسجلها. أما تعطيل الإضافة فلا يحذف أي شيء. تُحفظ بيانات الطلب (معرّفات UUID الخاصة بـ Montonio والملاحظات) دائمًا. الافتراضي: معطّل.

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

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

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

إشعارات الدفع

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

صفحة الدفع

في خطوة Payment Method يختار العميل طريقة الدفع (افتراضيًا Bank payment (Montonio)). وفي خطوة Confirm Order يرى العميل أيقونة Montonio ووصفك. ينشئ OpenCart الطلب في هذه الخطوة، ولا يزال بدون حالة. عندما يضغط العميل Confirm Order، تنشئ الإضافة دفعة Montonio بإجمالي الطلب بعملة الطلب، وتوجّه العميل إلى صفحة دفع Montonio. هناك يختار العميل بنكًا ويدفع. وفي OpenCart 4 يختار العميل طريقة الدفع بزر Choose في كتلة طريقة الدفع، في نافذة Payment method options، ويضغط Confirm Order في أسفل صفحة الدفع. تُعرض بنوك بلد الفوترة لدى العميل أولًا (بولندا لطلبات PLN). تظهر الدفعة باسم Order مع رقم الطلب. تُفتح صفحة Montonio بلغة المتجر إذا كانت الألمانية أو الإنجليزية أو الإستونية أو الفنلندية أو الليتوانية أو اللاتفية أو البولندية أو الروسية، وإلا فبالإنجليزية.

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

إذا أبلغت Montonio أن الدفعة ما زالت قيد الانتظار عند عودة العميل، تعرض صفحة Payment confirmation النص نفسه مع زر Check again وزر Back to checkout. يطلب Check again من Montonio الحالة الحالية للدفعة. ويضبط الإشعار حالة الطلب فور وصوله.

إذا أُلغيت الدفعة أو رُفضت، يعود العميل إلى صفحة الدفع مع إحدى هذه الرسائل: The payment was cancelled or rejected by the bank. You can try again or choose another payment method.، أو The payment was not completed. You can try again or choose another payment method.، أو Montonio could not complete the payment. Please try again or choose another payment method. وفي OpenCart 4 تظهر هذه الرسائل أعلى صفحة الدفع. تُحفظ السلة. ويُنشئ OpenCart 3 طلبًا جديدًا في كل مرة تُعرض فيها خطوة Confirm Order، ويحتفظ OpenCart 4 بطلب واحد للدفع ويدفع الطلب نفسه مجددًا بدفعة Montonio جديدة. قبل إنشاء دفعة جديدة، تسأل الإضافة Montonio عن المحاولة السابقة للسلة نفسها. إذا كانت قد دُفعت بالفعل، تُؤكَّد تلك الدفعة، ويذهب العميل إلى صفحة النجاح، ولا تُجرى دفعة ثانية.

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

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

تقبل الإضافة المدفوعات المصرفية فقط (بدء الدفع). لا تدعم الدفع بالبطاقات أو BLIK أو Apple Pay أو Google Pay أو Pay Later أو التمويل، ولا شحن Montonio ولا الاشتراكات ولا طرق الدفع المحفوظة ولا اختيار البنك في موقعك الخاص.

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

حالات الطلب

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

Order Status After Payment (الافتراضي قيد المعالجة): أكدت Montonio الدفعة (PAID) بالمبلغ والعملة المطابقين تمامًا لمبلغ الطلب وعملته. تعرض ملاحظة البنك ومعرّف UUID لطلب Montonio والمبلغ والبيئة.

Payment On Hold Status (الافتراضي قيد الانتظار): لم يؤكد البنك الدفعة بعد (AUTHORIZED)؛ وينتقل الطلب إلى Order Status After Payment عندما تُبلغ Montonio بالحالة PAID. ويُوضع الطلب في حالة التعليق أيضًا عندما تُبلغ Montonio بمبلغ أو عملة تختلف عن إجمالي الطلب، أو عندما تصل دفعة من بيئة الاختبار بينما المتجر في الوضع الفعلي (لم يُستلم أي مبلغ حقيقي)، أو عندما تصل الدفعة بعد أن أُعطي الطلب حالة أخرى، مثل الإلغاء. وتشرح الملاحظة ذلك. تحقّق من الدفعة في Montonio Partner System ثم نفّذ الطلب أو استرد الدفعة.

Payment Failed Status (الافتراضي فشل): رفض البنك دفعة كانت محجوزة كمعتمدة. ولا يمكن أن يغيّر هذه الحالة إلا آخر محاولة دفع للطلب.

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

لا تُعاد الطلبات المدفوعة أو المستردة إلى الفتح بسبب الإشعارات اللاحقة. إذا وصلت دفعة ثانية لطلب مدفوع بالفعل، فلا يتغير الطلب. وتطلب منك ملاحظة استرداد الدفعة الثانية في Montonio Partner System.

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

تبويب VibeFox Montonio Payment

في Sales > Orders افتح طلبًا دُفع عبر Montonio. في أسفل صفحة الطلب، بجوار History وAdditional، يعرض تبويب VibeFox Montonio Payment محاولات دفع الطلب مع التاريخ وMontonio order UUID (مع تسمية Sandbox للدفعات التجريبية) والمبلغ والبنك وMontonio status والنتيجة. وأسفل ذلك تظهر المبالغ Paid / refunded ونموذج الاسترداد وسجل الاسترداد وMontonio notes للطلب. يُعرض التبويب للمستخدمين الذين لديهم صلاحية الوصول إلى الإضافة.

الاسترداد

في تبويب VibeFox Montonio Payment أدخل المبلغ (يُملأ المبلغ الذي لم يُسترد بعد)، واكتب سببًا إن أردت (يُحفظ في ملاحظة الطلب فقط)، ثم اضغط Refund via Montonio. أكّد السؤال هل تريد استرداد هذا المبلغ عبر Montonio؟ لا يمكن التراجع عن هذا الإجراء. يُدعم الاسترداد الكامل والجزئي. تحتاج إلى صلاحية تعديل الإضافة (وتُحدَّد في System > Users > User Groups). يقتصر الاسترداد على المبلغ الذي خصمته Montonio، لذلك بعد وجود فارق في المبلغ يمكنك استرداد ما دفعه العميل فعلًا حتى لا يتجاوز الإجمالي، لا إجمالي الطلب. يُرسل الاسترداد إلى البيئة التي تمت فيها الدفعة (بيئة الاختبار أو البيئة الفعلية)، لذلك يجب ضبط مفاتيح تلك البيئة. إذا لم تقبل Montonio الاسترداد، يعرض التبويب الخطأ ولا يُسجَّل أي استرداد. يُضاف الاسترداد المُرسل إلى سجل الاسترداد والملاحظات مع حالته ومعرّف الاسترداد في Montonio. يضع الاسترداد الكامل الطلب على Refunded Status دون إشعار العميل ودون إعادة المنتجات إلى المخزون، تمامًا كتغيير الحالة يدويًا. لا يغيّر الاسترداد الجزئي الحالة. ويكون الاسترداد متاحًا بعد أن تُبلغ Montonio بأن الدفعة مدفوعة.

تؤكد Montonio لاحقًا كل استرداد أو ترفضه عبر إشعار. تُضاف الموافقة إلى الملاحظات. وإذا رفضت Montonio الاسترداد، فستوضح الملاحظة أن المال لم يُعَد إلى العميل؛ تحقّق من ذلك في Montonio Partner System وصحّح الاسترداد في OpenCart.

لا ترسل المرتجعات الواردة في Sales > Returns أموالًا عبر Montonio. تُضاف عمليات الاسترداد التي أُجريت في Montonio Partner System إلى الملاحظات عندما تُبلغ Montonio بها. ولا تتغير حالة الطلب تلقائيًا؛ حدّثها يدويًا إذا لزم الأمر.

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

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

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

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

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

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

لا يظهر Montonio في صفحة الدفع: تحقّق من أن الترخيص فعّال، وأن Enable/Disable مفعّل، وأن المفتاحين الخاصين بالبيئة الحالية مضبوطان: Sandbox access key وSandbox secret key في وضع بيئة الاختبار، أو Live access key وLive secret key في الوضع الفعلي. تعرض صفحة الإعدادات تحذيرًا عندما تكون المفاتيح مفقودة. يجب أن يدفع العميل بعملة EUR أو PLN (العملة المختارة في المتجر). تحقّق أيضًا من أن عنوان الدفع يقع ضمن Geo Zone المحددة، وأن الطلب يبلغ Total المحدد في الإعدادات.

تمت الدفعة لكن الطلب بقي بلا حالة: لم يصل الإشعار إلى متجرك. تحقّق من أن المتجر متاح عبر الإنترنت، وأن المفاتيح في الإعدادات تنتمي إلى بيئة الدفعة. كما يحصل الطلب على حالته عندما يعود العميل إلى المتجر بعد الدفع، أو عندما يضغط Check again، أو عندما يحاول دفع السلة نفسها مرة أخرى.

يجيب الإشعار بـ Invalid token: لم يتطابق توقيع الرمز أو انتهاء صلاحيته أو مفتاح الوصول. تحقّق من أن مفتاح الوصول والمفتاح السري منسوخان بشكل صحيح وينتميان إلى البيئة الصحيحة، ومن أن ساعة الخادم صحيحة. ويُرفض أيضًا الرمز الموقّع بمفتاح البيئة الأخرى.

يجيب الإشعار بـ Payment does not belong to this order: لم يُنشئ هذا المتجر الدفعة لهذا الطلب. يحدث ذلك عندما يستخدم متجران الحساب نفسه في Montonio وأرقام الطلبات نفسها.

يجيب الإشعار بـ Gateway not configured: لم تُضبط أي مفاتيح Montonio، أو مفاتيح بيئة الدفعة مفقودة. أدخل المفاتيح؛ وستعيد Montonio إرسال الإشعار.

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

يرى العميل خطأً بعد Confirm Order: انظر خانة Log في صفحة الإضافة. تعني الرسالة This payment method is not available. Please reload the checkout page. أن جلسة الدفع لم تعد تطابق الطلب، أو أن طريقة الدفع أُوقفت في هذه الأثناء: على العميل إعادة تحميل صفحة الدفع. وتشير الرسالة This payment method is temporarily unavailable. Please choose another payment method. عادةً إلى مفاتيح خاطئة أو مفقودة. وتعني الرسالة Montonio could not start the payment. Please check your order details or choose another payment method. أن Montonio رفضت بيانات الدفع؛ والسجل يحتوي على السبب.

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

لا تؤكد دفعات بيئة الاختبار طلبًا فعليًا: لا تؤكد دفعة بيئة الاختبار طلبًا أبدًا ما دام المتجر في الوضع الفعلي؛ بل يُوضع الطلب في حالة التعليق. غيّر Sandbox mode إلى البيئة التي تريدها واستخدم مفاتيح تلك البيئة.

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

يفشل الاسترداد برسالة متعلقة بالبيئة: تمت الدفعة في بيئة الاختبار أو في البيئة الفعلية، ومفاتيح تلك البيئة غير مضبوطة. أدخلها وأعد المحاولة. وتعني الرسالة The order is being updated by a payment notification, try again in a moment. أن إشعارًا يُعالَج للطلب نفسه.

للمطورين: تُطلق الإضافة أحداث OpenCart التالية wc_mnt_supported_currencies وwc_mnt_order_data وwc_mnt_locale لتغيير العملات المدعومة وبيانات الدفع ولغة صفحة Montonio.

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

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

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

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