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

المتطلبات

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

PHP: ‏8.0 أو أحدث.

العملة: البيزو الكولومبي (COP) أو الدولار الأمريكي (USD). عندما يدفع العميل بعملة أخرى، تُخفى طريقة الدفع عند الدفع.

حساب ePayco: تحتاج إلى المفاتيح الأربعة لحساب ePayco الخاص بك: P_CUST_ID_CLIENTE وP_KEY وPUBLIC_KEY وPRIVATE_KEY. توجد في لوحة تحكم ePayco ضمن Integrations, API keys. تعمل المفاتيح نفسها في وضع الاختبار ووضع الإنتاج. طرق الدفع التي يمكن للعميل استخدامها (البطاقات، وPSE، وشبكات الدفع النقدي، والمحافظ الإلكترونية) هي الطرق المفعّلة في حساب ePayco الخاص بك.

الموقع العام: يجب أن يكون عنوان URL للتأكيد في متجرك متاحًا من الإنترنت، ولا يجوز أن تحجبه جدار حماية أو المصادقة الأساسية.

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

التثبيت

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

OpenCart 3

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

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

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

4. أدخل المفاتيح الأربعة لـ ePayco واختر نوع الدفع (انظر الإعدادات).

5. فعّل Enable/Disable وانقر على Save. اختبر دفعة مع تفعيل Test Mode وبطاقات الاختبار الخاصة بـ ePayco، ثم أوقف Test Mode.

OpenCart 4

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

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

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

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

يبدأ التثبيت الجديد بطريقة الدفع معطّلة ووضع الاختبار معطّلًا. يُرسل عنوان URL للتأكيد إلى ePayco مع كل دفعة، لذلك لا يلزم إعداد أي شيء في لوحة تحكم ePayco.

الإعدادات

توجد جميع الإعدادات في صفحة الإضافة: Extensions > Extensions > Payments > VibeFox ePayco Payment > Edit. تُعرض الأقسام على اليسار؛ وزر Save أسفل القائمة يحفظ الصفحة كاملة. وفوق الإعدادات، توضح الصفحة أن الطلب لا يحصل على حالة إلا بعد أن تؤكد ePayco المعاملة. وتحذّرك عندما لا تُدخل المفاتيح الأربعة كاملة (عندها تُخفى طريقة الدفع عند الدفع) وعندما تكون العملة الافتراضية لمتجرك غير COP أو USD، وتعرض Test mode is on: customers pay with ePayco test cards and no real money is charged. أثناء تفعيل وضع الاختبار. وبدون صلاحية تعديل الإضافة، تعرض الصفحة الإعدادات لكنها لا تستطيع حفظها.

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

ePayco

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

Title: اسم طريقة الدفع الذي يراه العملاء عند الدفع. وهو أيضًا اسم طريقة الدفع المحفوظ في الطلب. حتى ‏128 حرفًا؛ وإذا تُرك فارغًا، سيرى العملاء ePayco. الافتراضي: ePayco.

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

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

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

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

مفاتيح حساب ePayco

اعثر على المفاتيح الأربعة في لوحة تحكم ePayco ضمن Integrations, API keys (يحتوي القسم على رابط إلى اللوحة). يتحقق P_CUST_ID_CLIENTE وP_KEY من تأكيدات الدفع؛ وينشئ PUBLIC_KEY وPRIVATE_KEY جلسات الدفع. تعمل المفاتيح نفسها في وضع الاختبار ووضع الإنتاج.

Customer ID (P_CUST_ID_CLIENTE): معرّف العميل الخاص بك في ePayco (رقمي).

Secret Key (P_KEY): يُستخدم للتحقق من توقيع تأكيدات الدفع الصادرة عن ePayco. احتفظ به سرًا.

Public Key (PUBLIC_KEY): مفتاح API العام الخاص بك في ePayco.

Private Key (PRIVATE_KEY): مفتاح API الخاص بك في ePayco. احتفظ به سرًا.

لا يُعرض Secret Key (P_KEY) وPrivate Key (PRIVATE_KEY) المحفوظان مرة أخرى أبدًا. يبقى الحقل فارغًا ويعرض Saved — leave empty to keep it. أدخل قيمة جديدة فقط إذا أردت تغييرها. ولحذف مفتاح محفوظ، ضع علامة على Clear saved secret on save أسفل الحقل، ثم انقر على Save.

