Comment on page
Learn about the webhooks.
Digital River uses webhooks to notify your application when events occur.
When an event occurs, Digital River will create a data object and send a webhook to your application (endpoint URL) through a POST request containing the event and timestamp. You can set up multiple webhooks endpoints to receive a single event. This allows you to receive real-time updates on the state of your order, line item, subscriptions, returns, and refunds.
You can use the Webhook Service page in Global Commerce or the Webhooks API to search, create, edit, enable, disable, and delete webhooks. You can also reveal and rotate webhook secrets. When you register your webhook URLs with Digital River, Digital River creates a data object and sends webhook events that notify your application any time an event occurs. The data object includes the type of event and the data associated with that event.
An endpoint URL is where the payload will be sent when the subscribed event happens. The endpoint URL must begin with either
The endpoint must return a
2xxHTTP status code to acknowledge the receipt of an event. If the endpoint fails to acknowledge events over several days, the endpoint will be disabled. You did not receive the event if Digital River receives any response codes outside this range, you did not receive the event. For example, Digital River treats a URL redirection as a failure.
The webhook status is disabled by default. The system will prompt you to enable the webhook when creating one. If you choose to disable the webhook, no payload will be sent when an event occurs.
After you create a webhook, you can choose to enable or disable the webhook manually. Enabling a webhook manually does not require confirmation. However, you must provide confirmation when you manually disable a webhook by entering the username (case sensitive).