Webhooks
Last updated: April 23, 2025
With Checkout.com's webhooks feature, you can build notification flows tailored to your business needs, directly in the Dashboard.
You can register up to 100 webhook configurations, selecting the events and entities you’d like to receive notifications for.
Information
You can also use our Workflows API to create webhooks.
Create webhooks to receive notifications about various events related to your account. For example, payment lifecycle activity, identity verification updates, or card issuing status changes.
- Sign in to the Dashboard.
- Select the Developers icon in the top navigation bar and open the Webhooks tab.
- Select New webhook.
- Enter a Name for the webhook to make it easier to identify.
- Enter the Endpoint URL. Webhooks will be sent to this address. The endpoint URL should be prefixed with either https:// or http://.
- Optionally, enter an Authorization header key. This key is included in the header of your webhook to validate that the notification was sent from Checkout.com.
- Optionally, enter a Signature key. We use the key to hash the contents of the notification for the HMAC in the webhook signature.
- You can configure HTTP headers, which will be included in each webhook notification. You can use this to configure a key that you want to provide in your webhook notifications' Authorization HTTP header, allowing you to authenticate requests with your server.
- Choose the events you want the webhook to notify you about. There is no limit to the number of events you can select per endpoint.
- Select the entities or processing channels you want to receive notifications for.
- Select Create webhook to publish your endpoint.
Once you've created the webhook, we'll begin to send relevant notifications to the specified endpoint.
Note
If you do not acknowledge a webhook within 10 seconds, it will time out and fail.
You can temporarily disable a webhook without deleting it:
- Sign in to the Dashboard.
- Select the Developers icon in the top navigation bar and open the Webhooks tab.
The Webhook configurations list displays all webhooks configured for the active entity. - Select the configuration you want to disable to open its details page.
- Select Disable.
By default, webhook configurations are enabled when you create them.
You can re-enable a previously disabled webhook configuration:
- Sign in to the Dashboard.
- Select the Developers icon in the top navigation bar and open the Webhooks tab.
The Webhook configurations list displays all webhooks configured for the active entity. - Select the configuration you want to enable to open its details page.
- Select Enable.
If you have the Create, edit and delete workflow notifications user permission, you can delete webhook configurations that you no longer need:
- Sign in to the Dashboard.
- Select the Developers icon in the top navigation bar and open the Webhooks tab.
The Webhook configurations list displays all webhooks configured for the active entity. - Select the configuration you want to delete to open its details page.
- Select Delete.
Information
You can only delete webhooks if they are linked solely to entities you have access to. If you need to delete webhooks for entities that your permissions do not include, unlink the entities instead.
If a webhook fails, you can use the Dashboard to find out why it failed, and manually retry it.
Note
Retrying a webhook manually may cause duplicates if there are any automatic retries scheduled.
To manually retry a failed webhook:
Sign in to the Dashboard.
Select the Developers icon in the top navigation bar and open the Webhooks tab.
The Webhook configurations list displays all webhooks configured for the active entity.
Webhook configurations with failed webhooks display Failures in the Config status column.Select the configuration with failures to open its details page.
By default, the Webhooks tab displays a list of all unique webhooks that have fired in the previous two weeks, from oldest to newest. You can use the date picker tool to edit the date range, and the filter to find events with a specific status.
Webhooks with failed attempts display Failed in the Status column.Select the failed webhook to open its details page.
The attempt details page displays a log of all attempts for the selected webhook, from oldest to newest. In this page you can view the following details for each attempt:- The date and time of the attempt.
- The response code returned.
- The custom response message you configured.
- The status.
Failed attempts display Failed in the Status column.
Select Retry now to manually trigger a new attempt.