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

المتطلبات

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

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

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

حساب MakeCommerce: تحتاج إلى Shop ID وSecret key من MakeCommerce Merchant Portal (Settings > API). تملك بيئتا الاختبار والإنتاج حسابين ومفتاحين منفصلين. تحدد طرق الدفع والعملات المتاحة عقدُك مع MakeCommerce. لا تُعرض العملات ذات ثلاث منازل عشرية، مثل KWD أو BHD.

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

التثبيت

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

OpenCart 3

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

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

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

4. أدخل Shop ID وSecret key لبيئة الاختبار، وللمدفوعات الحقيقية أدخل مفاتيح الإنتاج (راجع الإعدادات). لا يلزم ضبط أي شيء في Merchant Portal.

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

OpenCart 4

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

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

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

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

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

الإعدادات

جميع الإعدادات موجودة في صفحة الإضافة: Extensions > Extensions > Payments > VibeFox MakeCommerce Payment > Edit. تظهر الأقسام في القائمة على اليسار، ويحفظ الزر Save الموجود أسفل القائمة الصفحة بأكملها. وفوق الإعدادات، تعرض الصفحة Test mode is on: payments are created in the MakeCommerce test environment and no real money is charged. طالما كان وضع الاختبار مفعّلًا. وتحذّرك عندما تكون طريقة الدفع مفعّلة لكن Shop ID أو Secret key للبيئة الحالية فارغ (وعندها تُخفى طريقة الدفع عند إتمام الشراء)، وعندما لا تستطيع MakeCommerce تحصيل العملة الافتراضية للمتجر (وعندها تُخفى طريقة الدفع للطلبات بتلك العملة). ومن دون صلاحية تعديل الإضافة، تعرض الصفحة الإعدادات لكنها لا تستطيع حفظها.

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

MakeCommerce

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

Title: اسم طريقة الدفع الذي يراه العملاء عند إتمام الشراء. وهو أيضًا اسم طريقة الدفع المحفوظ في الطلب. الافتراضي: Bank link or card (MakeCommerce). حقل إلزامي، حتى 128 حرفًا.

Description: النص الذي يراه العميل في الخطوة Confirm Order فوق زر التأكيد. الافتراضي: Pay with your Estonian, Latvian, Lithuanian or Finnish bank, or by card. You will be redirected to the secure MakeCommerce payment page.

Sort Order: موضع MakeCommerce بين طرق الدفع عند إتمام الشراء. اتركه فارغًا أو أدخل عددًا صحيحًا.

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

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

حساب MakeCommerce

يوجد Shop ID وSecret key في MakeCommerce Merchant Portal ضمن Settings > API. يملك بوابة الاختبار وبوابة الإنتاج حسابين ومفتاحين منفصلين. يتضمن القسم روابط إلى البوابتين وإلى صفحة التسجيل في MakeCommerce.

Test mode: يستخدم بيئة الاختبار الخاصة بـ MakeCommerce (لا يُخصم أي مبلغ حقيقي). تُنشأ المدفوعات الجديدة في البيئة المحددة باستخدام مفاتيحها. يتذكر كل طلب البيئة التي دُفع فيها: تُرسل استعلامات الحالة وعمليات الاسترداد دائمًا إلى تلك البيئة. وعندما يكون مفعّلًا، يرى العملاء في الخطوة Confirm Order الرسالة TEST MODE — MakeCommerce test environment, no real money is charged. الافتراضي: مفعّل.

Test Shop ID: Shop ID لحساب الاختبار الخاص بك، بالصيغة xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

Test Secret key: Secret key لحساب الاختبار الخاص بك. يوقّع رسائل الدفع ويتحقق منها.

Live Shop ID: Shop ID لحساب الإنتاج الخاص بك، بالصيغة نفسها.

Live Secret key: Secret key لحساب الإنتاج الخاص بك.

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

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

