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

المتطلبات

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

PHP: الإصدار 8.0 أو أحدث.

العملة: يجب تفعيل السول البيروفي (PEN) أو الدولار الأمريكي (USD) في System > Localisation > Currencies. تُعرض طريقة الدفع فقط عندما يدفع العميل بإحدى هاتين العملتين. وبالنسبة إلى العملات الأخرى، تكون مخفية في صفحة الدفع.

حساب Niubiz: تصدر Niubiz معرّف التاجر (código de comercio) ومستخدم API وكلمة مرور API لكل بيئة. تأتي بيانات الاعتماد الخاصة بالبيئة التجريبية (sandbox) من فريق التكامل لدى Niubiz، أما بيانات الاعتماد الخاصة بالإنتاج فتأتي بعد أن تعتمد Niubiz تكاملك. لا حاجة لإعداد أي webhook: تردّ Niubiz على التفويض فورًا.

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

التثبيت

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

OpenCart 3

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

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

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

4. أبقِ Sandbox mode مفعّلًا، وأدخل معرّف التاجر ومستخدم API وكلمة مرور API الخاصة بالبيئة التجريبية (انظر Configuration).

5. فعّل Enable/Disable، وانقر على Save، ثم أجرِ بعض المدفوعات التجريبية باستخدام بطاقات الاختبار الخاصة بـ Niubiz.

6. بعد أن تعتمد Niubiz تكاملك، أدخل بيانات الاعتماد الخاصة بالإنتاج، ثم أوقف تفعيل Sandbox mode.

OpenCart 4

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

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

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

4. أدخل مفتاح الترخيص وبيانات اعتماد Niubiz، واختبر المدفوعات كما في الخطوات من 3 إلى 6 لـ OpenCart 3. صفحة الإعدادات وحقولها متطابقة في الإصدارين.

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

الإعدادات

توجد جميع الإعدادات في صفحة الإضافة: Extensions > Extensions > Payments > VibeFox Niubiz Payment > Edit. تظهر الأقسام في القائمة على اليسار؛ ويحفظ زر Save الموجود أسفل القائمة الصفحة بأكملها. وفوق الإعدادات، تنبهك الصفحة إذا لم تكن عملة PEN أو USD مفعّلة في المتجر، أو إذا كانت بيانات الاعتماد الخاصة بالوضع الحالي غير مكتملة (وفي كلتا الحالتين تُخفى طريقة الدفع في صفحة الدفع). وإذا لم تكن العملة الافتراضية للمتجر هي PEN أو USD، فإن الصفحة توضح أن Niubiz تُعرض فقط عندما يدفع العميل بعملة PEN أو USD. وطالما أن وضع البيئة التجريبية مفعّل، تعرض الصفحة الرسالة Sandbox mode is on: payments go to the Niubiz sandbox and no real charges are made. وبدون صلاحية تعديل الإضافة، تعرض الصفحة الإعدادات لكنها لا تستطيع حفظها.

عند الحفظ، لا تُحفظ القيمة الخاطئة: تظهر رسالة خطأ فوق الإعدادات، ويعود الحقل إلى قيمته السابقة، وتُحفظ الحقول الأخرى. ينطبق ذلك على Title الفارغ أو الذي يتجاوز 128 حرفًا، ومعرّف التاجر الذي لا يتكون من أرقام فقط، ورابط الشعار (Logo URL) الذي لا يبدأ بـ https://، وSort Order الذي ليس عددًا صحيحًا، وTotal الذي ليس رقمًا يساوي 0 أو أكبر.

Niubiz

Enable/Disable: يفعّل مدفوعات Niubiz أو يوقفها. الافتراضي: off.

Title: اسم طريقة الدفع الذي يراه العميل في صفحة الدفع. وهو أيضًا اسم طريقة الدفع المحفوظ في الطلب. الافتراضي: Credit or debit card (Niubiz). حقل مطلوب، بحد أقصى 128 حرفًا.

Description: النص الذي يُعرض للعميل في خطوة Confirm Order، فوق زر التأكيد. الافتراضي: Pay securely with Visa, Mastercard, American Express or Diners Club in the Niubiz payment form.

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

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

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

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

تمنحك Niubiz معرّف تاجر ومستخدم API وكلمة مرور API للبيئة التجريبية (QA)، وبعد الاعتماد، للإنتاج. وتُعتمد أي دفعة بدأت بالفعل دائمًا ببيانات اعتماد وضعها الخاص.

