—

sidebar_position: 5

—

Flutterwave Overview

Flutterwave is a payment gateway that is supported in Nigeria, Ghana, Kenya, South Africa, Uganda, Tanzania, United States, United Kingdom, and the rest of Europe.

In addition to the local cards of these countries/regions, Flutterwave also allows you to receive payments from all MasterCard and Visa Cards.

How to Set Up Flutterwave Payment Gateway

Log in to your eCommerce admin panel
Navigate to the Settings → Payments in your admin panel
Click on the “Add payment method” anchor text
If available with your store currency, select “Flutterwave” as your payment provider (if not available, see the Flutterwave isn’t available with your store currency section below)
In the “Enable payment method” section, click on the toggle to enable the payment method
Enter the “Secret Key” from your Flutterwave account, then click on the Submit button

Acquiring an API Key for Initial Setup

Navigate to the Settings area of your Flutterwave dashboard
Choose the Developers tab and select API Keys. This section displays your Test API Keys and Live Public Keys
Click on Generate Secret Key to obtain your live Secret key. An authentication code will be dispatched to your email address
Input the 7-digit authentication code received in your email

If You Already Have an API Key and Wish to Generate New Ones

Go to the Settings section in your Flutterwave dashboard
Navigate to the API keys option under the Developers tab
Click on Generate secret key to obtain live API keys
Choose the desired expiration period for your current API keys
Enter the 7-digit authentication code that was sent to you and click on Generate new API keys

Enable Sandbox Mode for Testing

You can also enable the Sandbox mode to test the key:

Click on the More options on the same page, and click on the toggle to enable the Sandbox mode
Write down the same keys to the “test Secret key” input box to test the Flutterwave payment method at the checkout

Flutterwave Supported Currencies

Flutterwave supports the following currencies:

| CURRENCY NAME | CURRENCY CODE |

|——————-|——————-|

| United States Dollar | USD |

| British Pound Sterling | GBP |

| Canadian Dollar | CAD |

| Central African CFA Franc | XAF |

| Chilean Peso | CLP |

| Colombian Peso | COP |

| Egyptian Pound | EGP |

| SEPA | EUR |

| Ghanaian Cedi | GHS |

| Guinean Franc | GNF |

| Kenyan Shilling | KES |

| Malawian Kwacha | MWK |

| Moroccan Dirham | MAD |

| Nigerian Naira | NGN |

| Rwandan Franc | RWF |

| Sierra Leonean Leone | SLL |

| São Tomé and Príncipe dobra | STD |

| South African Rand | ZAR |

| Tanzanian Shilling | TZS |

| Ugandan Shilling | UGX |

| West African CFA Franc BCEAO | XOF |

| Zambian Kwacha | ZMW |

For the latest list, check out the currencies you can charge cards in Flutterwave.

Flutterwave Isn't Available with Your Store Currency

If Flutterwave payment isn’t available due to your store currency, you cannot select this payment provider. To resolve this issue, you need to change your store’s currency to one that Flutterwave supports.

To change your store’s currency:

Head to the Settings → General in your eCommerce admin panel
Click on the “Standards and formats” settings
From the Currency dropdown menu, select the currency that Flutterwave supports
Click Save

:::caution

If you’ve already received an order for your online store, you cannot change the currency through the settings. In such cases, please contact eCommerce support (support@eCommerce.com) to request a change in your store currency.

:::

Key Features of Flutterwave

Multiple Payment Options

Flutterwave offers a variety of payment methods tailored to different regions:

Card Payments: Accept Visa, Mastercard, and local cards across Africa and beyond
Mobile Money: Integrate with popular mobile money services across multiple African countries
Bank Transfers: Support for direct bank transfers in supported countries
USSD: Offer payment via USSD codes for users without smartphones or internet
QR Payments: Enable contactless payments through QR code scanning

Regional Specialization

Flutterwave has specific features for different regions:

Nigeria: Support for local payment methods like USSD and bank transfers
Kenya: Integration with M-Pesa and other mobile money services
Ghana: Support for mobile money networks like MTN, Vodafone, and AirtelTigo
South Africa: Integration with local banking systems and payment methods
Tanzania/Uganda: Support for local mobile money services

Security and Compliance

Flutterwave maintains high security standards:

PCI DSS Level 1 compliance
3D Secure authentication
Anti-fraud monitoring and protection
Data encryption and security

Best Practices for Using Flutterwave

Test thoroughly: Always test your integration in the sandbox environment before going live
Implement webhook notifications: Set up webhooks to receive real-time updates on payment status
Handle currency conversion appropriately: Be clear about which currencies you accept and how conversion works
Keep your API keys secure: Never expose your secret key in client-side code
Display appropriate payment methods: Show payment options relevant to your customer’s location
Regularly verify transaction status: Always confirm payment status before fulfilling orders
Stay updated: Keep up with Flutterwave’s API documentation for new features and changes

Flutterwave

Table of Contents

Flutterwave Overview

How to Set Up Flutterwave Payment Gateway

Acquiring an API Key for Initial Setup

If You Already Have an API Key and Wish to Generate New Ones

Enable Sandbox Mode for Testing

Flutterwave Supported Currencies

Flutterwave Isn't Available with Your Store Currency

Key Features of Flutterwave

Multiple Payment Options

Regional Specialization

Security and Compliance

Best Practices for Using Flutterwave

Your Progress

Quick Links

Related Guides

Yoco

Stripe

PayPal

Shipping Integrations

📈 Marketing

Marketing & SEO

Enterprise Security

Store Building

Graphics & Appearance

Templates

Build My Website ✅

Mobile Commerce

Social Commerce

Integrations

Inventory Management

Payment Methods

Ready to Launch Your Dream Store?