لا يلزم ضبط أي شيء في Merchant Portal. يعرض Callback URLs، للاستئناس فقط، عنوان عودة العميل أو إلغائه وعنوان إشعارات الدفع. تُبنى هذه العناوين من عنوان المتجر في تثبيت OpenCart الخاص بك، مثل https://your-store/index.php?route=extension/payment/wcp_makecommerce_payment/notification في OpenCart 3، وhttps://your-store/index.php?route=extension/wcp_makecommerce_payment/payment/wcp_makecommerce_payment.notification في OpenCart 4. تحمل كل معاملة روابط الإرجاع والإلغاء والإشعار الخاصة بها، وتُبنى على هذه العناوين مع رقم الطلب ومفتاح مضاف. ترسل MakeCommerce رسالة موقّعة إلى رابط الإشعار (من الخادم إلى الخادم)، وترسل عبر متصفح العميل إلى رابط العودة أو الإلغاء. يُتحقق من التوقيع بالـ Secret key للبيئة التي أُنشئت فيها المعاملة. تُرفض الرسائل التي لا تحمل توقيعًا صالحًا.

تتعامل الإضافة مع حالات معاملات MakeCommerce التالية:

تُؤكَّد الدفعة أيضًا عندما يعود العميل إلى المتجر. وإذا عاد العميل من دون رسالة موقّعة، تطلب الإضافة الحالة من واجهة MakeCommerce البرمجية.

الطلبات

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

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

Payment On Hold Status: تحتاج الدفعة إلى مراجعة يدوية: المبلغ المدفوع أو العملة يختلفان عن الطلب، أو المعاملة ليست نهائية بعد لدى MakeCommerce، أو وصلت الأموال لطلب ملغى. توضح ملاحظة السبب. الافتراضي: بانتظار الدفع، لأن OpenCart لا يملك حالة "في الانتظار". يمكنك إنشاء حالتك الخاصة في System > Localisation > Order Statuses واختيارها هنا.

Cancelled Order Status: الحالة التي تعني "ملغى" في متجرك. تضع الدفعة القادمة من MakeCommerce لطلب كهذا الطلبَ في حالة الانتظار. لا تضبط الإضافة هذه الحالة بنفسها أبدًا. الافتراضي: ملغى.

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

متقدم

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

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

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

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

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

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

إتمام الشراء

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

بعد الدفع، يعود العميل إلى متجرك. لا يُعلَّم الطلب بأنه مدفوع إلا بعد أن تؤكده MakeCommerce: عبر الإشعار الموقّع أو العودة الموقّعة للعميل، مع التحقق من المعاملة عبر واجهة MakeCommerce البرمجية. ثم يحصل الطلب على حالته بالطريقة القياسية في OpenCart، مع رسائل البريد الإلكتروني المعتادة للطلب وتحديث المخزون، ويرى العميل صفحة نجاح الطلب في OpenCart مع الرسالة Your MakeCommerce payment has been received. وإذا دخل الطلب حالة المراجعة، تعرض الصفحة Your MakeCommerce payment was received and is being reviewed by the store.

إذا كانت الدفعة معتمدة لكنها لم تكتمل بعد، أو إذا كان الطلب يُؤكَّد في الوقت نفسه بواسطة طلب آخر، أو إذا تعذّر الوصول إلى MakeCommerce، تظهر صفحة Payment confirmation مع الرسالة We could not confirm your payment yet. If you completed it, your order will be updated automatically — please do not pay again. والأزرار Check again وBack to checkout. ينقر Check again ليطلب من MakeCommerce حالة أحدث معاملات الطلب. ويضبط الإشعار حالة الطلب فور اكتمال الدفعة.

إذا ألغى العميل على صفحة MakeCommerce، أو انتهت صلاحية الدفعة أو فشلت، يعود العميل إلى إتمام الشراء برسالة، مثل The payment was cancelled. You can try again or choose another payment method. أو The payment session expired. Please try again. أو The payment was not completed. Please try again or choose another payment method. في OpenCart 4 تظهر هذه الرسائل أعلى صفحة الدفع. تُحفظ السلة ويمكن للعميل الدفع مرة أخرى. كل محاولة هي معاملة MakeCommerce جديدة (ينشئ OpenCart 3 أيضًا طلبًا جديدًا في كل مرة تُعرض فيها الخطوة Confirm Order، أما OpenCart 4 فيحتفظ بطلب واحد للدفع ويدفعه من جديد). قبل إنشاء معاملة جديدة، تُفحص المحاولات المفتوحة للسلة نفسها لدى MakeCommerce: إذا كانت إحداها مدفوعة بالفعل، ينتقل العميل مباشرة إلى صفحة النجاح. ما زال رابط الدفع الأقدم للسلة نفسها يعمل، لكن السلة لا تُدفع أبدًا في طلبين: فالدفعة المتأخرة لطلب أقدم من سلة مدفوعة بالفعل تضيف فقط ملاحظة إلى الطلب المدفوع.

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