Sandbox mode: يستخدم البيئة التجريبية لـ Niubiz، دون أي خصومات حقيقية. ويبدّل كلًا من نقاط نهاية API ومجموعة بيانات الاعتماد الواردة أدناه. الافتراضي: on. أوقفه لقبول مدفوعات حقيقية ببيانات اعتماد الإنتاج. وطالما هو مفعّل، يرى العملاء الرسالة SANDBOX MODE: use Niubiz test cards — no real charges are made. في خطوة Confirm Order وفي صفحة الدفع.

Sandbox merchant ID: رمز التاجر (código de comercio) الخاص بحسابك في البيئة التجريبية، أرقام فقط. تُحذف المسافات.

Sandbox API user: مستخدم API للبيئة التجريبية، وغالبًا ما يكون عنوان بريد إلكتروني.

Sandbox API password: كلمة مرور API للبيئة التجريبية.

Production merchant ID: رمز التاجر الخاص بحسابك الإنتاجي (التابع)، أرقام فقط.

Production API user: مستخدم API الخاص بالإنتاج.

Production API password: كلمة مرور API الخاصة بالإنتاج.

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

نموذج الدفع

Logo URL: عنوان اختياري لشعارك يُعرض في نموذج الدفع الخاص بـ Niubiz. يجب أن يكون عنوان https://. اتركه فارغًا لعرض اسم المتجر.

الطلبات

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

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

On Hold Status: وافقت Niubiz على دفعة لا تطابق الطلب، أو لم تعطِ ردًا حاسمًا، لذلك ربما خُصمت قيمة البطاقة. الافتراضي: Pending، لأن OpenCart لا يملك حالة On hold. يمكنك إنشاء حالتك الخاصة في System > Localisation > Order Statuses واختيارها هنا.

متقدم

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

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

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

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

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

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

صفحة الدفع

في خطوة Payment Method، يختار العميل طريقة الدفع (افتراضيًا Credit or debit card (Niubiz)). وفي خطوة Confirm Order، يرى العميل وصفك والملاحظة You will complete the payment in the secure Niubiz payment form. ينشئ OpenCart الطلب في هذه الخطوة، ولا يزال دون حالة. وفي OpenCart 4 يختار العميل طريقة الدفع بزر Choose الموجود في كتلة طريقة الدفع، في النافذة Payment method options، وينقر على Confirm Order في أسفل صفحة الدفع. وعندما ينقر العميل على Confirm Order، تطلب الإضافة من Niubiz رمز وصول وجلسة دفع بمجموع الطلب بعملة الطلب، ثم تفتح صفحة Niubiz payment في متجرك. وإذا تعذر إنشاء الجلسة، يبقى العميل في خطوة Confirm Order مع رسالة قصيرة، مثل We could not connect to Niubiz. Please try again in a few minutes.

في صفحة الدفع، يُفتح نموذج الدفع الخاص بـ Niubiz تلقائيًا. وتقول الصفحة Complete the payment in the secure Niubiz payment form — your card details are entered on Niubiz, not on this site. وتحتوي أيضًا على زر Pay يعرض مجموع الطلب لإعادة فتح النموذج، ورابط Choose another payment method للعودة إلى صفحة الدفع. ويلزم تفعيل JavaScript. وإذا تعذر تحميل نموذج Niubiz، تعرض الصفحة The Niubiz payment form could not be loaded. Please reload the page or try again later.

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

رفض البطاقة: يبقى الطلب دون حالة وتُضاف إليه ملاحظة. يعود العميل إلى صفحة الدفع مع Your payment was declined: والسبب الذي تذكره Niubiz، ويمكنه المحاولة مجددًا بالبطاقة نفسها أو ببطاقة أخرى. لا يُعاد فتح النموذج فوق الرسالة؛ إذ ينقر العميل على Pay.

لا رد من Niubiz: إذا لم تعطِ Niubiz ردًا حاسمًا (انتهاء المهلة، خطأ في الخادم، رد غير قابل للقراءة)، يحصل الطلب على On Hold Status، وتعرض صفحة النجاح We could not confirm your payment with Niubiz. Please do not pay again — the store will verify the payment and contact you. وإذا وافقت Niubiz على دفعة لا تطابق الطلب، تعرض صفحة النجاح Your payment was received and is being reviewed by the store. We will contact you if anything else is needed.

رفض الطلب: إذا رفضت Niubiz الطلب نفسه (مثلًا بيانات اعتماد غير صالحة أو رقم شراء مكرر)، يبقى الطلب دون حالة وتُضاف ملاحظة، ويرى العميل Niubiz could not process the payment and your card was not charged. وإذا تعذر الوصول إلى API الخاص بـ Niubiz في تلك اللحظة، يرى العميل We could not connect to Niubiz and your card was not charged. Please try again in a few minutes.

