The verdict in three sentences
Below a few hundred transactions a month, wiring the Paystack API by hand wastes time a plugin saves; above it, direct integration at 1.5 % + ₦100 earns back the effort. The critical point is not the redirect but the signed webhook: verify the HMAC SHA512 signature or you expose yourself to spoofed confirmations. Plan for T+1 settlement in your cash flow, not instant availability.
Make or buy: the integration decision
Two paths exist to collect with Paystack in Lagos: the direct API, or a ready-made plugin that wraps it behind a store extension. The first costs less per transaction to control; the second costs less in development and maintenance time.
| Criterion | Direct Paystack API | Plugin |
|---|---|---|
| Local card fee | 1.5 % + ₦100 (cap ₦2,000) | Same |
| International fee | 3.9 % + ₦100 | Same |
| Integration time | 2 to 4 weeks | 3 to 7 days |
| Webhook control | Full (HMAC SHA512) | Managed |
| Customization | High | Limited |
| Settlement | T+1 | T+1 |
The rule: if you need custom checkout logic and volume exceeds a few hundred transactions a month, direct integration is justified. Otherwise the plugin wins on speed.
Handling webhooks and failures cleanly
The real technical work with Paystack is webhook verification and failure recovery. The webhook must be validated with HMAC SHA512, the browser return must never be trusted, and failed charges must be surfaced clearly.
| Failure cause | Share of attempts (est.) | Strategy |
|---|---|---|
| Insufficient funds | 6 % | Suggest another method |
| Card declined by bank | 5 % | Clear message + retry |
| Wrong OTP / 3DS | 4 % | New attempt |
| Network drop | 3 % | Status pending + poll |
| Customer abandons | 8 % | Cart kept 24 h |
| Direct success | 74 % | Verified webhook |
A clear error message plus a saved cart on abandonment recovers roughly 4 to 6 points of conversion at no cost to the customer.
Mini case study
Chidi runs an electronics store in Lagos, average cart ₦45,000, 400 attempts a month. Without clean failure handling he converts at 74 % (296 sales, ₦13,320,000). Adding clear decline messages and a 24-hour saved cart, he reaches 80 % (320 sales, ₦14,400,000). Monthly gain: ₦1,080,000, with development amortized in two weeks. Paystack fee on new sales: 1.5 % + ₦100.
Need a professional website?
Kolonell builds websites that attract clients, optimized for the Sénégalese market. Free quote in 2 minutes.
FAQ
Direct API or plugin for Paystack?
Direct if you need custom checkout logic and volume exceeds a few hundred transactions a month. A plugin if you want to go live in a week with standard flows.
What settlement delay should I expect?
Paystack settles T+1 on local transactions. Build that one-day lag into your cash flow, especially for restocking inventory.
How do I secure the webhook?
Verify the HMAC SHA512 signature on every event using your secret key. Never confirm an order on the browser return alone.
What are the fees in 2026?
1.5 % + ₦100 on local cards, capped at ₦2,000, and 3.9 % + ₦100 on international cards. The cap makes large local baskets cheap to process.
Can I refund through the API?
Yes, Paystack supports full and partial refunds via API. Build the refund logic in from the start, including status tracking.
Let's talk about your project. We settle your Paystack make-or-buy and code the signed-webhook handling that protects your revenue. WhatsApp +221 77 596 93 33.
Mohamed Bah
Fondateur, Kolonell
Passionate about digital and entrepreneurship in Africa, Mohamed has been helping Sénégalese businesses with their digital transformation since 2020. Founder of Kolonell, he believes every SME deserves a professional and accessible online présence.
