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

المتطلبات

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

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

العملة: الين الياباني (JPY). تُحصّل GMO-PG المدفوعات بالين فقط، لذلك لا تظهر طريقة الدفع إلا عندما تكون عملة الدفع لدى العميل هي JPY. أضف JPY في System > Localisation > Currencies إذا لم يكن متجرك يملكها بعد. المبلغ هو إجمالي الطلب محوَّلًا بسعر JPY في المتجر ومُقرَّبًا إلى أقرب ين كامل.

حساب GMO Payment Gateway: عقد تاجر لدى GMO-PG مع Link Type Plus. تحتاج إلى Shop ID وShop password وLink Type Plus Config ID (設定ID) لبيئة الاختبار و/أو بيئة الإنتاج، ويجب تفعيل إشعار النتيجة (結果通知) في لوحة متجر GMO-PG (راجع Configuration). لا يُستخدم Site ID ولا Site password.

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

التثبيت

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

OpenCart 3

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

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

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

4. أدخل Shop ID وShop password وConfig ID لبيئة الاختبار و/أو الإنتاج، ثم اختر Environment.

5. في لوحة متجر GMO-PG، فعّل 結果通知 (result notification) واضبط عنوان الإشعار المعروض في الإعدادات (راجع Configuration).

6. فعّل Enable/Disable وانقر على Save. أجرِ دفعة تجريبية في بيئة الاختبار، ثم غيّر Environment إلى الإنتاج.

OpenCart 4

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

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

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

4. أدخل مفتاح الترخيص وبيانات اعتماد GMO-PG وعنوان الإشعار كما في الخطوات من 3 إلى 6 لـ OpenCart 3. صفحة الإعدادات وحقولها متطابقة في الإصدارين، ويختلف عنوان الإشعار وحده (راجع إشعارات الدفع (結果通知)).

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

الإعدادات

جميع الإعدادات موجودة في صفحة الإضافة: Extensions > Extensions > Payments > VibeFox GMO Payment Gateway > Edit. تظهر الأقسام على اليسار؛ يحفظ زر Save أسفل القائمة الصفحة بأكملها. وفوق الإعدادات تحذّرك الصفحة إذا لم تكن العملة الافتراضية للمتجر هي JPY، وإذا كان Shop ID أو Shop password أو Config ID للبيئة الحالية مفقودًا (عندها تُخفى طريقة الدفع في صفحة الدفع). كما تُظهر البيئة النشطة: TEST — payments go to pt01.mul-pay.jp with the test credentials, no real money is charged. أو PRODUCTION — payments go to p01.mul-pay.jp. من دون صلاحية تعديل الإضافة، تعرض الصفحة الإعدادات لكنها لا تستطيع حفظها.

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

GMO Payment Gateway — بطاقة ائتمانية

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

Title: اسم طريقة الدفع الذي يراه العميل في صفحة الدفع. وهو أيضًا اسم طريقة الدفع المحفوظ في الطلب. الافتراضي: Credit card. حقل إلزامي، حتى 128 حرفًا.

Description: وصف طريقة الدفع الذي يظهر في خطوة Confirm Order، فوق زر التأكيد. الافتراضي: You will be redirected to the secure GMO Payment Gateway page to pay by credit card.

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

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

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

حساب GMO-PG

يوجد Shop ID وShop password في لوحة متجر GMO-PG ضمن Shop management > Shop information، ويوجد Config ID ضمن Link Type Plus > Settings (設定ID). لبيئتي الاختبار والإنتاج بيانات اعتماد مختلفة.

Environment: بيئة GMO-PG التي تستقبل المدفوعات الجديدة.

Production Shop ID: Shop ID لبيئة الإنتاج.

Production Shop password: Shop password لبيئة الإنتاج.

Production Config ID: Link Type Plus config ID (設定ID) المسجّل في لوحة GMO-PG.

Test Shop ID: Shop ID لبيئة الاختبار.

Test Shop password: Shop password لبيئة الاختبار.

