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

المتطلبات

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

PHP: ‏8.0 أو أحدث.

متجر Barion: تحتاج إلى POSKey (المفتاح السري) لمتجرك وإلى عنوان البريد الإلكتروني لمحفظة Barion التي تستلم المدفوعات. يوجد الاثنان في بوابة Barion: ‏secure.barion.com للوضع الفعلي، و‏secure.test.barion.com للاختبار، ضمن My stores ومتجرك. بيانات الاعتماد للاختبار والوضع الفعلي مختلفة.

العملة: يجب أن تكون عملة الطلب HUF أو EUR أو USD أو CZK. بالنسبة إلى العملات الأخرى تُخفى طريقة الدفع عند الدفع.

متجر قابل للوصول: تستدعي Barion متجرك بعد كل دفعة، لذلك يجب أن يكون الموقع متاحًا من الإنترنت دون جدار حماية أو مصادقة أساسية أمامه. لا يمنع وضع الصيانة استدعاء الرد: يسمح OpenCart 3 بمرور طلبات إضافات الدفع، وفي OpenCart 4 تضيف الإضافة إجراء بدء تشغيل لذلك.

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

التثبيت

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

OpenCart 3

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

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

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

4. أدخل POSKey الخاص بالاختبار وبريد محفظة الاختبار، واترك Test Mode مفعّلًا، وفعّل Enable/Disable ثم انقر على Save. أجرِ طلبًا تجريبيًا.

5. عندما يعمل كل شيء، أدخل بيانات الاعتماد الفعلية وأوقف Test Mode.

OpenCart 4

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

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

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

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

يُرسَل عنوان الاستدعاء إلى Barion تلقائيًا مع كل دفعة. لا حاجة إلى إعداد أي شيء في بوابة Barion. يبدأ التثبيت الجديد بطريقة الدفع متوقفة ووضع الاختبار مفعّلًا.

الإعدادات

جميع الإعدادات موجودة في صفحة الإضافة: Extensions > Extensions > Payments > VibeFox Barion Gateway > Edit. تظهر الأقسام في القائمة على اليسار؛ وزر Save أسفل القائمة يحفظ الصفحة بأكملها. وفوق الإعدادات تحذّرك الصفحة إذا لم يكن للوضع الحالي POSKey أو بريد إلكتروني للمستفيد (وعندها تُخفى طريقة الدفع عند الدفع)، وإذا كانت العملة الافتراضية لمتجرك غير مدعومة من Barion، مع عرض قائمة العملات المدعومة. وطالما كان وضع الاختبار مفعّلًا، تعرض الصفحة الرسالة Test mode is on: payments go to the Barion sandbox (api.test.barion.com), no real money is charged. وبدون صلاحية تعديل الإضافة تعرض الصفحة الإعدادات لكنها لا تستطيع حفظها.

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

Barion

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

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

Description: النص الذي يظهر للعميل في خطوة Confirm Order، فوق زر التأكيد. الافتراضي: Pay securely with Barion — card, Barion Wallet, Apple Pay or Google Pay.

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

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

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

بيانات اعتماد متجر Barion

احصل على POSKey الخاص بك وبريد المحفظة من بوابة Barion: ‏secure.barion.com (للوضع الفعلي) أو ‏secure.test.barion.com (للاختبار)، وMy stores، ثم متجرك (البوابات مرتبطة في هذا القسم). يستخدم وضع الاختبار بيانات الاعتماد الخاصة بالاختبار فقط، ويستخدم الوضع الفعلي بيانات الاعتماد الفعلية فقط.

Test Mode: يستخدم بيانات اعتماد الاختبار المذكورة أدناه وبيئة Barion التجريبية (api.test.barion.com). لا يُخصم أي مبلغ حقيقي. الافتراضي: مفعّل. أوقفه لاستقبال مدفوعات حقيقية. وطالما كان مفعّلًا، يرى العملاء في خطوة Confirm Order الرسالة Test mode: no real payment is taken.

Test POSKey: المفتاح السري (POSKey) لمتجرك في نظام Barion للاختبار (‏secure.test.barion.com، My stores).

Test Payee Email: عنوان البريد الإلكتروني لمحفظة Barion الخاصة بالاختبار، والتي تستلم مدفوعات الاختبار.

Live POSKey: المفتاح السري (POSKey) لمتجرك في نظام Barion الفعلي (‏secure.barion.com، My stores).

Live Payee Email: عنوان البريد الإلكتروني لمحفظة Barion التي تستلم المدفوعات.

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

