Debitsuccess uses webhooks to notify your application when an event occurs in your account. Notifications are the only way you'll receive automatic updates about events that are not triggered by a request from your side, for example when the account suspension schedules are changed.
Currently, we support limited events but may include additional events in the future. You can create webhooks for:
Once your server is configured to receive payloads, it'll listen for any payload sent to the endpoint you configured. For security reasons, you probably want to consider whitelisting our IP(can be provided during subscription) and/or limit requests to those coming from Debitsuccess.
You could also opt to receive a token to authenticate the messages. The token will be a static text - 256 chars max length.
This will be passed in the request header - X-Token
Delivery attempts and retries
Successful delivery expects a http status code 200 response
Whenever any webhook fails to send data to the desired notification URL Debitsuccess retries three times every 180 seconds. If a message fails to deliver after 3 retries an email would be triggered to the email address nominated during the subscription and the webhook would be disabled.
Incase you would want any specific messages delivered please contact Debitsuccess.
Token - A unique static text of 256 characters max, that is returned in the notification header (see Securing webhooks section). If you do not provide a value Debitsuccess will generate one and supply it to you.(Optional, Debitsuccess can provide a unique one if not provided, as listed in Securing Webhooks).
Facility - The facility/facilities for notification subscription.
Events - Events which you wish to receive notifications for. /To receive notifications for events listed below.
Email Address - A nominated email address to receive notification in case of notification failure.
Testing
Test webhooks notification in integrations test environment. Separate registration from prod environment
Add Comment