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

المتطلبات

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

PHP: 8.0 أو أحدث.

العملة: البيزو الكولومبي (COP). تُحصِّل Wompi Colombia المبالغ بالبيزو الكولومبي. أضف COP في System > Localisation > Currencies إذا لم تكن موجودة في متجرك بعد؛ لا تُعرض وسيلة الدفع إلا عندما يدفع العميل بعملة COP. تحذّرك صفحة الإعدادات عندما لا تكون العملة الافتراضية للمتجر هي COP.

حساب Wompi: حساب تاجر لدى Wompi Colombia. لكل بيئة (الاختبار والإنتاج) أربعة مفاتيح: المفتاح العام، والمفتاح الخاص، وسر الأحداث، وسر التكامل. تجدها في لوحة تاجر Wompi (comercios.wompi.co) ضمن قسم المطورين. لا تُدعم Wompi El Salvador وPanama لأنهما تستخدمان واجهات برمجة تطبيقات مختلفة.

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

التثبيت

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

OpenCart 3

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

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

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

4. الصق مفاتيح الاختبار والإنتاج من لوحة تاجر Wompi، واضبط Events URL في Wompi (انظر الإعداد).

5. فعّل Enable/Disable وانقر على Save. اختبر دفعة في وضع sandbox، ثم أوقف Sandbox mode لقبول المدفوعات الحقيقية.

OpenCart 4

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

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

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

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

يبدأ التثبيت الجديد بوسيلة الدفع معطّلة ووضع sandbox مُفعّل.

الإعداد

جميع الإعدادات موجودة في صفحة الإضافة: Extensions > Extensions > Payments > VibeFox Wompi Payment > Edit. تُدرج الأقسام على اليسار؛ يحفظ الزر Save أسفل القائمة الصفحة كاملة. فوق الإعدادات يعرض مربع الحالة الوضع الحالي، إما SANDBOX أو PRODUCTION. عندما يكون مفتاح من هذا الوضع مفقودًا، يسرده المربع ويوضح أن وسيلة الدفع تبقى مخفية عند الدفع إلى أن تُعبَّأ جميع مفاتيح هذه البيئة. وعندما تكتمل جميع المفاتيح، يوضح ما إذا كانت المدفوعات الحقيقية ستُخصم. عند الحفظ تحذرك الإضافة إذا كان مفتاح لا يبدأ ببادئة قسمه، أو إذا كانت Wompi مُفعّلة لكنها مخفية عند الدفع بسبب نقص المفاتيح. يجب ألا يتجاوز Title 128 حرفًا (Title must be at most 128 characters.)، ويجب أن يكون Sort Order عددًا صحيحًا (Sort Order must be a whole number.)، ويجب أن يكون Total رقمًا أكبر من أو يساوي 0 (Total: enter a number, 0 or greater.)، ويجب أن توجد المنطقة الجغرافية وحالات الطلب المختارة؛ وإلا فلن يُحفظ شيء وتعرض الصفحة الخطأ. بدون صلاحية تعديل الإضافة تعرض الصفحة الإعدادات لكنها لا تستطيع حفظها.

Wompi

Enable/Disable: يُفعّل Enable Wompi وسيلة الدفع أو يُعطّلها. الافتراضي: معطّل.

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

Description: النص الذي يراه العميل في خطوة Confirm Order فوق زر التأكيد. الافتراضي: Pay securely with Wompi: cards, PSE, Nequi, Bancolombia and more.

Sort Order: ترتيب Wompi بين وسائل الدفع عند الدفع. اتركه فارغًا أو أدخل عددًا صحيحًا؛ الأعداد السالبة مسموحة.

Geo Zone: اعرض Wompi فقط لعناوين الدفع الواقعة ضمن المنطقة الجغرافية المختارة. الافتراضي: All zones. تُضبط المناطق الجغرافية في System > Localisation > Geo Zones. وفي OpenCart 4، عندما لا يحتوي الدفع على عنوان دفع، يُفحص عنوان الشحن.

Total: إجمالي الدفع، بعملة المتجر الافتراضية، الذي يجب أن يبلغه الطلب قبل عرض Wompi: رقم أكبر من أو يساوي 0. اتركه فارغًا لعرضه مع أي إجمالي. تتطلب Wompi نفسها 1,500 COP على الأقل.

حساب Wompi

