Ctrl K
Payload Structure
Webhook URL requirements
Your webhook URL must support:
POST — to receive webhook events
GET — must return HTTP 200
When API access is approved, we register your webhook URL with our delivery provider, which validates reachability with a GET request first (we cannot use POST for this check). If GET fails or does not return 200, registration fails and you will not receive webhooks.
Each webhook has:
eventId
customer_id
eventType
eventCategory
eventData (event-specific details)
pvb_reference, pvb_wallet , etc. (as applicable)
1
Example (Wallet Creation):
(JSON)
{ "eventId": "4204dc18-efb3-44d0-b9a2-1362448d4f21", "customer_id": "c0065070-dc32-45d2-9c01-871a27abfd10", "eventType": "create-wallet.success", "eventCategory": "create_wallet", "eventData": { // Details... }, "pvb_wallet": "923f843a-be7e-494a-bc5d-9f49f4cc640f"}For other events, refer to the provided samples.