🍀Fastapesa
Sign in

Webhook API

HomeDashboardDocumentationsWebhook API
Merchant webhooks are coming soon. Use the Transaction Status API meanwhile.

Authentication

Every request requires your API key in the headers.

Content-Typeapplication/json
Header Namex-api-key
AlternativeAuthorization: Bearer KEY

PAYIN & PAYOUT Webhook Events

Webhooks allow FastaPesa 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. PAYIN fires when a customer completes a payment; PAYOUT fires when a payout is sent.

Response Example

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