Test Config ID: Link Type Plus config ID (設定ID) لبيئة الاختبار.

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

الدفع

Capture: متى يُخصم مبلغ من البطاقة.

Order status after payment: الحالة التي يحصل عليها الطلب المدفوع.

إشعارات الدفع (結果通知)

يُخبر إشعار النتيجة متجرك بأن دفعة قد تمت. وهو إلزامي. في لوحة متجر GMO-PG فعّل 結果通知 (result notification) واضبط العنوان المعروض في Notification URL ضمن هذا القسم. في OpenCart 3 يبدو العنوان هكذا: https://your-store/index.php?route=extension/payment/wcp_gmo_payment/notify، وفي OpenCart 4 هكذا: https://your-store/index.php?route=extension/wcp_gmo_payment/payment/wcp_gmo_payment.notify، ويُنشأ من عنوان الواجهة الأمامية لتثبيت OpenCart لديك. انسخ العنوان تمامًا كما تعرضه الإعدادات. يجب أن يكون متاحًا من الإنترنت؛ ولا يمنعه وضع الصيانة.

إشعارات GMO-PG غير موقّعة، لذلك لا تثق الإضافة بمحتواها أبدًا. يجب أن يصدر الإشعار من أحد Shop ID المُعدّة لديك، وأن يشير إلى دفعة أنشأها هذا المتجر في البيئة نفسها التي تمت فيها الدفعة. ثم تطلب الإضافة من GMO-PG معلومات المعاملة (SearchTrade) باستخدام Shop password الخاص بك، وتغيّر الطلب استنادًا إلى تلك الإجابة فقط. أما الإشعار الذي لا يطابق معاملة حقيقية فلا يغيّر شيئًا. وتُقرّ المعاملات التي لم ينشئها المتجر، مثل تلك التي أُجريت في لوحة GMO-PG، ثم تُتجاهل. وإذا لم تستطع الإضافة التحقق من إشعار، فإنها ترد بطريقة تجعل GMO-PG يعيد إرساله.

من دون الإشعار، لا يحصل الطلب على حالته إلا عندما يعود العميل إلى المتجر بعد الدفع.

حالات الطلب

ينشئ OpenCart الطلب في خطوة Confirm Order من دون حالة (طلب مفقود، missing order). لا يحصل الطلب على حالة إلا بعد أن تؤكد GMO-PG الدفعة. تسرد كل خانة حالات الطلب في OpenCart لديك. ولا تملك OpenCart حالة On hold، لذلك تحصل عملية التفويض أو الدفعة بمبلغ مختلف على حالة الانتظار الموضحة أدناه وملاحظة في الطلب.

Processing: طلب مدفوع عندما تكون Order status after payment هي قيد المعالجة. الافتراضي: قيد المعالجة.

Completed: طلب مدفوع عندما تكون Order status after payment هي مكتمل. الافتراضي: مكتمل.

GMO-PG payment on hold: تفويض فقط (بانتظار التحصيل) أو مبلغ لا يطابق الطلب. الافتراضي: قيد الانتظار. يمكنك إنشاء حالتك الخاصة في System > Localisation > Order Statuses واختيارها هنا.

Cancelled: تفويض أو دفعة معلّقة أُلغيت في GMO-PG، أو تفويض رُدّ بالكامل. الافتراضي: ملغي.

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

متقدّم

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

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

Delete data on uninstall: عند التفعيل، يؤدي إلغاء تثبيت الإضافة إلى حذف إعدادات البوابة والسجل. تبقى بيانات الطلب (GMO OrderID، ومعرّفات المعاملات) محفوظة دائمًا. الافتراضي: معطّل.

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

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

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

صفحة الدفع