Test Mode: تُنشأ جلسات الدفع كمعاملات اختبار. يدفع العملاء ببطاقات اختبار ePayco ولا يُخصم أي مبلغ حقيقي. لا تدفع معاملات الاختبار أبدًا الطلبات التي أُنشئت في وضع الإنتاج. الافتراضي: معطّل. أثناء تفعيله يرى العملاء TEST MODE — use ePayco test cards, no real money is charged. في خطوة Confirm Order وفي صفحة الدفع.

الدفع

Checkout Type: كيفية فتح صفحة الدفع الخاصة بـ ePayco.

عنوان URL للتأكيد

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

يجب أن يحمل كل تأكيد توقيعًا صالحًا أُنشئ باستخدام P_CUST_ID_CLIENTE وP_KEY الخاصين بك. وتُرفض التأكيدات التي لا تحمل توقيعًا صالحًا ولا تغيّر أي شيء. وبدون التأكيد، لا يحصل الطلب على حالته إلا عندما يعود العميل إلى المتجر بعد الدفع.

الطلبات

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

Order Status After Payment: وافقت ePayco على الدفعة، ويتطابق المبلغ والعملة مع الطلب. الافتراضي: Processing.

Awaiting Payment Status: أبلغت ePayco أن الدفعة معلّقة أو محتجزة (تحويل PSE، وشبكات الدفع النقدي). يتغير الطلب تلقائيًا عندما توافق ePayco على الدفعة أو ترفضها. الافتراضي: Pending.

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

Payment Failed Status: رُفضت دفعة معلّقة أو فشلت أو انتهت صلاحيتها أو أُلغيت. ولا تزال الدفعة الجديدة الموافَق عليها تسدد الطلب. الافتراضي: Failed.

Reversed Status: عكست ePayco دفعة الطلب. الافتراضي: Refunded.

متقدم

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

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

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

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

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

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

الدفع

في خطوة Payment Method يختار العميل طريقة الدفع (افتراضيًا ePayco). وفي خطوة Confirm Order يرى العميل وصفك والملاحظة After confirming the order you pay securely in the ePayco checkout (cards, PSE, cash, wallets). ينشئ OpenCart الطلب في هذه الخطوة، ولا يزال بدون حالة. في OpenCart 4 يختار العميل طريقة الدفع بزر Choose في كتلة طريقة الدفع، في نافذة Payment method options، وينقر على Confirm Order أسفل صفحة الدفع. وعندما ينقر العميل على Confirm Order، تنشئ الإضافة جلسة دفع ePayco لإجمالي الطلب بعملة الطلب، مع الضرائب ورقم الطلب واسم الفوترة وعنوانها وبريدها الإلكتروني وهاتفها. يظهر الدفع في ePayco باسم Order # ورقم الطلب. لغة صفحة الدفع إسبانية أو إنجليزية، حسب لغة متجر العميل.

ثم يرى العميل صفحة ePayco payment مع العبارة Thank you for your order. The secure ePayco checkout opens automatically; if it does not, click the button below. تُفتح صفحة دفع ePayco كنافذة منبثقة أو كإعادة توجيه، حسب Checkout Type. وتحتوي الصفحة أيضًا على الزر Pay with ePayco والرابط Choose another payment method. كل Confirm Order جديد ينشئ جلسة ePayco جديدة (تنشئ OpenCart 3 طلبًا جديدًا في كل مرة تُعرض فيها خطوة Confirm Order، أما OpenCart 4 فيحدّث طلب الدفع، فتدفع المحاولة الجديدة الطلب نفسه). وإذا كان طلب سابق من السلة نفسها مدفوعًا بالفعل أو بانتظار ePayco، يُنقل العميل إلى صفحة نجاح الطلب ولا يُخصم منه المبلغ مرة أخرى.

في صفحة دفع ePayco يدفع العميل بإحدى الطرق المفعّلة في حساب ePayco الخاص بك. بعد ذلك ترسل ePayco التأكيد إلى متجرك وتعيد العميل. لا يُعلَّم الطلب كمدفوع إلا بعد أن تؤكده ePayco: بالتأكيد الموقَّع، أو بطلب من الخادم إلى ePayco عندما يعود العميل. ولا تسدد عودة العميل وحدها أي طلب. ثم يحصل الطلب على حالته بالطريقة القياسية في OpenCart، مع رسائل الطلب المعتادة وتحديث المخزون، ويرى العميل صفحة نجاح الطلب في OpenCart.

