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
Log in to Paystack
Log in to your Paystack Dashboard.
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
Log in to your PayLexer dashboard and navigate to Payment Gateways → Paystack.
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
Log in to your Paystack Dashboard and go to Settings → API Keys & 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
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
Still Have Questions?
-
Paystack Support: Paystack Help Center
-
PayLexer Support: Contact Support
Last updated 4 days ago
Built with Documentation.AI