في خطوة Payment Method، يختار العميل طريقة الدفع (افتراضيًا Credit card). وفي خطوة Confirm Order، يرى العميل وصفك؛ وفي بيئة الاختبار يظهر فوقه الشارة TEST — GMO-PG test environment, no real charges. ينشئ OpenCart الطلب في هذه الخطوة، ما يزال من دون حالة. في OpenCart 4 يختار العميل طريقة الدفع بزر Choose في كتلة طريقة الدفع، في النافذة Payment method options، وينقر على Confirm Order أسفل صفحة الدفع. عندما ينقر العميل على Confirm Order، تنشئ الإضافة دفعة GMO-PG Link Type Plus بإجمالي الطلب بالين الكاملة، وترسل العميل إلى صفحة دفع GMO-PG. هناك يدفع العميل ببطاقة ائتمانية. تتولى GMO-PG المصادقة 3-D Secure 2.0، ويُمرَّر بريد العميل الإلكتروني إليها من أجل 3-D Secure. تُفتح صفحة الدفع باليابانية أو الصينية أو الإنجليزية، حسب لغة الطلب. تظهر الدفعة لدى GMO-PG مع OC- ورقم الطلب. لا يُرسل أي بيانات أخرى للعميل.

بعد الدفع يعود العميل إلى متجرك. يُتحقق من النتيجة الموقّعة باستخدام Shop password الخاص ببيئة الدفعة، ولا يُعلَّم الطلب كمدفوع إلا بعد أن تؤكد GMO-PG ذلك: إما بطلب SearchTrade من جهة الخادم عند عودة العميل، أو بإشعار النتيجة. يستخدم المساران المنطق نفسه، فلا تُطبَّق الدفعة مرتين أبدًا. ثم يحصل الطلب على حالته بالطريقة القياسية في OpenCart، مع رسائل البريد الإلكتروني المعتادة للطلبات وتحديث المخزون، ويرى العميل صفحة نجاح الطلب في OpenCart. وإذا لم تؤكد GMO-PG الدفعة بعد، تعرض صفحة Payment confirmation النص Your card payment is being confirmed by GMO Payment Gateway. You will receive an e-mail as soon as it is confirmed. مع الزرين Check again وBack to checkout؛ ويحدد الإشعار حالة الطلب فور وصوله.

إذا رُفضت البطاقة أو فشلت الدفعة في صفحة GMO-PG، يعود العميل إلى صفحة الدفع مع الرسالة The card payment was declined or could not be completed. Please try again or use another card. وإذا غادر العميل صفحة GMO-PG من دون أن يدفع، فالرسالة هي The payment was not completed. You can try again or choose another payment method. ويبقى محتوى السلة محفوظًا. في OpenCart 4 تظهر هذه الرسائل فوق صفحة الدفع. وكل محاولة جديدة (ينشئ OpenCart 3 طلبًا جديدًا في كل مرة تظهر فيها خطوة Confirm Order، ويحدّث OpenCart 4 الطلب الخاص بصفحة الدفع) تلغي روابط الدفع السابقة غير المدفوعة للسلة. وإذا كان أحد الروابط السابقة قد دُفع في الأثناء، فيُعتمد ذلك الدفع ولا يُنشأ رابط جديد.

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

يمكن دفع إجماليات الطلبات من 1 إلى 9,999,999 JPY؛ أما الإجماليات الأكبر فتُخفي طريقة الدفع. وإذا تعذّر بدء الدفع، يبقى العميل في خطوة Confirm Order مع رسالة قصيرة فوق الزر، مثل Card payment could not be started. Please try again or choose another payment method.، ويُكتب السبب في السجل.

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

تقبل الإضافة مدفوعات البطاقات الائتمانية بالين الياباني (JPY) فقط، ودائمًا في صفحة GMO-PG. ولا تتضمن طرق دفع أخرى من GMO-PG، ولا تعدد عملات، ولا بطاقات محفوظة، ولا تسجيل عضوية في GMO-PG، ولا اشتراكات أو فوترة متكررة، ولا نموذج بطاقة داخل الموقع.

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

حالات الطلب

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

Processing or Completed status: تم تأكيد الدفعة؛ وتتبع الحالة Order status after payment. تعرض الملاحظة المبلغ وحالة GMO-PG والمعاملة وطريقة التأكيد (إشعار أو عودة).