انسخ المفاتيح من لوحة تاجر Wompi (comercios.wompi.co)، ضمن قسم المطورين. لكل بيئة مفتاحها العام ومفتاحها الخاص وسر أحداثها وسر تكاملها.

Sandbox mode: يستخدم بيئة sandbox التابعة لـ Wompi (مفاتيح sandbox، بلا أموال حقيقية). يبدّل هذا الخيار المفاتيح وواجهة Wompi البرمجية معًا (sandbox.wompi.co أو production.wompi.co). تحتفظ محاولات الدفع بالبيئة التي أُجريت فيها. الافتراضي: مُفعّل. أوقفه لقبول المدفوعات الحقيقية. وما دام مُفعّلًا، يرى العملاء Sandbox mode: no real payment is made. في خطوة Confirm Order.

مفاتيح sandbox

المفاتيح الأربعة لبيئة sandbox التابعة لـ Wompi. تبدأ بـ pub_test_ وprv_test_ وtest_events_ وtest_integrity_.

Public key: المفتاح العام لبيئة sandbox (pub_test_...). يعرّف حسابك في Wompi Web Checkout.

Private key: المفتاح الخاص لبيئة sandbox (prv_test_...). يُستخدم لقراءة المعاملات من واجهة Wompi البرمجية.

Events secret: سر أحداث sandbox (test_events_...). يتحقق من توقيع أحداث Wompi.

Integrity secret: سر تكامل sandbox (test_integrity_...). يوقّع طلب الدفع المرسل إلى Web Checkout.

مفاتيح الإنتاج

المفاتيح الأربعة لبيئة الإنتاج في Wompi. تبدأ بـ pub_prod_ وprv_prod_ وprod_events_ وprod_integrity_.

Public key: المفتاح العام للإنتاج (pub_prod_...).

Private key: المفتاح الخاص للإنتاج (prv_prod_...).

Events secret: سر أحداث الإنتاج (prod_events_...).

Integrity secret: سر تكامل الإنتاج (prod_integrity_...).

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

Events URL (webhook)

تُخبر أحداث Wompi متجرك بأن معاملة قد تغيّرت. في لوحة تاجر Wompi، ضمن قسم المطورين، اضبط Events URL المعروض في هذا القسم، لبيئتي sandbox والإنتاج. يُبنى الرابط من عنوان واجهة متجرك في تثبيت OpenCart، على OpenCart 3 يبدو هكذا: https://your-store/index.php?route=extension/payment/wcp_wompi_payment/webhook، وعلى OpenCart 4 هكذا: https://your-store/index.php?route=extension/wcp_wompi_payment/payment/wcp_wompi_payment.webhook. انسخ الرابط تمامًا كما تعرضه الإعدادات.

تستخدم الإضافة هذا الحدث:

تُجاب الأحداث الأخرى بـ Ignored. يُتحقق من كل حدث بسر الأحداث الخاص ببيئته (sandbox أو الإنتاج). تُرفض webhooks التي لا تحمل توقيعًا صالحًا. بعد التحقق تُقرأ المعاملة من واجهة Wompi البرمجية باستخدام المفتاح الخاص لتلك البيئة، ولا تُستخدم إلا هذه البيانات. بدون Events URL، لا يحصل الطلب على حالته إلا عندما يعود العميل إلى المتجر بعد الدفع.

Orders

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

Order Status After Payment: معاملة APPROVED بالمبلغ المتوقع بالعملة COP. الافتراضي: Processing.

Awaiting Payment Status: معاملة PENDING، مثل PSE أو Nequi أو دفعة نقدية تنتظر التأكيد. يحصل الطلب على Order Status After Payment عندما توافق عليه Wompi. الافتراضي: Pending.

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

Failed Payment Status: رُفضت المعاملة المعلّقة لأحدث محاولة دفع أو انتهت بخطأ. الافتراضي: Failed.

Cancelled Order Status: أُلغيت المعاملة المعلّقة لأحدث محاولة دفع في Wompi. الدفع المعتمد لطلب في هذه الحالة يضعه في الانتظار بدلًا من تعليمه كمدفوع. الافتراضي: Canceled.

متقدم

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

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

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

Import / Export

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

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

الدفع

