CartModules: Flutterwave Payment Gateway

Accept Payments Across Africa and Beyond

Integrate Flutterwave into your CS-Cart or Multi-Vendor store and start accepting payments from customers in 30+ African countries and globally. Flutterwave is Africa's leading payment technology company, trusted by over 1 million businesses.

Supported Payment Methods

• Cards — Visa, Mastercard, Verve, American Express, and local debit cards
• Bank Transfers — Direct bank debits and transfers across multiple African banks
• Mobile Money — M-Pesa, MTN Mobile Money, Airtel Money, and other mobile wallets
• USSD — Pay with USSD codes from any mobile phone (no internet required)
• POS — Point-of-sale terminal payments
• Bank Accounts — Direct debit from customer bank accounts

Supported Countries

Accept payments from customers in Nigeria, Ghana, Kenya, South Africa, Uganda, Tanzania, Rwanda, Cameroon, Ivory Coast, Senegal, Zambia, and 20+ more African countries. Also supports international payments in USD, GBP, and EUR.

Supported Currencies

NGN, KES, GHS, ZAR, UGX, TZS, RWF, XAF, XOF, ZMW, USD, GBP, EUR

Key Features

• Dual Checkout Modes — Choose between redirect (hosted page) or inline (popup) checkout
• On-Site Payment — Inline mode keeps customers on your store during payment
• Apple Pay — Accept Apple Pay payments via inline checkout
• Google Pay — Accept Google Pay payments via inline checkout
• Hosted Checkout — Customers are redirected to Flutterwave's secure, PCI-compliant checkout page. No card data touches your server (PCI SAQ A).
• Webhook Support — Real-time server-to-server notifications ensure orders are updated even if the customer closes their browser.
• Webhook Verification — Incoming webhooks are verified using a secret hash to prevent fraudulent notifications.
• Transaction Verification — Every payment is verified via the Flutterwave API before the order is finalized.
• Idempotent Callbacks — Duplicate callbacks are safely handled to prevent double-processing.
• Live/Test Mode Toggle — Switch between production and sandbox environments directly from the admin panel.
• Order Status Mapping — Map Flutterwave payment outcomes (successful, failed, pending) to your preferred CS-Cart order statuses.
• Structured Logging — All gateway interactions are logged with sensitive data (API keys, card numbers) automatically stripped.

Checkout Modes

• Redirect (Default) — Customer is redirected to Flutterwave's secure hosted payment page
• Inline (Popup) — FlutterwaveCheckout opens directly on your checkout page. Customer pays without leaving your store.

How It Works

1. Customer selects Flutterwave at checkout and clicks "Place Order".
2. In redirect mode: Customer is redirected to Flutterwave's hosted checkout page to enter payment details.
3. In inline mode: Flutterwave popup appears on the checkout page.
4. After payment, customer is returned to your store with the order confirmation (or popup closes).
5. Flutterwave sends a webhook notification to confirm the payment server-to-server.
6. The addon verifies the transaction via the Flutterwave API and updates the order status.

Installation

1. Go to Add-ons > Manage add-ons, click Manual installation, and upload the addon zip
2. Activate the addon and enter the license key
3. Create a new payment method and select "Flutterwave Payment Gateway" as the processor.
4. Enter your Flutterwave Secret Key and Secret Hash from the Flutterwave dashboard.
5. Select your preferred currency and order status mappings.
6. Configure the webhook URL in your Flutterwave dashboard.

Requirements

• CS-Cart or Multi-Vendor 4.x
• A Flutterwave merchant account (Sign up here)
• PHP 5.6+ with JSON and cURL extensions
• SSL certificate on your store (HTTPS)