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

المتطلبات

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

PHP: ‏8.0 أو أحدث.

HTTPS: يجب أن يكون متجرك متاحًا من الإنترنت عبر HTTPS، حتى يتمكن Cardcom من إرسال إشعار الدفع.

العملة: يجب أن تكون عملة الطلب (العملة التي يتسوق بها العميل) إحدى العملات ILS أو USD أو EUR أو GBP. بالنسبة لأي عملة أخرى، تُخفى طريقة الدفع في صفحة الدفع.

حساب Cardcom: للمدفوعات الفعلية تحتاج إلى حساب تاجر في Cardcom يتضمن رقم الطرفية واسم مستخدم API وكلمة مرور API. تحتاج المدفوعات إلى رقم الطرفية واسم مستخدم API فقط. تُستخدم كلمة مرور API فقط في عمليات الاسترداد من OpenCart. يعمل وضع الاختبار دون حساب Cardcom.

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

التثبيت

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

OpenCart 3

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

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

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

4. فعّل Enable/Disable، واترك Test Mode مفعّلًا، ثم انقر على Save. أجرِ طلب اختبار باستخدام البطاقة 4580 0000 0000 0000، وأي تاريخ انتهاء صلاحية مستقبلي، ورمز CVV 123.

5. للمدفوعات الفعلية، عطّل Test Mode، وأدخل Terminal Number وAPI Username وAPI Password التي استلمتها من Cardcom، ثم انقر على Save. لا حاجة إلى إعداد أي شيء في لوحة Cardcom: تُرسل عناوين الإشعار والعودة مع كل عملية دفع.

OpenCart 4

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

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

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

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

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

الإعدادات

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

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

Cardcom

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

Title: اسم طريقة الدفع الذي يراه العملاء في صفحة الدفع. وهو أيضًا اسم طريقة الدفع المحفوظ في الطلب. الافتراضي: Credit Card (Cardcom). مطلوب.

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

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

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

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

وضع الاختبار

يستخدم وضع الاختبار الطرفية التجريبية العامة لـ Cardcom رقم 1000 (مستخدم API هو CardTest1994). لا يُخصم أي مبلغ حقيقي، ولا يلزم حساب Cardcom. بطاقة الاختبار: 4580 0000 0000 0000، وأي تاريخ انتهاء صلاحية مستقبلي، ورمز CVV 123. وفي وضع الاختبار تعرض خطوة Confirm Order أيضًا سطرًا يتضمن بطاقة الاختبار هذه.

Test Mode: يفعّل وضع الاختبار (الطرفية 1000، دون مبالغ حقيقية). الافتراضي: مفعّل. عطّله لقبول مدفوعات فعلية باستخدام بيانات الاعتماد الفعلية أدناه. تُرسل عمليات الاسترداد دائمًا ببيانات اعتماد الوضع الذي دُفع فيه الطلب.

بيانات الاعتماد الفعلية

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

Terminal Number: رقم طرفية Cardcom الخاص بك. يجب أن يحتوي على أرقام فقط. إذا أدخلت أي شيء آخر، فستُحفظ الإعدادات الأخرى مع تحذير، ويبقى رقم الطرفية السابق كما هو.

API Username: اسم مستخدم API الخاص بك في Cardcom (ApiName) لهذه الطرفية. تُحذف المسافات عند الحفظ.

API Password: كلمة مرور API الخاصة بك في Cardcom. وهي مطلوبة فقط لعمليات الاسترداد من OpenCart. لا تُعرض كلمة المرور المحفوظة مرة أخرى أبدًا: يبقى الحقل فارغًا ويعرض محفوظة — اتركه فارغًا للاحتفاظ بها. أدخل قيمة جديدة فقط إذا أردت تغييرها. لحذف كلمة المرور المحفوظة، ضع علامة على Clear the saved API password أسفل الحقل، ثم انقر على Save.

صفحة الدفع

Notification URL: يرسل Cardcom إشعارات الدفع (IndicatorUrl) إلى هذا العنوان. يبدو في OpenCart 3 على هذا النحو: https://your-store/index.php?route=extension/payment/wcp_cardcom_payment_gateway/webhook، وفي OpenCart 4 على هذا النحو: https://your-store/index.php?route=extension/wcp_cardcom_payment_gateway/payment/wcp_cardcom_payment_gateway.webhook، ويُبنى من عنوان الواجهة الأمامية لتثبيت OpenCart الخاص بك. يُمرَّر العنوان تلقائيًا إلى Cardcom مع كل عملية دفع، إلى جانب رقم الطلب، لذلك لا يوجد ما يلزم ضبطه في Cardcom. ويجب أن يكون متاحًا من الإنترنت عبر HTTPS.

Operation: ما الذي يفعله Cardcom في صفحة الدفع.

Max Installments: الحد الأقصى لعدد الأقساط (الدفعات) التي يمكن للعميل اختيارها في صفحة Cardcom، من 1 إلى 36. تعني القيمة 1 عدم وجود تقسيط. الافتراضي: 1.

الطلبات

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

Success Order Status: الحالة التي تُعيَّن بعد تأكيد الدفع. الافتراضي: قيد المعالجة.

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

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

