Enabling Paystack

Connect Paystack under Settings > Payments to accept hosted online payments and process full or partial order refunds through Paystack. Customers who select Paystack at checkout are redirected to Paystack's hosted payment page to complete payment and then return to your store.

Before you start

• Sign in as the store owner or with a staff account that has permission to manage Payments. Staff accounts without Payments permission cannot open the Paystack settings page.
• Have an eligible Paystack merchant account. Paystack operates in supported African markets (including Nigeria, Ghana, Kenya, South Africa and Côte d'Ivoire); complete business activation in your Paystack Dashboard before accepting live payments, and verify that USD settlement is enabled on your Paystack account if your store charges in USD.
• Confirm that your store currency is supported by the Paystack integration: GHS, KES, NGN, USD, XOF or ZAR. While this guide uses USD examples, a USD store currency does not by itself establish merchant or currency eligibility on your Paystack account.
• Copy your test and live API keys under Settings > API Keys & Webhooks in your Paystack Dashboard.

Open the Paystack setup

1. In your Nevuto admin, go to Settings > Payments.
2. Click Add payment in the upper-right corner, then select Add payment provider.
3. In the Add payment method modal, enter Paystack in Enter payment method. Clear any category tab filter if it hides the result.
4. Select the Paystack card to open its setup form.

If Paystack is already configured on your store, click its row on Settings > Payments or open the row's three-dot menu and select Manage. Opening the setup form does not connect or activate Paystack until you submit valid credentials. Select any screenshot to view it at full size.

Match Paystack API keys to the Nevuto fields

In your Paystack Dashboard, open Settings > API Keys & Webhooks to locate your Public Key and Secret Key for Test Mode and Live Mode. See Paystack's authentication documentation for details on Paystack key prefixes.

Match your Paystack credentials to the fields in Nevuto:

• Public key: Your live Paystack Public Key (starts with pk_live_).
• Secret key: Your live Paystack Secret Key (starts with sk_live_).
• Sandbox public key (inside Sandbox mode): Your test Paystack Public Key (starts with pk_test_).
• Sandbox secret key (inside Sandbox mode): Your test Paystack Secret Key (starts with sk_test_).

Configure sandbox mode

1. In the Paystack setup form under Configure API keys, click Sandbox mode to expand the test fields.
2. Paste your Test Public Key (pk_test_...) into Sandbox public key.
3. Paste your Test Secret Key (sk_test_...) into Sandbox secret key. You can leave the live Public key and Secret key fields blank while setting up only sandbox testing.
4. Turn on Enable sandbox mode so Nevuto uses your test credentials.
5. Turn on Enable payment status when you want Paystack offered at checkout during testing.
6. Review Payment Limits if you want to restrict Paystack by cart total.
7. Click Submit in the upper-right corner and wait for the confirmation toast.

When you click Submit, Nevuto validates the active mode's Secret Key with Paystack before saving. On a successful first save, Nevuto returns to Settings > Payments. Reopen Paystack to confirm that your keys were saved and to access the Paystack webhook card.

In the Payments list, Active or Inactive indicates whether customers see Paystack at checkout, while Sandbox or Live shows which credential pair is active.

This screenshot shows an unsaved example. All four credential fields are intentionally empty and Enable payment status is off. Enter your own Paystack test keys before clicking Submit.

Copy the Paystack webhook URL after saving

After you save Paystack for the first time and reopen Settings > Payments > Paystack, Nevuto displays a Paystack webhook card above Payment Limits (when your store's public webhook URL is available):

1. In the Paystack webhook card in Nevuto, click Copy next to the read-only webhook URL.
2. In your Paystack Dashboard, open Settings > API Keys & Webhooks.
3. Paste the copied address into Paystack's Test Webhook URL field (while testing) or Live Webhook URL field (when going live) and save your changes in Paystack. See Paystack's webhooks guide for where to paste the URL.

Configuring the webhook URL allows refunds processed in your Paystack Dashboard to sync immediately to your Nevuto orders.

Test the hosted checkout flow

After saving your sandbox settings, test a complete customer checkout and return path before switching to live keys. Review Paystack's test payments documentation for official test cards and simulated payment options. Never use a real payment card in sandbox mode.

To run your own merchant test after saving sandbox credentials:

1. Add a product to your storefront cart in a supported currency (such as USD or NGN) and proceed to checkout.
2. Select Paystack as the payment method and continue to Paystack's hosted checkout page.
3. Complete the payment using one of Paystack's official test cards.
4. Wait for Paystack to redirect back to your store and confirm that the order is marked as paid in Nevuto.
5. In your Paystack Dashboard (with Test Mode enabled), open Transactions and confirm that the test payment status is Success and matches the Nevuto order total.
6. Also test a declined test card or cancel the hosted payment page to verify that unsuccessful attempts return to checkout without marking the order as paid.

An Active badge in Settings > Payments only confirms that your secret key passed the save-time check; always verify a complete checkout round-trip before going live.

Set payment limits

Use Payment Limits to control which cart totals can use Paystack at checkout. Turn on the Payment Limits switch and enter a Minimum Cart Amount and Maximum Cart Amount in your store currency. The minimum amount cannot exceed the maximum amount.

Switch to live payments

After your sandbox tests pass and your Paystack business account is approved for live transactions:

1. In your Paystack Dashboard, open Settings > API Keys & Webhooks and copy your Live Public Key (pk_live_...) and Live Secret Key (sk_live_...).
2. In Nevuto, open Settings > Payments and select Paystack.
3. Paste your Live Public Key into Public key and your Live Secret Key into Secret key.
4. Copy the URL from the Paystack webhook card in Nevuto and paste it into the Live Webhook URL field in your Paystack Dashboard.
5. Expand Sandbox mode and turn off Enable sandbox mode.
6. Confirm Enable payment status and Payment Limits are set as intended.
7. Click Submit and verify that Settings > Payments lists Paystack as Active in Live mode. Reopen Paystack to confirm your live keys are stored.

Your test keys can remain in the sandbox fields; turning off Enable sandbox mode switches Nevuto to your live credentials.

Edit, refund, or deactivate Paystack

Open Paystack from Settings > Payments (or choose Manage from the row's three-dot menu ) any time you need to rotate API keys, switch environments or adjust cart limits. Submit stays disabled until you change a field on the form.

Paystack supports full and partial order refunds directly from Nevuto Admin orders, and syncs refunds initiated in your Paystack Dashboard when the Paystack webhook URL is configured.

To stop offering Paystack at checkout without deleting your keys, turn off Enable payment status and click Submit, or open the three-dot menu on the Paystack row in Settings > Payments and select Deactivate. Choosing Delete from the three-dot menu removes the saved Paystack configuration from your store. Deactivating or deleting Paystack only affects new checkouts and does not cancel or refund past orders.

Troubleshooting