The verdict in three sentences
A payment dispute is won on proof: in Kampala, without an audit trail you lose 70% of contests, with a timestamped, immutable ledger you win 65%. Every event (creation, payment, provider confirmation, refund) must be logged immutably and kept 7 years for the tax authority. A ready-to-send evidence pack turns a dispute you'd suffer into a case you win.
The events to log without exception
A useful ledger isn't a plain application log: it's a sequence of immutable, timestamped events tied to the provider reference. Here's what we record.
| Event | Key data | Why it's decisive |
|---|---|---|
| Order creation | id, amount, customer | anchors the sale |
| Payment attempt | provider, ref | proves intent |
| Webhook confirmation | signature, timestamp | proof of settlement |
| Shipment / delivery | tracking, date | counters "not received" |
| Refund | amount, reason | traces the gesture |
| Dispute opening | channel, deadline | triggers the SLA |
Immutability is the key point: an event is never modified, a new one is appended. That's what makes the ledger admissible.
Windows, retention and response SLA
Each provider imposes a contest window and requires an evidence pack. Anticipating these deadlines is the difference between winning and suffering.
| Parameter | 2026 value (est.) | Impact |
|---|---|---|
| MTN reversal window | 30 days | time to react |
| Win rate without proof | 30% | you suffer |
| Win rate with ledger | 65% | you flip it |
| Fiscal retention | 7 years | legal obligation |
| Dispute response SLA | < 48 h | case credibility |
| Refund policy | full / partial | per delivery proof |
Need a professional website?
Kolonell builds websites that attract clients, optimized for the Sénégalese market. Free quote in 2 minutes.
The full vs partial refund choice is driven by proof: proven delivery = a justifiable partial refund; unproven delivery = a full gesture to protect reputation.
Mini case study
Jean-Marc runs a shop in Kampala, 800 orders/month, ~12 monthly disputes via MTN MoMo, average contested amount UGX 130,000. Before an audited ledger: 70% losses, i.e. ~8 lost disputes/month = UGX 1.04M gone. After the immutable ledger and auto evidence pack: 65% wins, ~4 losses/month = UGX 520,000. Net gain: UGX 520,000/month recovered, and case-building time down from 45 min to 3 min per dispute.
FAQ
What makes a ledger "admissible" in a dispute? Immutability and timestamping: each event is appended, never modified, and tied to the provider reference. Against MTN or a card scheme, a timestamped creation -> payment -> delivery chain flips 65% of cases.
How long must I keep this data? The reference fiscal retention is 7 years in the region: your ledger must archive orders, payments and invoices over that span. A premature purge exposes you during an audit.
Does the evidence pack generate itself? Yes: when a dispute opens, the system automatically assembles order, signed webhook confirmation and delivery proof into a ready-to-send pack within the 48 h SLA.
How to choose between full and partial refund? On delivery proof: if it exists, a partial refund is justifiable; otherwise a full gesture better protects reputation. The ledger documents the decision.
Let's talk about your project. We set up your immutable ledger and evidence packs to win your next disputes. 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.
