PAYMENT INTEGRATION • NIGERIA

How to Add Paystack to a WordPress Website in Nigeria

Step-by-step guide to integrating Paystack on your Nigerian WordPress website — API keys, webhooks, test mode, and fixing common setup errors.

You have a WordPress website. Now you need to accept payments.

Paystack is the most popular payment gateway in Nigeria for a reason: it accepts cards, bank transfers, USSD and mobile money, and its checkout experience is smooth. But integrating it correctly on WordPress requires care — especially the webhook setup that most guides skip.

This guide walks you through the full process, whether you are using WooCommerce, a donation form, or a simple payment form. It also covers the errors most Nigerian site owners run into and how to fix them.

Quick answer:

To add Paystack to WordPress: (1) create a Paystack account and get your API keys, (2) install the correct Paystack plugin for your site type (WooCommerce, Payment Forms, Give, etc.), (3) enter your Test API keys and enable Test Mode, (4) configure the Webhook URL in your Paystack dashboard, (5) test with a test card, and (6) switch to Live API keys when ready.

The webhook setup is the step most people miss — and without it, orders can stay "Pending" even after successful payment.

Before You Start: What You Need

Before you begin, make sure you have all of the following ready. Missing any one of these will block your integration.

  • A WordPress website with admin access
  • A Paystack account (personal or business) — you can sign up at paystack.com
  • A Nigerian bank account linked to your Paystack account
  • HTTPS (SSL certificate) active on your domain — Paystack rejects non-secure webhook endpoints
  • The right Paystack plugin for your site type (WooCommerce, Payment Forms, Give, etc.)
  • Access to your Paystack dashboard to retrieve API keys
Important: If your WordPress site does not have HTTPS (the padlock icon), get an SSL certificate first. Paystack will not process live payments on an insecure site. Most hosting providers offer free SSL via Let's Encrypt.

Which Paystack Plugin Do You Need?

Paystack offers different plugins depending on what you are selling. Choosing the wrong one wastes time. Here is a quick guide.

What You Are Selling Plugin to Use Best For
Physical products (multiple items, cart) Paystack WooCommerce Payment Gateway Online stores, boutiques, grocery shops
Single payments, donations, simple forms Payment Forms for Paystack Donations, event tickets, single-product sales
Digital products (ebooks, software) Paystack Easy Digital Downloads Selling downloads, courses, licences
Donations for NGOs and churches Give — Paystack Gateway Charities, churches, fundraising campaigns
Memberships and subscriptions Paystack for Paid Memberships Pro Premium content, clubs, associations
Event ticketing Paystack Gateway for The Events Calendar Concerts, conferences, workshops

If you are not sure which one fits, the Paystack WordPress introduction guide explains each category in detail [citation:3].

Step 1: Get Your Paystack API Keys

1 Log Into Your Paystack Dashboard

Go to dashboard.paystack.com and log in. If you do not have an account yet, sign up at paystack.com first.

2 Switch Between Test and Live Mode

At the top right of your dashboard, you will see a toggle for Test Mode and Live Mode. Test Mode is for development and testing. Live Mode is for real payments.

If you only see Test Mode and no toggle, your Paystack account has not been fully activated yet. Complete your business verification first.

3 Retrieve Your API Keys

In your Paystack dashboard, go to Settings then API Keys & Webhooks. You will see:

  • Test Public Key (starts with pk_test_)
  • Test Secret Key (starts with sk_test_)
  • Live Public Key (starts with pk_live_)
  • Live Secret Key (starts with sk_live_)

Copy the keys you need. Never share your Secret Key publicly. If you are starting out, use the Test keys first.

Step 2: Install the Paystack Plugin

1 Log Into Your WordPress Dashboard

Go to yourdomain.com/wp-admin and log in.

2 Install the Plugin

Navigate to Plugins > Add New. In the search box, type the name of the Paystack plugin you identified in the previous section (for example, "Paystack WooCommerce Payment Gateway" or "Payment Forms for Paystack").

