How to integrate Paystack with

In this article, you'll learn how to integrate your Paystack account with your account.

What you'll need :

Create or sign in to your Paystack account:

If you already have a Paystack account, please log in. Otherwise, if you don't yet have an account, you can create a Paystack account by clicking here to use this payment gateway in

Note: The supported currency will depend on the selected country.

Creating a Paystack bank subaccount:

Within your Paystack account, you'll need to create a subaccount that contains bank details. To do this, go to the Paystack dashboard, to "Subaccounts" in the "Payments" section, then click on "New Subaccount".

A popup window will appear to allow you to complete the process of generating your new subaccount.

How to generate the secret access token:

From the Paystack dashboard, click on "Settings" on the left-hand panel, then go to the "Api Keys & Webhooks" tab. Once there, make your secret token visible by clicking on the eye icon, then copy it.

Integrating your Paystack account on

In your account, click on your profile photo, then on "Settings" (number 1 in the image), then redirect to "Payment gateways" (number 2 in the image).

On the payment gateways page, click on "Connect" for Paystack (number 3 in the image).

Enter the secret access token you copied from Paystack, making sure to select the subaccount you created from the drop-down menu, then press "Save" to validate the integration of your Paystack payment gateway on

After adding the secret access token and selecting the subaccount, the Paystack integration will be in the "Synchronization" phase on your account. Once this has been finalized, you'll see the webhook URL appear on the connected gateways page.

Webhook configuration:

Copy the webhook URL generated on, then return to the Paystack dashboard, go to "Settings" on the left-hand side panel, and paste the webhook URL into the Webhook URL entry in the "API Keys & Webhooks" section.

Notes :

1. To connect your Paystack account, you must add our IP "" to the IT Whitelist.

2. If the customer is using the Paystack payment method for the first time, it is necessary to authorize the payment method for future subscription debits. Therefore, when purchasing a subscription, the amount displayed will not correspond to the subscription amount, but rather to the minimum amount authorized (for example, 1 ZAR). Once authorized, the amount will be refunded to the customer's card and the subscription fee will be debited according to the subscription plan.

3. Paystack does not support multiple intervals, you can only set up plans where the payment interval is every day/week/month/year, you cannot for example set up a plan where the payment is every 2 or 3 days/weeks/months/years.

4. "Email", "Last name" and "First name" fields are mandatory on your payment pages for payment via Paystack to work correctly.

5. Paystack supports a wide range of currencies, including GHS, NGN, KES and ZAR.

6. If you'd like to enable dollar payments, Paystack offers you this option. Please see the following articles:

What happens when a Paystack payment fails?

Currently, Paystack does not make any new direct debit attempts when a payment fails.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.