The verdict in three sentences
Integrating the Paystack inline checkout into a React app in Lagos takes 2 to 3 developer-days and moves you onto a local fee around 1.5% on cards and mobile money. Settlement is T+1 for local transactions, the test environment is free, and the HMAC-signed webhook is mandatory to confirm payments reliably. On ₦5,000,000 of monthly sales, choosing the right rate saves you a meaningful margin every month.
The step-by-step integration flow
Paystack exposes a clean REST API: you initialize a transaction, open the inline popup with the access code, then listen to the confirmation webhook. In React, you use @paystack/inline-js for the popup and verify the status server-side before fulfilling the order.
| Step | Technical action | Estimated time |
|---|---|---|
| 1. Merchant account | Activate Paystack + sandbox API key | 1 h |
| 2. Init endpoint | POST /transaction/initialize (amount, NGN) | 3 h |
| 3. React popup | Inline JS + onSuccess callback | 4 h |
| 4. HMAC webhook | Signature check + idempotency | 5 h |
| 5. Reconciliation | Server verify before fulfilment | 3 h |
| 6. Sandbox tests | Success, failure, timeout cases | 4 h |
Paystack versus a heavier gateway: the real cost
Paystack's advantage is a transparent local rate with capped fees on larger transactions, versus gateways that add a fixed fee on every payment.
| Criterion | Paystack | Heavier gateway |
|---|---|---|
| Merchant fee | ~1.5% (local) | 2.9% + fixed |
| Fee cap | Yes on large txns | Often none |
| Settlement | T+1 | T+2 to T+3 |
| Sandbox | Free | Free |
| Webhook | HMAC required | Variable signature |
| On ₦100,000 | ~₦1,500 | ~₦3,000 |
These figures are a 2026 order of magnitude and should be confirmed in your merchant contract.
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 shop in Lagos via his React storefront. He collects ₦5,000,000 per month. With a gateway at 2.9% + a fixed fee across ~1,000 transactions, he pays roughly ₦145,000 + fixed fees. With Paystack near 1.5%, he pays around ₦75,000. Monthly saving: ~₦70,000+, reinvested into inventory.
FAQ
Is the HMAC webhook really mandatory? Yes. Without signature verification, an attacker can spoof a successful payment. Paystack signs each event; you recompute the HMAC with your secret and compare before fulfilling the order.
How long to go live? Budget 2 to 3 developer-days for a full checkout, plus merchant account verification which can take a few business days.
What if the customer closes the popup early? Never fulfil on the client side. Wait for the webhook or call GET /transaction/verify/{ref} server-side to get the true status.
Does Paystack support mobile money? Yes, alongside cards and bank transfer in Nigeria and several African markets; confirm channel coverage and NGN settlement in your dashboard before launch.
Let's talk about your project. We integrate Paystack into your React app with a signed webhook and reconciliation in 2 to 3 days. 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.
