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

المتطلبات

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

PHP: 8.0 أو أحدث.

العملة: CAD لحساب Moneris الكندي، وUSD لحساب Moneris USA القديم. لا تُعرض طريقة الدفع إلا عندما تكون عملة الدفع هي عملة الحساب.

HTTPS وPCI DSS: تُدخَل أرقام البطاقات في صفحة الدفع الخاصة بمتجرك وتمرّ عبر خادمك. وتتطلب المدفوعات الحية وجود HTTPS والالتزام بمعيار PCI DSS SAQ D. وإذا تعذّر عليك ذلك، فاستخدم بدلًا منه حلًّا بصفحة دفع مستضافة.

حساب Moneris: تحتاج إلى Store ID وAPI Token لمتجر Moneris Gateway الخاص بك من Moneris Merchant Resource Center > Admin > Store Settings. ولأغراض الاختبار، يُملأ متجر Moneris التجريبي العام افتراضيًا. وتوجد بيانات الاعتماد التجريبية وبطاقات الاختبار في بوابة مطوّري Moneris.

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

التثبيت

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

OpenCart 3

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

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

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

4. اختر بلد الحساب وأدخل Live Store ID وLive API Token. وضع الاختبار مفعّل افتراضيًا ويستخدم المتجر التجريبي العام (store5 / yesguy لكندا، وmonusqa002 / qatoken للولايات المتحدة).

5. اختر نوع المعاملة وشعارات البطاقات، ثم فعّل Enable / Disable واضغط على Save.

6. أجرِ طلبًا تجريبيًا ببطاقة اختبار من Moneris، ثم أوقف Test mode.

OpenCart 4

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

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

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

4. أدخل مفتاح الترخيص والإعدادات كما في الخطوات من 3 إلى 6 الخاصة بـ OpenCart 3. صفحة الإعدادات وحقولها هي نفسها في الإصدارين.

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

الإعدادات