GMO-PG payment on hold (authorized): مع Authorize only (仮売上) تم تفويض المبلغ. حصّله بـ Capture payment (GMO-PG) أو في لوحة GMO-PG قبل انتهاء صلاحية التفويض. بعد التحصيل يحصل الطلب على حالة المدفوع. وإذا أُلغي التفويض في GMO-PG، يحصل الطلب على حالة Cancelled.

GMO-PG payment on hold after payment: أبلغت GMO-PG عن مبلغ يختلف عن إجمالي الطلب. وتوضح الملاحظة ذلك. تحقّق من الطلب ونفّذه، أو استرد الدفعة.

Refunded: استُردّت الدفعة بالكامل عبر الإضافة. ويؤدي الاسترداد الكامل لتفويض لم يُحصَّل أبدًا إلى حالة Cancelled.

إذا وصلت دفعة ثانية لطلب مدفوع بالفعل، أو لطلب آخر من السلة نفسها، فلن يُغيَّر الطلب المدفوع. وتطلب منك ملاحظة استرداد النسخة المكررة في لوحة GMO-PG. وإذا وصلت دفعة لطلب له حالة بالفعل من دون دفعة GMO-PG، فلا تُضاف سوى ملاحظة.

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

تبويب VibeFox GMO Payment Gateway

في Sales > Orders افتح طلبًا دُفع عبر GMO-PG. في أسفل صفحة الطلب، بجوار History وAdditional، يعرض تبويب VibeFox GMO Payment Gateway الحقل GMO OrderID (مع الوسم TEST لدفعات الاختبار)، وTransaction ID، وStatus مع حالة GMO-PG، وPaid / refunded، وزر التحصيل ونموذج الاسترداد، وسجل الاستردادات، وGMO-PG notes الخاصة بالطلب. يظهر التبويب للمستخدمين الذين لديهم صلاحية الوصول إلى الإضافة؛ ويحتاج التحصيل والاسترداد إلى صلاحية تعديل الإضافة (وتُضبط في System > Users > User Groups).

التحصيل

يظهر Capture payment (GMO-PG) في تبويب طلب معلّق لم يُفوَّض إلا تفويضًا فقط. أكّد Capture the authorized GMO-PG payment? تتحقق الإضافة من المعاملة لدى GMO-PG وتحصّل المبلغ المفوَّض؛ ثم يحصل الطلب على حالة المدفوع. وإذا لم تعد المعاملة مفوَّضة، كأن تكون قد حُصّلت بالفعل في لوحة GMO-PG، فستعرض الرسالة الحالة الحالية. ويصل التحصيل الذي يتم في لوحة GMO-PG عبر إشعار النتيجة.

الاستردادات

في التبويب أدخل Amount (يُملأ المبلغ الذي لم يُسترد بعد)، واختياريًا Reason (optional)، ثم انقر على Refund via GMO-PG. أكّد Refund this amount through GMO-PG? الاستردادات الكاملة والجزئية مدعومة، بالين الكامل. والحد الأقصى هو المبلغ الذي حصّلته GMO-PG فعليًا وما زالت تحتفظ به، وليس إجمالي الطلب. ويؤدي استرداد المبلغ المتبقي كاملًا إلى إلغاء معاملة GMO-PG، وتقرر GMO-PG ما إذا كان ذلك إلغاءً (void) أم إرجاعًا. ويُخفّض الاسترداد الجزئي مبلغ المعاملة. يُرسل الاسترداد إلى البيئة التي تمت فيها الدفعة، لذلك يجب ضبط Shop ID وShop password لتلك البيئة. وإذا لم تقبل GMO-PG الاسترداد، فسيعرض التبويب الخطأ ولن يُسجَّل أي استرداد. وتُضاف عملية الاسترداد الناجحة إلى سجل الاستردادات والملاحظات. ويؤدي الاسترداد الكامل إلى تعيين الحالة Refunded من دون إشعار العميل ومن دون إعادة المنتجات إلى المخزون، تمامًا كتغيير الحالة يدويًا. أما الاسترداد الجزئي فلا يغيّر الحالة.

