Webhooks FAQ
How can I verify that my webhook URL is correctly set to receive notifications?
You have the ability to send test notitications to the webhook URL at the configuration time in the user interface. This guarantees the correctness of the webhook setup before the notifications feature is turned on.
I'm not receiving webhooks anymore. Am I alerted when something goes wrong?
An automated daily email is going to be sent to all the configured webhook email addresses so that you are alerted when notifications fail to be delivered. Once such an alert email is received, the customer owning the webhook infrastructure should take immediate action and fix the webhook URL reachability so that the failed notifications are retried with the next defined retry interval and get successfully delivered. Failing to take any action, leads to losing all the notifications beyond the retry period.
Can I configure multiple email addresses to get alerted when webhooks are failing to be delivered?
Absolutely. You can configure multiple email addresses to receive the daily alerts. Please consider updating the email addresses in case people change roles or leave the company.
What is the lead time to remediate the webhook URL so that I recover all failed notifications?
The failed notifications are retried based on the documented retry-intervals but the retrial process will not exceed more than 30 days.
Why am I not receiving at all the webhooks?
Please verify the correct webhook URL is configured, check your firewall restrictions and perform Click to Test from the user interface to validate the reachability.
Why am I not receiving webhooks from time to time?
Please verify that your server for receiving notifications is able to properly handle peak-loads of messages. When processing goes to higher transactions per second rates, then you should expect to receive same or higher number of notifications per second. If the notifications cannot be all consumed by your webhook server then your webhook URL listener might become slower and from time to time unreachable.
How do I know to which transactions the notification updates are referring to?
If the notification is for a transaction status change, you will get at least one of the following data points: id, referenceId, registrationId, or merchantTransactionId. You can use these fields to match your transaction data against the webhook message.
How to best handle webhook URL connection?
For PCI DSS compliance, SSL (Secure Socket Layers) connections using untrusted certificates are not allowed. Please ensure you have a valid SSL certificate chain. Self-signed certificates are not valid.