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

المتطلبات

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

PHP: 8.0 أو أحدث.

العملة: يجب أن تكون عملة الدفع إحدى العملات التي تدعمها Mollie: AED، AUD، BGN، BRL، CAD، CHF، CZK، DKK، EUR، GBP، HKD، HUF، ILS، ISK، JPY، MXN، MYR، NOK، NZD، PHP، PLN، RON، SEK، SGD، THB، TWD، USD، ZAR. بالنسبة إلى العملات الأخرى تُخفى طريقة الدفع عند الدفع. وطرق الدفع التي تقدمها Mollie تعتمد على العملة وعلى حسابك.

اتصال المتجر بالإنترنت: ترسل Mollie إشعارات webhook إلى متجرك، لذلك يجب أن يكون الموقع متاحًا عبر الإنترنت. ومن دون webhooks، تحصل الطلبات على حالتها عندما يعود العميل من Mollie.

حساب Mollie: تحتاج إلى مفاتيح API من Mollie Dashboard > Developers > API keys. تبدأ مفاتيح الاختبار بـ test_، وتبدأ المفاتيح الحية بـ live_. لا حاجة إلى أي مفاتيح أو أسرار أخرى. تُفعَّل طرق الدفع نفسها في حساب Mollie الخاص بك.

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

التثبيت

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

OpenCart 3

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

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

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

4. أدخل مفاتيح API الخاصة بالاختبار والمفاتيح الحية (راجع Configuration). لا حاجة إلى إعداد أي webhook في Mollie.

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

OpenCart 4

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

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

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

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

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

الإعدادات

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

عند الحفظ، يجب أن يتكون Title من 1 إلى 128 حرفًا، ويجب أن يكون Sort Order عددًا صحيحًا، ويجب أن يكون Total رقمًا يساوي 0 أو أكبر؛ وإلا فلن يُحفظ أي شيء. لا يُحفظ مفتاح API الذي لا يبدأ بـ test_ أو live_ متبوعًا بما لا يقل عن 30 حرفًا وأرقامًا: تعرض الصفحة Settings saved, except the API key shown in red.، ويشير الخطأ إلى المفتاح، ويبقى المفتاح المحفوظ سابقًا كما هو.

Checkout

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

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

Description: النص الذي يظهر للعميل في خطوة Confirm Order، فوق زر التأكيد. الافتراضي: Pay securely via Mollie.

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

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

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

مفاتيح API

تجد مفاتيح API الخاصة بك في Mollie Dashboard ضمن Developers > API keys؛ ويحتوي هذا القسم على رابط إلى تلك الصفحة. مفاتيح الاختبار ومفاتيح الإنتاج منفصلة.

Test Mode: يستخدم مفتاح API الخاص بالاختبار للمدفوعات الجديدة. ولا تُعالَج أي مدفوعات حقيقية. وفي صفحة الدفع التجريبية لدى Mollie يمكنك اختيار نتيجة الدفع. يرى العملاء Test mode: no real payment will be made. في خطوة Confirm Order. وتستمر المدفوعات التي أُجريت في الوضع الآخر في استخدام مفتاح وضعها الخاص للتحقق من الحالة وللاسترداد. الافتراضي: مفعّل.

Test API Key: مفتاح API الخاص بالاختبار في Mollie (يبدأ بـ test_).

Live API Key: مفتاح API الحي في Mollie (يبدأ بـ live_).

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

Webhook

Webhook URL: يُعرض للاسترشاد فقط. لا حاجة إلى أي إعداد لـ webhook: ترسل الإضافة هذا الرابط إلى Mollie مع كل دفعة. وهو يبدو في OpenCart 3 مثل https://your-store/index.php?route=extension/payment/wcp_mollie_gateway/webhook، وفي OpenCart 4 مثل https://your-store/index.php?route=extension/wcp_mollie_gateway/payment/wcp_mollie_gateway.webhook، ويُنشأ من عنوان واجهة المتجر في تثبيت OpenCart الخاص بك. ويجب أن يكون متاحًا عبر الإنترنت، وإلا فلن تحصل الطلبات على حالتها إلا عندما يعود العميل من Mollie.

