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

المتطلبات

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

PHP: الإصدار 8.0 أو أحدث، مع امتداد OpenSSL (يُستخدم لتشفير الطلب وفك تشفير الرد).

حساب CCAvenue: تحتاج إلى حساب تاجر لدى CCAvenue يتضمن Merchant ID وAccess Code وWorking Key. يُصدر Access Code وWorking Key لنطاق موقع ويب، لذا أنشئهما لنطاق هذا المتجر. تستخدم CCAvenue بيانات الاعتماد نفسها لبيئة الاختبار؛ يجب أن تفعّل CCAvenue وصول الاختبار لحسابك. تستخدم الإضافة نقاط النهاية الخاصة بـ CCAvenue India.

العملة: تُرسل عملة الطلب إلى CCAvenue كما هي. تقبل حسابات CCAvenue عملة INR افتراضيًا؛ أما العملات الأخرى فتتطلب تفعيل المعالجة متعددة العملات في حساب CCAvenue الخاص بك.

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

التثبيت

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

OpenCart 3

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

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

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

4. أدخل Merchant ID وAccess Code وWorking Key من لوحة تحكم CCAvenue، ثم فعّل Enable/Disable وانقر على Save.

5. أبقِ Test mode مفعّلًا أثناء الاختبار، ثم أوقفه لقبول المدفوعات الحقيقية. لا حاجة إلى أي إعداد في لوحة CCAvenue: يُرسل عنوان الإرجاع مع كل عملية دفع.

OpenCart 4

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

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

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

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

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

الإعدادات

جميع الإعدادات موجودة في صفحة الإضافة: Extensions > Extensions > Payments > VibeFox CCAvenue Payment > Edit. تُدرج الأقسام على اليسار؛ ويحفظ الزر Save الموجود أسفل القائمة الصفحة كاملة. تنبّهك الصفحة فوق الإعدادات عندما تكون CCAvenue مفعّلة لكن Merchant ID أو Access Code أو Working Key مفقود (عندئذٍ تُخفى طريقة الدفع عند إتمام الشراء حتى تُعيَّن الحقول الثلاثة)، وتعرض CCAvenue test mode is on: customers are sent to test.ccavenue.com and no real money is taken. طالما أن طريقة الدفع مفعّلة في وضع الاختبار، وتذكّرك بالمعالجة متعددة العملات عندما لا تكون العملة الافتراضية للمتجر هي INR. ومن دون صلاحية تعديل الإضافة، تعرض الصفحة الإعدادات لكنها لا تستطيع حفظها.

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

CCAvenue

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

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

Description: النص الذي يراه العميل في خطوة Confirm Order، فوق زر التأكيد. الافتراضي: Pay securely via Credit/Debit card, Net Banking, UPI or Wallet through CCAvenue.

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

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

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

بيانات اعتماد API

سجّل الدخول إلى لوحة تاجر CCAvenue (M.A.R.S.) وافتح Settings > API Keys. أنشئ Access Code وWorking Key لنطاق هذا المتجر. تُحذف المسافات في بيانات الاعتماد عند الحفظ.

Merchant ID: معرّف Merchant ID الرقمي لدى CCAvenue. إذا احتوى على أي شيء غير الأرقام، تظهر عند الحفظ الرسالة CCAvenue: the Merchant ID must contain digits only — the previous value was kept.، ويبقى القيمة المحفوظة سابقًا، وتُحفظ بقية الإعدادات.

Access Code: الـ Access Code الخاص بهذا الموقع (Settings > API Keys).

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

Test mode: يرسل العملاء إلى بيئة اختبار CCAvenue (test.ccavenue.com). تستخدم CCAvenue المعرّف Merchant ID نفسه وAccess Code وWorking Key للاختبار والإنتاج؛ يجب أن تفعّل CCAvenue وصول الاختبار لحسابك. في وضع الاختبار، تعرض خطوة Confirm Order الرسالة TEST MODE: no real transactions will be processed. الافتراضي: مفعّل. أوقفه للمدفوعات الحقيقية.

عنوان الإرجاع URL

