The verdict in three sentences
The Paystack API covers two distinct needs: Charge (collect from customers) and Transfer (pay out to vendors or staff). Budget 2 to 4 development days for a working checkout, a signed webhook and clean reconciliation. The economics are competitive: 1.5% + NGN 100 capped at NGN 2,000 on local cards, with go-live after a 48-hour KYC review.
Charge vs Transfer: two endpoints, two logics
Charge initializes a payment session (hosted checkout or inline) and notifies you by webhook once the customer pays. Transfer moves money *from* your balance to a recipient, essential for marketplaces (vendor split) and payroll. Each has its own lifecycle and statuses.
| Aspect | Charge | Transfer |
|---|---|---|
| Flow direction | Customer → merchant | Merchant → third party |
| Trigger | POST /transaction/initialize | POST /transfer |
| Confirmation | Webhook charge.success | Webhook transfer.success |
| Statuses | pending, success, abandoned | pending, success, failed |
| Use case | Store, invoice | Marketplace, vendor payout |
| Idempotency | reference | reference |
Fees, caps and timings: the 2026 numbers
Operator choice comes down to three numbers: the rate, the per-transaction cap and the settlement delay. Here is a 2026 order of magnitude for the Nigerian and West African market.
| Provider | Collection fee | Fee cap | Settlement |
|---|---|---|---|
| Paystack | 1.5% + NGN 100 | NGN 2,000 | T+1 |
| Flutterwave | 1.4% | none local | T+1 |
| Interswitch | ~1.5% | varies | T+1 |
| Bank transfer | flat NGN 10-50 | n/a | T+0/T+1 |
The NGN 100 flat fee is waived on charges under NGN 2,500. On a NGN 40,000 basket, Paystack takes NGN 600 + 100 = NGN 700; on a NGN 200,000 basket the fee is capped at NGN 2,000 instead of NGN 3,000 — a real saving at high tickets.
Securing the webhook and reconciling
A Paystack webhook arrives signed: verify the x-paystack-signature HMAC with your secret before processing. Respond HTTP 200 in under 2 seconds, or Paystack retries. Store each event id in a dedup table so you never credit an order twice — idempotency is covered in a dedicated article.
| Step | Technical action | Typical time |
|---|---|---|
| 1. Initialize | Charge call + reference | < 1 d |
| 2. Redirect customer | Hosted or inline checkout | < 1 d |
| 3. Receive webhook | Verify signature + status | 1 d |
| 4. Reconcile | Match order ↔ transaction | 1 d |
| 5. Transfer (option) | Marketplace vendor split | 1 d |
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
Adaeze, who runs a cosmetics store in Lagos, processes 850 orders a month at an average basket of NGN 40,000, totalling NGN 34,000,000 in volume. With Paystack at 1.5% + NGN 100 (capped), she pays roughly NGN 595,000 in fees. Choosing a provider with no fee cap on the same volume would push costs above NGN 680,000. Monthly saving from the cap: around NGN 85,000, or NGN 1,020,000 a year. The 4-day integration cost is recovered within the first month.
FAQ
How long does Paystack integration take?
Budget 2 to 4 days for an experienced developer: initialize, redirect, signed webhook and reconciliation. Add one day if you also wire the Transfer API for a marketplace split.
What is the fee cap on Paystack?
In 2026 the local-card fee is 1.5% + NGN 100, capped at NGN 2,000 per transaction. That cap makes high-ticket sales meaningfully cheaper than uncapped alternatives.
How fast is go-live after KYC?
Business verification typically clears within 48 hours once you submit valid documents. You can build and test in test mode before that approval lands.
Do I need to test in test mode first?
Yes, without exception. Around 70% of production bugs come from untested webhooks. Use test API keys and simulate failures before switching to live keys.
Let's talk about your project. We integrate Paystack Charge + Transfer, signed webhooks and reconciliation in under a week. 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.
