Create a webhook
Subscribe to real-time status updates for customers, virtual accounts, and payments. When you create a webhook, you’ll receive JSON notifications at your specified endpoint whenever status changes occur.
Webhook Payload Mapping:
- If you subscribe to CUSTOMER STATUS, your webhook will receive the payload described in the
customer_status_updatedevent. - If you subscribe to VBAN STATUS, your webhook will receive the payload described in the
virtual_account_status_updatedevent. - If you subscribe to PAYMENT STATUS, your webhook will receive the payload described in the
payment_status_updatedevent. - If you subscribe to THIRD PARTY CUSTOMER STATUS, your webhook will receive the payload described in the
third_party_customer_status_updatedevent.
For details of the payload structure, refer to the respective webhook event definition linked above.
Authentication: Bearer token required
Headers
Authorization
Bearer authentication of the form Bearer <token>, where token is your auth token.
Request
This endpoint expects an object.
endpoint
The HTTPS URL where webhook notifications will be sent. Must be a publicly accessible endpoint that can receive POST requests.
event_type
The type of event to subscribe to.
Allowed values:
Response
Webhook created successfully
id
Unique subscription ID for this webhook subscription.