لا تُعيد مرتجعات المنتجات في Sales > Returns أي أموال عبر GMO-PG.

تصل الاستردادات والإلغاءات التي تُجرى في لوحة GMO-PG عبر إشعار النتيجة، وتُضاف إلى الملاحظات. ولا تتغير حالة الطلب تلقائيًا، إلا في حالة التفويض أو الدفعة المعلّقة التي أُلغيت في GMO-PG. حدّثها يدويًا عند الحاجة.

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

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

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

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

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

Credit card does not appear at checkout: تحقق من أن الترخيص نشط، وأن Enable/Disable مفعّل، وأن عملة الدفع هي JPY، وأن البيئة الحالية تملك Shop ID وShop password وConfig ID. لا يمكن دفع الإجماليات التي تتجاوز 9,999,999 JPY ببطاقة. وتعرض صفحة الإعدادات تحذيرًا إذا كانت العملة أو بيانات الاعتماد خاطئة. تحقق أيضًا من أن عنوان الدفع ضمن Geo Zone المحددة، وأن الطلب يبلغ Total المضبوط في الإعدادات.

The payment went through, but the order stays without a status: إشعار النتيجة لا يعمل. في لوحة متجر GMO-PG للبيئة التي تستخدمها، تحقق من أن 結果通知 مفعّل، وأن العنوان مطابق تمامًا للعنوان المعروض في Notification URL. تحقق من أن Shop ID وShop password لتلك البيئة مملوءان، لأن الإضافة تتحقق من كل إشعار بهما. فعّل Debug log وانظر إلى الحقل Log في صفحة الإضافة. ويحصل الطلب أيضًا على حالته عندما يعود العميل إلى المتجر بعد الدفع.

Log shows Notification rejected: unknown ShopID.: جاء الإشعار من متجر لا يوجد Shop ID الخاص به في الإعدادات. أدخل Shop ID لتلك البيئة.

Log shows Notification ignored: OrderID is not a payment of this store.: لم يُنشئ هذا المتجر المعاملة، فقد تكون أُجريت في لوحة GMO-PG مثلًا. لا يلزم أي إجراء.

Log shows that the order was paid in another environment: تُفصل دفعات الاختبار عن دفعات الإنتاج. ولا يؤكد إشعار الاختبار أبدًا دفعة إنتاج، والعكس صحيح.

The customer sees an error after Confirm Order: فعّل Debug log وانظر إلى الحقل Log. يعرض السجل رمز خطأ GMO-PG (ErrCode وErrInfo). والسبب المعتاد هو Shop ID أو Shop password أو Config ID غير صحيح. أما This payment method is not available at the moment. Please choose another payment method. فتعني أن جلسة الدفع لم تعد تطابق الطلب، أو أن طريقة الدفع أُوقفت في الأثناء: ويجب على العميل إعادة تحميل صفحة الدفع.

Order is in the GMO-PG payment on hold status: اقرأ الملاحظات في تبويب VibeFox GMO Payment Gateway. فالطلب مُفوَّض فقط وينتظر التحصيل، أو أن المبلغ المدفوع يختلف عن الطلب.

Refund or capture fails: اقرأ الرسالة في التبويب. قد يكون الطلب قد دُفع في البيئة الأخرى التي لم يُضبط Shop ID وكلمة المرور الخاصان بها، أو قد تكون المعاملة قد أُلغيت بالفعل في GMO-PG، أو قد يتجاوز المبلغ ما تبقى في المعاملة. The order is being updated by GMO-PG right now. Try again in a moment. تعني أن إشعارًا كان قيد المعالجة في الوقت نفسه.

The tab shows You do not have permission to refund orders.: ليس لمجموعة المستخدمين لديك صلاحية تعديل الإضافة. اطلب من مدير منحها في System > Users > User Groups.

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

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

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

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