# Connect your Paystack account

> Take cards, bank transfers, USSD and mobile money in Nigeria, Ghana, South Africa, Kenya and Côte d'Ivoire with your own Paystack account. In Settings > Payments, click Set up Paystack, paste your secret key, switch it on and click Save settings.

Help Centre / Payments - Updated 19 November 2026

Paystack is the most used way to pay online in Nigeria, Ghana, South Africa, Kenya and Côte d'Ivoire. When you connect your Paystack account, your customers can pay by card, by bank transfer, with USSD, with mobile money, or with the other payment methods you have switched on in Paystack. Payments go straight to your Paystack account, and Shoprocket takes 0%.

Your customers pay without leaving your shop. When they click **Pay now**, Paystack's payment window opens on top of your checkout. They pay there, the window closes, and they see their order confirmation. Card details go straight to Paystack and never pass through Shoprocket.

## Before you start

You need a Paystack business account. Your secret key is in your Paystack dashboard, under **Settings > API Keys & Webhooks**. Paystack gives every account two secret keys:

- the **test secret key**, which starts with `sk_test_`, for trying your checkout without real money
- the **live secret key**, which starts with `sk_live_`, for taking real payments once Paystack has activated your business

Copy the secret key, not the public key. The public key starts with `pk_` and Shoprocket doesn't need it.

## Connect Paystack

1. In your dashboard, go to **Settings > Payments**.
2. On the Paystack card in **Payment gateways**, click **Set up Paystack**.
3. Paste your secret key into the **Secret Key** field.
4. Turn Paystack's switch to **On**.
5. Click **Save settings**.

![The Paystack card in Settings > Payments: Connected with a test key, the currency the account takes, and the webhook URL with its Copy button](https://shoprocket.io/img/help/connect-paystack/paystack-card.webp)

When you save, Shoprocket checks your key with Paystack. If Paystack rejects it, nothing is saved and a message at the top of the screen says why. The card then says **Connected**, and Paystack appears at your checkout.

## Add your webhook URL in Paystack

Once Paystack is connected, its card shows a **Webhook URL**. Paystack uses it to tell Shoprocket about payments that finish later, such as a bank transfer a customer completes after closing the payment window. It also uses it to tell Shoprocket about refunds you make in Paystack itself.

1. Click the copy button next to the webhook URL.
2. In your Paystack dashboard, go to **Settings > API Keys & Webhooks**.
3. Paste the URL into **Webhook URL** and save.
4. Switch Paystack to the other mode (test or live) and paste the same URL there too.

Your orders are still confirmed without the webhook URL, because Shoprocket checks each payment with Paystack itself. Adding it means a late payment shows on its order straight away.

## The currency your account takes

A Paystack account takes payments in the currency of the country it is registered in: naira in Nigeria, cedis in Ghana, rand in South Africa, shillings in Kenya and CFA francs in Côte d'Ivoire. Businesses in Nigeria and Kenya can also ask Paystack to add US dollars.

When you save your key, Shoprocket asks Paystack which currencies your account holds. If it holds only one, the card shows it, and Paystack appears at checkout only for customers paying in that currency. If your shop is priced in a different currency, the card warns you, and you can still offer Paystack to customers paying in its currency under **Card gateway by currency**, as [Choose a payment gateway](https://shoprocket.io/help/choose-a-payment-gateway.md) explains.

## Try it with a test key

Paste your test secret key to try your checkout without moving real money. The card then shows **Test key: no real money moves**. Paystack's developer documentation lists the test cards to use.

When you are ready to sell, click **Edit Paystack credentials**, paste your live secret key, and click **Save settings**.

## How customers pay

- **By card**: the customer types their card into Paystack's window. If their bank needs to check the payment with a PIN, a one-time code or a 3D Secure check, that happens in the same window.
- **By bank transfer, USSD or mobile money**: Paystack's window shows the account to pay into, the code to dial, or the prompt to approve on their phone. The order is confirmed as soon as the money arrives.

If a customer closes Paystack's window without paying, they are back in your checkout with everything they typed, and can try again.

You don't need to do anything for any of these. Shoprocket marks the order paid when Paystack confirms the payment, and sends your usual order emails.

## Refunds

When you refund an order paid with Paystack, the money goes back to the customer automatically, in full or in part. See [Refund an order](https://shoprocket.io/help/refund-an-order.md). Paystack takes a little while to process a refund, so it shows as pending on the order until Paystack confirms it. A refund you make in your Paystack dashboard also appears on the order in Shoprocket, once your webhook URL is added.

## Subscriptions

Paystack can renew subscriptions. When a customer buys a subscription with their card, Paystack saves the card, and Shoprocket charges it on each renewal date without the customer having to come back. A renewal paid by bank transfer, USSD or mobile money can't be charged again automatically, so customers buying a subscription should pay by card.

If a renewal is declined, Shoprocket tries again over the following days and lets the customer know, as it does with every gateway.

## Changing your key or turning it off

Once Paystack is connected, its button reads **Edit Paystack credentials**. Your saved key is stored encrypted and never shown again. The card shows only its last four characters. To keep it, leave the field blank. To replace it, paste the new key and click **Save settings**.

To stop offering Paystack, turn its switch to **Off** and click **Save settings**. Your key stays saved, so you can switch it back on at any time.

## Related

- [Choose a payment gateway](https://shoprocket.io/help/choose-a-payment-gateway.md)
- [Refund an order](https://shoprocket.io/help/refund-an-order.md)
- [Take a test order](https://shoprocket.io/help/take-a-test-order.md)

[Open Payments in your dashboard](https://app.shoprocket.io/go/settings/payments)

---

- HTML version: https://shoprocket.io/help/connect-paystack
- Language: English (en)
- Also in: [العربية](https://shoprocket.io/ar/help/connect-paystack.md), [Deutsch](https://shoprocket.io/de/hilfe/paystack-konto-verbinden.md), [Ελληνικά](https://shoprocket.io/el/help/connect-paystack.md), [Español](https://shoprocket.io/es/ayuda/conectar-paystack.md), [Français](https://shoprocket.io/fr/aide/connecter-paystack.md), [עברית](https://shoprocket.io/he/help/connect-paystack.md), [हिन्दी](https://shoprocket.io/hi/help/connect-paystack.md), [Bahasa Indonesia](https://shoprocket.io/id/bantuan/hubungkan-akun-paystack.md), [Italiano](https://shoprocket.io/it/aiuto/collega-paystack.md), [日本語](https://shoprocket.io/ja/help/connect-paystack.md), [Lietuvių](https://shoprocket.io/lt/pagalba/prijunkite-paystack-paskyra.md), [Norsk](https://shoprocket.io/nb/hjelp/koble-til-paystack-kontoen-din.md), [Nederlands](https://shoprocket.io/nl/hulp/paystack-account-koppelen.md), [Polski](https://shoprocket.io/pl/pomoc/polacz-konto-paystack.md), [Português](https://shoprocket.io/pt/ajuda/conectar-paystack.md), [Română](https://shoprocket.io/ro/ajutor/conecteaza-contul-paystack.md), [Русский](https://shoprocket.io/ru/help/connect-paystack.md), [ไทย](https://shoprocket.io/th/help/connect-paystack.md), [Türkçe](https://shoprocket.io/tr/yardim/paystack-hesabi-baglama.md), [中文](https://shoprocket.io/zh/help/connect-paystack.md)
