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

المتطلبات

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

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

الوصول إلى الإنترنت: يجب أن يكون متجرك متاحًا من الإنترنت، دون صفحة صيانة أو جدار حماية أو حماية بكلمة مرور أمام عنوان URL الخاص بالإشعارات، حتى يتمكن Comgate من إرسال الإشعار في الخلفية.

العملة: CZK وEUR وPLN وHUF وUSD وGBP وRON وHRK وNOK أو SEK. بالنسبة إلى العملات الأخرى، وإلى الإجماليات الأقل من الحد الأدنى لـ Comgate (مثل 1 CZK أو 0.10 EUR أو 100 HUF)، تُخفى طريقة الدفع. تُقرَّب مدفوعات HUF إلى فورنتات صحيحة، كما يتطلب Comgate.

حساب Comgate: تحتاج إلى Merchant ID وsecret (كلمة المرور الخاصة بالاتصال في الخلفية) لاتصال متجرك في بوابة عملاء Comgate، وإلى عنوان URL للإشعارات مضبوط هناك (راجع الإعداد). يستخدم Comgate المعرّف Merchant ID والـ secret نفسيهما للمدفوعات التجريبية والحقيقية.

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

التثبيت

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

OpenCart 3

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

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

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

4. أدخل Merchant ID وSecret من بوابة عملاء Comgate، واضبط هناك عنوان URL للإشعارات (راجع الإعداد).

5. فعّل Enable / Disable وانقر على Save. أبقِ Test Mode مفعّلًا لإجراء عملية دفع تجريبية، ثم أوقفه.

OpenCart 4

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

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

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

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

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

الإعداد

جميع الإعدادات موجودة في صفحة الإضافة: Extensions > Extensions > Payments > VibeFox Comgate Gateway > Edit. تُدرج الأقسام على اليسار؛ ويحفظ الزر Save الموجود أسفل القائمة الصفحة كاملة. تنبّهك الصفحة فوق الإعدادات عندما تكون Comgate مفعّلة لكن Merchant ID أو secret مفقود (عندئذٍ تُخفى طريقة الدفع عند إتمام الشراء حتى يُعبَّأ الحقلان)، وعندما لا تكون العملة الافتراضية للمتجر مدعومة من Comgate. وعند تفعيل وضع الاختبار تعرض Test mode is on: payments are created as Comgate test payments and no money is charged. Turn it off before going live. ومن دون صلاحية تعديل الإضافة، تعرض الصفحة الإعدادات لكنها لا تستطيع حفظها.

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

Comgate

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

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

Description: النص الذي يراه العميل في خطوة Confirm Order، فوق زر التأكيد. الافتراضي: Pay securely via Comgate — cards, bank transfers, wallets and more. وفي وضع الاختبار تُضاف إليه العبارة TEST MODE: no real money is charged.، أو تظهر وحدها إذا كان الوصف فارغًا.

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

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

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

اتصال Comgate

خذ معرّف المتجر (Merchant ID) وكلمة المرور (secret) من بوابة عملاء Comgate، في Integration > shop connection settings (تحتوي الصفحة على رابط إلى البوابة). وفي المكان نفسه، اضبط URL for passing the payment result (الإشعار في الخلفية) على عنوان URL المعروض في Notification URL ضمن هذا القسم. يبدو في OpenCart 3 كالتالي https://your-store/index.php?route=extension/payment/wcp_comgate_gateway/notify، وفي OpenCart 4 كالتالي https://your-store/index.php?route=extension/wcp_comgate_gateway/payment/wcp_comgate_gateway.notify، ويُبنى من عنوان واجهة المتجر في تثبيت OpenCart الخاص بك. انسخ عنوان URL تمامًا كما تعرضه الإعدادات. يستدعيه Comgate بعد كل عملية دفع؛ ثم تعيد الإضافة التحقق من الدفعة عبر واجهة برمجة حالة Comgate قبل تغيير الطلب. تُرسل عناوين URL للإرجاع الخاصة بالعميل مع كل عملية دفع. إذا طلبت البوابة عناوين إرجاع (مدفوع، ملغى، قيد الانتظار)، فاستخدم عنوان URL الثاني المعروض في هذا القسم، والذي ينتهي بـ back&id=${id}&refId=${refId} (وفي OpenCart 4 بـ wcp_comgate_gateway.back&id=${id}&refId=${refId}).

Merchant ID: معرّف المتجر الإلكتروني لدى Comgate (merchant).

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

