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.
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.
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
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
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:
For Paid Memberships Pro, it looks like:
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.
- In your WordPress plugin settings, uncheck "Test Mode".
- Paste your Live Public Key and Live Secret Key into the corresponding fields.
- Save your changes.
- Verify that Paystack still appears as a payment option on your checkout page.
- 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 AuditThis 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.
