---
title: How to Connect Paystack to OneSuite
description: "Connect Paystack so your clients can pay invoices online through it. Go to **Settings** > **Integrations** > **Payment** and click **Connect** on the Paystack card. Paste your Paystack **Secret key**, choose a **Currency**, and copy the webhook URL into Paystack. Then click **Save**. **In this guide you'll learn how to:** -…"
url: "https://help.onesuite.io/docs/how-to-connect-paystack-to-onesuite/"
updated: "2026-11-18"
category: Payment Integration
---

# How to Connect Paystack to OneSuite

Connect Paystack so your clients can pay invoices online through it. Go to **Settings** > **Integrations** > **Payment** and click **Connect** on the Paystack card. Paste your Paystack **Secret key**, choose a **Currency**, and copy the webhook URL into Paystack. Then click **Save**.

**In this guide you'll learn how to:**

- Find your Paystack secret key
- Choose between a test key and a live key
- Add the OneSuite webhook URL in Paystack
- Switch Paystack on for an invoice

## Before you start

- You need a Paystack 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 Paystack. It lets OneSuite work with your Paystack account. Keep it private.
- A webhook is a web address. Paystack uses it to tell OneSuite about a payment.
- Use the test secret key to try Paystack out. Test mode is a practice mode with no real payments.
- Use the live secret key to take real payments. Paystack's guide says live keys work after your account is activated.

## What does OneSuite ask for when you connect Paystack?

| Field | Where to find it | Required |
| --- | --- | --- |
| **Secret key** | In the Paystack Dashboard, open **Settings**, then **API Keys & Webhooks**. The test key starts with sk_test_ and the live key with sk_live_. | Yes |
| **Currency** | Starts as **Nigerian Naira (NGN)**. OneSuite uses it when an invoice has no currency of its own. | No |

The dialog also shows a **Webhook URL for your Paystack dashboard** box with a copy button.

## How do I connect Paystack 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 **Paystack** and click **Connect**. Keep the dialog open.
4. In Paystack, open **Settings**, then **API Keys & Webhooks**. Copy your secret key.
5. Paste it into **Secret key** in OneSuite.
6. Add the webhook URL in Paystack. The next section shows you how.
7. Check the **Currency** setting.
8. Click **Save**.

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

## How do I add the Paystack webhook?

Do this while the OneSuite dialog is still open.

1. In the OneSuite dialog, click the copy button beside **Webhook URL for your Paystack dashboard**.
2. In Paystack, open **Settings**, then **API Keys & Webhooks**.
3. Paste the URL into the **Webhook URL** field for the same mode as your secret key, test or live.

Paystack sends every event to that one URL. OneSuite ignores payments that were not made through its invoices. If another app already uses that field, replacing it stops that app's notifications.

## How do I check it worked?

The Paystack card on the **Payment Methods** page now says **Connected** instead of **Not connected**. You also see Paystack marked **Connected** under **Invoices** > **Configure** > **Getting paid** > **Online payments**.

OneSuite switches a connected gateway on for every new invoice. An invoice you created earlier keeps its own choice. To use Paystack on an older invoice:

1. Open the invoice.
2. Switch Paystack on in its **Payments** panel.
3. Save the invoice and send it again.

## FAQs

### Can I try Paystack with a test key first?

Yes. Use the test secret key to try Paystack out and the live secret key for real payments. Add the webhook URL for the same mode as your key.

### What happens to my other apps if I add the OneSuite webhook URL?

Paystack sends all events to a single URL. If another app already uses that field, replacing its URL stops that app's notifications.

### Which currency does Paystack use in OneSuite?

The **Currency** list starts as Nigerian Naira (NGN). OneSuite applies it to any invoice that has no currency of its own.

## 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/).
