VibeFox Flutterwave for PrestaShop

Overview

VibeFox Flutterwave Payment adds Flutterwave payments to PrestaShop through the Flutterwave hosted checkout page (Flutterwave Standard, API v3). At the payment step the customer chooses Flutterwave, is sent to the Flutterwave page, pays with any method enabled on your Flutterwave account, such as cards, bank transfer, USSD or mobile money, and comes back to your shop. The order is created only after Flutterwave confirms the payment, so abandoned payments leave no unpaid orders.

It suits shops in Nigeria, Ghana, Kenya, South Africa, East and Francophone Africa and shops that accept international cards. The cart is always charged in the cart currency. The module takes one-time payments only. It has no inline or modal checkout on your site, no saved cards, subscriptions, split payments or payment plans, and refunds made in the Flutterwave dashboard are not synced back to PrestaShop.

Key features

Hosted checkout: a payment is created for the cart total in the cart currency, rounded to the precision of the currency (XOF, XAF, UGX, RWF and others have no decimals). You can limit the payment options shown on the Flutterwave page.

Paid only when Flutterwave confirms: neither the return URL nor the webhook body is trusted. Every payment is read again from Flutterwave on your server, and the order is paid only when the reference belongs to the cart, the status is successful and the amount and currency match.

Signed webhooks: webhooks are accepted only with your secret hash. They confirm the payment even when the customer closes the browser.

No double processing: repeated webhooks and returns never create a second order or record the payment twice. An older payment link paid later is still accepted, and a second payment for a paid order is flagged for refund.

Pending methods handled: a bank transfer, USSD or mobile money payment that is still pending puts the order in Awaiting Flutterwave payment until Flutterwave confirms it.

Refunds from the order page: full and partial refunds in the Flutterwave payment block of the order, in the amount and currency Flutterwave charged, with the key of the mode the payment was made in.

Test and live: separate secret keys. A test key in live mode, or a live key in test mode, hides the payment method and shows a warning.

Flutterwave block on the order page: reference, transaction, mode, refund history and the Flutterwave notes of the order. Optional log without keys or customer data.

Requirements

PrestaShop 8.0 to 9.x, PHP 8.0 or later. A Flutterwave account with its secret keys and a webhook with a secret hash. A VibeFox license key from vibefox.net (one key per domain).