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

المتطلبات

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

PHP: 8.0 أو أحدث.

العملة: البيso التشيلي (CLP)، أو البيso الأرجنتيني (ARS)، أو السول البيروفي (PEN). يجب أن تكون العملة موجودة في System > Localisation > Currencies. لا يُعرض Khipu إلا عندما يدفع العميل بإحدى هذه العملات؛ وبالنسبة للعملات الأخرى تُخفى طريقة الدفع عند إتمام الشراء.

حساب Khipu: تحتاج إلى Receiver ID ("Id de cobrador")، و API key، و secret key لحساب التحصيل الخاص بك في Khipu. تجدها في حسابك في Khipu ضمن الملف الشخصي للتاجر (khipu.com/merchant/profile). الثلاثة مطلوبة: من دونها لا يُعرض Khipu عند إتمام الشراء، ومن دون secret key لا يمكن تأكيد أي دفعة. ولا يلزم إعداد أي شيء في حساب Khipu.

متجر قابل للوصول: يؤكد Khipu الدفعات باستدعاء متجرك، لذلك يجب أن يكون عنوان الإشعارات متاحًا من الإنترنت، دون حماية بكلمة مرور ودون جدار حماية يحجب Khipu. ولا يحجب وضع الصيانة في المتجر هذا الوصول.

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

التثبيت

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

OpenCart 3

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

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

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

4. أدخل Receiver ID وAPI key وSecret key لحساب التحصيل الخاص بك في Khipu (انظر Configuration).

5. فعّل Enable / Disable واضغط Save. للاختبار أولًا، استخدم مفاتيح حساب مطوّر في Khipu، ثم استبدلها بمفاتيح حسابك الإنتاجي.

OpenCart 4

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

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

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

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

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

الإعدادات

توجد جميع الإعدادات في صفحة الإضافة: Extensions > Extensions > Payments > VibeFox Khipu Gateway > Edit. تُعرض الأقسام على اليسار؛ وزر Save أسفل القائمة يحفظ الصفحة كاملة. وفوق الإعدادات تحذّرك الصفحة عندما يكون Receiver ID أو API key أو secret key مفقودًا (عندها لا يُعرض Khipu عند إتمام الشراء)، وعندما لا تكون العملة الافتراضية للمتجر مدعومة من Khipu (عندها لا يُعرض Khipu إلا عندما يدفع العميل بعملة CLP أو ARS أو PEN). وإذا لم تكن لديك صلاحية تعديل الإضافة، تعرض الصفحة الإعدادات لكنها لا تستطيع حفظها.

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

Khipu

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

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

Description: النص الذي يظهر للعميل في خطوة Confirm Order، فوق زر التأكيد. الافتراضي: ادفع عبر التحويل البنكي باستخدام Khipu.

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

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

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

حساب Khipu

انسخ Receiver ID و API key و secret key من حساب التحصيل الخاص بك في Khipu (يرتبط القسم بـ khipu.com/merchant/profile). ليس لدى Khipu خادم sandbox منفصل، ولا يوجد في الإضافة مفتاح لوضع الاختبار. للاختبار، استخدم مفاتيح حساب تحصيل للمطوّر ("desarrollo"): يدفع هذا الحساب عبر بنك الاختبار DemoBank، ولا تُنقل أي أموال حقيقية. انتقل إلى مفاتيح حساب التحصيل الإنتاجي عند الانتقال إلى البيع الفعلي.

Receiver ID: معرّف المستلم ("cobrador") الخاص بك في Khipu. تُرفض المدفوعات المرسلة إلى حسابات Khipu أخرى.

API key: تُستخدم لإنشاء المدفوعات والتحقق من كل دفعة لدى Khipu.

Secret key: تُستخدم للتحقق من توقيع (HMAC-SHA256) إشعارات الدفع من Khipu. من دونها لا يمكن تأكيد أي دفعة.

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

إشعارات الدفع

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

يجب أن يحمل كل إشعار توقيعًا صالحًا أُنشئ باستخدام Secret key لديك. تُرفض الإشعارات التي لا تحمل توقيعًا صالحًا. ولا تثق الإضافة أبدًا في محتوى الإشعار: بل تطلب من Khipu حالة الدفع وتتصرف وفق ما يبلغه Khipu:

Status after payment: الحالة التي يحصل عليها الطلب عندما يؤكد Khipu الدفع. تُضبط الحالة فورًا، في تغيير حالة واحد.

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

Paid Order Status: الحالة بعد دفعة مؤكدة عندما تكون Status after payment هي Processing. الافتراضي: قيد المعالجة.

Complete Order Status: الحالة بعد دفعة مؤكدة عندما تكون Status after payment هي Completed. الافتراضي: مكتمل.

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

متقدم

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

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

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

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

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

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

