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?
- Click your name at the bottom of the sidebar, then click Settings.
- Under Integrations, click Payment.
- On the Payment Methods page, find Paystack and click Connect. Keep the dialog open.
- In Paystack, open Settings, then API Keys & Webhooks. Copy your secret key.
- Paste it into Secret key in OneSuite.
- Add the webhook URL in Paystack. The next section shows you how.
- Check the Currency setting.
- Click Save.

How do I add the Paystack webhook?
Do this while the OneSuite dialog is still open.
- In the OneSuite dialog, click the copy button beside Webhook URL for your Paystack dashboard.
- In Paystack, open Settings, then API Keys & Webhooks.
- 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:
- Open the invoice.
- Switch Paystack on in its Payments panel.
- 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.
Record the money that arrives: Log payments made outside a gateway with How to Record Invoice Payments.