VibeFox Hubtel for PrestaShop

نظرة عامة

تضيف VibeFox Hubtel Pay Gateway مدفوعات Hubtel في غانا إلى PrestaShop. في خطوة الدفع يختار العميل Hubtel، ويُوجَّه إلى صفحة الدفع الآمنة Hubtel Online Checkout، ويدفع عبر MTN MoMo أو Telecel Cash أو AirtelTigo Money أو بطاقة Visa أو Mastercard أو GhQR، ثم يعود إلى متجرك. لا يُنشأ الطلب إلا بعد أن تؤكد Hubtel الدفع، لذلك لا تترك المدفوعات المتروكة طلبات غير مدفوعة.

تناسب المتاجر الغانية التي تبيع بالسيدي الغاني (GHS) ولديها حساب أعمال لدى Hubtel. يجب أن تدرج Hubtel عنوان IP لخادم الويب الخاص بك في القائمة البيضاء من أجل Transaction Status API، ولا توفر Hubtel بيئة اختبار عامة، لذلك فإن جميع المدفوعات حقيقية. لا تدعم الوحدة الاسترداد من PrestaShop، ولا الاشتراكات، ولا حفظ البطاقات، ولا اختيار قناة الدفع من داخل المتجر.

الميزات الرئيسية

صفحة دفع Hubtel المستضافة: مدفوعات Mobile Money والبطاقات في صفحة Hubtel. يختار العميل قناة الدفع هناك.

الدفع يُعتمد فقط عند تأكيد Hubtel: استدعاءات رد Hubtel غير موقَّعة، لذلك لا تثق بها الوحدة أبدًا. تستعلم الوحدة من Hubtel Transaction Status API الموثَّقة، ولا تُنشئ الطلب كمدفوع إلا عندما تفيد Hubtel بأنه "Paid" بكامل إجمالي السلة بالضبط بعملة GHS.

التحقق من المبلغ: أي مبلغ مختلف يضع الطلب في حالة Hubtel payment on hold مع ملاحظة لمدير المتجر.

لا يتطلب أي إعداد في Hubtel: يُرسل رابط الرد (callback) مع كل عملية دفع.

تغطية استدعاءات الرد المفقودة: عودة العميل تفحص حالة الدفع، ويعيد رابط cron عمليات الفحص في الخلفية، ويمكن لمدير المتجر النقر على Check Hubtel payment status في صفحة الطلب.

منع المعالجة المزدوجة: لكل محاولة دفع مرجع خاص بها. لا تؤدي استدعاءات الرد المتكررة أبدًا إلى إنشاء طلب ثانٍ أو إعادة فتح طلب ملغى أو مسترد. وتُعلَّم الدفعة الثانية لسلة مدفوعة بالفعل للاسترداد.

الإلغاء في Hubtel: يعود العميل إلى صفحة الدفع برسالة توضيحية ويمكنه المحاولة مرة أخرى. تُحفظ السلة.

كتلة Hubtel في صفحة الطلب: جميع محاولات الدفع للطلب مع حالتها ومعاملتها في Hubtel، إضافة إلى ملاحظات Hubtel. سجل اختياري دون مفاتيح API أو بيانات العملاء.

المتطلبات

PrestaShop من 8.0 إلى 9.x، وPHP 8.0 أو أحدث مع امتداد cURL. حساب أعمال لدى Hubtel مع API ID وAPI Key ورقم حساب التاجر (POS Sales ID)، وإدراج عنوان IP لخادمك في القائمة البيضاء لدى Hubtel. عملة المتجر: السيدي الغاني (GHS). يُنصح بإعداد cron على الخادم للفحوصات في الخلفية. ومفتاح ترخيص VibeFox من vibefox.net (مفتاح واحد لكل نطاق).