Provider Adapter Guide
Pesapal v3 IPN & Status Query Integration
Streamline Pesapal v3 Instant Payment Notifications (IPN). Active queries retrieve complete merchant references, buyer email details, and amounts automatically.
Setup & Configuration
- Obtain your Consumer Key and Consumer Secret from your Pesapal developer settings.
- Configure the credentials inside ParsePesa Providers, and enable "Active Status Lookup Queries".
- Register your ParsePesa Callback URL as an IPN endpoint inside your Pesapal merchant account.
- Provide the registered IPN ID when initializing transactions via the Pesapal API.
Verification Method:
HMAC Signature verification combined with a secure token-based backend query to the Pesapal GetTransactionStatus API.
Sample Inbound Webhook Payload
{
"OrderTrackingId": "pesapal-track-999",
"MerchantReference": "ORDER-5544",
"EventType": "TRANSACTION_STATUS_UPDATE"
}Normalized Financial Event Payload
{
"id": "evt_pesapal_track_999",
"environment": "production",
"provider": "pesapal",
"source": "pesapal_ipn",
"eventType": "money.received",
"eventName": "Money Received",
"status": "succeeded",
"amount": 12500.0,
"currency": "KES",
"merchantReference": "ORDER-5544",
"providerReference": "pesapal-track-999",
"counterparty": {
"name": "John Doe",
"email": "buyer@example.com",
"phone": "254711223344"
},
"occurredAt": "2026-06-13T09:34:00Z"
}