VibeFox Hubtel for OpenCart

نظرة عامة

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

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

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

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

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

التحقق من المبلغ: إذا كان المبلغ مختلفًا، يُنقل الطلب إلى حالة مراجعة تختارها أنت مع ملاحظة.

لا شيء يلزم إعداده في Hubtel: يُرسل عنوان الاستدعاء (callback URL) مع كل عملية دفع.

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

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

تبويب Hubtel في صفحة الطلب: جميع محاولات الدفع الخاصة بالطلب مع حالتها ومعاملتها في Hubtel، إضافةً إلى ملاحظات Hubtel.

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

المتطلبات

OpenCart 3.0.x (تم اختباره على 3.0.5.0) أو OpenCart 4.0.2 وما بعده (تم اختباره على 4.1.0.3)، وPHP 8.0 أو أحدث مع امتداد cURL. يحتوي التنزيل الواحد على حزم للإصدارين معًا. حساب أعمال لدى Hubtel يتضمن API ID وAPI Key ورقم حساب التاجر (POS Sales ID)، وعنوان IP لخادمك مُدرَج في القائمة البيضاء لدى Hubtel. عملة الطلب سيدي غانا (GHS). يُوصى بـ cron على الخادم للفحوصات في الخلفية. مفتاح ترخيص VibeFox من vibefox.net (مفتاح واحد لكل نطاق).