Loading
In this article, you will learn how to integrate your Flutterwave account with your systeme.io account.
To get started, you will need:
- A systeme.io account
- A Flutterwave account
1. Setup and configuration:
To connect your Flutterwave account to your systeme.io account, click on your profile picture and then Settings (1).
Next, from the left-hand menu, click Payment Gateways (2), then click Connect (3).
Add your Flutterwave credentials to your systeme.io account and click Save (4).
Log into your Flutterwave account to get the API public key, API secret key & API encryption key.
Go to Settings (5) and then to API Keys (6). Generate and copy the API public key, API secret key & API encryption key (7)
Alternatively, log in and visit https://app.flutterwave.com/dashboard/settings/apis/live to generate and copy the API keys.
2. Configuring the Flutterwave webhooks:
Copy the webhook URL and webhook secret from the Flutterwave section in your systeme.io account.
From your Flutterwave account, click on Settings (8), then go to Webhooks (9).
Paste the webhook URL and the webhook secret, then click Save (10).
Alternatively, log in and visit https://app.flutterwave.com/dashboard/settings/webhooks/live to paste the webhook URL and the webhook secret.
Next, check the boxes for the following events:
- Receive a webhook response in JSON format
- Enable Webhook retries
- Enable webhook for failed transactions
- Enable V3 Webhooks
IMPORTANT:
- You must enable these webhook preferences so systeme.io can track transactions and grant customers access to their purchases. This does not happen automatically; be sure to check the appropriate boxes.
- Refunds for a Flutterwave payment are disabled by default. To enable this feature, contact Flutterwave support. To learn more about refunds for Flutterwave payments, click here.
- The payment will fail if the email field is not included on the order form.
3. Supported currencies and restrictions
Before receiving payments, please ensure your funnels and products are set up with one of the currencies supported by this gateway.
- Supported buyers: Africa and International
- Recurring payments (subscriptions): Yes
- Supported currencies: CAD, CLP, COP, EGP, EUR, GBP, GHS, GNF, KES, MAD, MWK, NGN, RWF, SAR, SLL, STD, TZS, UGX, USD, XAF, XOF, ZAR, and ZMW.
- Merchant restrictions: Your Flutterwave merchant account must be registered in an African country.
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.