Architecting High-Throughput Kenyan Fintech Systems

Integrating payment gateways in East Africa requires engineering for high variability in telecommunication latency and webhook delivery drops.

The Challenge with Webhook-Only Architecture

Many engineering teams rely solely on Safaricom Daraja webhook callbacks. However, network hops and upstream gateway congestion frequently delay or drop callbacks, resulting in frustrated users whose payments were deducted without their order being marked as completed.

The Dual-Loop Verification Pattern

In our architecture at Akubrecah, we implement a Dual-Loop Verification Pattern:

1. Immediate STK Dispatch: The user triggers an STK push.
2. Active Server-Side Polling: A background task periodically queries the transaction status for 50 seconds.
3. Idempotent Webhook Handler: If the webhook arrives first, it fulfills the transaction and sets state to COMPLETED. If the active poll detects payment first, it marks state and fulfills in-memory.

This guarantees that users receive their digital assets or compliance certificates within seconds of entering their PIN, even during upstream gateway congestions.