بالنسبة إلى دفعة معلّقة (مثل PSE أو الدفع النقدي) يحصل الطلب على Awaiting Payment Status، وتعرض صفحة النجاح Your ePayco payment is being confirmed. We will e-mail you as soon as it is approved. وإذا كانت الدفعة المعلّقة قد رُفضت أو انتهت صلاحيتها بالفعل عند عودة العميل، تعرض الصفحة Your ePayco payment was not completed. Please contact us about this order. وإذا لم تؤكد ePayco الدفعة بعد عند عودة العميل، تعرض صفحة Payment confirmation العبارة We are waiting for ePayco to confirm your payment. This page does not need to stay open. مع زر Check again.

إذا رُفضت الدفعة، يعود العميل إلى صفحة الدفع مع الرسالة Your ePayco payment was declined or could not be completed. You can try again or choose another payment method. وإذا عاد العميل دون أن يدفع، تكون الرسالة The ePayco payment was not completed. If you already paid, the order will be updated as soon as ePayco confirms it; otherwise you can try again. تُحفظ السلة ويبقى الطلب بدون حالة. وفي OpenCart 4 تُعرض هذه الرسائل فوق صفحة الدفع.

يحتفظ OpenCart 4 بالطلب في الدفع حتى تُعرض صفحة النجاح. إذا أُغلق ذلك الطلب دون دفعة من ePayco في هذه الأثناء (مثلًا إذا فشلت دفعته المعلّقة أو ألغيتها)، يُعاد العميل إلى صفحة الدفع مع رسالة الدفعة المرفوضة، ويدفع Confirm Order التالي طلبًا جديدًا للسلة. وإذا حصل ذلك الطلب على حالة بالفعل ثم تغيّرت السلة بعد ذلك، بما في ذلك كمية جديدة، يُعاد العميل إلى صفحة الدفع، ويدفع Confirm Order التالي السلة الجديدة بطلب جديد. ولا يظهر الطلب المدفوع أبدًا كمدفوع لسلة مختلفة.

إذا تعذّر على ePayco بدء الدفع، يبقى العميل في خطوة Confirm Order مع رسالة قصيرة فوق الزر، مثل We could not connect to ePayco. Please try again in a moment or choose another payment method. ويُكتب السبب التقني في السجل.

لا تدعم الإضافة إلا الدفعات لمرة واحدة. ليس فيها استرداد من المتجر، ولا بطاقات محفوظة، ولا اشتراكات، ولا دفعات مقسّطة، ولا تستعلم من ePayco عن المعاملات المعلّقة: تُحدَّث الطلبات بتأكيد ePayco وعودة العميل.

الطلبات

حالات الطلب

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

Order Status After Payment (default Processing): وافقت ePayco على الدفعة. تعرض ملاحظة مرجع ePayco والحالة والمبلغ وطريقة الدفع ورمز الموافقة.

Awaiting Payment Status (default Pending): أبلغت ePayco أن الدفعة معلّقة أو محتجزة، مثل تحويل PSE أو دفعة نقدية. عندما توافق ePayco عليها ينتقل الطلب إلى Order Status After Payment؛ وعندما تُرفض أو تفشل أو تنتهي صلاحيتها أو تُلغى، ينتقل الطلب إلى Payment Failed Status. يرسل OpenCart رسائل بريد إلكتروني إلى العميل بشأن هذه التغييرات.

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

Payment Failed Status (default Failed): لم تكتمل دفعة معلّقة. تعرض الملاحظة سبب ePayco. ولا تزال الدفعة الجديدة الموافَق عليها تسدد الطلب. والفشل المتأخر لا يغيّر أبدًا طلبًا مدفوعًا.

Reversed Status (default Refunded): عكست ePayco الدفعة التي سدّدت هذا الطلب.

إذا أبلغت ePayco عن دفعة موافَق عليها أخرى لطلب مدفوع بالفعل، فلن تتغير الحالة. وتطلب منك ملاحظة التحقق من وجود خصم مزدوج وإعادة المبلغ في ePayco عند الحاجة. وإذا دفع العميل طلبًا ثانيًا من السلة نفسها (مثلًا من نافذتين مفتوحتين لـ ePayco)، فلن يحصل ذلك الطلب على أي حالة، ويرى العميل صفحة نجاح الطلب، ويتلقى الطلب المدفوع ملاحظة تطلب منك إعادة الدفعة الثانية في ePayco. تُتجاهل معاملة الاختبار لطلب أُنشئ في وضع الإنتاج، والمعاملة التي تنتمي بالفعل إلى طلب آخر. والملاحظات إدخالات في History الطلب التي لا يراها العميل.