Test Mode: ينشئ عمليات دفع تجريبية (لا يُخصم أي مبلغ). يستخدم Comgate المعرّف Merchant ID والـ secret نفسيهما للمدفوعات التجريبية والحقيقية؛ وتُعلَّم المدفوعات التجريبية بـ test=true. تُرسل الاستردادات دائمًا في وضع عملية الدفع الأصلية. الافتراضي: مفعّل.

صفحة الدفع

Payment Methods: طرق الدفع في Comgate التي يمكن للعميل الاختيار من بينها. تُعرض فقط الطرق المفعّلة لمتجرك في Comgate.

Language: لغة صفحة الدفع الخاصة بـ Comgate. Automatic (store language, English as fallback) (الافتراضي) أو إحدى اللغات الـ 26.

الطلبات

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

Order Status After Payment: الحالة التي تُعيَّن عندما تؤكد Comgate الدفعة. الافتراضي: قيد التنفيذ.

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

Payment Canceled Status: طلب مفوَّض مسبقًا أُلغيت دفعته في Comgate أو انتهت صلاحيتها. الافتراضي: ملغي.

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

متقدم

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

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

Delete Data on Uninstall: عند التفعيل، يؤدي إلغاء تثبيت الإضافة إلى حذف إعدادات البوابة والسجل. تبقى الطلبات ومعرّفات معاملات Comgate الخاصة بها محفوظة دائمًا. الافتراضي: متوقف.

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

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

Import: الصق ملف JSON مُصدَّرًا سابقًا، ثم انقر على Import لاستعادة الإعدادات. يُحتفظ بـ secret المحفوظ.

إتمام الشراء

في خطوة Payment Method، يختار العميل طريقة الدفع (افتراضيًا Comgate). في خطوة Confirm Order، يرى العميل وصفك والملاحظة You will be redirected to the secure Comgate payment page. ينشئ OpenCart الطلب في هذه الخطوة، ولا يزال بدون حالة. عندما ينقر العميل على Confirm Order، تنشئ الإضافة عملية دفع لدى Comgate بمبلغ إجمالي الطلب بعملة الطلب، وتنقل العميل إلى صفحة دفع Comgate. يُمرَّر بريد العميل الإلكتروني واسمه إلى Comgate، وتُعنون عملية الدفع بـ Order ورقم الطلب. يُشترط عنوان بريد إلكتروني صالح. في صفحة Comgate، يدفع العميل بإحدى الطرق التي سمحت بها. وفي OpenCart 4 يختار العميل طريقة الدفع بزر Choose في كتلة طريقة الدفع، في نافذة Payment method options، وينقر على Confirm Order في أسفل صفحة إتمام الشراء. إذا لم يطلب المتجر عنوان دفع (الافتراضي في OpenCart 4)، يُمرَّر إلى Comgate بلد عنوان التسليم.

بعد الدفع، يعود العميل إلى متجرك. لا يُعلَّم الطلب كمدفوع إلا بعد أن تؤكد Comgate ذلك: تقرأ الإضافة الدفعة من واجهة برمجة حالة Comgate، سواء عند وصول الإشعار في الخلفية أو عند عودة العميل. ثم يحصل الطلب على حالته بالطريقة القياسية في OpenCart، مع رسائل البريد الإلكتروني المعتادة للطلب وتحديث المخزون، ويرى العميل صفحة نجاح الطلب في OpenCart. إذا وُضع الطلب قيد الانتظار، تضيف الصفحة Your payment is being reviewed. We will contact you if anything else is needed. وفي OpenCart 4 لا يرسل المتصفح جلسة المتجر عندما ترجع Comgate العميل، لذلك تعرض الإضافة أولًا صفحة قصيرة تعيد فتح عنوان الإرجاع نفسه من متجرك: يحتفظ العميل بسلة التسوق وتسجيل الدخول.

إذا لم تُؤكَّد الدفعة بعد عند عودة العميل، مثلًا تحويل بنكي في الطريق، تعرض صفحة Payment confirmation الرسالة Comgate has not confirmed your payment yet. Your order will be confirmed automatically as soon as the payment is confirmed — please do not pay again. مع زر Check again وزر Back to checkout.

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