متقدم

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

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

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

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

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

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

الدفع

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

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

إذا لم يكتمل الدفع أو رفضه Cardcom، يعود العميل إلى صفحة الدفع مع الرسالة The card payment was not completed. Please try again or choose a different payment method. وفي OpenCart 4 تظهر هذه الرسالة فوق صفحة الدفع. يبقى الطلب بدون حالة وتُحفظ السلة. يمكن للعميل المحاولة مرة أخرى: ينشئ OpenCart 3 طلبًا جديدًا في كل مرة تُعرض فيها خطوة Confirm Order، ويحتفظ OpenCart 4 بطلب واحد للدفع ويحدّثه، وتحصل كل محاولة على صفحة دفع جديدة من Cardcom. قبل إنشاء صفحة جديدة، تُفحص لدى Cardcom صفحات الدفع المفتوحة لهذا الطلب ولطلبات أخرى من السلة نفسها (الجلسة نفسها للعميل ومحتوى السلة نفسه) خلال آخر 24 ساعة. إذا تبين أن إحداها مدفوعة، يُؤكَّد ذلك الطلب، وينتقل العميل إلى صفحة النجاح بدلًا من الدفع مرة أخرى. لا يُخصم مرة أخرى من سلة دُفع ثمنها بالفعل بطلب آخر: ينتقل العميل إلى صفحة النجاح. ولا يؤثر الرفض في صفحة قديمة على محاولة أحدث.

إذا أُغلق طلب الدفع بدون دفع في هذه الأثناء (مثلًا إذا ألغيته)، فإن Confirm Order أو عودة العميل من Cardcom يعيده إلى صفحة الدفع مع الرسالة This order can no longer be paid. Please confirm your order again.، والنقرة التالية على Confirm Order تدفع ثمن طلب جديد للسلة. يحتفظ OpenCart 4 بالطلب في صفحة الدفع حتى تُعرض صفحة النجاح: فإذا كانت لذلك الطلب حالة بالفعل وتغيّرت السلة منذ ذلك الحين (منتجات أو كميات أخرى)، يحصل العميل على الرسالة نفسها، وتحصل السلة المتغيرة على طلب جديد ودفعة خاصة بها، بينما تنتقل السلة نفسها دون دفعة جديدة إلى صفحة النجاح.

إذا لم يتمكن Cardcom من فتح صفحة الدفع، يبقى العميل في خطوة Confirm Order مع رسالة قصيرة فوق الزر، مثل تعذر الاتصال بـ Cardcom. يرجى المحاولة مرة أخرى بعد قليل. أو الرسالة التي تفيد بأن Cardcom لم يتمكن من فتح صفحة الدفع، مع رمز Cardcom، ويمكنه اختيار طريقة دفع أخرى.

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

تقبل الإضافة مدفوعات البطاقات الفردية في صفحة Cardcom فقط. ليس فيها بطاقات محفوظة أو دفع بنقرة واحدة، ولا اشتراكات، ولا تحصيل للرموز المحفوظة، ولا إعدادات فواتير أو إيصالات لـ Cardcom، ولا Bit أو Apple Pay أو Google Pay أو PayPal عبر Cardcom، ولا وضع iframe، ولا اتفاقات تحصيل مؤجل.

الطلبات وعمليات الاسترداد

حالات الطلب

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

Success Order Status (الافتراضي قيد المعالجة): تم تأكيد الدفع. تعرض ملاحظة معاملة Cardcom، وعندما يبلغ Cardcom بها، آخر أربعة أرقام من البطاقة ورقم الفاتورة وعدد الأقساط، وكيفية تأكيد الدفع (إشعار أو عودة أو محاولة جديدة). تُعلَّم المدفوعات التجريبية بـ وضع الاختبار — لم يُخصم أي مبلغ حقيقي.

On Hold (Review) Status (الافتراضي قيد الانتظار): أكد Cardcom دفعة لا تطابق الطلب، فمثلًا خُصم مبلغ أو عملة مختلفان، أو لم يُرجع Cardcom رقم معاملة. تشرح الملاحظة ذلك، وتعرض علامة تبويب الطلب هذا تحت Needs review:. قارن الدفعة في لوحة Cardcom بالطلب، ثم أتمّ الطلب أو استرد الدفعة.

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

إذا وصلت دفعة ناجحة ثانية لطلب له حالة بالفعل (مثلًا دفع العميل في تبويبين من المتصفح)، فلا يتغير الطلب. تحذّر ملاحظة من أنه ربما خُصم من العميل مرتين، وتطلب منك استرداد المبلغ في لوحة Cardcom. تُضاف الملاحظة نفسها إلى الطلب المدفوع عندما دُفعت السلة نفسها مرة أخرى بطلب آخر (مثلًا في تبويب ثانٍ)؛ ولا يحصل ذلك الطلب الآخر على أي حالة.

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

تبويب VibeFox Cardcom Payment Gateway