تُعيد CCAvenue العميل إلى العنوان المعروض في هذا القسم. في OpenCart 3 يبدو كالتالي https://your-store/index.php?route=extension/payment/wcp_ccavenue_payment/back، وفي OpenCart 4 يبدو كالتالي https://your-store/index.php?route=extension/wcp_ccavenue_payment/payment/wcp_ccavenue_payment.back. ويُبنى من عنوان واجهة المتجر في تثبيت OpenCart الخاص بك. ترسل الإضافة هذا الرابط مع كل عملية دفع (بوصفه رابط إعادة توجيه ورابط إلغاء)، لذلك لا يلزم ضبط شيء في CCAvenue. ويجب أن ينتمي إلى النطاق المسجل لدى CCAvenue.

الطلبات

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

Order Status After Payment: عملية دفع ناجحة (حالة CCAvenue هي Success، والمبلغ والعملة مُتحقَّق منهما). الافتراضي: قيد التنفيذ.

Awaiting Payment Status: Awaited: لم يؤكد البنك الدفعة بعد. يحصل الطلب على Order Status After Payment عندما تُبلغ CCAvenue عن Success للمعرّف tracking ID نفسه. الافتراضي: في انتظار الدفع.

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

Cancelled Payment Status: أُجهضت عملية دفع معلّقة لاحقًا (Aborted للمعرّف tracking ID نفسه). الافتراضي: ملغي.

Failed Payment Status: فشلت عملية دفع معلّقة لاحقًا (Failure أو Invalid أو Timeout للمعرّف tracking ID نفسه). لا يغيّر فشل محاولة أقدم الطلب. الافتراضي: فشل.

متقدم

Debug log: يكتب أحداث CCAvenue في ccavenue_p_debug.log.php داخل مجلد السجلات في OpenCart (storage/logs). لا يمكن فتح الملف من الويب. تُسجَّل مراجع الطلبات ومعرّفات tracking IDs والحالات فقط؛ أما المفاتيح وبيانات البطاقات ورسائل البريد الإلكتروني والعناوين فلا تُسجَّل. الافتراضي: متوقف. وعند إيقافه لا يُكتب أي شيء، بما في ذلك الأخطاء.

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

Delete data on uninstall: عند التفعيل، يؤدي إلغاء تثبيت الإضافة إلى حذف إعداداتها وسجلها. تبقى الطلبات ومراجع الدفع الخاصة بـ CCAvenue، لذلك يُعالَج الرد المتأخر لعملية دفع قديمة حتى بعد إعادة التثبيت. الافتراضي: متوقف.

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

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

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

إتمام الشراء

في خطوة Payment Method، يختار العميل طريقة الدفع (افتراضيًا CCAvenue). في خطوة Confirm Order، يرى العميل وصفك. ينشئ OpenCart الطلب في هذه الخطوة، ولا يزال بدون حالة. عندما ينقر العميل على Confirm Order، تعرض الخطوة Thank you for your order. You are being redirected to CCAvenue to complete the payment. وتنقل العميل إلى صفحة دفع CCAvenue. يظهر زر Pay via CCAvenue بينما ينتقل المتصفح إلى هناك. في OpenCart 4 يختار العميل طريقة الدفع بزر Choose في كتلة طريقة الدفع، في النافذة Payment method options، وينقر على Confirm Order أسفل صفحة إتمام الشراء.

يحصل كل محاولة على مرجع طلب جديد في CCAvenue يتكون من رقم طلب OpenCart والوقت. يُرسل في الطلب المشفّر إجمالي الطلب وعملته، وبيانات الفوترة، وعنوان التسليم (عندما يُشحن الطلب ويختلف عنوان التسليم عن عنوان الفوترة)، ورمز سري خاص بالمحاولة. تُنقّى الأسماء والعناوين لتتوافق مع الأحرف والأطوال التي تقبلها CCAvenue؛ ويُرسل البلد والولاية بالأسماء، والهاتف بالأرقام فقط. يختار العميل البطاقة أو Net Banking أو UPI أو المحفظة أو EMI في صفحة CCAvenue. لا يطلب OpenCart 4 عنوان الدفع افتراضيًا؛ وتُؤخذ بيانات الفوترة عندئذٍ من عنوان التسليم.