Callback URL: العنوان الذي تستدعيه Barion بعد كل دفعة. على OpenCart 3 يبدو هكذا: https://your-store/index.php?route=extension/payment/wcp_barion_gateway/callback، وعلى OpenCart 4 هكذا: https://your-store/index.php?route=extension/wcp_barion_gateway/payment/wcp_barion_gateway.callback، ويُنشأ من عنوان واجهة المتجر لتثبيت OpenCart الخاص بك. يُرسل إلى Barion مع كل دفعة، لذلك لا يوجد ما يلزم إعداده. يكفي أن يكون متاحًا من الإنترنت.

الطلبات

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

Order Status After Payment: الحالة التي تُعيَّن بعد دفعة ناجحة وموثّقة. الافتراضي: قيد التنفيذ.

Awaiting Barion Payment Status: أنهى العميل الإجراء في صفحة Barion، لكن Barion ما زالت تعالج الدفعة. الافتراضي: بانتظار الدفع.

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

Payment Failed Status: طلب بانتظار الدفع فشلت دفعته في Barion. الافتراضي: فشل.

Payment Canceled Status: طلب بانتظار الدفع أُلغيت دفعته في Barion أو انتهت صلاحيتها. الافتراضي: ملغي.

Refunded Status: يُعيَّن بعد استرداد الدفعة بالكامل من صفحة الطلب. الافتراضي: مسترد.

متقدم

Logging: يكتب طلبات Barion واستدعاءاتها في الملف barion_p_debug.log.php داخل مجلد السجلات في OpenCart (storage/logs). لا يمكن فتح الملف من الويب. لا تُسجَّل المفاتيح السرية وعناوين البريد الإلكتروني للمحافظ. الافتراضي: متوقف. وعند إيقافه لا يُكتب أي شيء، بما في ذلك الأخطاء.

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

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

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

Export: Download JSON يحفظ الإعدادات في ملف JSON. لا يتم تصدير مفاتيح POSKey.

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

الدفع

في خطوة Payment Method يختار العميل طريقة الدفع (افتراضيًا Barion). وفي خطوة Confirm Order يرى العميل وصفك والملاحظة You will be redirected to the secure Barion payment page. ينشئ OpenCart الطلب في هذه الخطوة، ولا يزال دون حالة. عندما ينقر العميل على Confirm Order، تبدأ الإضافة دفعة Barion بإجمالي الطلب بعملة الطلب، وتوجّه العميل إلى صفحة دفع Barion. تُدرج المنتجات والشحن ورسوم الطلب الأخرى والضريبة في الدفعة؛ ويُمرَّر رقم طلب OpenCart بوصفه رقم الطلب، ويُمرَّر بريد العميل بوصفه تلميحًا، وتتبع لغة الصفحة لغة العميل حيث تدعمها Barion (المجرية والألمانية والفرنسية والإسبانية والتشيكية والسلوفاكية والسلوفينية واليونانية، وإلا فالإنجليزية). وفي OpenCart 4 يختار العميل طريقة الدفع بزر Choose في كتلة طريقة الدفع، ضمن النافذة Payment method options، وينقر على Confirm Order أسفل صفحة الدفع.

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

إذا نجحت الدفعة، يرى العميل صفحة نجاح الطلب في OpenCart. وإذا كانت الدفعة ما زالت قيد المعالجة في Barion، يحصل الطلب على الحالة Awaiting Barion Payment Status وتعرض صفحة النجاح الرسالة Your payment is being confirmed by Barion. You will receive an e-mail as soon as it is confirmed. وإذا تعذر الوصول إلى Barion عند عودة العميل، أو تمت الدفعة لكنها لم تُطبَّق بعد، فإن صفحة Payment confirmation تعرض النص نفسه وزر Check again؛ ويعيّن الاستدعاء حالة الطلب بمجرد أن تؤكد Barion الدفعة.