إتمام الشراء

في خطوة Payment Method يختار العميل طريقة الدفع (افتراضيًا Khipu). وفي خطوة Confirm Order يرى العميل وصفك فوق زر التأكيد. ينشئ OpenCart الطلب في هذه الخطوة، ما يزال دون حالة. عندما يضغط العميل Confirm Order، تنشئ الإضافة دفعة Khipu بإجمالي الطلب بعملة الطلب، وترسل العميل إلى صفحة الدفع في Khipu. تظهر الدفعة في Khipu باسم Order # مع رقم الطلب واسم المتجر، مع قائمة المنتجات. يُمرَّر البريد الإلكتروني للعميل إلى Khipu عندما يكون صالحًا. وفي صفحة Khipu يدفع العميل بتحويل بنكي من بنكه.

في OpenCart 4 يختار العميل طريقة الدفع بزر Choose في كتلة طريقة الدفع، داخل النافذة Payment method options، وينقر على Confirm Order أسفل صفحة الدفع.

بعد الدفع يعود العميل إلى متجرك. لا يُعلَّم الطلب كمدفوع إلا بعد أن يؤكده Khipu: بالإشعار الموقّع، أو بطلب حالة يُرسل إلى Khipu عندما يعود العميل. ولا تعني العودة نفسها أي شيء كمدفوع. ثم يحصل الطلب على حالته بالطريقة المعيارية في OpenCart، مع رسائل البريد المعتادة وتحديث المخزون، ويرى العميل صفحة نجاح الطلب في OpenCart. وإذا كان البنك ما زال يتحقق من التحويل، أو تعذّر الوصول إلى Khipu، تعرض صفحة Payment confirmation الرسالة Khipu is confirming your bank transfer. Your order will be confirmed automatically as soon as Khipu confirms the payment, and you will receive an e-mail. مع الزرين Check again وBack to checkout. وإذا تعذّر مطابقة آخر دفعة Khipu للطلب معه (مثلًا لأنها تخص Receiver ID آخر)، يعود العميل إلى صفحة الشراء مع الرسالة We could not match this payment to an order. If you paid, please contact us.

إذا ألغى العميل في صفحة Khipu، أو لم تكتمل الدفعة، يعود العميل إلى صفحة الشراء مع الرسالة The Khipu payment was not completed. You can try again or choose another payment method. وتُحفظ السلة. في OpenCart 4 تظهر هذه الرسائل أعلى صفحة الدفع. وكل محاولة جديدة (ينشئ OpenCart 3 طلبًا جديدًا في كل مرة تُعرض فيها خطوة Confirm Order، أما OpenCart 4 فيُحدِّث طلب الدفع الحالي ويدفعه بدفعة Khipu جديدة) تحذف دفعة Khipu السابقة غير المدفوعة للطلب أو السلة، بحيث لم يعد الرابط القديم قابلًا للدفع. وإذا كان Khipu قد استلم الدفعة السابقة بالفعل، فإنها تُطبَّق ويذهب العميل إلى صفحة النجاح دون دفعة جديدة. وإذا كان البنك ما يزال يتحقق من التحويل السابق، يرى العميل Your previous Khipu payment for this order is still being verified by the bank. Please wait a few minutes before paying again. وإذا كانت الدفعة السابقة قيد المراجعة، يُطلب من العميل التواصل مع المتجر قبل الدفع مرة أخرى. وتغيير السلة، بما في ذلك الكمية الجديدة، يُحسب سلة جديدة تحتاج إلى دفعها الخاص.

في OpenCart 4 يبقى الطلب في صفحة الدفع إلى أن تظهر صفحة النجاح. وإذا أُغلق هذا الطلب دون دفع في الأثناء (مثلًا ألغيته)، يُعاد العميل إلى صفحة الدفع مع الرسالة Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. وإذا كان الطلب قد تم تقديمه بالفعل وتغيّرت السلة منذ ذلك، فالرسالة هي Your previous order has already been placed. Your cart has changed since — please confirm the order again to pay for the current cart with a new order. وفي الحالتين، يدفع Confirm Order التالي طلبًا جديدًا للسلة.

إذا تعذّر على Khipu إنشاء الدفعة، يبقى العميل في خطوة Confirm Order مع رسالة قصيرة فوق الزر، مثل Khipu could not create the payment for this order. Please check your billing details and try again, or contact the store. أو Khipu is temporarily unavailable. Please try again in a few minutes. وتُكتب التفاصيل في السجل.

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

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

الطلبات

حالات الطلب

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

Paid Order Status أو Complete Order Status (الافتراضي قيد المعالجة أو مكتمل): أكد Khipu الدفع. تتبع الحالة Status after payment. تعرض ملاحظة Khipu payment verified. Payment ID: مع معرّف الدفع والمبلغ.

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

