Skip to main content

Payment Gateway - Flutterwave

A detailed guide on integrating and managing Flutterwave payments in your Ivonto store.

Updated over 8 months ago

Flutterwave Overview

Flutterwave is a robust payment gateway that supports businesses in Nigeria, Ghana, Kenya, South Africa, Uganda, Tanzania, the United States, the United Kingdom, and across Europe. It facilitates payments from local cards within these countries/regions as well as all MasterCard and Visa cards globally.

How to Set Up Flutterwave Payment Gateway

  1. Log in to Ivonto Admin Panel: Access your Ivonto admin panel.

  2. Navigate to Payments: Go to Settings → Payments.

  3. Add Flutterwave Payment Method:

    • Click on "Add payment method."

    • Select "Flutterwave" as your payment provider if available with your store currency. If not, follow the steps to change your store currency.

  4. Enable Payment Method:

    • In the "Enable payment method" section, toggle the switch to enable Flutterwave.

    • Enter the "Secret Key" from your Flutterwave account and click Submit.

Acquiring API Key for Initial Setup

  1. Access API Keys: In your Flutterwave dashboard, go to Settings → Developers → API Keys.

  2. Generate Secret Key:

    • Click on "Generate Secret Key" to get your live secret key.

    • An authentication code will be sent to your email.

    • Enter the 7-digit authentication code from your email.

Regenerating API Keys

  1. Go to Settings: In your Flutterwave dashboard, navigate to Settings → Developers → API Keys.

  2. Generate New API Key:

    • Click on "Generate Secret Key" for new live API keys.

    • Select the expiration period for your current keys.

    • Enter the 7-digit authentication code sent to your email and generate new API keys.

Enabling Sandbox Mode for Testing

  1. Enable Sandbox Mode:

    • Click on "More options" on the same page.

    • Toggle to enable Sandbox mode.

  2. Enter Test Keys:

    • Enter the same keys in the "Test Secret Key" input box for testing the Flutterwave payment method at checkout.


Flutterwave Supported Currencies

Flutterwave supports a variety of currencies, including:

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 the Flutterwave documentation.


Flutterwave Isn't Available with Your Store Currency

If Flutterwave isn't available due to your store currency, you need to change your store currency.

Change Store Currency:

  • Go to Settings → General in your Ivonto admin panel.

  • Click on "Standards and formats."

  • Select a currency that Flutterwave supports from the dropdown menu.

For more information, read about setting up a currency for your online store and what to do if a payment gateway doesn't support your currency.

Did this answer your question?