The verdict in three sentences
A manual weekly payout for 20 vendors ties up around 3 hours and introduces number or amount errors on several lines. A disbursement API driven by a cron runs the same batch in under 2 minutes, with logging, automatic retries and mobile money credit in under 60 seconds. The gain is not only time: it's the end of unpaid vendors who lose trust.
Manual vs cron + disbursement API
Manual feels free while volume is low; it becomes a sinkhole past twenty vendors. Automation costs a few lines of fees but removes human risk.
| Criterion | Manual payout | Cron + disbursement API |
|---|---|---|
| Time for 20 vendors | ~ 3 h | ~ 2 min |
| Entry error rate | 3-5% | ~ 0% |
| Technical failure rate | — | ~ 2% (auto retry) |
| Disbursement fees | Variable | 0.5-1% |
| Batch cap | — | 500 transactions |
| Vendor credit delay | Minutes to hours | < 60 s |
| Audit log | None | Complete |
The architecture of an automated payout
The cron fires every Friday at a fixed time. It aggregates the week's vendor balances, filters those above the threshold, builds a disbursement batch, sends it to the API, then processes status callbacks.
| Step | 2026 detail |
|---|---|
| Cron frequency | Weekly (Friday) |
| Minimum vendor threshold | 5,000 FCFA |
| Max batch size | 500 transactions |
| Disbursement fees | 0.5-1% of amount |
| Failure rate (invalid number) | ~ 2% |
| Retry policy | 3 attempts, backoff |
| Expected final status | < 60 s after send |
| Vendor prerequisite | KYC verified + verified MoMo number |
The 2% failures almost always come from a wrong number or an inactive account. Automatic retry resolves half of them; the rest fall into a "to fix" queue and notify the vendor to update their number.
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
Ibrahim runs a services marketplace in Kampala with 24 providers, settling in UGX (shown here in FCFA-equivalent for comparison). Every Friday, 480,000 FCFA-equivalent must be split. The cron builds a batch of 22 payouts (2 vendors below the 5,000 threshold are carried over). Disbursement fees at 0.8%: 3,840 FCFA. One payout fails (changed number), resolved on the next retry. Ibrahim's total manual work: 0 minutes, versus 3 hours before. Over a month, automation gives him back 12 hours and removes 4-5 entry errors.
FAQ
Why a 5,000 FCFA payout threshold? Below it, fixed disbursement fees eat a disproportionate share of the amount. Carrying over to the next cycle is more profitable for both vendor and platform.
What about the 2% failed payouts? They go to automatic retry (3 attempts), then, if the failure persists, to a manual queue with a vendor notification. A MoMo number verified at KYC sharply reduces this rate.
Is bulk disbursement capped? Yes, typically around 500 transactions per batch in 2026. Beyond that, you split into sequential batches, which still stays well under a minute per batch.
Can you pay on demand instead of via cron? Technically yes, but the weekly cron smooths cash flow, groups fees and simplifies accounting. On-demand payment multiplies per-unit fees.
Is KYC needed before the first payout? Absolutely. No disbursement should go to an unverified vendor: it's both a compliance requirement and an anti-fraud protection.
Let's talk about your project. We automate your vendor payouts with cron, disbursement API, retries and a complete audit log. 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.