إذا وصلت دفعة لطلب مدفوع بالفعل، أو لطلب آخر من سلة مدفوعة بالفعل، فلا يتغير الطلب. وتطلب ملاحظة منك استرداد المبلغ للعميل إذا كانت هذه دفعة ثانية. وإذا أبلغ Khipu عن دفعة مدفوعة بأنها أُلغيت، يحصل الطلب على ملاحظة ولا تتغير حالته.

الملاحظات هي إدخالات في History الطلب لا يراها العميل. وتبدأ بكلمة Khipu.

تبويب VibeFox Khipu Gateway

في Sales > Orders افتح طلبًا دُفع عبر Khipu. في أسفل صفحة الطلب، بجانب History وAdditional، يعرض تبويب VibeFox Khipu Gateway محاولات الدفع عبر Khipu الخاصة بالطلب (التاريخ، المبلغ، معرّف دفعة Khipu، حالة Khipu والنتيجة)، وتحذيرًا Manual review ما دام الطلب في حالة المراجعة، وKhipu notes الخاصة بالطلب. التبويب للقراءة فقط، ويُعرض للمستخدمين الذين لديهم صلاحية الوصول إلى الإضافة.

المبالغ المستردة

لا تُرسل المبالغ المستردة من OpenCart إلى Khipu، لأن Khipu لا يقدّم استرداد مبالغ عبر واجهة API الخاصة به. ويوضح التبويب ذلك. استرد المبلغ للعميل من حسابك لدى Khipu أو عبر تحويل بنكي، ثم غيّر حالة الطلب يدويًا في OpenCart.

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

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

من دون مفتاح فعّال لا يُعرض Khipu للعملاء عند إتمام الشراء. وإذا بدأ الدفع رغم ذلك، يرى العميل 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. ويؤدي إلغاء تثبيت الإضافة دائمًا إلى إزالة مفتاح الترخيص وحالة الترخيص.

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

لا يظهر Khipu عند إتمام الشراء: تحقق من أن الترخيص فعّال، وأن Enable / Disable مفعّل، وأن Receiver ID وAPI key وSecret key مُدخلة كلها. يجب أن يدفع العميل بعملة CLP أو ARS أو PEN. تعرض صفحة الإعدادات تحذيرًا عندما يكون شيء ما مفقودًا. وتحقق أيضًا من أن عنوان الدفع يقع ضمن Geo Zone المحددة، وأن الطلب يبلغ Total المضبوط في الإعدادات.

تمّت عملية الدفع لكن الطلب يبقى بلا حالة: يؤكد Khipu التحويل بعد أن يتحقق منه البنك. يحصل الطلب على حالته عندما يصل إشعار Khipu أو عندما يضغط العميل Check again. تحقق من أن متجرك متاح من الإنترنت على العنوان المعروض في Notification URL (دون حماية بكلمة مرور أو جدار حماية يحجب Khipu)، وانظر إلى الحقل Log في صفحة الإضافة.

يرد الإشعار بـ Secret key not configured: الحقل Secret key فارغ. أدخله. يعيد Khipu إرسال الإشعار.

يرد الإشعار بـ Invalid signature أو Missing signature أو Malformed signature: الـ Secret key لا يخص حساب التحصيل الذي تستخدم مفاتيحه، أو أن الطلب لم يأتِ من Khipu.

يرد الإشعار بـ Order not found أو Payment not found for this account أو Payment does not belong to this order: دُفعت الدفعة إلى Receiver ID آخر، أو بمفاتيح أخرى، أو لطلب آخر. تحقق من Receiver ID والمفاتيح.

يرد الإشعار بـ Payment not final yet أو Verification unavailable: ما يزال التحويل قيد التحقق، أو تعذّر الوصول إلى Khipu. يعيد Khipu إرسال الإشعار.

يرد الإشعار بـ Busy, retry later أو Order could not be updated, retry later: كان الطلب يُؤكَّد بطلب آخر في الوقت نفسه، أو تعذّر ضبط حالة الطلب. يعيد Khipu إرسال الإشعار. والسبب موجود في السجل.

الطلب في حالة المراجعة بعد الدفع: اقرأ الملاحظات في تبويب VibeFox Khipu Gateway. لم يتطابق المبلغ أو العملة مع الطلب، أو وصلت الدفعة بعد إلغاء الطلب.

يرى العميل "Khipu payments are not available right now": API key مفقود أو خاطئ. تحقق من المفاتيح في حسابك لدى Khipu.

للمطوّرين: تُطلق الإضافة أحداث OpenCart wc_khp_supported_currencies (لإضافة عملة يقبلها حساب Khipu لديك، مثل EUR لـ Khipu إسبانيا)، وwc_khp_currency_decimals، وwc_khp_payment_data.

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

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

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

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