الطلبات

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

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

Awaiting Mollie Payment Status: اختار العميل التحويل البنكي في صفحة Mollie؛ يُعلَّم الطلب تلقائيًا بأنه مدفوع عندما تستلم Mollie المال. الافتراضي: قيد الانتظار.

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

Payment Error Status: فشل التحويل البنكي المنتظر أو الدفع المعتمد أو انتهت صلاحيته أو أُلغي. الافتراضي: فشل.

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

متقدم

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

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

Delete Data on Uninstall: عند التفعيل، تُحذف إعدادات البوابة وسجلها عند إلغاء تثبيت الإضافة. ولا تُحذف معرّفات دفعات Mollie المحفوظة مع الطلبات (المدفوعات والاستردادات) أبدًا. الافتراضي: إيقاف.

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

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

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

الدفع

في خطوة Payment Method يختار العميل طريقة الدفع (افتراضيًا Mollie). وفي خطوة Confirm Order يرى العميل وصفك والملاحظة You will be redirected to Mollie to choose a payment method and pay. ينشئ OpenCart الطلب في هذه الخطوة، ولا يزال بدون حالة. وعندما يضغط العميل على Confirm Order، تنشئ الإضافة دفعة Mollie بإجمالي الطلب بعملة الطلب (لا تحتوي JPY وISK على منازل عشرية)، بالوصف Order # مع رقم الطلب، وترسل العميل إلى صفحة الدفع المستضافة لدى Mollie. وهناك يختار العميل إحدى طرق الدفع المفعّلة في حساب Mollie الخاص بك ويدفع. وفي OpenCart 4 يختار العميل طريقة الدفع بالزر Choose في كتلة طريقة الدفع، في النافذة Payment method options، ثم يضغط على Confirm Order في أسفل صفحة الدفع.

لا تحمل إشعارات webhook من Mollie أي توقيع، بل معرّف الدفعة فقط. لذلك لا تثق الإضافة أبدًا بإشعار webhook بذاته: إذ تقبل فقط معرّفات الدفعات التي أنشأتها بنفسها، وتقرأ الدفعة من واجهة Mollie API باستخدام مفتاح الوضع الذي أُجريت فيه الدفعة، وتتحقق من أن الدفعة تنتمي إلى الطلب، وتقارن المبلغ المدفوع والعملة بإجمالي الطلب. ولا يُعلَّم الطلب كمدفوع إلا بعد أن تؤكد Mollie ذلك بهذه الطريقة. وتتعامل الإضافة مع حالات الدفع التالية في Mollie:

عندما يعود العميل، تتحقق الإضافة من الدفعة عبر واجهة Mollie API بالطريقة نفسها. ثم يحصل الطلب على حالته بالطريقة القياسية في OpenCart، مع رسائل البريد الإلكتروني المعتادة للطلبات وتحديث المخزون، ويرى العميل صفحة نجاح الطلب في OpenCart مع الرسالة Your payment with Mollie has been received. وفي حالة التحويل البنكي تعرض الصفحة Your order will be processed as soon as Mollie receives your bank transfer. وإذا كان الطلب في حالة On hold، تعرض الصفحة We are confirming your payment with Mollie. The order will be updated automatically — please do not pay again. وإذا فشلت دفعة منتظرة، تعرض الصفحة Your Mollie payment was not completed. Please contact us about this order.

إذا أُلغيت الدفعة أو فشلت أو انتهت صلاحيتها أو لم تكتمل، يعود العميل إلى صفحة الدفع مع رسالة، مثل You cancelled the Mollie payment. You can try again or choose another payment method. أو The Mollie payment has expired. Please try again or choose another payment method. وفي OpenCart 4 تُعرض هذه الرسائل أعلى صفحة الدفع. وتُحفظ السلة. وإذا تعذر الوصول إلى Mollie أو لم تتخذ قرارها بعد، تظهر صفحة Payment confirmation تطلب من العميل عدم الدفع مرة أخرى، وتعرض زر Check again؛ ويحدد webhook حالة الطلب فور وصوله.

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

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