في خطوة Payment Method يختار العميل وسيلة الدفع (افتراضيًا Wompi). في خطوة Confirm Order يرى العميل وصفك. ينشئ OpenCart الطلب في هذه الخطوة، ولا يزال بدون حالة. عندما ينقر العميل على Confirm Order، تنشئ الإضافة محاولة دفع برقم مرجعي خاص بها (OC- ورقم الطلب وختم زمني)، وتوقّعها بسر التكامل، وترسل العميل إلى Wompi Web Checkout بإجمالي الطلب بالعملة COP. يُمرَّر بريد العميل واسم عنوان الدفع إلى Wompi. على OpenCart 4 يختار العميل وسيلة الدفع بزر Choose في كتلة وسيلة الدفع، في النافذة Payment method options، ثم ينقر على Confirm Order في أسفل صفحة الدفع. وعندما لا يحتوي الدفع على عنوان دفع، يُؤخذ الاسم من الطلب أو من عنوان الشحن.

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

عندما تُوافَق المعاملة، يحصل الطلب على حالته بالطريقة القياسية في OpenCart، مع رسائل الطلب المعتادة وتحديث المخزون، ويرى العميل صفحة نجاح الطلب في OpenCart. وفي حالة الدفع المعلّق (مثل PSE أو Nequi أو الدفع النقدي) تعرض الصفحة Your Wompi payment is pending confirmation (for example PSE, Nequi or a cash payment). We will process the order as soon as Wompi confirms the payment. وبالنسبة إلى طلب في الانتظار تعرض We have received your Wompi payment and are reviewing it. We will contact you if anything is needed. وإذا رُفض الدفع المعلّق لاحقًا تعرض الصفحة Your Wompi payment was not approved. Please contact us. وإذا أُلغي تعرض Your Wompi payment was voided and this order was cancelled. Please contact us.

إذا لم تؤكد Wompi المعاملة بعد عندما يعود العميل، تعرض صفحة We are waiting for Wompi to confirm your payment. You will receive an e-mail as soon as it is confirmed. مع الزرين Check again وBack to checkout. ويضبط حدث Wompi حالة الطلب فور وصوله.

إذا رُفض الدفع، يبقى الطلب بلا حالة وتُحفظ السلة. يعود العميل إلى صفحة الدفع مع Your Wompi payment was not approved (...). You can try again or choose another payment method. والسبب الذي تذكره Wompi. ويعرض الدفع الملغى Your Wompi payment was voided. You can try again or choose another payment method. وإذا غادر العميل Web Checkout دون أن يدفع، تكون الرسالة Your Wompi payment was not completed. You can try again or choose another payment method. ويحصل كل محاولة جديدة على رقم مرجعي جديد. ينشئ OpenCart طلبًا جديدًا في كل مرة تُعرض فيها خطوة Confirm Order، لكن السلة الواحدة تُدفع مرة واحدة فقط: فإذا دُفع أحد طلبات السلة أو كان ينتظر الدفع أو كان في الانتظار، يُوجَّه العميل إلى صفحة النجاح بدلًا من الدفع مرة أخرى.

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

تظهر وسيلة الدفع فقط عندما يكون الترخيص نشطًا، وتكون المفاتيح الأربعة للوضع الحالي معبأة، ويدفع العميل بعملة COP، ويكون الإجمالي 1,500 COP على الأقل. إذا تعذّر بدء الدفع، يبقى العميل في خطوة Confirm Order مع رسالة قصيرة فوق الزر:

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

لا تُجري الإضافة عمليات استرداد من OpenCart. لا توجد بطاقات محفوظة أو اشتراكات أو حقول بطاقات في موقعك: تُدخل جميع بيانات الدفع في Wompi.

الطلبات

حالات الطلب

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

Awaiting Payment Status (الافتراضي Pending): تُبلّغ Wompi عن المعاملة بأنها معلّقة، مثل مدفوعات PSE وNequi أو المدفوعات النقدية التي تنتظر التأكيد. ينتظر الطلب حتى توافق Wompi عليه أو ترفضه. وعند الموافقة ينتقل إلى Order Status After Payment.

Order Status After Payment (الافتراضي Processing): وُافق على المعاملة بمبلغ الطلب بالعملة COP. تعرض ملاحظة المعاملة ونوع وسيلة الدفع (مثل CARD أو PSE أو NEQUI) والمرجع والمبلغ والبيئة.

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

Failed Payment Status (الافتراضي Failed): رُفضت المعاملة المعلّقة لأحدث محاولة دفع أو انتهت بخطأ. تُضاف رسالة Wompi إلى الملاحظة. ولا تغيّر نتائج المحاولات الأقدم الطلب.

