Webhooks
Last updated: January 10, 2024
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 50 webhook endpoints, 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 through the Dashboard to receive notifications about various events related to your account. For example, payment lifecycle activity, identity verification updates, or card issuing status changes.
- Go to the Developers > Webhooks page.
- 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://.
- Enter an Authorization header key. This key will be included in the header of your webhook to validate that the notification was sent from Checkout.com.
- Enter a Signature key. This field is required as 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.
If you have the manage notifications permission, you can delete webhooks that are no longer needed. To do this, go to the Webhook details page and select Delete in the top right.
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.