Find the plugin published by Paystack (look for the verified blue icon). Click Install Now, then Activate.

3 (WooCommerce Users Only)

If you are using WooCommerce, make sure the WooCommerce plugin is installed and activated before the Paystack plugin. The Paystack WooCommerce plugin will not work without it.

Step 3: Configure Paystack Settings

The exact menu location depends on which plugin you installed. Here are the settings you need to configure regardless of plugin.

For WooCommerce Users

Go to WooCommerce > Settings > Payments. Find Paystack in the list and click Manage.

For Payment Forms Users

Go to the Paystack Forms tab in your WordPress dashboard, then click API Keys Settings.

For Give (Donations) Users

Go to Donations > Settings > Payment Gateways > Paystack.

Configure the following settings:

  • Enable Paystack: Check the box so Paystack appears at checkout
  • Title: What customers see (e.g., "Pay with Card, Bank Transfer or USSD")
  • Description: A short explanation of the payment option
  • Test Mode: Enable this while testing (uses Test API keys)
  • Payment Option: Choose "Popup" (payment opens in a modal) or "Redirect" (customer goes to a separate Paystack page). Popup usually converts better.
  • Test Public Key: Paste your pk_test_ key
  • Test Secret Key: Paste your sk_test_ key
  • Live Public Key: Leave blank for now, fill in when going live
  • Live Secret Key: Leave blank for now
Currency note: Paystack supports NGN (₦), GHS, USD, KES, ZAR, and a few other currencies. Make sure your WooCommerce or plugin currency is set to one of these. If your store currency is unsupported, Paystack will not appear at checkout [citation:4].

Step 4: Set Up the Webhook (Critical)

This is the step most guides skip — and the reason many Nigerian store owners see orders stuck on "Pending" even after customers pay successfully. The webhook tells your WordPress site that a payment has completed, even if the customer closed their browser before being redirected back.

1 Copy Your Webhook URL

In your WordPress plugin settings page (the same page where you entered your API keys), look for a Webhook URL field. It is usually displayed in red or in a highlighted box.

The URL format varies by plugin. For WooCommerce, it typically looks like:

https://yourdomain.com/?wc-api=WC_Gateway_Paystack

For Paid Memberships Pro, it looks like:

https://yourdomain.com/pmpro/wp-admin/admin-ajax.php?action=pmpro_paystack_ipn

Copy the exact URL shown in your plugin settings [citation:1][citation:2].

2 Paste It in Your Paystack Dashboard

Go back to your Paystack dashboard. Navigate to Settings > API Keys & Webhooks. Find the Webhook URL field. Paste the URL you copied. Click Save Changes.

3 Verify the Webhook Works

After making a test purchase, go to your Paystack dashboard and check Logs > Webhook. You should see a successful delivery (HTTP 200 response) for your test transaction. If you see a failure, check that your site URL is correct and that HTTPS is working.

Step 5: Test in Test Mode

Never go live without testing first. Paystack provides test cards that simulate successful and failed payments without using real money.

Common Test Cards

  • Successful payment: 4084 0840 8408 4081 (any future expiry, CVV 408, PIN 0000)
  • Insufficient funds: 4084 0800 0000 0408
  • Declined: Use the successful card with a wrong CVV

What to Check After a Test Payment

  • The order status in WordPress updates from Pending to Processing (WooCommerce)
  • The transaction appears in your Paystack dashboard under Test Mode
  • The webhook log shows a successful delivery
  • The customer receives a confirmation email (if you have that set up)

If the order stays on "Pending" after payment, the webhook is the most likely problem. Re-check the URL in both your plugin settings and your Paystack dashboard.

Step 6: Switch to Live Mode

Once testing works perfectly, you are ready to accept real payments.

  1. In your WordPress plugin settings, uncheck "Test Mode".
  2. Paste your Live Public Key and Live Secret Key into the corresponding fields.
  3. Save your changes.
  4. Verify that Paystack still appears as a payment option on your checkout page.
  5. Make one real small transaction (for example, ₦100) to confirm everything works end-to-end.