في OpenCart 4 يبقى الطلب في إتمام الشراء حتى تظهر صفحة النجاح. إذا أُلغي هذا الطلب في الأثناء دون دفع، يعيد Confirm Order العميل إلى إتمام الشراء مع رسالة الدفعة الملغاة. إذا أُغلق بطريقة أخرى (مثلًا مُسترد أو مُلغى بعد الدفع)، فالرسالة هي Your previous order is closed (cancelled or refunded). Please confirm the order again: the cart will be paid with a new order. وفي الحالتين يدفع Confirm Order التالي طلبًا جديدًا للسلة. إذا كان الطلب مدفوعًا بالفعل وتغيّرت السلة منذ ذلك الحين (منتجات أو كميات أخرى)، يعود العميل إلى إتمام الشراء، وتحصل السلة المعدَّلة على طلب جديد ودفعة خاصة بها.

إذا تعذّر على Comgate بدء الدفع، يبقى العميل في خطوة Confirm Order مع رسالة قصيرة فوق الزر، مثل The Comgate payment could not be started. Please try again or choose another payment method.، تفيد بأن Comgate لا يقبل هذا المبلغ أو هذه العملة، أو أن طريقة دفع Comgate المختارة غير متاحة. يُكتب السبب التقني في السجل.

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

تقبل الإضافة المدفوعات لمرة واحدة فقط في صفحة Comgate. لا تتضمن مدفوعات متكررة أو اشتراكات أو بطاقات محفوظة، ولا صفحة دفع Comgate مدمجة، ولا أزرار Apple Pay أو Google Pay على موقعك (هذه متاحة في صفحة Comgate)، ولا تحصيل أو إلغاء للتفويضات المسبقة من OpenCart. دون الإشعار، لا تُستعلم حالة الدفعة تلقائيًا؛ بل تُفحص فقط عند عودة العميل.

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

حالات الطلبات

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

Order Status After Payment (default Processing): أبلغت Comgate عن الدفعة بأنها PAID بالمبلغ والعملة نفسيهما. تعرض ملاحظة معاملة Comgate والمبلغ. تتلقى المدفوعات التجريبية الملاحظة Comgate test payment — no money was charged.

Comgate Payment On Hold Status (default Pending): المبلغ المدفوع أو العملة لا يطابقان الطلب، أو أُكدت دفعة تجريبية بينما المتجر في الوضع الحقيقي (لم يُستلم أي مال)، أو الدفعة مفوَّضة فقط (تفويض مسبق في حسابك لدى Comgate). تصبح الدفعة المفوَّضة مدفوعة تلقائيًا عند تحصيلها في بوابة Comgate. تشرح الملاحظة السبب.

Payment Canceled Status (default Canceled): أُلغيت دفعة مفوَّضة أو انتهت صلاحيتها لدى Comgate. إذا أكدت Comgate الدفعة بعد ذلك، يُعاد فتح الطلب كمدفوع مع ملاحظة للتحقق من المخزون قبل الشحن.

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

إذا أبلغت Comgate عن دفعة PAID أخرى لطلب مدفوع بالفعل، فلا يتغير الطلب. تطلب منك ملاحظة التحقق من ذلك في بوابة Comgate واسترداد النسخة المكررة. ينطبق الأمر نفسه عندما تُدفع السلة نفسها مرة أخرى مع طلب آخر (مثلًا في تبويبين من المتصفح في الوقت نفسه): لا يحصل ذلك الطلب على حالة، ويتلقى الطلب المدفوع الملاحظة. إذا وصلت دفعة لطلب غيّرت حالته في هذه الأثناء، فلا تُمس الحالة، وتطلب منك ملاحظة التحقق من الطلب. لا يعيد التأكيد المكرر فتح طلب مسترد أبدًا.

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

VibeFox Comgate Gateway tab

في Sales > Orders، افتح طلبًا مدفوعًا عبر Comgate. في أسفل صفحة الطلب، بجوار History وAdditional، يعرض التبويب VibeFox Comgate Gateway الحقل Comgate transaction (transId) مع عنوان Test mode للمدفوعات التجريبية، وStatus، وPayment amount، وOrder total / refunded، وسبب المراجعة، ونموذج الاسترداد، وسجل الاستردادات، وComgate notes الخاصة بالطلب. يُعرض التبويب للمستخدمين الذين لديهم صلاحية الوصول إلى الإضافة.

الاستردادات

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

الاسترداد متاح للطلبات المدفوعة فقط. لا يمكن استرداد طلب وُضع قيد الانتظار بعد عدم تطابق المبلغ أو العملة من OpenCart؛ استرده في بوابة Comgate. لا تعيد مرتجعات المنتجات في Sales > Returns المال عبر Comgate. لا تُبلَّغ الاستردادات التي تتم في بوابة Comgate إلى المتجر.

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

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

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

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

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

