Best practices to follow for webhooks
Keep the flexibility of retrieving unknown fields with the webhook response. As the platform evolves new fields are introduced time to time. Reading of webhook data should not fail while a new parameter is received. For example in Java you can use below property on your objects :
@JsonIgnoreProperties(ignoreUnknown = true)
Related Articles
My webhook endpoint keeps getting disabled due to various reasons, any best practices should I follow?
Do not execute business logic while receiving webhooks. Even if you execute, make sure a 200 response is returned always. For example an entity not found in your database (due to data archival), or state change of an object where this webhook is not ...
What are webhooks and how can I enable them?
Digio webhooks can be used for receiving server to server events, by providing an HTTP based endpoint, where Digio keeps publishing the events. You can enable webhooks from your enterprise dashboard - profile section. Navigate to the profile section ...
I recently started using a new Service of Digio, but not receiving webhooks for this one while I am receiving proper webhooks for existing services.
Webhooks are enabled at event/service level. If you started using a new service, for example you were using NACH mandate registration webhooks, now started using NACH Debits as well you can login to Enterprise Dashboard and enable relevant webhooks.
Will I be notified when my webhooks are failing?
Yes, Digio makes periodic attempts on non 200 http responses. First email is sent to the registered account email, if the webhook is failing since the last 1 hour. If any failure is observed, subsequent attempts are made after 5 minutes, 10 minutes, ...
Will I be notified when my webhooks are disabled ?
Yes, If the webhook endpoint is returning a non 200 response for more than 24 hours, webhook account is disabled and a Webhook disable email is sent to the registered email id. Sample email -