---
title: How to Connect Flutterwave to OneSuite
description: "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…"
url: "https://help.onesuite.io/docs/how-to-connect-flutterwave-to-onesuite/"
updated: "2026-11-16"
category: Payment Integration
---

# How to Connect Flutterwave to OneSuite

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?

1. Click your name at the bottom of the sidebar, then click **Settings**.
2. Under **Integrations**, click **Payment**.
3. On the **Payment Methods** page, find **Flutterwave** and click **Connect**.
4. Keep the dialog open.
5. In Flutterwave, open **Settings**, then **API Keys**.
6. Copy your secret key.
7. Paste it into **Secret key** in OneSuite.
8. Choose a long random value for the secret hash.
9. Paste it into **Secret hash** in OneSuite.
10. Add the webhook in Flutterwave. The next section shows how.
11. Check the **Currency** setting.
12. Click **Save**.

![](https://help.onesuite.io/wp-content/uploads/2026/11/open-payment-settings-in-onesuite-1-925x1024.png)

## How do I add the Flutterwave webhook?

1. In the OneSuite dialog, click the copy button next to **Webhook URL for your Flutterwave dashboard**.
2. In Flutterwave, open **Settings**, then **Webhooks**.
3. Paste the OneSuite URL.
4. Set the **Secret hash** to the same value you entered in OneSuite.
5. Tick all four boxes:
   - **Receive webhook response in JSON format**
   - **Enable webhook retries**
   - **Enable webhook for failed transactions**
   - **Enable V3 webhooks**
6. 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:

1. Open the invoice.
2. Switch Flutterwave on in its **Payments** panel.
3. 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](https://flutterwave.com/gh/support/my-account/getting-your-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](https://help.onesuite.io/docs-category/payment-integration/).

**Record the money that arrives:** Log payments made outside a gateway with [How to Record Invoice Payments](https://help.onesuite.io/docs/how-to-record-invoice-payments/).
