A webhook URL can be provided as a request parameter in the request body for certain endpoints, allowing you to receive notifications when the status of an underlying object changes.This eliminates the need to schedule tasks or constantly poll Xnova’s endpoints for updates. Simply include a webhook_url in the API payload, and Xnova will send a POST request to your server whenever there is a status change in the object. Ensure that the webhook_url is set to HTTPS, as webhooks will not be triggered over unencrypted connections.It’s essential to configure your endpoint URL to acknowledge Xnova's webhooks with standard HTTP response codes. For example, return a 2xx code to confirm the successful receipt of a POST request on your server.If Xnova does not receive a 2xx acknowledgement, it will retry sending the webhook for up to 36 hours as detailed in the retry policy below.The following Xnova objects trigger webhook responses:The webhook subscription can also be requested in the Dashboard, with the following types available:
PAYMENT
REVIEW RESULT
DISPUTE RECIEVED
DISPUTE RESULT
REFUND RECIEVED
REFUND ACCEPTED
REFUND RESULTIn case of any server block or not receiving a response to your webhook URL, try whitelisting the below IP addresses:
Test Mode (Sandbox) : XX.XXX.XXX.XXX
Live Mode (Production) : XX.XXX.XXX.XXX
Retry Policy#
If Xnova does not receive a 2xx status from your endpoint as an acknowledgement of successful webhook delivery, it keeps retrying.The time between each retry increases exponentially by a power of 2 with jitter till a period of 12 hours. The first retry starts after 1 second of original webhook delivery.This process is repeated 3 times. You can receive a retried webhook upto 36 hours from the delivery of the first webhook.Review#
Review notifications will be sent to the notify_url defined by merchant, in the format of NameValuePair. Below are the notification parameters:Chargeback#
Chargeback notifications will be sent to the notify_url defined by merchant, in the format of NameValuePair. Below are the notification parameters:Payment#
For offline payment such as offline bank transfers, our gateway system will notify merchant with the final result via payment notification once payment is completed. These notifications will send to the ‘notify_url’ defined by merchant in HTML format via POST method.Below are the parameters of payment notificationRefund#
Refund notifications will be sent to the notify_url defined by merchant, in the format of NameValuePair. Below are the notification parameters: 