VibeFox Flutterwave for OpenCart

نظرة عامة

تضيف VibeFox Flutterwave Payment مدفوعات Flutterwave إلى OpenCart 3 وOpenCart 4 عبر صفحة الدفع المستضافة من Flutterwave (Flutterwave Standard، الإصدار 3 من API). في الخطوة الأخيرة من الدفع ينقر العميل على Confirm Order، فيُنقل إلى صفحة Flutterwave، ويدفع بأي وسيلة مفعّلة في حسابك لدى Flutterwave، مثل البطاقات أو التحويل البنكي أو USSD أو الدفع عبر الهاتف المحمول، ثم يعود إلى متجرك. ينشئ OpenCart الطلب قبل الدفع، لكن الطلب لا يحصل على حالة إلا بعد أن تؤكد Flutterwave الدفع، لذلك تبقى المحاولات غير المدفوعة طلبات مفقودة.

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

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

الدفع المستضاف: يُنشأ دفع بإجمالي الطلب بعملة الطلب، مقرَّبًا وفق دقة العملة (لا تحتوي XOF وXAF وUGX وRWF وغيرها على منازل عشرية). ويمكنك تقييد خيارات الدفع المعروضة في صفحة Flutterwave.

يُعتمد الدفع فقط عند تأكيد Flutterwave: لا يُعتمد عنوان الإرجاع ولا محتوى الـ webhook. يُعاد قراءة كل دفعة من Flutterwave من خادمك، ولا يُعلَّم الطلب كمدفوع إلا عندما تكون الحالة ناجحة ويتطابق المبلغ والعملة. بعد ذلك يرسل OpenCart رسائل البريد المعتادة للطلب.

Webhooks موقّعة: لا تُقبل الـ webhooks إلا مع مفتاح التجزئة السري الخاص بك. وهي تؤكد الدفع حتى عندما يغلق العميل المتصفح.

لا معالجة مزدوجة: الـ webhooks والعودة المتكررة لا تطبّق الدفعة مرتين أبدًا. قبل أي محاولة جديدة تُفحص المدفوعات المفتوحة للطلب والسلة، ويُقبل رابط دفع قديم يُدفع لاحقًا، ويُعلَّم الدفع الثاني لطلب مدفوع بالفعل للاسترداد.

معالجة وسائل الدفع المعلّقة: إذا كانت دفعة تحويل بنكي أو USSD أو دفع عبر الهاتف المحمول ما زالت معلّقة عند عودة العميل، يبقى الطلب في حالة انتظار حتى تؤكدها Flutterwave.

الاسترداد من صفحة الطلب: استرداد كامل وجزئي من تبويب VibeFox Flutterwave Payment في الطلب، بالمبلغ والعملة اللذين خصمتهما Flutterwave، ومفتاح الوضع الذي تمت فيه الدفعة.

الاختبار والإنتاج: مفاتيح سرية منفصلة. يؤدي مفتاح الاختبار في وضع الإنتاج، أو مفتاح الإنتاج في وضع الاختبار، إلى إخفاء وسيلة الدفع وعرض تحذير.

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

المتطلبات

OpenCart 3.0.x (تم الاختبار على 3.0.5.0) أو OpenCart 4.0.2 وما بعده (تم الاختبار على 4.1.0.3)، وPHP 8.0 أو أحدث. يحتوي ملف التنزيل الواحد على الحزم الخاصة بالإصدارين. حساب Flutterwave يحتوي على مفاتيحه السرية، وwebhook مع مفتاح تجزئة سري. مفتاح ترخيص VibeFox من vibefox.net (مفتاح واحد لكل نطاق).