Paystack

Connect Paystack to PayLexer to accept cards, mobile money, bank transfers, and USSD payments across Nigeria, Ghana, South Africa, Kenya, and more.

Paystack is an Africa-focused payment processor with coverage across key markets including Nigeria, Ghana, South Africa, Kenya, and Côte d'Ivoire, enabling businesses to accept payments locally and internationally. It supports cards, mobile money, bank transfers, QR, and USSD channels.

Supported Regions (Merchant Accounts): Nigeria, Ghana, South Africa, Kenya, Côte d'Ivoire, and other African markets - view full list
Supported Currencies: NGN, GHS, ZAR, KES, XOF, and USD where enabled - view full list

Supported Features

One-time payments
Refunds
Payment status updates via webhooks
Recurring billing and subscriptions (if enabled)

Before You Start

Make sure you have:

Paystack Account – Don't have one? Sign up for Paystack →
PayLexer Account – Required to configure the integration. Create your account →
A website where you want to integrate

Looking for a different payment processor? View all supported gateways →

Configuring Paystack

You need a Public Key and Secret Key from Paystack for this integration.

Getting API Credentials

Navigate to API Keys

Go to Settings → API Keys & Webhooks.

Copy your keys

Copy the Secret Key and Public Key.

Paystack provides separate keys for Test and Live modes. Toggle between "Test mode" and "Live mode" in the dashboard to access different keys.

Adding Credentials to PayLexer

Open PayLexer Dashboard

Enter your credentials

Paste the Secret Key and Public Key you copied from Paystack.

Understanding Live/Production and Sandbox Settings:

Environment	Purpose
Live / Production (Mandatory)	Used for real transactions. Cannot be empty, even when testing.
Test / Sandbox (Optional)	Used for testing only. No real money is processed.

How PayLexer selects credentials:

Debug/Test mode ON → Test credentials are used
Debug/Test mode OFF → Live credentials are used

Test and save

Click Test Connection to verify your credentials, then click Save Configuration.

Configuring Webhooks (Mandatory)

Webhooks enable real-time payment updates and significantly improve reliability.

Benefits of Webhooks:

Instant payment status updates
Automatic refund processing
Dispute notifications

Open Paystack Webhooks

Add the Webhook URL

Copy the Webhook URL from PayLexer, paste it into the Webhook URL field in Paystack, and click Save changes.

Copy Webhook Secret

Copy the Webhook Secret from Paystack.

Save in PayLexer

Paste the Webhook Secret into PayLexer, then click Save Configuration.

Integrate Paystack to Your Website

If you have already added and configured your site, you can enable Paystack in your existing setup.

Go to Websites

Navigate to Websites in your PayLexer dashboard.

Edit your website

Click the Edit Icon of your added website.

Enable Paystack

Click the checkbox to enable Paystack for the website.

If you haven't added a website yet, Continue to Add Your Website →

Troubleshooting

Verify Public Key and Secret Key are correct
Ensure you're using the right environment keys (Test vs Live)
Re-run Test Connection in PayLexer

Confirm webhook URL is correctly added in Paystack
Check Webhook Secret matches exactly
Verify webhook is active in Paystack settings
Review webhook delivery logs in Paystack Dashboard

Verify Paystack is enabled in your integration
Ensure credentials match the environment (Test vs Live)

Best Practices

Test in sandbox before enabling Production mode
Validate the first live transaction
Confirm webhooks are working
Monitor the gateway dashboard for failed payments
Keep API keys and secrets secure
Use separate Test and Production credentials
Use only official Paystack test cards during testing

FAQs

Live credentials are mandatory to save the configuration. Test credentials are optional but highly recommended so you can safely test payments before going live.

Check the Debug Mode setting in your platform (e.g., WP Travel Engine Settings → Payments). When Debug Mode is ON, PayLexer uses your Test credentials. When OFF, it uses Live credentials.

Transactions appear in three places: your platform's booking/order pages, PayLexer Dashboard → Orders, and Paystack Dashboard. All three show the same transactions with different IDs.

Payments will still process, but status updates may be delayed. Check webhook logs in Paystack Dashboard → Settings → API Keys & Webhooks to troubleshoot.

Still Have Questions?

Paystack Support: Paystack Help Center
PayLexer Support: Contact Support

Was this page helpful?

Last updated Apr 3, 2026

Built with Documentation.AI