إذا تعذر على Mollie بدء الدفعة، يبقى العميل في خطوة Confirm Order مع رسالة قصيرة فوق الزر، مثل The payment provider could not be reached. Please try again in a moment. أو This payment method is temporarily unavailable. Please choose another payment method. (مفتاح API خاطئ) أو Mollie cannot accept a payment of this amount or currency. Please choose another payment method. ويُكتب السبب الفني في السجل.

يعمل webhook أيضًا أثناء وجود المتجر في وضع الصيانة، لأن OpenCart 3 يسمح بمرور طلبات إضافات الدفع، وفي OpenCart 4 تضيف الإضافة إجراء بدء التشغيل (startup action) لهذا الغرض، وهو يسمح أيضًا بعودة العميل من Mollie.

يختار العميل طريقة Mollie في صفحة Mollie، وليس في صفحة الدفع الخاصة بمتجرك. لا تحتوي الإضافة على اشتراكات أو مدفوعات متكررة، ولا على بطاقات محفوظة أو تفويضات (mandates)، ولا على حقول بطاقات في موقعك، ولا على أزرار Apple Pay أو PayPal السريعة، ولا على Orders API؛ لذلك لا تعرض Mollie الطرق التي تحتاج إلى بنود الطلب (مثل بعض متغيرات Klarna أو Billie أو in3) لهذه المدفوعات. وتُحصَّل الدفعات المعتمدة أو تُلغى في Mollie Dashboard، لا من OpenCart.

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

حالات الطلب

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

Order Status After Payment (الافتراضي قيد المعالجة): تم تأكيد الدفع. تعرض الملاحظة دفعة Mollie (tr_...) والطريقة والوضع.

Awaiting Mollie Payment Status (الافتراضي قيد الانتظار): اختار العميل التحويل البنكي في صفحة Mollie. ينتقل الطلب إلى حالة الدفع عندما تستلم Mollie المال.

Mollie Payment On Hold Status (الافتراضي قيد الانتظار): دفعة معتمدة تنتظر التحصيل، أو أبلغت Mollie عن اعتراض (chargeback)، أو كان المبلغ المدفوع أو العملة مختلفًا عن الطلب، أو دُفعت دفعة تجريبية بينما المتجر في الوضع الحي (لم يُستلم أي مال)، أو وصلت الدفعة بعد أن حصل الطلب على حالة أخرى (مثل الإلغاء). توضح الملاحظة السبب. تحقق من الدفعة في Mollie Dashboard، ثم عالج الطلب أو استرد الدفعة.

Payment Error Status (الافتراضي فشل): فشل التحويل البنكي أو تفويض الطلب أو انتهت صلاحيته أو أُلغي.

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

يُبلغ OpenCart العميل بتغييرات الحالة هذه بالطريقة المعتادة. وإذا دُفعت دفعة ثانية للسلة نفسها، فلا يتغير الطلب. وتطلب منك ملاحظة على الطلب المدفوع استرداد الدفعة المكررة في Mollie Dashboard.

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

تبويب VibeFox Mollie Gateway

في Sales > Orders افتح طلبًا دُفع عبر Mollie. في أسفل صفحة الطلب، بجوار History وAdditional، يعرض التبويب VibeFox Mollie Gateway معرّف Mollie payment مع تسمية Test mode للدفعات التجريبية، وMethod، وStatus الدفعة، والمبالغ Paid / refunded، ونموذج الاسترداد، وسجل الاسترداد (التاريخ، ومعرّف الاسترداد، والمبلغ، والوضع، وحالة Mollie، والسبب)، وMollie notes الخاصة بالطلب. ويُعرض التبويب للمستخدمين الذين لديهم صلاحية الوصول إلى الإضافة.

الاستردادات

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

