Connect Flutterwave

Take cards, mobile money and bank transfer across Africa through your own Flutterwave account - secret key, webhook, test mode and going live.

Flutterwave lets customers pay by card, mobile money and bank transfer across Africa (NGN, GHS, KES, ZAR, UGX, TZS, RWF, XAF, XOF, plus USD, EUR and GBP).

Before you start

• A Flutterwave business account. Test keys work straight away; live mode needs your business approved (KYB).
• You must be an admin of the business in Ellibo.

Step 1: Get your secret key

1. Sign in to the Flutterwave Dashboard.
2. Go to Settings › API Keys (under Developers).
3. Use the Test / Live switch in the settings menu to choose the mode.
4. Copy the Secret Key - it starts with FLWSECK, and test keys contain TEST.

Step 2: Connect in Ellibo

1. Open Settings › Integrations › Payments.
2. On the Flutterwave tile, click Connect.

Step 3: Add the webhook

1. In Ellibo, under Your gateways › Flutterwave, click Copy next to Webhook URL.
2. In Flutterwave, go to Settings › Webhooks (same mode).
3. Paste the address and tick all the boxes.
4. Flutterwave asks for a secret hash - type any password of your own. (Ellibo checks every payment directly with Flutterwave, so it isn't needed in Ellibo.)
5. Click Save.

Step 4: Try a test payment

1. With the test key connected, open a small invoice's Pay now link and choose Flutterwave.
2. Pay with one of the test cards in Flutterwave's developer docs.
3. Check the invoice shows Paid, then cancel the test receipt.

Step 5: Go live

Switch Flutterwave to Live, copy the live secret key, paste it in Ellibo under Keys, Save, and add the webhook again in live mode.

Fees, payouts and refunds

• Flutterwave usually pays out the next working day for local currencies. Record payouts in Accounting › Online Payments.
• Refund with the Refund button in Ellibo.

If something goes wrong

See also Fix payment problems.