إذا لم تكتمل الدفعة (أُلغيت أو انتهت صلاحيتها أو فشلت)، يبقى الطلب دون حالة، ويُحفظ السلة، ويعود العميل إلى الدفع مع الرسالة Payment was not completed. Please try again. إذا لم يتطابق رابط العودة مع الطلب، فالرسالة هي Payment verification failed. وفي OpenCart 4 تُعرض هذه الرسائل أعلى صفحة الدفع. تنشئ كل محاولة جديدة طلب OpenCart جديدًا في OpenCart 3. ويحتفظ OpenCart 4 بطلب واحد للدفع ويحدّثه، لذلك تكون المحاولة الجديدة دفعة Barion جديدة للطلب نفسه. ولا تستطيع Barion إلغاء دفعة بدأت، لذلك تتحقق الإضافة قبل أي دفعة جديدة من الدفعات المفتوحة السابقة للسلة لدى Barion: إذا كانت إحداها مدفوعة أو ما زالت قيد المعالجة، فيُؤكَّد طلبها ويذهب العميل إلى صفحة النجاح دون أن يدفع من جديد. وإذا كان طلب آخر من السلة نفسها (المنتجات نفسها في الزيارة نفسها) مدفوعًا بالفعل، يذهب العميل أيضًا إلى صفحة النجاح دون دفعة جديدة؛ وعملية شراء جديدة بعد عملية مكتملة تُعد سلة جديدة. وتؤكد الدفعة المتأخرة لمحاولة سابقة للطلب نفسه الطلب، أما المحاولة السابقة التي تنتهي صلاحيتها فلا تلغي الطلب. وإذا دفع العميل طلبين من السلة نفسها (علامتا تبويب)، فلا تؤكد الدفعة الثانية طلبها: يتلقى الطلب المدفوع ملاحظة بأنه استُلمت دفعة ثانية للسلة نفسها، لتتمكن من استرداد مبلغها في بوابة Barion.

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

إذا تعذر بدء الدفعة، يبقى العميل في خطوة Confirm Order مع رسالة قصيرة فوق الزر: The Barion payment could not be started. Please try again or choose another payment method.، أو Barion does not support payments in عملة الطلب، أو Barion payment is not available at the moment. Please choose another payment method.، أو Barion cannot process an order with a zero total. تُكتب التفاصيل في السجل عند تفعيل Logging.

تقبل الإضافة الدفعات الفورية فقط. لا تتضمن دفعات الحجز أو التحصيل المؤجل، ولا الاشتراكات أو الدفعات المتكررة، ولا البطاقات المحفوظة، ولا Barion Pixel، ولا بيانات 3-D Secure إضافية؛ وتتولى Barion التحقق بـ 3-D Secure في صفحة الدفع الخاصة بها.

الطلبات والاستردادات

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

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

Awaiting Barion Payment Status (الافتراضي Pending): تُبلغ Barion بأن الدفعة ما زالت قيد التنفيذ. تعرض ملاحظة معرّف الدفعة PaymentId الخاص بـ Barion والمبلغ، وفي وضع الاختبار تعرض (test mode). ينتقل الطلب إلى حالة المدفوع عندما تؤكد Barion الدفعة.

Order Status After Payment (الافتراضي Processing): أكدت Barion الدفعة. تعرض ملاحظة المبلغ وPaymentId والمعاملة في Barion.

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

Payment Canceled Status (الافتراضي Canceled): أُلغيت آخر محاولة دفع لطلب بانتظار الدفع أو انتهت صلاحيتها في Barion.

Payment Failed Status (الافتراضي Failed): فشلت آخر محاولة دفع لطلب بانتظار الدفع.

Refunded Status (الافتراضي Refunded): استُردت الدفعة بالكامل عبر الإضافة.

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

علامة تبويب VibeFox Barion Gateway

في Sales > Orders افتح طلبًا دُفع عبر Barion. في أسفل صفحة الطلب، بجوار History وAdditional، تعرض علامة التبويب VibeFox Barion Gateway معرّف الدفعة PaymentId مع التسمية Test mode لدفعات الاختبار، ومعاملة Barion Transaction، وStatus الدفعة، والمبالغ Paid / refunded، ونموذج الاسترداد، وسجل الاستردادات، وBarion notes الخاصة بالطلب. تظهر علامة التبويب للمستخدمين الذين لديهم صلاحية الوصول إلى الإضافة.

الاستردادات