إذا تعذّر على MakeCommerce بدء الدفع، يبقى العميل في الخطوة Confirm Order مع الرسالة MakeCommerce is temporarily unavailable. Please try again in a moment or choose another payment method. أو MakeCommerce could not start the payment for this order. Please choose another payment method or contact us. ويُكتب السبب التقني في السجل.

يُختار البنك أو البطاقة في صفحة MakeCommerce، وليس في إتمام الشراء في متجرك. لا تملك الإضافة بطاقات محفوظة أو مدفوعات متكررة أو اشتراكات، ولا شحنًا عبر MakeCommerce (خزائن الطرود، والملصقات).

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

حالات الطلب

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

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

Payment On Hold Status (الافتراضي بانتظار الدفع): اختلف المبلغ المدفوع أو العملة عن الطلب، أو كان المبلغ مفقودًا، أو لم تكن المعاملة لدى MakeCommerce نهائية بعد رغم الإبلاغ عنها كمكتملة، أو وصلت الدفعة بعد إلغاء الطلب. تشرح الملاحظة ذلك. لا تُكمل المعاملة التي بها اختلاف الطلب لاحقًا أبدًا؛ أما المعاملة التي لم تكن نهائية فتُكمل الطلب عندما تبلغ MakeCommerce باكتمالها. تحقق من المعاملة في Merchant Portal ثم نفّذ الطلب أو استرد الدفعة.

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

إذا وصلت دفعة ثانية لطلب مدفوع بالفعل، فلا يتغير الطلب. تطلب ملاحظة منك استرداد النسخة المكررة في MakeCommerce Merchant Portal. ولا تضيف الدفعة لطلب مُسترد، أو لطلب تحوّل إلى طريقة دفع أخرى، إلا ملاحظة.

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

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

في Sales > Orders افتح طلبًا دُفع عبر MakeCommerce. في أسفل صفحة الطلب، بجوار History وAdditional، تعرض علامة التبويب VibeFox MakeCommerce Payment جميع معاملات MakeCommerce للطلب (التاريخ، ومعرّف المعاملة، وتسمية Test للمدفوعات التجريبية، والمبلغ، وحالة MakeCommerce ونتيجتها)، والمبالغ Paid / refunded، ونموذج الاسترداد، وسجل الاسترداد، وMakeCommerce notes الخاصة بالطلب. تُعرض العلامة للمستخدمين الذين لديهم صلاحية الوصول إلى الإضافة؛ وتحتاج أزرارها إلى صلاحية تعديل الإضافة (تُضبط في System > Users > User Groups).

Check MakeCommerce payment status: يطلب من واجهة MakeCommerce البرمجية حالة معاملات الطلب (الأحدث أولًا)، ويطبّقها، ويضيف ملاحظة بالنتيجة. استخدمه عندما يقول العميل إنه دفع لكن الطلب ليس له حالة.

الاسترداد