بعد الدفع، تُعيد CCAvenue العميل مع رد مشفّر. لا يُعلَّم الطلب كمدفوع إلا بعد أن تؤكد CCAvenue ذلك: يجب أن يُفك تشفير الرد باستخدام Working Key الخاص بك، وأن ينتمي إلى محاولة في هذا المتجر، وأن يحمل المبلغ والعملة نفسيهما اللذين أُرسلا وإجمالي الطلب. ثم يحصل الطلب على حالته بالطريقة القياسية في OpenCart، مع رسائل البريد الإلكتروني المعتادة للطلب وتحديث المخزون، ويرى العميل صفحة نجاح الطلب في OpenCart مع العبارة Your CCAvenue payment has been received. وبالنسبة لعملية دفع Awaited، تعرض الصفحة Your CCAvenue payment is awaiting confirmation from your bank. The order will be processed as soon as the payment is confirmed. وبعد وجود فرق في المبلغ أو العملة، تعرض Your payment was received and is being reviewed by the store. وفي OpenCart 4 لا يرسل المتصفح جلسة المتجر عندما تُعيد CCAvenue العميل، لذلك تعرض الإضافة بعد تطبيق الرد صفحة قصيرة تفتح عنوان الإرجاع من متجرك مرة أخرى: يحتفظ العميل بالسلة وبتسجيل الدخول.

إذا فشلت عملية الدفع، يعود العميل إلى إتمام الشراء مع الرسالة Payment was not completed. Please try again or choose a different payment method. وإذا ألغى العميل في صفحة CCAvenue، فالرسالة هي Payment was cancelled. You may try again. وإذا تعذّر التحقق من الرد، فالرسالة هي We could not confirm the payment result. If your account was charged, please contact us before paying again. وفي OpenCart 4 تظهر هذه الرسائل فوق صفحة إتمام الشراء. في هذه الحالات يبقى الطلب بدون حالة ويُحتفظ بسلة التسوق، فيستطيع العميل الدفع مرة أخرى. ينشئ OpenCart 3 طلبًا جديدًا في كل مرة تُعرض فيها خطوة Confirm Order، ويُبقي OpenCart 4 طلبًا واحدًا للإتمام ويحدّثه. وتحصل كل محاولة على مرجع طلب CCAvenue خاص بها. لا تستطيع CCAvenue إلغاء عملية دفع بدأت، لذلك تُطبَّق عملية الدفع الناجحة المتأخرة لمحاولة أقدم على طلبها الخاص. تُدفع السلة مرة واحدة: لا تُرسل السلة التي دفعها طلب آخر مجددًا إلى CCAvenue (ينتقل العميل إلى صفحة النجاح)، وإذا دُفعت السلة نفسها مرتين مع ذلك (مثلًا في تبويبين من المتصفح)، يبقى الطلب الثاني بدون حالة، ويتلقى الطلب المدفوع ملاحظة تفيد بأنه ربما خُصم من العميل مرتين، حتى تتمكن من استرداد المبلغ من لوحة CCAvenue.

يُبقي OpenCart 4 الطلب في صفحة إتمام الشراء حتى تُعرض صفحة النجاح. وإذا أُغلق ذلك الطلب في هذه الأثناء، فإن Confirm Order يعيد العميل إلى إتمام الشراء، وتؤدي النقرة التالية على Confirm Order إلى دفع طلب جديد للسلة. الرسالة هي Payment was cancelled. You may try again. عند إلغاء دفعة معلّقة، وPayment was not completed. Please try again or choose a different payment method. عند فشلها، وThis order can no longer be paid (it was closed by the store). Please confirm your order again. عندما تُغلق طلبًا كان له دفع. وإذا كان للطلب حالة بالفعل وتغيّرت السلة منذ ذلك (منتجات أو كميات أخرى)، فالرسالة هي Your previous order is already paid. Please confirm the order again: the cart will be paid with a new order.

تُؤخذ النتيجة فقط من عودة العميل من CCAvenue: لا توجد إشعارات من الخادم إلى الخادم ولا طلبات حالة. إذا أغلق العميل المتصفح قبل أن يعود، يبقى الطلب بدون حالة؛ تحقّق من الدفعة في لوحة CCAvenue. لا تدعم الإضافة الاسترداد من OpenCart، ولا البطاقات المحفوظة، ولا الاشتراكات أو المدفوعات المتكررة، ولا نموذج البطاقة داخل الموقع، ولا CCAvenue UAE أو المنصات الإقليمية الأخرى.

الطلبات

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

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

Order Status After Payment (default Processing): تم تأكيد الدفعة. تعرض ملاحظة مرجع البنك ومعرّف tracking ID ووضع الدفع.