تغيّر الطلب: إذا لم يعد مجموع الطلب مطابقًا للجلسة عند إرسال النموذج، فلا يُعتمد الدفع، ويرى العميل Your order total has changed since the payment form was opened, so your card was not charged. Please check the total and pay again.

انتهاء الجلسة: تستمر جلسة الدفع الخاصة بـ Niubiz حتى 20 دقيقة. وعندما تكون الجلسة قد استُخدمت، أو بقي لها أقل من 5 دقائق، أو تنتمي إلى وضع آخر أو معرّف تاجر آخر، أو تغيّر مجموع الطلب، تنشئ صفحة الدفع جلسة جديدة.

تحصل كل محاولة دفع على رقم شراء جديد: رقم الطلب يتبعه رقم محاولة من ثلاثة أرقام، لأن Niubiz تشترط رقم شراء فريدًا لكل تفويض. وينشئ OpenCart 3 طلبًا جديدًا في كل مرة تُعرض فيها خطوة Confirm Order. ويحتفظ OpenCart 4 بطلب واحد للدفع ويحدّثه، فيدفع العميل بعد رفض البطاقة الطلبَ نفسه برقم شراء جديد، لكن السلة التي دُفعت بالفعل لا تُدفع مرة أخرى: بل يُنقل العميل إلى صفحة نجاح الطلب المدفوع.

يحتفظ OpenCart 4 بالطلب في الدفع حتى تُعرض صفحة النجاح. وإذا أُغلق ذلك الطلب دون دفع في الأثناء (مثلًا إذا ألغيته)، يُعاد العميل إلى صفحة الدفع مع الرسالة Your previous order was cancelled or its payment failed. Please confirm the order again.، وعند النقر التالي على Confirm Order يُدفع طلب جديد. وإذا كان لذلك الطلب حالة بالفعل، وصارت السلة تحتوي الآن على منتجات أو كميات أخرى، فالرسالة هي Your previous order has already been placed for other cart contents. Please confirm the order of your current cart again. وفي OpenCart 4 تظهر فوق صفحة الدفع الرسائل التي تعيد العميل إليها، مثل The Niubiz payment could not be found. Please confirm your order again.

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

لا تقبل الإضافة إلا المدفوعات الفردية بالبطاقة. ولا تتيح استردادات أو إلغاءات من OpenCart، ولا بطاقات محفوظة، ولا اشتراكات أو مدفوعات متكررة، ولا خيار التقسيط (cuotas)، ولا PagoEfectivo أو Yape أو غيرهما من المحافظ الإلكترونية والمدفوعات بـ QR. ولا تُعاد مراجعة الطلبات المعلّقة بسبب ضياع الرد تلقائيًا.

الطلبات

حالات الطلب

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

على OpenCart 4 يمكن أن يحصل طلب غير مدفوع في خطوة الدفع على الحالة Voided، التي يضبطها OpenCart 4 عندما يعود العميل إلى خطوة Confirm Order. تعامل الإضافة هذا الطلب كطلب بدون حالة، ويؤكده أي دفع لاحق.

Order Status After Payment (الافتراضي Processing): وافقت Niubiz على الدفعة، وطابق الرد الطلب. تعرض الملاحظة البيئة ومعرّف المعاملة ورمز التفويض ورقم الشراء وعلامة البطاقة مع رقم البطاقة المُخفى.

On Hold Status (الافتراضي Pending)، موافَق عليه لكنه غير مطابق: وافقت Niubiz على دفعة يختلف رقم شرائها أو مبلغها أو عملتها عن الطلب، أو لا يتضمن ردها المبلغ أو العملة. لا يُعلَّم الطلب كمدفوع. وتسرد الملاحظة الفروق. راجع المعاملة في لوحة Niubiz.

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

إذا وصل رد على دفعة ثانية لسلة مدفوعة بالفعل، فلا تُضبط حالة ثانية. وتعرض ملاحظة على الطلب المدفوع رقم الشراء ومعرّف المعاملة والمبلغ، لتتمكن من مراجعتها في لوحة Niubiz واسترداد المبلغ أو إلغاء المعاملة عند الحاجة.

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

تبويب VibeFox Niubiz Payment

