The verdict in three sentences
Payout (or disbursement) is the outbound transfer from the platform to the vendor's wallet. At small scale you do it by hand; beyond 30-50 vendors it becomes unmanageable and error-prone. A disbursement API for Wave/OM or a B2C bulk via aggregator automates transfers, handles caps, fees and failure reconciliation.
Manual payout vs API: the real hidden cost
Manual looks free, but operator time and errors cost dearly. Here is a comparison for 100 vendors paid weekly.
| Criterion | Manual payout | API payout |
|---|---|---|
| Time per batch (100 vendors) | 8-10 h | 2-5 min |
| Typo risk | High (1 wrong digit = wrong account) | Near zero (number verified in DB) |
| Traceability | Fragile spreadsheet | Log + transaction ID |
| Failure reconciliation | Manual, forgotten | Automatic, status per payout |
| Monthly cost (4 batches) | ~32-40 h operator | ~a few minutes |
| Scaling | Nightmare past 50+ | Linear to thousands |
At 2,500 FCFA/operator hour, manual costs 80,000 to 100,000 FCFA/month in time alone, not counting disputes from mis-payments.
Fees, caps and frequency (2026 order of magnitude)
Exact parameters depend on your aggregator contract, but here are the orders of magnitude to plan for.
| Parameter | Wave (estimate) | Orange Money (estimate) |
|---|---|---|
| Outbound payout fee | ~0.5-1 % or flat per transaction | ~1 % or tier |
| Cap per transaction | around one million FCFA | around one million FCFA |
| Daily B2C cap | per merchant contract | per merchant contract |
| Vendor credit delay | near instant | seconds to minutes |
| Bulk / batch B2C | via API or aggregator | via API or aggregator |
| Confirmation webhook | yes | yes (per integration) |
Always plan for failure handling: inactive number, cap reached, full wallet. A failed payout must re-queue and replay, not vanish.
Failure reconciliation: the critical block
| Payout status | Typical cause | Automatic action |
|---|---|---|
| Success | — | Mark paid, notify vendor |
| Invalid number failure | Bad format/closed account | Block, request KYC update |
| Cap failure | Daily cap reached | Reschedule next day |
| Full wallet failure | Vendor max balance | Notify vendor, retry D+1 |
| Pending / timeout | Operator network | Check status via API, do not re-pay |
The golden anti-double-pay rule: never replay a "timeout" payout without verifying its real status via the API; otherwise you risk paying the same vendor twice.
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
Aminata runs a 120-vendor marketplace paid every Friday. Manually: ~10 h/week, i.e. 40 h/month at 2,500 FCFA = 100,000 FCFA, plus ~2 errors/month (payouts to fix). After moving to the disbursement API: 5 minutes per batch, zero typos, ~0.8 % payout fee absorbed in commission. Net saving: ~95,000 FCFA/month and a freed-up weekend.
FAQ
Do Wave and Orange Money offer a payout API in 2026?
B2C disbursement capabilities exist, directly or via aggregator, but access depends on your merchant status and contract. That is the first thing to validate before building the module.
What does an outbound payout cost?
Expect an order of magnitude of 0.5 to 1 % or a flat fee per transaction depending on operator and volume. Build it into your commission grid so it doesn't erode margin.
How often should vendors be paid?
Weekly is the standard: it balances platform cash flow and vendor satisfaction. Automation even makes daily feasible with no extra labor cost.
How do I avoid paying twice on a timeout?
Always query the real status via the API before replaying, and use an idempotent ID per payout. A "timeout" doesn't mean "failure": the transfer may have succeeded.
Let's talk about your project. We automate your Wave/OM payouts with failure reconciliation and double-pay protection. 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.
