VibeFox Flutterwave for OpenCart

Overview

VibeFox Flutterwave Payment adds Flutterwave payments to OpenCart 3 and OpenCart 4 through the Flutterwave hosted checkout page (Flutterwave Standard, API v3). At the last checkout step the customer clicks Confirm Order, 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 store. OpenCart creates the order before the payment, but the order gets a status only after Flutterwave confirms the payment, so unpaid attempts stay missing orders.

It suits stores in Nigeria, Ghana, Kenya, South Africa, East and Francophone Africa and stores that accept international cards. The order is always charged in the order currency. The extension 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 OpenCart.

Key features

Hosted checkout: a payment is created for the order total in the order 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 status is successful and the amount and currency match. OpenCart then sends its usual order e-mails.

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 apply a payment twice. Before a new attempt, the open payments of the order and the cart are checked, 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 when the customer returns puts the order in an awaiting status until Flutterwave confirms it.

Refunds from the order page: full and partial refunds in the VibeFox Flutterwave Payment tab 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.

OpenCart conditions: your own order statuses, optional autocomplete, geo zone, minimum order total and sort order. Optional log without keys or customer data.

Requirements

OpenCart 3.0.x (tested on 3.0.5.0) or OpenCart 4.0.2 and later (tested on 4.1.0.3), PHP 8.0 or later. One download has the packages for both versions. 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).