في علامة التبويب VibeFox Barion Gateway أدخل المبلغ (يُملأ المبلغ الذي لم يُسترد بعد)، واختياريًا Reason (optional)، ثم انقر على Refund via Barion. أكّد السؤال Refund this amount through Barion? This cannot be undone. الاستردادات الكاملة والجزئية مدعومة. تحتاج إلى صلاحية تعديل الإضافة (وتُضبط في System > Users > User Groups). يُرسل السبب إلى Barion بوصفه تعليقًا. يجب أن تكون استردادات HUF مبالغ صحيحة. يُرسل الاسترداد في الوضع (الاختبار أو الفعلي) الذي تمت فيه الدفعة، لذلك يجب ضبط POSKey ذلك الوضع. إذا لم تقبل Barion الاسترداد أو لم تؤكده، تعرض علامة التبويب الخطأ ولا يُسجَّل أي استرداد. يُضاف الاسترداد الناجح إلى سجل الاستردادات والملاحظات مع معاملة Barion وحالتها. الاسترداد الكامل يضبط الطلب على Refunded Status دون إشعار العميل ودون إعادة المنتجات إلى المخزون، كما في تغيير الحالة يدويًا. الاسترداد الجزئي لا يغير الحالة.

تكون الاستردادات متاحة بعد أن تؤكد Barion الدفعة ويكون الطلب مدفوعًا بها. لا يمكن استرداد دفعة بها فرق في المبلغ أو العملة من OpenCart؛ استردها من بوابة Barion. لا ترسل المرتجعات في Sales > Returns الأموال عبر Barion.

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

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

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

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

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

لا يظهر Barion عند الدفع: تحقّق من أن الترخيص فعّال، وأن Enable/Disable مفعّل، وأن الوضع الحالي فيه POSKey وبريد إلكتروني للمستفيد (تعرض صفحة الإعدادات تحذيرًا عند غياب أحدهما)، وأن عملة الطلب هي HUF أو EUR أو USD أو CZK. وتحقق أيضًا من أن عنوان الدفع ضمن Geo Zone المحددة، وأن الطلب يبلغ Total المضبوط في الإعدادات.

تمت الدفعة لكن الطلب يبقى دون حالة: يحصل الطلب على حالته عندما تستدعي Barion عنوان الاستدعاء أو عندما يعود العميل إلى متجرك. تأكد من أن الموقع متاح من الإنترنت (لا جدار حماية أو مصادقة أساسية أمام عنوان الاستدعاء). تحقق من أن POSKey للوضع الذي تمت فيه الدفعة صحيح، لأن الإضافة تطلب حالة الدفعة من Barion به. فعّل Logging لرؤية الاستدعاء.

يرد الاستدعاء بـ Busy, retry: كان الطلب يُعالَج أثناء عودة العميل في اللحظة نفسها، أو تعذّر تعيين حالة الطلب. تعيد Barion الاستدعاء. فعّل Logging لرؤية السبب.

يرد الاستدعاء بـ API error: لم يتمكن المتجر من قراءة حالة الدفعة من Barion، أو POSKey للوضع الذي تمت فيه الدفعة غير مضبوط. تحقق من هذا POSKey.

يرد الاستدعاء بـ Order not found: معرّف الدفعة PaymentId لم يبدأه هذا المتجر. تُتجاهل استدعاءات Barion الموجهة إلى متاجر أخرى أو أنظمة اختبار.

يرى العميل Payment verification failed.: رابط العودة لا يطابق الطلب، على سبيل المثال لأنه عُدّل. تبقى حالة الدفعة مؤكدة عبر الاستدعاء.

يرى العميل خطأ بعد Confirm Order: فعّل Logging وراجع حقل Log في صفحة الإضافة. يؤدي POSKey خاطئ أو بريد مستفيد خاطئ إلى The Barion payment could not be started. وThis payment method is not available. Please reload the checkout page. تعني أن جلسة الدفع لم تعد تطابق الطلب، أو أن طريقة الدفع أُوقفت في هذه الأثناء: على العميل إعادة تحميل صفحة الدفع.

الطلب في حالة الانتظار: اقرأ ملاحظة عدم التطابق في علامة التبويب VibeFox Barion Gateway، وتحقق من الدفعة في بوابة Barion، ثم نفّذ الطلب أو استرده في بوابة Barion.

لماذا لا أستطيع استرداد 10.50 HUF: تعالج Barion عملة HUF بدون منازل عشرية. أدخل مبلغًا صحيحًا.

لا يوجد نموذج استرداد في علامة التبويب: تبيّن علامة التبويب السبب: الدفعة غير مؤكدة بعد، أو مستردة بالكامل، أو مجموعة المستخدمين لا تملك صلاحية تعديل الإضافة، أو POSKey لوضع الدفعة غير مضبوط.

للمطورين: تُطلق الإضافة أحداث OpenCart wcp_barion_supported_currencies (قائمة العملات) وwcp_barion_payment_request (طلب الدفع والطلب، قبل إرسالهما إلى Barion).

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

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

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

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