The verdict in three sentences
Integrating Paystack into an online store in Lagos takes 1 to 5 days depending on whether you pick a hosted checkout (redirect/inline popup) or a full API integration. Paystack settles on T+1 for Nigerian merchants, so cash flow planning matters. The two costly pitfalls are idempotency (avoiding double charges) and a poorly secured webhook signature.
Hosted vs API: what to choose
The *inline/hosted* mode opens a Paystack popup and returns a reference. The *API* mode drives init and verify server-side and keeps full control. Here are the 2026 orders of magnitude.
| Criterion | Hosted checkout | API integration |
|---|---|---|
| Dev time | 1 to 2 days | 3 to 5 days |
| Dev cost (estimate) | NGN 200k - 500k | NGN 600k - 1M |
| Webhook required | Yes | Yes |
| Design control | Low | Full |
| PCI scope | Minimal (Paystack) | Minimal |
| Settlement | T+1 | T+1 |
For 80% of stores starting out, the *hosted/inline* mode is enough and shrinks the bug surface.
The technical steps
The standard flow is five steps, each with its own gotcha.
| Step | Action | Pitfall to avoid |
|---|---|---|
| 1. API keys | Generate live public + secret | Never expose the secret client-side |
| 2. Initialize | Call transaction/initialize with amount + reference | Unique reference per order |
| 3. Redirect | Send customer to authorization_url | Handle the cancel case |
| 4. Webhook | Receive the signed charge.success | Verify the HMAC SHA512 signature |
| 5. Verify + idempotency | Call transaction/verify, mark paid once | Idempotency key in DB |
Amounts are sent in kobo (1 NGN = 100 kobo); Paystack merchant fees are around 1.5% + NGN 100 in 2026 (order of magnitude, confirm per contract), capped for larger transactions.
Need a professional website?
Kolonell builds websites that attract clients, optimized for the Sénégalese market. Free quote in 2 minutes.
Mini case study
Chidi runs a cosmetics store in Lekki, Lagos. He sells about 220 orders/month at an average basket of NGN 12,000, i.e. NGN 2,640,000 in volume. The inline integration cost him NGN 350,000 once. With Paystack fees near 1.5%, he pays roughly NGN 39,600/month in processing. Verifying every transaction server-side (not trusting the client callback) stopped two fraudulent "paid" orders in the first month, saving him about NGN 40,000.
FAQ
How long to wire Paystack into my store? Between 1 and 5 days. An inline/hosted checkout takes 1-2 days; a full API integration with webhook and idempotency takes 3-5 days of development.
What is the development cost? Roughly NGN 200k-500k for hosted and NGN 600k-1M for a full API build (2026 estimate, store design not included).
Is the webhook really mandatory? Yes. Without the charge.success webhook you risk marking an order paid when it is not, or missing a real payment. Add a verify/polling fallback too.
How do I avoid double charges? Store an idempotency key per order: if the webhook fires twice, the order is fulfilled only once. This is the number-one bug in rushed integrations.
When does Paystack pay out? T+1 for Nigerian merchants in most cases, so plan your cash flow one day ahead versus instant mobile money rails.
Let's talk about your project. We integrate Paystack and mobile money into your store with a reliable webhook and proper idempotency. 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.