Comgate does not appear at checkout: تحقّق من أن الترخيص نشط، وأن Enable / Disable مفعّل، وأن Merchant ID وSecret معبّآن، وأن عملة إتمام الشراء مدعومة، وأن إجمالي الطلب ليس أقل من الحد الأدنى لـ Comgate (مثل 1 CZK أو 0.10 EUR أو 100 HUF). وتحقّق أيضًا من أن عنوان الدفع ضمن Geo Zone المحددة، وأن الطلب يبلغ Total المحدد في الإعدادات.

The payment went through, but the order stays without a status: لم تُسلّم Comgate الإشعار في الخلفية. تحقّق من URL for passing the payment result في بوابة Comgate (مطابقًا تمامًا لـ Notification URL في الإعدادات)، ومن أن متجرك متاح من الإنترنت، ومن السجل (فعّل Debug Log). يعيد Comgate إرسال الإشعارات غير المُسلَّمة؛ وتردّ الإضافة بخطأ كلما لم تتمكن من معالجة إشعار، لذلك سيُعاد إرساله. ويحصل الطلب على حالته أيضًا عندما يعود العميل إلى المتجر.

Notification answers Invalid merchant or secret: الـ Merchant ID أو الـ secret في الإعدادات لا يطابقان اتصال المتجر في بوابة Comgate.

Notification answers Gateway not configured: الـ Merchant ID أو الـ secret فارغ في الإعدادات. يعيد Comgate المحاولة بعد تعبئتهما.

Notification answers Unknown transaction, Order not found or Reference mismatch: الإشعار يخص دفعة لم ينشئها هذا المتجر لذلك الطلب. لا يتغير شيء.

Notification answers Status verification failed, Status verification rejected or Busy, retry later: تعذّر الوصول إلى واجهة برمجة حالة Comgate، أو رفضت الطلب، أو كان الطلب يُعالَج بطلب آخر في اللحظة نفسها. يُرجع Busy أيضًا عندما يتعذّر تعيين حالة الطلب؛ والسبب مكتوب في السجل. يعيد Comgate محاولة الإشعار.

The notification URL shows code=1&message=POST%20required in the browser: هذا طبيعي. يقبل عنوان URL طلبات Comgate فقط.

The customer sees We could not verify the Comgate payment: لم يتطابق رابط الإرجاع مع الطلب. إذا خُصم المبلغ، فإن الإشعار ما زال يؤكد الطلب. تحقّق من الدفعة في بوابة Comgate قبل أن يدفع العميل مرة أخرى.

The customer sees This payment method is not available. Please reload the checkout page.: لم تعد جلسة إتمام الشراء مطابقة للطلب، أو أُوقفت طريقة الدفع في الأثناء. يعيد العميل تحميل صفحة إتمام الشراء.

The customer sees The order total is below the minimum amount accepted by Comgate or A valid billing e-mail address is required for Comgate payments: لا يمكن دفع الطلب عبر Comgate بوضعه الحالي.

Order is in the on-hold status after payment: اقرأ الملاحظات في تبويب VibeFox Comgate Gateway. كان المبلغ المدفوع أو العملة مختلفين، أو وصلت دفعة تجريبية في الوضع الحقيقي، أو الدفعة مفوَّضة فقط. تحقّق من الدفعة في بوابة Comgate، ثم أكمل الطلب أو استرده يدويًا.

No refund form in the tab: يوضح التبويب السبب: ليس للطلب دفعة Comgate مؤكدة، أو أُسترد بالكامل، أو ليست لمجموعة مستخدميك صلاحية تعديل الإضافة، أو أن الـ Merchant ID والـ secret غير مُعيَّنين.

Refund fails: اقرأ الرسالة في التبويب. Comgate rejected the refund: the amount exceeds the refundable amount. تعني أن المبلغ أكبر مما تبقّى للاسترداد؛ ولا يمكن استرداد دفعة بحالة غير PAID. Comgate could not be reached. The refund was not made — please try again later. تعني مشكلة في الاتصال.

للمطورين: تتيح أحداث OpenCart comgate_p_currencies (العملات المدعومة والحدود الدنيا لها) وcomgate_p_create_params (معلمات دفعة Comgate والطلب) لإضافات أخرى تغييرها.

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

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

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

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