في Sales > Orders افتح طلبًا دُفع عبر Cardcom. في أسفل صفحة الطلب، بجوار History وAdditional، يعرض تبويب VibeFox Cardcom Payment Gateway Transaction مع تسمية Test mode للمدفوعات التجريبية، وPayment page (LowProfileCode)، وStatus، وCard، وInstallments، وInvoice، وCard token (مع Charge + Save token)، والمبلغ Charged، وOrder total / refunded، ونموذج الاسترداد، وسجل الاسترداد، وCardcom notes الخاصة بالطلب. يُعرض التبويب للمستخدمين الذين لديهم صلاحية الوصول إلى الإضافة.

عمليات الاسترداد

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

لا تعيد مرتجعات المنتجات في Sales > Returns أي أموال عبر Cardcom. ولا تُبلَّغ عمليات الاسترداد التي تُجرى في لوحة Cardcom إلى المتجر.

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

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

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

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

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

لا يظهر Cardcom في صفحة الدفع: تحقق من أن الترخيص فعّال، وأن Enable/Disable مفعّل، وأن عملة العميل هي ILS أو USD أو EUR أو GBP. في الوضع الفعلي، تحقق من أن Terminal Number وAPI Username مملوءان ببياناتك الخاصة، وليس بالطرفية التجريبية 1000 / CardTest1994. تعرض صفحة الإعدادات تحذيرًا عند غياب شيء ما. وتحقق أيضًا من وجود عنوان الدفع ضمن Geo Zone المحددة، ومن أن الطلب يبلغ Total المضبوط في الإعدادات.

تم الدفع، لكن الطلب بقي بدون حالة: ربما لم يتمكن Cardcom من الوصول إلى متجرك، مثلًا بسبب جدار حماية أو حماية بكلمة مرور أو موقع تطوير محلي. يجب أن يكون عنوان الإشعار متاحًا من الإنترنت عبر HTTPS. ويحصل الطلب أيضًا على حالته عندما يعود العميل إلى المتجر بعد الدفع. فعّل Debug log وانظر إلى الحقل Log في صفحة الإضافة.

يرد الإشعار بـ Missing or invalid lowprofilecode أو Unknown lowprofilecode for this order: لم يتضمن الاستدعاء رمز صفحة دفع صادرًا من متجرك لهذا الطلب. لا يتغير شيء.

يرد الإشعار بـ Gateway not configured أو Indicator check failed: بيانات اعتماد الوضع الذي أُنشئت فيه صفحة الدفع مفقودة، أو تعذر الوصول إلى Cardcom للتحقق. لا يتغير شيء؛ وتُعاد مراجعة الدفع عندما يعود العميل إلى المتجر.

يرد الإشعار بـ Busy, retry: كان الطلب يُؤكَّد من طلب آخر في اللحظة نفسها، أو تعذر ضبط حالة الطلب. فعّل Debug log لمعرفة السبب.

يرد الإشعار بـ ReturnValue mismatch أو Terminal mismatch: أبلغ Cardcom عن دفعة تخص طلبًا آخر أو طرفية أخرى. لا يتغير شيء. تحقق من أن Terminal Number هو طرفية حسابك.

يعرض عنوان الإشعار في المتصفح Missing or invalid lowprofilecode: هذا أمر طبيعي. يقبل العنوان الاستدعاءات الصادرة من Cardcom فقط.

يرى العميل «خطأ في الدفع: هذه العملة غير مدعومة من Cardcom.»: عملة الطلب ليست ILS أو USD أو EUR أو GBP.

يرى العميل «الدفع بالبطاقة غير متاح مؤقتًا. يرجى اختيار طريقة دفع أخرى.»: الوضع الفعلي مفعّل، لكن رقم الطرفية أو اسم مستخدم API مفقود، أو الحقول الفعلية تحتوي على الطرفية التجريبية العامة.

يرى العميل «طريقة الدفع هذه غير متاحة.» بعد Confirm Order: جلسة الدفع لم تعد تطابق الطلب، أو أُوقفت طريقة الدفع في هذه الأثناء. يعيد العميل تحميل صفحة الدفع.

يرى العميل خطأ آخر بعد Confirm Order: فعّل Debug log وانظر إلى الحقل Log. تُكتب فيه مشكلات الاتصال ورموز أخطاء Cardcom.

الطلب في حالة المراجعة بعد الدفع: اقرأ الملاحظات أو Needs review: في تبويب VibeFox Cardcom Payment Gateway. كان المبلغ أو العملة المدفوعة مختلفًا عن الطلب. أتمّ الطلب أو استرد الدفعة.

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

يفشل الاسترداد برسالة «API username and API password are required for refunds»: أدخل API Password (وAPI Username) في الإعدادات وحاول مرة أخرى.

يفشل الاسترداد برسالة «Could not connect to Cardcom»: راجع لوحة Cardcom قبل المحاولة مرة أخرى، لأن الاسترداد ربما تم أو لم يتم.

للمطورين: تُطلق الإضافة أحداث OpenCart cardcom_p_supported_currencies، الذي يوسّع قائمة العملات (أضف فقط العملات المفعّلة في طرفية Cardcom الخاصة بك)، وcardcom_p_low_profile_params، الذي يغيّر معلمات صفحة الدفع قبل إنشائها.

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

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

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

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