After that first live transaction succeeds and the order status updates correctly, your Paystack integration is complete.

Troubleshooting Common Paystack Errors

These are the most common issues Nigerian WordPress users encounter with Paystack, and how to fix them.

Paystack Not Showing at Checkout

Check three things: (1) the "Enable Paystack" box is ticked, (2) your API keys are entered correctly (Test keys when in Test Mode), and (3) your store currency is supported (NGN, GHS, USD, KES, ZAR, etc.).

Order Stays "Pending" After Payment

This is almost always a webhook problem. Check that the Webhook URL in your Paystack dashboard exactly matches the one in your plugin settings. Also confirm your site has HTTPS — Paystack will not deliver webhooks to insecure URLs.

"Paystack Does Not Support Your Store Currency"

Go to WooCommerce > Settings > General and change your currency to NGN (₦) or another Paystack-supported currency. If you need multi-currency, use a currency switcher that supports Paystack.

Payment Deducted but Order Not Created

This usually means the webhook failed and the customer was not redirected back. Check the Paystack dashboard to confirm the payment was received. You may need to manually mark the order as paid, and fix the webhook for future orders.

Plugin Conflict

If Paystack disappears after installing another plugin (like a caching or security plugin), the other plugin may be interfering. Temporarily deactivate it, test again, and adjust its settings to exclude checkout pages.

Old Plugin Version

If your Paystack plugin has not been updated in over a year, it may not be compatible with the latest WooCommerce or WordPress version. Update the plugin, or switch to a newer one. The official Paystack WooCommerce plugin is regularly maintained [citation:4].

Frequently Asked Questions

Do I need a business account to use Paystack on WordPress?

For live payments, yes — you need a fully activated Paystack business account with a linked Nigerian bank account. You can use a personal account for testing, but live payouts require business verification.

How much does Paystack charge per transaction?

Paystack charges a percentage per successful transaction (typically 1.5% + ₦100 for local transactions, capped at ₦2,000). Check the Paystack website for current rates, as they can change.

Can I use Paystack without WooCommerce?

Yes. The Payment Forms for Paystack plugin works on any WordPress site without WooCommerce. It is ideal for single-product sales, donations, event tickets and simple payment collection.

What is a webhook and why do I need it?

A webhook is an automatic message Paystack sends to your website when a payment event happens. Without it, your site may not know that a payment completed, leaving orders stuck on "Pending."

Can I accept payments from outside Nigeria?

Yes. Paystack accepts internationally-issued cards. Your customers can pay from anywhere in the world, and funds settle to your Nigerian account.

What if I see "Paystack Payment Gateway Disabled" error?

This usually means your store currency is not supported, or your API keys are missing or incorrect. Check both the currency setting and the key fields.

How long does it take to receive payouts?

Paystack typically settles transactions to your bank account within 1 to 2 business days (T+1). Some accounts may have different settlement schedules based on their risk profile.

Do I need to install SSL before using Paystack?

Yes. Paystack requires HTTPS on your site. Without SSL, the webhook will fail and payments may not process correctly. Most hosting providers offer free SSL via Let's Encrypt.

Can I integrate both Paystack and Flutterwave on the same site?

Yes. Having both gives customers a fallback option if one gateway is having issues. Most customers will choose Paystack, but Flutterwave as a secondary option can recover failed transactions.

Need Paystack Set Up on Your WordPress Website?

ClickStartNG builds affordable, mobile-first WordPress websites for Nigerian businesses — starting at ₦50,000 plus ₦10,000 for domain and technical setup. We can integrate Paystack, Flutterwave, or both, with full webhook configuration and testing.

Start Your Website Project View Portfolio Ask Us a Question Get Free Audit

This article provides general information about integrating Paystack with WordPress. Plugin settings and Paystack dashboard options may change. Always refer to official Paystack documentation for the most current setup instructions.

Ready to build your website? See packages and get a free mockup →