Webhook API | SpeedPesa

Overview

Webhooks allow SpeedPesa to push real-time notifications to your server when transaction events occur. Instead of polling our API for status updates, your server will receive an HTTP POST request automatically.

Setup Configure your webhook URL in the Dashboard Settings.

PAYIN Webhook Event

This event is triggered when a customer completes a payment (Mobile Money Payin).

Response Example

{ "reference": "BAH72NSNSI", "event": "PAYIN", "accountName": "Joseph", "channelProvider": "Airtel Tanzania", "phoneNumber": "0687819056", "status": "SUCCESS", "completedAt": "2026-06-23T12:00:00+03:00" }

PAYOUT Webhook Event

This event is triggered when a payout is successfully sent to a customer's mobile money account (Mobile Money Payout).

Response Example

{ "reference": "XYZ98ABC12", "event": "PAYOUT", "accountName": "Amina", "channelProvider": "Vodacom Tanzania", "phoneNumber": "0712345678", "status": "SUCCESS", "completedAt": "2026-06-23T14:30:00+03:00" }