Help Centerβ€ΊPaymentsβ€ΊHow to integrate Flutterwave in SystemeScale
πŸ’³ Payments

How to integrate Flutterwave in SystemeScale

πŸ“… Last updated: June 2026
⏱ 7 min read
βœ… Flutterwave

In this article, you will learn how to integrate your Flutterwave account with your SystemeScale account.

What you'll need

  • A SystemeScale account
  • A Flutterwave account

Setup and configuration

To connect your Flutterwave account to your SystemeScale account, click on your profile picture and then Settings.

Next, from the left-hand menu, click Payment Gateways, then click Connect for Flutterwave.

1
Open Settings
Click your profile picture, then click Settings.
2
Open Payment Gateways
From the left-hand menu, click Payment Gateways.
3
Connect Flutterwave
Click Connect for the Flutterwave payment gateway.

Add your Flutterwave credentials to your SystemeScale account and click Save.

Generate Flutterwave API keys

Log into your Flutterwave account to get the API public key, API secret key, and API encryption key.

Go to Settings, then to API Keys. Generate and copy the API public key, API secret key, and API encryption key.

Alternatively, log in and visit https://app.flutterwave.com/dashboard/settings/apis/live to generate and copy the API keys.

πŸ”‘
Copy all three Flutterwave keys
SystemeScale needs the API public key, API secret key, and API encryption key to connect the Flutterwave gateway correctly.

Configuring the Flutterwave webhooks

Copy the webhook URL and webhook secret from the Flutterwave section in your SystemeScale account.

From your Flutterwave account, click Settings, then go to Webhooks.

Paste the webhook URL and the webhook secret, then click Save.

Alternatively, log in and visit https://app.flutterwave.com/dashboard/settings/webhooks/live to paste the webhook URL and the webhook secret.

1
Copy webhook details from SystemeScale
Copy the webhook URL and webhook secret from the Flutterwave section in your SystemeScale account.
2
Open Flutterwave Webhooks
In Flutterwave, click Settings, then go to Webhooks.
3
Paste and save webhook details
Paste the webhook URL and webhook secret, then click Save.

Enable the required Flutterwave webhook preferences

Next, check the boxes for the following events and webhook preferences:

  • Receive Webhook response in JSON format
  • Enable Webhook retries
  • Enable webhook for failed transactions
  • Enable V3 Webhooks
⚠️
Enable every listed preference
You must enable these webhook preferences so SystemeScale can track transactions and grant customers access to their purchases. This does not happen automatically, so be sure to check the appropriate boxes.

Important notes

  • Refunds for a Flutterwave payment are disabled by default. To enable this feature, contact Flutterwave support.
  • The payment will fail if the email field is not included on the order form.
↩️
Need to understand refunds?
Refund availability depends on the payment gateway and the gateway account configuration used for the original transaction.
Read Refund Guide β†’
πŸ“‹
Email field is mandatory
Before sending traffic to an order form that uses Flutterwave, confirm that the email field is present. Without it, payments cannot be processed correctly.

What happens when a Flutterwave payment fails?

After the main payment attempt, there will be three additional attempts, 30 minutes apart from each other.

The delay between each attempt cannot be changed.

πŸ”
Flutterwave retry timing
Flutterwave makes three additional attempts after the main payment attempt. These retries are spaced 30 minutes apart, and the delay cannot be changed.

Related payment guides

Use the related guides below if you need to activate payments in a funnel, create an order form, review failed-payment behavior, process refunds, or compare other payment gateways.

πŸ’³
Need to activate Flutterwave inside a funnel?
After connecting Flutterwave, enable the relevant payment option in the specific funnel or order form where customers will pay.
Read Funnel Payment Guide β†’
Was this article helpful?