Provider Adapter Guide
Custom Webhook Mapping Integration
Integrate unsupported or proprietary payment providers using our zero-dependency JSONPath mapping rules.
Setup & Configuration
- Open the Custom Webhook Mappers panel inside your developer console.
- Define mapping properties using dot notation (e.g. $.data.payment.amount_value).
- Test your rules with custom payloads using the Test Playground before deployment.
Verification Method:
Static Token verification (query string match e.g. ?token=my-secret).
Sample Inbound Webhook Payload
{
"data": {
"ref": "CUSTOM-ORDER-100",
"buyer": {
"full_name": "Alex Kip"
},
"payment": {
"amount_value": 7500.00,
"currency_code": "KES",
"tx_id": "CUSTOM-TX-100",
"state": "completed"
}
}
}Normalized Financial Event Payload
{
"id": "evt_CUSTOM-TX-100",
"environment": "production",
"provider": "custom-custom",
"source": "custom_mapper",
"eventType": "money.received",
"eventName": "Money Received",
"status": "succeeded",
"amount": 7500.0,
"currency": "KES",
"merchantReference": "CUSTOM-ORDER-100",
"providerReference": "CUSTOM-TX-100",
"counterparty": {
"name": "Alex Kip"
},
"occurredAt": "2026-06-13T10:00:00Z"
}