Designing a Reliable Payment API for Real-Time Donations

A Retrospective on Moving Money at Scale — What I Built, What I Learned, and How It Evolved Introduction Helpa is a donation platform that connects donors to campaigns for medical bills and emergency relief across Nigeria — serving both individual fundraisers and NGOs. Its payment infrastructure settles real money for real emergencies: a delayed settlement means someone's surgery fundraiser stalls; a duplicate charge means a donor loses trust in the platform. As the architect and technical lead, I designed and built the system from its first transaction through to a production-hardened platform serving multiple payment providers. The result: a 99.7% settlement success rate across three payment providers, no confirmed duplicate charges since deploying idempotency and atomic webhook processing, and automated recovery that has saved hundreds of donations from manual intervention. This article documents the architecture, the failure modes discovered and resolved, and the engineering trade-