Cancelled Order Status (الافتراضي Canceled): أُلغيت المعاملة المعلّقة لأحدث محاولة دفع في Wompi.

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

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

تبويب VibeFox Wompi Payment

في Sales > Orders افتح طلبًا مدفوعًا عبر Wompi. في أسفل صفحة الطلب، بجانب History وAdditional، يعرض تبويب VibeFox Wompi Payment الحقول Reference وTransaction ID وStatus (مع حالة Wompi) وRequested وTransaction amount وPayment method وWompi message، وعلامة SANDBOX للمدفوعات التجريبية، وPayment attempts للسلة عند وجود أكثر من محاولة، وWompi notes الخاصة بالطلب. يظهر التبويب للمستخدمين الذين لديهم صلاحية الوصول إلى الإضافة.

الاستردادات

لا تُرسل الاستردادات من OpenCart. استرد الدفعة أو ألغها في لوحة تاجر Wompi، ثم سجّل الاسترداد يدويًا في OpenCart. يُضاف إلغاء معاملة الدفع الذي تم في Wompi إلى الطلب كملاحظة. ولا تعيد مرتجعات المنتجات في Sales > Returns الأموال عبر Wompi.

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

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

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

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

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

لا تظهر Wompi عند الدفع: تحقق من أن الترخيص نشط، وأن Enable/Disable مُفعّل، وأن المفاتيح الأربعة للوضع الحالي معبأة (يسرد مربع الحالة في صفحة الإعدادات المفاتيح الناقصة). تحقق أيضًا من أن العميل يدفع بعملة COP، وأن الإجمالي 1,500 COP على الأقل. وتحقق من أن عنوان الدفع ضمن Geo Zone المختارة، وأن الطلب يبلغ Total المحدد في الإعدادات.

تمت عملية الدفع لكن الطلب بقي بلا حالة: لا يعمل Events URL. في لوحة Wompi تحقق من أن Events URL مضبوط للبيئة التي تستخدمها (sandbox أو الإنتاج)، وأنه مطابق تمامًا للرابط المعروض في الإعدادات. وتحقق من أن سر الأحداث لتلك البيئة موجود في القسم المناسب. كما سيحصل الطلب على حالته عندما يعود العميل إلى المتجر بعد الدفع.

Events URL answers Not configured: سر الأحداث لبيئة الحدث فارغ. الصقه في الإعدادات.

Events URL answers Invalid signature: سر الأحداث يعود إلى بيئة أخرى أو حساب آخر. انسخه مرة أخرى من لوحة Wompi.

Events URL answers Transaction lookup failed: لم تُرجع واجهة Wompi البرمجية المعاملة، مثلًا بسبب مفتاح خاص خاطئ أو مشكلة في الشبكة. ستعيد Wompi إرسال الحدث لاحقًا.

Events URL answers Retry: كان الطلب يُؤكَّد في الوقت نفسه بطلب آخر، أو تعذّر ضبط حالة الطلب. ستعيد Wompi إرسال الحدث لاحقًا. انظر حقل Log لمعرفة السبب.

Events URL answers Environment mismatch: وصلت معاملة sandbox لمحاولة دفع إنتاجية، أو العكس. لا تؤكد مدفوعات sandbox طلبات الإنتاج أبدًا.

Events URL answers Unknown reference: يبدو المرجع الخاص بالمعاملة مرجعًا لهذا المتجر، لكنه لم يُصدر هنا أبدًا، مثلًا من متجر OpenCart آخر على الحساب نفسه في Wompi. تتلقى المراجع الخاصة بأنظمة أخرى الرد Ignored: not an OpenCart reference.

The Events URL shows Method not allowed in the browser: هذا طبيعي. يقبل الرابط الطلبات الصادرة من Wompi فقط.

The key does not start with ... warning on save: لُصق مفتاح في القسم الخطأ. تبدأ مفاتيح sandbox بـ pub_test_ وprv_test_ وtest_events_ وtest_integrity_، وتبدأ مفاتيح الإنتاج بـ pub_prod_ وprv_prod_ وprod_events_ وprod_integrity_.

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

Other errors: انظر حقل Log في صفحة الإضافة وWompi notes الخاصة بالطلب. تُسجَّل الأخطاء دائمًا. فعّل Debug log لمزيد من التفاصيل.

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

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

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

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