في علامة التبويب VibeFox MakeCommerce Payment أدخل Amount (يُملأ المبلغ الذي لم يُسترد بعد تلقائيًا)، واختياريًا Reason (optional)، ثم انقر على Refund via MakeCommerce. أكّد السؤال Refund this amount via MakeCommerce? يُدعم الاسترداد الكامل والجزئي. تُقصر عمليات الاسترداد على مبلغ المعاملة وعملتها في MakeCommerce، لذلك بعد اختلاف في المبلغ يمكنك استرداد ما دفعه العميل فعلًا كحد أقصى، لا إجمالي الطلب. يُرسل الاسترداد إلى البيئة التي تمت فيها الدفعة (اختبار أو إنتاج)، لذلك يجب ضبط مفاتيح تلك البيئة. يُرسل السبب إلى MakeCommerce كتعليق على الاسترداد؛ وإذا لم يوجد سبب يكون التعليق Refund for order ورقم الطلب. إذا لم تقبل MakeCommerce الاسترداد، تعرض علامة التبويب الخطأ، وتُضاف ملاحظة، ولا يُسجَّل أي استرداد. وإذا كانت MakeCommerce ما زالت تعالج الدفعة، تكون الرسالة MakeCommerce is still processing this payment — try the refund again later. يُضاف الاسترداد الناجح إلى سجل الاسترداد والملاحظات مع معرّف الاسترداد لدى MakeCommerce. يضع الاسترداد الكامل الطلب في Refunded Status من دون إشعار العميل ومن دون إعادة المنتجات إلى المخزون، كما في تغيير الحالة يدويًا. لا يغيّر الاسترداد الجزئي الحالة. تتوفر عمليات الاسترداد بعد أن تؤكد MakeCommerce الدفعة.

لا تعيد مرتجعات المنتجات في Sales > Returns الأموال عبر MakeCommerce.

تصل عمليات الاسترداد التي تتم في Merchant Portal مع حالة المعاملة وتُضاف إلى الملاحظات. ولا تتغير حالة الطلب تلقائيًا.

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

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

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

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

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

لا تظهر MakeCommerce عند إتمام الشراء: تحقق من أن الترخيص نشط، وأن Enable/Disable مفعّل، وأن البيئة الحالية لديها مفاتيحها: Test Shop ID وTest Secret key في وضع الاختبار، وLive Shop ID وLive Secret key في الوضع الحي. تحقق من أن عملة الطلب لا تحتوي على أكثر من منزلتين عشريتين، وأن عنوان الدفع ضمن Geo Zone المحددة، وأن الطلب يبلغ Total المضبوط في الإعدادات.

تمت الدفعة لكن الطلب يبقى من دون حالة: لم تتمكن الإشعارات من الوصول إلى المتجر، على سبيل المثال بسبب جدار حماية أو مصادقة أساسية. ويحصل الطلب على حالته أيضًا عندما يعود العميل إلى المتجر أو ينقر على Check again، وعندما تنقر على Check MakeCommerce payment status في علامة تبويب الطلب. تحقق من ضبط مفاتيح البيئة التي تمت فيها الدفعة: يُتحقق من الإشعار بـ Secret key تلك البيئة، ومن دونه تتلقى MakeCommerce خطأ وتعيد المحاولة. فعّل Debug log لرؤية الإشعارات.

الطلب في حالة المراجعة: اقرأ MakeCommerce notes في علامة تبويب الطلب (راجع حالات الطلب)، وتحقق من المعاملة في Merchant Portal، ثم نفّذ الطلب أو استرد الدفعة.

تُرفض الإشعارات: تُرفض الرسالة ذات التوقيع الخاطئ، أو الخاصة بطلب آخر أو متجر آخر أو معاملة لم تُنشأ للطلب، ولا يتغير شيء. تحقق من أن Shop ID وSecret key ينتميان إلى الحساب والبيئة نفسهما في MakeCommerce.

يرى العميل خطأً بعد Confirm Order: فعّل Debug log وانظر إلى الحقل Log في صفحة الإضافة. تعني الرسالة This payment method is not available. Please reload the checkout page. أن جلسة إتمام الشراء لم تعد تطابق الطلب، أو أن طريقة الدفع أُوقفت في الأثناء: على العميل إعادة تحميل صفحة إتمام الشراء. ويعطي العملة التي لا تستطيع MakeCommerce تحصيلها الرسالة MakeCommerce cannot process payments in مع رمز العملة.

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

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

للمطوّرين: تُطلق الإضافة أحداث OpenCart wc_mkc_transaction_data وwc_mkc_customer_data وwc_mkc_supported_locales وwc_mkc_is_available لتعديل بيانات المعاملة وبيانات العميل ولغات صفحة الدفع وتوفر طريقة الدفع.

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

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

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

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