لا تعيد المرتجعات المنتجة في Sales > Returns المال عبر Mollie. ولا تظهر الاستردادات التي أُنشئت في Mollie Dashboard على الطلب؛ وأما الاعتراض (chargeback) فيضيف ملاحظة.

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

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

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

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

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

لا تظهر Mollie عند الدفع: تحقق من أن الترخيص نشط، وأن Enable/Disable مفعّل، وأن الوضع الحالي يحتوي على مفتاح API: Test API Key في وضع الاختبار، وLive API Key في الوضع الحي. وتحقق من أن عملة الدفع مدعومة من Mollie، وأن عنوان الدفع يقع ضمن Geo Zone المحددة، وأن الطلب يبلغ Total المضبوط في الإعدادات. تعرض صفحة الإعدادات تحذيرًا عند غياب المفتاح وعند وجود عملة متجر غير مدعومة.

تمت الدفعة لكن الطلب يبقى بدون حالة: لا يستطيع webhook الوصول إلى متجرك. يجب أن يكون الرابط الظاهر في Webhook URL متاحًا عبر الإنترنت (دون مصادقة أساسية أو جدار ناري يعيقه). ويحصل الطلب أيضًا على حالته عندما يعود العميل إلى المتجر بعد الدفع، أو عندما يضغط العميل على Check again.

يرد webhook بالرسالة Unknown payment.: لم تُنشأ الدفعة بواسطة هذا المتجر، أو لا تعرفها Mollie بمفتاح API الخاص بوضعها، مثل دفعة تخص حسابًا آخر في Mollie.

يرد webhook بالرسالة Payment ID mismatch.: الدفعة لا تنتمي إلى الطلب الذي أُنشئت من أجله. ولا يتغير أي شيء.

يرد webhook بالرسالة Failed to fetch payment.: تعذر الوصول إلى واجهة Mollie API، أو أن مفتاح API لوضع الدفعة غير مضبوط. ستعيد Mollie محاولة webhook لاحقًا.

يرد webhook بالرسالة Temporarily unavailable.: كانت السلة تُعالَج بطلب آخر في اللحظة نفسها، أو تعذر ضبط حالة الطلب. تعيد Mollie محاولة webhook. فعّل Logging لمعرفة السبب.

يعرض رابط webhook الرسالة Method not allowed. في المتصفح: هذا طبيعي. يقبل الرابط الطلبات الصادرة من Mollie فقط.

لا يُحفظ مفتاح API: يجب أن يبدأ المفتاح بـ test_ أو live_ متبوعًا بما لا يقل عن 30 حرفًا وأرقامًا. انسخه مرة أخرى من Mollie Dashboard.

يرى العميل خطأ بعد Confirm Order: انظر إلى الحقل Log في صفحة الإضافة. يعرض رمز HTTP ورسالة Mollie. ويعني 401 مفتاح API خاطئًا؛ ويشير 422 إلى حقل في الطلب، مثل مبلغ أو عملة لا تقبلها Mollie. وتعني الرسالة This payment method is not available. أن جلسة الدفع لم تعد تطابق الطلب، أو أن طريقة الدفع أُوقفت في الأثناء: على العميل إعادة تحميل صفحة الدفع.

الطلب في حالة On hold: اقرأ الملاحظات في تبويب VibeFox Mollie Gateway (راجع Order statuses)، ثم عالج الطلب أو استرد الدفعة.

لا يوجد نموذج استرداد في التبويب: يوضح التبويب السبب: لم تُدفع الدفعة بعد، أو أُسترد مبلغها بالكامل، أو لا يملك مجموعة المستخدمين لديك صلاحية تعديل الإضافة، أو أُجريت الدفعة في الوضع التجريبي أو الحي ومفتاح API لذلك الوضع غير مضبوط (أدخله وأعد فتح الطلب).

للمطورين: تُطلق الإضافة أحداث OpenCart molg_supported_currencies (قائمة العملات) وmolg_payment_data (طلب الدفع والطلب، قبل إنشاء دفعة Mollie).

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

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

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

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