تبويب VibeFox ePayco Payment

في Sales > Orders افتح طلبًا مدفوعًا بواسطة ePayco. في أسفل صفحة الطلب، بجوار History وAdditional، يعرض تبويب VibeFox ePayco Payment المرجع ePayco reference (ref_payco) والمعرّف Transaction ID والحالة State وطريقة الدفع Payment method ورمز الموافقة Approval code وتاريخ المعاملة Transaction date ووضع التشغيل Mode (مع تسمية Test mode لمدفوعات الاختبار) وحالة المحاولة Attempt status وePayco notes الخاصة بالطلب. وبالنسبة إلى طلب قيد المراجعة يعرض التبويب تحذيرًا بالتحقق من المعاملة قبل الشحن. التبويب للقراءة فقط ويظهر للمستخدمين الذين لديهم صلاحية الوصول إلى الإضافة.

المرتجعات

الاسترداد من المتجر غير مدعوم. استرد الدفعة في لوحة تحكم ePayco، ثم حدّث الطلب في OpenCart يدويًا إذا لزم الأمر. وعكس المعاملة المدفوعة الذي تبلغ عنه ePayco يضع الطلب في Reversed Status. ولا ترسل المرتجعات للمنتجات في Sales > Returns أموالًا عبر ePayco.

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

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

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

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

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

ePayco does not appear at checkout: تحقق من أن الترخيص نشط، وأن Enable/Disable مفعّل، وأن المفاتيح الأربعة مُدخلة، وأن العميل يدفع بـ COP أو USD. تعرض صفحة الإعدادات تحذيرًا عندما تكون المفاتيح ناقصة. وتحقق أيضًا من أن عنوان الدفع داخل Geo Zone المحددة، وأن الطلب يبلغ Total المحدد في الإعدادات.

The payment went through, but the order stays without a status: لا يصل تأكيد ePayco إلى متجرك. تحقق من أن عنوان URL للتأكيد المعروض في الإعدادات يفتح من الإنترنت ولا يحجبه جدار حماية أو إضافة أمان أو مصادقة أساسية. انظر إلى حقل Log في صفحة الإضافة؛ وفعّل Logging لرؤية كل تأكيد. كما يحصل الطلب على حالته عندما يعود العميل إلى المتجر بعد الدفع.

Confirmation answers Invalid signature: Customer ID (P_CUST_ID_CLIENTE) أو Secret Key (P_KEY) لا يطابق حساب ePayco الذي استلم الدفعة. انسخ الاثنين مرة أخرى من لوحة تحكم ePayco.

Confirmation answers Gateway not configured: إن P_CUST_ID_CLIENTE أو P_KEY فارغ. أدخلهما في الإعدادات.

Confirmation answers Order not found: يشير التأكيد إلى طلب ليست له دفعة ePayco من هذا المتجر.

Confirmation answers Busy, retry later: كان الطلب يُحدَّث بواسطة طلب آخر في اللحظة نفسها. تعيد ePayco محاولة التأكيد. والسبب موجود في السجل.

The customer sees We could not connect to ePayco: رفضت ePayco PUBLIC_KEY وPRIVATE_KEY. يعرض السجل رد ePayco. انسخ المفتاحين مرة أخرى.

The customer sees ePayco could not start the payment: لم تنشئ ePayco جلسة الدفع. اقرأ في السجل خطأ ePayco.

The customer sees This payment method is not available right now: لم تعد جلسة الدفع تطابق الطلب، أو أُوقفت طريقة الدفع في هذه الأثناء، أو أُزيلت المفاتيح. يعيد العميل تحميل صفحة الدفع.

The ePayco checkout does not open: يرى العميل The ePayco checkout could not be loaded. Please reload the page or choose another payment method. تعذّر تحميل نص الدفع الخاص بـ ePayco في صفحة الدفع. يمكن للعميل إعادة تحميل الصفحة أو استخدام Choose another payment method.

A test payment did not pay the order: لا تدفع معاملات الاختبار أبدًا الطلبات التي أُنشئت في وضع الإنتاج. أنشئ طلب الاختبار والخيار Test Mode مفعّل.

Order is in the review status after payment: اقرأ الملاحظات في تبويب VibeFox ePayco Payment (انظر حالات الطلب) وتحقق من المعاملة في لوحة تحكم ePayco قبل الشحن.

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

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

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

ePayco علامة تجارية مسجلة لمالكها. هذه الإضافة غير تابعة لـ ePayco ولا معتمدة من قبلها.