توجد جميع الإعدادات في صفحة الإضافة: Extensions > Extensions > Payments > VibeFox Moneris Gateway > Edit. تُعرض الأقسام على اليسار؛ ويحفظ الزر Save أسفل القائمة الصفحة بأكملها. وفوق الإعدادات، تعرض الصفحة Moneris gateway is in TEST MODE. No real charges will be made. طالما وضع الاختبار مفعّل. وفي الوضع الحي، تنبهك الصفحة عندما تحتوي الحقول الحية على بيانات اعتماد Moneris التجريبية (فتُخفى طريقة الدفع عند الدفع حينها)، وعندما لا يكون SSL مفعّلًا للمتجر (في OpenCart 4، عندما يبدأ عنوان الواجهة الأمامية للمتجر بـ http://). كما تنبهك عندما تكون طريقة الدفع مفعّلة لكن Store ID أو API Token للوضع الحالي فارغ، وعندما لا تكون العملة الافتراضية للمتجر هي عملة حساب Moneris؛ وفي الحالتين تُخفى طريقة الدفع عند الدفع. وبدون صلاحية تعديل الإضافة، تعرض الصفحة الإعدادات لكنها لا تستطيع حفظها.

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

Moneris

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

Title: عنوان طريقة الدفع الذي يظهر للعميل. وهو أيضًا اسم طريقة الدفع المحفوظ في الطلب. الافتراضي: بطاقة ائتمان (Moneris). وفي وضع الاختبار يُضاف (Test Mode) إلى العنوان. مطلوب.

Description: النص الذي يظهر فوق حقول البطاقة في خطوة Confirm Order. الافتراضي: Pay securely with your credit card.

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

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

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

حساب Moneris

يوجد Store ID وAPI Token الخاصان بك في Moneris Merchant Resource Center ضمن Admin > Store Settings. وتوجد بيانات الاعتماد التجريبية وبطاقات الاختبار في بوابة مطوّري Moneris. ويحتوي هذا القسم على روابط إلى الاثنين.

Moneris account country: تُحصّل الحسابات الكندية بعملة CAD، وحسابات الولايات المتحدة بعملة USD. لا تُعرض طريقة الدفع إلا عندما تتطابق عملة الطلب. الافتراضي: كندا (CAD).

Test mode: يستخدم بوابة Moneris لضمان الجودة (QA) وبيانات الاعتماد التجريبية؛ ولا تُجرى أي خصومات حقيقية. وتُرسل الاستردادات والتحصيلات والإلغاءات دائمًا إلى البيئة التي أُجريت فيها الدفعة. ويرى العملاء TEST MODE: use a Moneris test card, no real charges are made. فوق حقول البطاقة. الافتراضي: مفعّل.

Live Store ID: معرّف المتجر الإنتاجي، مثل monca01234.

Live API Token: رمز API الإنتاجي.

Test Store ID: متجر Moneris التجريبي العام: store5 (كندا) أو monusqa002 (الولايات المتحدة). الافتراضي: store5.

Test API Token: الرمز التجريبي العام: yesguy (كندا) أو qatoken (الولايات المتحدة). الافتراضي: yesguy.

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

الدفع

Transaction type: الطريقة التي تُخصم بها البطاقة. الافتراضي: Purchase.

Card logos: علامات البطاقات التي تظهر مع طريقة الدفع عند الدفع: Visa وMastercard وDiscover وAmerican Express وJCB. تعتمد العلامات المقبولة على حساب Moneris لديك. الافتراضي: Visa وMastercard.

الطلبات

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

Order Status After Payment: خُصمت البطاقة (عملية شراء، أو تحصيل تفويض مسبق). الافتراضي: قيد المعالجة.

Authorized Status: تفويض مسبق: الأموال محجوزة فقط ولم تُخصم بعد. حصّلها في تبويب الطلب أو بتعيين حالة مدفوعة. الافتراضي: قيد الانتظار.

On Hold (Review) Status: مطلوب مراجعة يدوية: المبلغ الذي عالجته Moneris يختلف عن الطلب، أو لم تردّ Moneris وفشل فحص الحالة أيضًا (ربما خُصمت البطاقة). وتشرح ملاحظة السبب. الافتراضي: قيد الانتظار، لأن OpenCart لا يملك حالة On hold. يمكنك إنشاء حالاتك الخاصة في System > Localisation > Order Statuses واختيارها هنا وفي Authorized Status.

Canceled Status: تُعيَّن بواسطة Void pre-authorization (cancel order) في تبويب الطلب. وتعيين الطلب إلى هذه الحالة يحرر (يلغي) تفويضًا مسبقًا لم يُحصَّل. الافتراضي: ملغى.

Refunded Status: تُعيَّن بعد استرداد الدفعة بالكامل من تبويب الطلب. وتعيين الطلب إلى هذه الحالة يحرر أيضًا تفويضًا مسبقًا لم يُحصَّل. الافتراضي: مُسترَد.

متقدم

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

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

Delete data on uninstall: عند التفعيل، تُحذف إعدادات البوابة والسجل عند إلغاء تثبيت الإضافة. أما بيانات Moneris الخاصة بالطلبات (اللازمة للتحصيل والاسترداد) فتبقى دائمًا. الافتراضي: إيقاف.

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

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

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

الدفع

في خطوة Payment Method يختار العميل طريقة الدفع (افتراضيًا Credit card (Moneris)). وفي خطوة Confirm Order يرى العميل وصفك وشعارات البطاقات والحقول Card number وExpiry (MM/YY) وCard code (CVC). وجميع الحقول الثلاثة إلزامية. في OpenCart 4 يختار العميل طريقة الدفع بزر Choose في كتلة طريقة الدفع، في النافذة Payment method options؛ وتظهر حقول البطاقة بعدها في كتلة تأكيد الطلب أسفل صفحة الدفع، فوق زر Confirm Order. وعندما يضغط العميل على Confirm Order، يرسل خادمك البطاقة إلى Moneris بإجمالي الطلب ويحصل على النتيجة فورًا. لا توجد إعادة توجيه ولا webhook. وتُستخدم بيانات البطاقة لهذا الطلب وحده؛ ولا تُخزَّن أبدًا، ويعرض السجل الأرقام الأربعة الأخيرة فقط.

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

إذا رُفضت البطاقة، يبقى العميل في خطوة Confirm Order مع Your card was declined والسبب من Moneris، ويمكنه التحقق من بيانات البطاقة أو استخدام بطاقة أخرى. ولا يحتفظ الطلب بأي حالة؛ ويُكتب سبب الرفض في السجل أيضًا. وإذا تعذّر على Moneris معالجة الطلب (مثلًا Store ID أو API Token خاطئ)، يرى العميل The payment could not be processed. Please try again or use another payment method. ويُكتب السبب في السجل. وتعطي حقول البطاقة الخاطئة رسائل قصيرة، مثل Please enter your card details. أو Invalid card number. أو Invalid card expiry date.، ولا يُرسل شيء إلى Moneris.

وأي نقرة ثانية أثناء معالجة الدفعة تعرض A payment for this order is already being processed. Please wait a moment and check your order status before trying again. ويُنشئ OpenCart 3 طلبًا جديدًا في كل مرة تُعرض فيها خطوة Confirm Order، ويحتفظ OpenCart 4 بطلب واحد للدفع، وبعد رفض البطاقة يدفع العميل الطلب نفسه. وفي الحالتين تعامل الإضافة جميع طلبات السلة الواحدة كدفعة واحدة: فالسلة التي دُفعت من قبل، أو التي لا تُعرف نتيجتها، لا تُخصم مرة أخرى أبدًا، ويُنقل العميل إلى صفحة النجاح. ويُبقي OpenCart 4 الطلب في مرحلة الدفع حتى تُعرض صفحة النجاح. وإذا كان لذلك الطلب حالة بالفعل وعادت السلة لتحتوي منتجات (مثلًا تمت الدفعة لكن لم تُعرض صفحة النجاح، وأضاف العميل منتجات)، أو أُلغي الطلب أو استُرد أو حُرّرت أمواله في الأثناء، يعود العميل إلى صفحة الدفع عند Confirm Order، ويدفع Confirm Order التالي طلبًا جديدًا. وتظهر فوق صفحة الدفع الرسالة This order was cancelled or refunded by the store, so it cannot be paid again. Please check your cart and confirm the new order. عندما يكون الطلب مغلقًا، أو الرسالة This order has already been paid, and your cart now holds a new purchase. Please check your cart and confirm the new order. عندما يكون الطلب قد دُفع عن سلة سابقة.

وإذا لم تردّ Moneris (خطأ شبكة أو انتهاء مهلة)، ترسل الإضافة إلى Moneris فحصًا للحالة بمعرّف الطلب نفسه في Moneris لمعرفة ما إذا كانت المعاملة قد تمت. وإذا لم تكن لدى Moneris مثل هذه المعاملة، يمكن للعميل أن يدفع مرة أخرى. وإذا لم يحصل فحص الحالة هو الآخر على ردّ، يحصل الطلب على حالة المراجعة مع ملاحظة تذكر معرّف الطلب في Moneris، ولا يُدعى العميل إلى الدفع مرة ثانية. وإذا تمت الدفعة لكن تعذّر ضبط حالة الطلب، يرى العميل Your payment was received, but the order could not be completed automatically. Please contact us — do not pay again.

لا تحتوي الإضافة على بطاقات محفوظة أو Moneris Vault، ولا اشتراكات، ولا Apple Pay أو Google Pay أو Interac Online، ولا Moneris Checkout أو Hosted Tokenization، ولا 3-D Secure أو AVS أو Kount، ولا تسعير بعدة عملات.

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

حالات الطلب

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

Order Status After Payment (الافتراضي قيد المعالجة): اعتُمدت عملية الشراء، أو حُصّل تفويض مسبق. وتعرض الملاحظة المبلغ ومعرّف المعاملة في Moneris (Trans ID) والإيصال.

Authorized Status (الافتراضي قيد الانتظار): اعتُمد تفويض مسبق وينتظر التحصيل.

On Hold (Review) Status (الافتراضي قيد الانتظار): اختلف المبلغ الذي عالجته Moneris عن إجمالي الطلب، أو لم تؤكد Moneris النتيجة. وتشرح الملاحظات ذلك.

Canceled Status (الافتراضي ملغى): بالنسبة إلى طلب مُفوَّض مسبقًا، تحررت الأموال المحجوزة (إلغاء).

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

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

تبويب VibeFox Moneris Gateway

في Sales > Orders افتح طلبًا دُفع عبر Moneris. في أسفل صفحة الطلب، بجوار History وAdditional، يعرض التبويب VibeFox Moneris Gateway الـ Trans ID (وTrans ID التفويض المسبق بعد التحصيل)، وMoneris order ID، وReceipt، وTransaction type وحالته (لم يُحصَّل، أو حُصِّل، أو تحرر)، وAccount / environment مع تسمية Test mode للمدفوعات التجريبية، وCard مع رمز التفويض، والمبالغ Authorized / charged / refunded، وأزرار التحصيل والإلغاء والاسترداد، وسجل الاستردادات، وMoneris notes الخاصة بالطلب. وفي حالة الدفعة غير المؤكدة، يطلب منك التبويب البحث عن معرّف الطلب في Moneris ضمن Merchant Resource Center. ويُعرض التبويب للمستخدمين الذين لديهم صلاحية الوصول إلى الإضافة؛ أما التحصيل والإلغاء والاسترداد فيحتاجون إلى صلاحية تعديل الإضافة (تُضبط في System > Users > User Groups).

التحصيل والإلغاء

لتحصيل تفويض مسبق، اضغط على Capture payment في التبويب وأكّد Capture the pre-authorized amount through Moneris?، أو غيّر حالة الطلب عبر Add History إلى حالة مدفوعة مثل Order Status After Payment أو أي حالة معالجة أو اكتمال أخرى في OpenCart. يُحصَّل إجمالي الطلب ناقصًا الاستردادات؛ ولا يمكن أن يتجاوز المبلغ المعتمد. وبعد التحصيل عبر الزر يحصل الطلب على Order Status After Payment. وإذا رفضت Moneris التحصيل، لا تتغير الحالة، ولا يُرسل أي بريد إلكتروني، ويعرض Add History السبب بدلًا من رسالة النجاح، وتشرح ملاحظة ذلك: Moneris: status not changed — the pre-authorization could not be captured مع السبب. وتنتهي التفويضات المسبقة في Moneris بعد بضعة أيام، لذلك حصّلها في وقتها.

لتحرير الأموال، اضغط على Void pre-authorization (cancel order) وأكّد، أو عيّن الطلب إلى Canceled Status. وتعيين الطلب إلى Refunded Status يحرر أيضًا تفويضًا مسبقًا مفتوحًا. وإذا فشل التحرير، تطلب منك ملاحظة تحريره في Merchant Resource Center.

تعمل تغييرات الحالة هذه أيضًا عندما تكون الإضافة متوقفة (لكن مثبّتة)، لذلك يمكن تحصيل التفويضات المسبقة التي أُجريت من قبل وتحريرها.

الاستردادات

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

لا تعيد المرتجعات المنتجة في Sales > Returns المال عبر Moneris.

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

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

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

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

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

لا تظهر Moneris عند الدفع: تحقق من أن الترخيص نشط، وأن Enable / Disable مفعّل، وأن الوضع الحالي يحتوي على Store ID وAPI Token. وفي الوضع الحي يجب أن تحتوي الحقول الحية على بيانات اعتمادك الإنتاجية، لا بيانات Moneris التجريبية. وتحقق من أن عملة الدفع هي عملة الحساب (CAD لكندا، وUSD لحساب أمريكي)، وأن عنوان الدفع يقع ضمن Geo Zone المحددة، وأن الطلب يبلغ Total المضبوط في الإعدادات.

تمت الدفعة لكن الطلب في حالة المراجعة: ليس للإضافة webhook؛ وتأتي النتيجة من ردّ Moneris فقط. اقرأ Moneris notes في التبويب. وإذا لم تؤكد Moneris النتيجة، فهذا يعني أن Moneris لم تردّ وأن فحص الحالة فشل أيضًا. ابحث عن معرّف الطلب في Moneris ضمن Merchant Resource Center: إن كانت المعاملة موجودة هناك فشحن الطلب (واسترده هناك إن لزم)؛ وإن لم تكن موجودة فألغِ الطلب أو اطلب من العميل الدفع مرة أخرى. وإن اختلف المبلغ فتحقق من الطلب وأنجزه أو استرد الدفعة.

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

يرى العميل This payment method does not support the order currency.: عملة الطلب ليست عملة حساب Moneris.

يرى العميل خطأ عند الدفع: انظر إلى الحقل Log في صفحة الإضافة. تُكتب الأخطاء دائمًا؛ فعّل Debug log لرؤية الطلبات والاستجابات كاملة.

فشل التحصيل: ليس للطلب تفويض مسبق في انتظار التحصيل، أو إجمالي الطلب صفر، أو المبلغ أكبر من المبلغ المعتمد. وتنتهي التفويضات المسبقة في Moneris أيضًا بعد بضعة أيام.

يفشل الاسترداد أو التحصيل أو الإلغاء برسالة عن الوضع أو الحساب: أُجريت الدفعة في الوضع التجريبي أو الحي، وبيانات اعتماد ذلك الوضع غير مضبوطة، أو أُجريت الدفعة بحساب Moneris من بلد آخر. أدخل بيانات الاعتماد، أو عالج الدفعة في Merchant Resource Center.

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

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

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

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

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