How to Connect Paystack to WordPress in Nigeria
If you want to receive payments on your website in Nigeria, one of the best things you can learn is How to Connect Paystack to WordPress in Nigeria
This allows your customers to pay you using:
- Debit cards
- Bank transfers
- USSD
- QR codes
The best part is that you don’t need to be a developer to set it up.
In this guide, I will walk you through everything step by step in simple English on How to Connect Paystack to WordPress in Nigeria, including how to fix common issues and test your payments.
Table of Contents
- What You Need Before You Start
- Step-by-Step WooCommerce + Paystack Setup
- Understanding the Paystack Settings Screen
- How to Test Payments
- Common Errors and Fixes
- Troubleshooting (Very Important)
- FAQs
- Final CTA
What You Need Before You Start on How to Connect Paystack to WordPress in Nigeria
Before you begin, make sure you have the following ready:
- A working WordPress website
- A domain name and hosting
- WooCommerce installed
- A verified Paystack account
If any of these are missing, set them up first before continuing.
Step-by-Step WooCommerce + Paystack Setup
Let’s go step by step.
Step 1: Install WooCommerce
Log in to your WordPress dashboard.
Go to:
Plugins → Add New
Search for:
WooCommerce
Click:
- Install
- Activate
After activation, WooCommerce will open a setup wizard.
What you will see on the screen:
- Store setup page
- Fields asking for location, currency, and business type
Select:
- Country: Nigeria
- Currency: Nigerian Naira (₦)
Complete the setup and continue.
Step 2: Install Paystack Plugin
Still in your dashboard, go to:
Plugins → Add New
Search for:
Paystack for WooCommerce
Click:
- Install
- Activate
What you will notice:
There won’t be a big setup screen, but Paystack will now appear in your WooCommerce payment settings.
Step 3: Get Your Paystack API Keys
Log in to your Paystack dashboard.
Go to:
Settings → API Keys & Webhooks
What you will see on the screen:
- Public Key
- Secret Key
Copy both keys. You will need them next.
Learn how to receive payments online in Nigeria
Step 4: Connect Paystack to WooCommerce
Go back to your WordPress dashboard.
Navigate to:
WooCommerce → Settings → Payments
Scroll down and find:
Paystack
Click:
- Enable
- Manage
What you will see on the screen:
- Enable Paystack checkbox
- Title field
- Description field
- Test Mode toggle
- Public Key field
- Secret Key field
Paste your API keys into the correct fields.
Set a title like:
Pay with Card, Transfer, or USSD
Click:
Save Changes
Step 5: Set Up Webhook URL
Inside the Paystack settings page, you will see a webhook URL.
It usually looks like:
yourwebsite.com/wc-api/Paystack_Webhook
Copy this URL.
Now go back to your Paystack dashboard and paste it into the Webhook URL field.
What you will see on the screen:
- A field labeled Webhook URL
- Paste your link and save
This step is very important because it helps your website confirm payments automatically.
Step 6: Enable Live Mode
When you are ready to start receiving real payments:
- Turn OFF Test Mode
- Save changes
Your setup is now complete.
Understanding the Paystack Settings Screen
Here is what each option means:
Enable Paystack
Turns the payment option on or off.
Title
The name customers see at checkout.
Description
A short explanation shown to users.
Test Mode
Allows you to test without real money.
Public Key and Secret Key
Connect your website to Paystack.
Webhook URL
Used to confirm payments automatically.
How to Test Payments
Before going live, always test your system.
Step 1: Enable Test Mode
Go to Paystack settings and turn on Test Mode.
Step 2: Use Test Card Details
Get test card details from your Paystack dashboard.
Step 3: Place a Test Order
Go to your website:
- Add a product to cart
- Click checkout
What you will see on the screen:
- Payment method option showing Paystack
- Payment form
Enter test card details and complete payment.
Step 4: Check Order Status
Go to:
WooCommerce → Orders
If successful, the order should show:
- Processing
or - Completed
Step 5: Switch to Live Mode
Once everything works:
- Turn off Test Mode
- Save
Common Errors and Fixes
Checkout Not Working
Problem:
Customer clicks “Place Order” but nothing happens.
Fix:
- Ensure WooCommerce is installed correctly
- Confirm Paystack is enabled
- Disable conflicting plugins
- Switch to default theme
Webhook Not Working
Learn how to receive payments online in Nigeria
Problem:
Payment is successful but order is not updated.
Fix:
- Check webhook URL is correct
- Ensure your site uses HTTPS
- Re-save webhook in Paystack dashboard
Payment Successful but No Confirmation
Problem:
Customer pays but you don’t see it.
Fix:
- Reconnect webhook
- Check Paystack dashboard directly
cURL Error or Timeout
Problem:
Server cannot connect to Paystack.
Fix:
- Contact your hosting provider
- Increase server timeout
- Enable SSL
Troubleshooting (Very Important)
If your Paystack is not working, follow this checklist carefully.
First, confirm your API keys are correct. Many people mix up test and live keys.
Second, make sure your website has SSL (https). Without it, payments may fail.
Third, check WooCommerce pages. Go to:
WooCommerce → Settings → Advanced
Ensure:
- Cart page is set
- Checkout page is set
- My account page is set
Fourth, disable all plugins except WooCommerce and Paystack. Then test again. If it works, reactivate plugins one by one.
Fifth, change your theme to a default WordPress theme. Some themes break checkout.
Sixth, check your hosting quality. Slow hosting can cause payment failures.
Seventh, ensure your Paystack account is verified and active.
Eighth, open your browser console:
- Right click your site
- Click Inspect
- Open Console tab
Check for red error messages.
Ninth, test on both mobile and desktop.
Tenth, clear cache if you are using caching plugins.
This process will solve most problems.
SMARTPHONE EBOOK CREATION PACK - Richtechhub | Learn Digital Skills, AI & Online Business
Create & sell an eBook using only your smartphone — no laptop required. Fast, simple and profitable.
FAQs
How do I connect Paystack to WordPress without WooCommerce?
You can use payment links or buttons, but WooCommerce gives you a full checkout system.
Why is Paystack not showing on checkout?
Make sure it is enabled and your API keys are correct.
Do I need a business account?
No, but verification is recommended for full access.
How long does setup take?
You can complete everything within one hour.
Can I accept international payments?
Yes, Paystack supports international cards.
What if payments fail?
Check your API keys, webhook, and SSL setup.
Final Thoughts
Connecting Paystack to WordPress is one of the most important steps for building a profitable online business in Nigeria.
Once properly set up, it allows you to:
- Receive payments automatically
- Reduce manual work
- Increase trust with customers
Take your time, follow each step, and test everything before going live.
Need Help Fixing Your Paystack Integration?
If you are facing issues like checkout not working, webhook errors, or failed payments, I can help you fix everything and make your website fully functional.
Need help? Chat me directly on WhatsApp now:
[Richtechhub Whatsapp