في Sales > Orders، افتح طلبًا دُفع عبر Niubiz. في أسفل صفحة الطلب، بجوار History وAdditional، يعرض تبويب VibeFox Niubiz Payment رقم الشراء والبيئة (تجريبية أو إنتاج) وNiubiz answer ومعرّف المعاملة ورمز التفويض والبطاقة والمبلغ (والمبلغ الذي وافقت عليه Niubiz) والمشكلات المكتشفة وعدد المحاولات وNiubiz notes الخاصة بالطلب. وبالنسبة إلى طلب في حالة الانتظار، يذكّرك التبويب بالتحقق من رقم الشراء في لوحة Niubiz. والتبويب للقراءة فقط، ويظهر للمستخدمين الذين لديهم صلاحية الوصول إلى الإضافة.

الاستردادات

لا تتوفر الاستردادات والإلغاءات من OpenCart. استرد المعاملة أو ألغِها في لوحة Niubiz، ثم حدّث حالة الطلب يدويًا. ولا تعيد المرتجعات في Sales > Returns الأموال عبر Niubiz.

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

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

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

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

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

لا يظهر Niubiz في صفحة الدفع: تحقق من أن الترخيص نشط، وأن Enable/Disable مفعّل، وأن معرّف التاجر ومستخدم API وكلمة مرور API الخاصة بالوضع الحالي مملوءة (حقول البيئة التجريبية في الوضع التجريبي، وحقول الإنتاج في الحالات الأخرى)، وأن العميل يدفع بعملة PEN أو USD. وتعرض صفحة الإعدادات تحذيرًا عندما تكون بيانات الاعتماد أو العملات غير صحيحة. وتحقق أيضًا من أن عنوان الدفع ضمن Geo Zone المختارة، وأن الطلب يبلغ Total المحدد في الإعدادات.

تمت عملية الدفع لكن الطلب يبقى دون حالة: ليس لدى Niubiz webhook لنموذج الدفع هذا، لذلك لا يحصل الطلب على حالته إلا من رد التفويض. فإذا لم ينهِ العميل النموذج، فلم يُدفع أي مبلغ. وإلا فراجع الحقل Log في صفحة الإضافة، وابحث عن رقم الشراء في لوحة Niubiz. وإذا ردّت Niubiz لكن تعذّر ضبط الحالة، يرى العميل Your payment was received, but the order could not be completed automatically. Please contact us — do not pay again. وتعيد الإضافة محاولة ضبط الحالة عندما يفتح العميل صفحة الدفع أو يؤكد السلة مرة أخرى.

يرى العميل الرسالة We could not connect to Niubiz: تعذّر الحصول على رمز الوصول. تحقق من مستخدم API وكلمة مرور API للوضع الحالي، ومن قدرة خادمك على الوصول إلى API الخاص بـ Niubiz. فعّل Debug log للحصول على التفاصيل.

يرى العميل الرسالة We could not start the Niubiz payment: لم تُنشئ Niubiz جلسة الدفع. تحقق من معرّف التاجر للوضع الحالي ومن السجل.

يرى العميل الرسالة This payment attempt was already processed: أُرسل النموذج نفسه مرتين. يبدأ العميل الدفع من جديد في صفحة الدفع؛ ولا تُخصم البطاقة مرتين.

يرى العميل الرسالة This order is already being paid: يقوم طلب آخر حاليًا باعتماد السلة نفسها. ينتظر العميل لحظة ويراجع بريده الإلكتروني قبل المحاولة مجددًا.

تقول ملاحظة إن Niubiz أبلغت عن تفويض مكرر: تعرف Niubiz رقم الشراء هذا مسبقًا. تحقق منه في لوحة Niubiz؛ ويمكن للعميل إعادة المحاولة برقم شراء جديد.

الطلب في حالة الانتظار (On Hold): اقرأ الملاحظات في تبويب VibeFox Niubiz Payment. لم تعطِ Niubiz ردًا حاسمًا، أو وافقت على دفعة لا تطابق الطلب. ابحث عن رقم الشراء في لوحة Niubiz، ثم اضبط الطلب على حالة مدفوع أو ألغِه.

خطأ عند حفظ الإعدادات: يجب أن يحتوي معرّف التاجر على أرقام فقط، ويجب أن يكون رابط الشعار عنوان https:// صالحًا، ويجب ألا يكون العنوان فارغًا أو أطول من 128 حرفًا. ويُحتفظ بالقيمة السابقة.

للمطوّرين: إذا طلبت Niubiz إرسال حقول مكافحة الاحتيال الخاصة بالتاجر (MDD)، فيمكن لإضافة أخرى إضافتها عبر الحدث niubiz_p_merchant_define_data في OpenCart. ويمكن تعديل بيانات حامل البطاقة المرسلة مع جلسة الدفع عبر الحدث niubiz_p_cardholder_data.

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

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

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

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