{"title":"Webhooks","category":"default","creationDate":1779620072,"content":"
\n
Webhooks webinar<\/h5>

\"\" Watch our on-demand webinar<\/a> to learn how to use Adyen webhooks for your integration.<\/p><\/div><\/div>\n\n

A webhook is a lightweight mechanism that allows an Adyen service to push event-driven messages using HTTP POST calls to an endpoint that you define. You need to accept webhooks that you receive with a 2xx HTTP status code, store the message, and process the contents of the message.<\/p>\n

When you configure a subscription to an Adyen webhook, you are requesting to be notified when an event has occurred. With webhooks, you can avoid having to continuously poll an API endpoint, waiting for a change in status for an asynchronous process, or for updates that your account holders make.<\/p>\n

Webhooks are great for long-running processes, where a change in a resource or its status may not occur for many seconds, minutes, hours, or days.<\/p>\n

In this way, you can make an API call, move on to other processes, and then act upon the status change when you receive a notification from Adyen that an event has occurred.<\/p>\n

Why you need to configure webhooks<\/h2>\n

Should you configure webhooks to integrate with Adyen services? Yes, absolutely.<\/p>\n

Webhooks are an essential feature of a successful integration with Adyen. Here are some of the main benefits of using webhooks in your integration.<\/p>\n

Handling asynchronous flows<\/h3>\n

Many flows in Adyen integrations are asynchronous, meaning the final status of a resource is not known immediately after you make an API request. For example, with payment methods like iDEAL<\/a>, it can take time to get a confirmation that the payment was completed.<\/p>\n

Webhooks solve this by sending you a message with the final outcome as soon as it is available. You can also tie payment events to other updates in your backend, such as for order management and inventory control. For example, if a payment is successfully authorized, you can update the order status to \"paid\" and start the shipping process.<\/p>\n

State management<\/h3>\n

You can use webhook messages to confirm or update the state of a resource in your own system. Some Adyen integrations need to manage several connected resources. For example, an Adyen for Platforms<\/a> integration requires you to manage account holders and their associated balance accounts, capabilities, and balances. Webhook messages contain a snapshot of the resource so your system can update its state accordingly.<\/p>\n

Reacting to external events<\/h3>\n

Some important events come from external systems and are not a direct result of an API request you made. Webhooks are the only way to be automatically notified of these events. For example:<\/p>\n