Provider Adapter Guide
PayHero Mobile Express Integration
Process notifications from PayHero Kenya STK pushes and paybill/buygoods checkout channels.
Setup & Configuration
- Obtain your PayHero API Key and Username from your merchant portal.
- Register your ParsePesa Callback URL inside the PayHero developers page.
- ParsePesa parses PayHero payment statuses and normalizes response parameters.
Verification Method:
Static endpoint query authorization.
Sample Inbound Webhook Payload
{
"CheckoutRequestID": "payhero-stk-100",
"status": "SUCCESS",
"amount": 100.0,
"Channel": "MPESA_EXPRESS",
"reference": "REF-3911",
"mpesa_code": "PAYHERO123"
}Normalized Financial Event Payload
{
"id": "evt_PAYHERO123",
"environment": "production",
"provider": "payhero",
"source": "payhero_stk",
"eventType": "money.received",
"eventName": "Money Received",
"status": "succeeded",
"amount": 100.0,
"currency": "KES",
"merchantReference": "REF-3911",
"providerReference": "PAYHERO123",
"counterparty": {
"name": "PayHero Customer"
},
"occurredAt": "2026-06-13T10:00:00Z"
}