Awaiting Payment Status (default Pending): أبلغت CCAvenue عن الدفعة بأنها Awaited (لم يؤكدها البنك بعد). لا يُعلَّم الطلب أبدًا بأنه فاشل طالما أن المبلغ قد يُحصَّل، وتطلب ملاحظة منك التحقق منه في لوحة CCAvenue قبل تنفيذ الطلب. يُطبَّق أيضًا أي رد لاحق بالمعرّف tracking ID نفسه: Success يضبط Order Status After Payment، وFailure يضبط Failed Payment Status، وAborted يضبط Cancelled Payment Status. يُبلغ OpenCart العميل بهذه التغييرات.

On Hold (Review) Status (default Pending): أكدت CCAvenue دفعة يختلف مبلغها أو عملتها عن إجمالي الطلب أو عمّا أُرسل، أو دفع العميل بعد إلغاء الطلب أو فشله. تعرض الملاحظة المبلغ المستلم والمبلغ المتوقع. تحقّق من الدفعة في لوحة CCAvenue، ثم نفّذ الطلب أو استرد الدفعة.

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

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

VibeFox CCAvenue Payment tab

في Sales > Orders، افتح طلبًا مدفوعًا عبر CCAvenue. في أسفل صفحة الطلب، بجوار History وAdditional، يعرض التبويب VibeFox CCAvenue Payment الحقل CCAvenue order ID مع عنوان Test mode لعمليات الدفع التجريبية، وTracking ID، وStatus، وBank reference، وPayment mode واسم البطاقة، وAmount sent وAmount received، وDate، وMessage من CCAvenue، وCCAvenue notes الخاصة بالطلب. يُعرض التبويب للمستخدمين الذين لديهم صلاحية الوصول إلى الإضافة.

الاسترداد

الاسترداد من OpenCart غير مدعوم. استرد الدفعة في لوحة CCAvenue، ثم سجّل الاسترداد في OpenCart يدويًا، مثلًا بتغيير حالة الطلب.

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

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

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

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

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

CCAvenue does not appear at checkout: تحقّق من أن الترخيص نشط، وأن Enable/Disable مفعّل، وأن بيانات الاعتماد الثلاثة مُعيّنة: Merchant ID وAccess Code وWorking Key. تعرض صفحة الإعدادات تحذيرًا عند غياب أي منها. وتحقّق أيضًا من أن عنوان الدفع ضمن Geo Zone المحددة، وأن الطلب يبلغ Total المحدد في الإعدادات.

The payment went through, but the order stays without a status: لم يعد العميل من CCAvenue إلى متجرك، مثلًا لأنه أغلق المتصفح. لا تملك الإضافة إشعارات من الخادم إلى الخادم. تحقّق من الدفعة في لوحة CCAvenue وحدّث الطلب يدويًا.

Every payment ends with We could not confirm the payment result: لا يمكن فك تشفير الرد. Working Key غير صحيح، أو ينتمي إلى نطاق آخر، أو نُسخ مع أحرف زائدة. أنشئ المفاتيح لنطاق هذا المتجر والصقها من جديد. فعّل Debug log وانظر إلى الحقل Log في صفحة الإضافة.

CCAvenue shows an error before the payment page: تحقّق من أن Access Code وWorking Key أُنشئا لهذا النطاق، وأن عنوان الإرجاع ينتمي إلى النطاق المسجل لدى CCAvenue، وأنه في وضع الاختبار فعّلت CCAvenue وصول الاختبار لحسابك. بالنسبة إلى عملة غير INR، يجب تفعيل المعالجة متعددة العملات في حساب CCAvenue الخاص بك.

The customer sees This payment method is temporarily unavailable: أحد بيانات الاعتماد مفقود، أو إجمالي الطلب صفر. يعرض Debug log السبب.

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

The customer sees Payment gateway error: encryption failed: تعذّر تشفير الطلب. تحقّق من تثبيت امتداد OpenSSL في PHP.

The Merchant ID does not change on save: القيمة تحتوي على شيء غير الأرقام. أدخل أرقام Merchant ID فقط.

Order is in the review or awaiting status: اقرأ الملاحظات في تبويب VibeFox CCAvenue Payment (راجع حالات الطلبات). تحقّق من الدفعة في لوحة CCAvenue، ثم نفّذ الطلب أو استرد الدفعة.

للمطورين: قبل تشفير الطلب، تُطلق الإضافة حدث OpenCart ccavenue_p_request_params مع معلمات الطلب والطلب نفسه (مثلًا لتعيين merchant_param2 إلى merchant_param5؛ لا تغيّر amount أو currency أو order_id أو merchant_param1).

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

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

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

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