VibeFox Flutterwave for PrestaShop

نظرة عامة

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

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

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

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

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

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

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

معالجة طرق الدفع المعلّقة: تُبقي التحويلات المصرفية وUSSD والأموال عبر الهاتف المحمول الطلب في حالة Awaiting Flutterwave payment حتى تؤكدها Flutterwave.

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

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

كتلة Flutterwave في صفحة الطلب: المرجع والمعاملة والوضع وسجل الاستردادات وملاحظات Flutterwave الخاصة بالطلب. سجل اختياري بلا مفاتيح أو بيانات عملاء.

المتطلبات

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