Connect Flutterwave so your clients can pay invoices online through it. Go to Settings > Integrations > Payment and click Connect on the Flutterwave card. Paste your Secret key and choose a long random Secret hash. Add the OneSuite webhook URL in Flutterwave with the same secret hash. Tick all four boxes there. Then click Save in OneSuite.
In this guide you’ll learn how to:
- Find your Flutterwave secret key
- Choose a secret hash and add it in both places
- Add the OneSuite webhook URL in Flutterwave
- Switch Flutterwave on for an invoice
Before you start
- You need a Flutterwave account and access to its Dashboard.
- You need access to Settings. If you can’t see Integrations, ask an admin.
- Your secret key is a private code from Flutterwave. It lets OneSuite work with your Flutterwave account. Keep it private.
- A secret hash is a private value that you make up yourself.
- A webhook is a web address that Flutterwave uses to tell OneSuite about a payment.
- Flutterwave has a test mode for practice and a live mode for real payments. Use the test secret key to try Flutterwave out. Use the live secret key to take real payments.
- Add the webhook in the dashboard for the same mode as your secret key.
What does OneSuite ask for when you connect Flutterwave?
| Field | Where to find it | Required |
|---|---|---|
| Secret key | In your Flutterwave Dashboard, open Settings, then API Keys. The test key starts with FLWSECK_TEST- | Yes |
| Secret hash | A value you choose. Type it in your Flutterwave Dashboard under Settings, then Webhooks. Choose a long random value and paste the same value here. | Yes |
| Currency | Starts as Nigerian Naira (NGN). OneSuite uses it when an invoice has no currency of its own. | No |
The dialog also has a Webhook URL for your Flutterwave dashboard box. Next to it is a copy button.
How do I connect Flutterwave to OneSuite?
- Click your name at the bottom of the sidebar, then click Settings.
- Under Integrations, click Payment.
- On the Payment Methods page, find Flutterwave and click Connect.
- Keep the dialog open.
- In Flutterwave, open Settings, then API Keys.
- Copy your secret key.
- Paste it into Secret key in OneSuite.
- Choose a long random value for the secret hash.
- Paste it into Secret hash in OneSuite.
- Add the webhook in Flutterwave. The next section shows how.
- Check the Currency setting.
- Click Save.

How do I add the Flutterwave webhook?
- In the OneSuite dialog, click the copy button next to Webhook URL for your Flutterwave dashboard.
- In Flutterwave, open Settings, then Webhooks.
- Paste the OneSuite URL.
- Set the Secret hash to the same value you entered in OneSuite.
- Tick all four boxes:
- Receive webhook response in JSON format
- Enable webhook retries
- Enable webhook for failed transactions
- Enable V3 webhooks
- Save your changes. Use the dashboard for the same mode as your secret key.
Flutterwave sends every payment to that one URL. Any payment not made through a OneSuite invoice is ignored.
How do I check if it worked?
The Flutterwave card on the Payment Methods page now says Connected instead of Not connected. You also see Flutterwave marked Connected under Invoices > Configure > Getting paid > Online payments.
Once you connect Flutterwave, OneSuite switches it on for every new invoice. An invoice you created earlier keeps its own choice. To use Flutterwave on an older invoice:
- Open the invoice.
- Switch Flutterwave on in its Payments panel.
- Save the invoice and send it again.
If something goes wrong
If you can’t find API Keys or Webhooks in Flutterwave, look for a Developers section under Settings. Flutterwave’s guide to API keys shows the path.
FAQs
What is the Flutterwave secret hash?
It is a value you make up. Enter a long random value in Flutterwave under Settings, then Webhooks. Paste the same value into Secret hash in OneSuite.
Which webhook boxes do I tick?
Tick all four: Receive webhook response in JSON format, Enable webhook retries, Enable webhook for failed transactions and Enable V3 webhooks.
Can I try Flutterwave with a test key first?
Yes. The test secret key lets you try Flutterwave out. Switch to the live secret key to take real payments, and add the webhook in the dashboard for the same mode.
What to do next
See every gateway: Browse all the guides in Payment Integration.
Record the money that arrives: Log payments made outside a gateway with How to Record Invoice Payments.