---
title: "Webhooks"
description: "Receive important updates related to events."
url: "https://docs.adyen.com/development-resources/webhooks"
source_url: "https://docs.adyen.com/development-resources/webhooks.md"
canonical: "https://docs.adyen.com/development-resources/webhooks"
last_modified: "2026-06-01T15:33:16+02:00"
language: "en"
---

# Webhooks

Receive important updates related to events.

[View source](/development-resources/webhooks.md)

##### Webhooks webinar

![](/user/pages/docs/13.development-resources/06.webhooks/help.svg?decoding=auto\&fetchpriority=auto) [Watch our on-demand webinar](https://help.adyen.com/academy/webinars/webhooks#join-live) to learn how to use Adyen webhooks for your integration.

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.

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.

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.

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.

## Why you need to configure webhooks

Should you configure webhooks to integrate with Adyen services? Yes, absolutely.

Webhooks are an essential feature of a successful integration with Adyen. Here are some of the main benefits of using webhooks in your integration.

### Handling asynchronous flows

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](/payment-methods/ideal), it can take time to get a confirmation that the payment was completed.

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.

### State management

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](/platforms) 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.

### Reacting to external events

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:

* **[Onboarding verification](/issuing/onboard-users/onboarding-steps?location=nl\&legal_entity=individual#get-verification-updates)**: For [Adyen for Platform](/adyen-for-platforms-model) integrations, receive webhook messages when Adyen verifies your users and enables capabilities, or when more information is required to complete verification.
* **[Dispute management](/risk-management/disputes-api/dispute-notifications)**: When a shopper initiates a [chargeback](/get-started-with-adyen/adyen-glossary#chargeback), Adyen sends a webhook message. This allows you to start the dispute resolution process immediately by gathering evidence and submitting a defense.
* **[Report generation](/reporting/automatically-get-reports#get-notifications)**: Receive webhook messages when new reports become available, so you can [download reports](/reporting/automatically-get-reports#download-reports) for accounting and reconciliation purposes.
* **[Relayed authorisation](/issuing/authorisation/relayed-authorisation)**: For integrations using Adyen Issuing, receive a webhook message when a cardholder of an Adyen-issued card makes a payment.

For a list of webhook events that Adyen supports, see [Webhook structure & types](/development-resources/webhooks/webhook-types).

## Next steps

[required](/development-resources/webhooks/configure-and-manage)

[Configure and manage webhooks](/development-resources/webhooks/configure-and-manage)

[Learn how to configure and manage subscriptions to Adyen webhooks.](/development-resources/webhooks/configure-and-manage)

[required](/development-resources/webhooks/secure-webhooks)

[Secure your webhooks](/development-resources/webhooks/secure-webhooks)

[Learn about best practices for securing your webhooks.](/development-resources/webhooks/secure-webhooks)

[required](/development-resources/webhooks/handle-webhook-events)

[Handle webhook events](/development-resources/webhooks/handle-webhook-events)

[Learn how to handle a webhook message you receive for an event.](/development-resources/webhooks/handle-webhook-events)

[Webhook structure and types](/development-resources/webhooks/webhook-types)

[Learn which webhook types are sent for each event.](/development-resources/webhooks/webhook-types)

[Troubleshoot webhooks](/development-resources/webhooks/troubleshoot)

[Find, diagnose, and resolve webhook delivery failures using the tools in your Customer Area.](/development-resources/webhooks/troubleshoot)
