Troubleshooting webhook delivery issues
Webhooks deliver Events to your Webhook Endpoint using HTTP requests. If Events aren't being delivered to your Webhook Endpoint as expected, this article will help you determine the cause of the issue and fix the problem.
Note: when an Event cannot be successfully delivered to your Webhook Endpoint we will retry delivery several times.
Determine the issue
The first step is to figure out what the issue is from Stripe's point of view:
- Go to the Webhooks page in your Dashboard
- Select the Webhook Endpoint experiencing delivery failures
- Switch to the Failed tab
- Select one of the Events in the list
- Press the ••• button on the right and select View event
- Under Webhook attempts expand the delivery attempt
Look at the HTTP status code and go to the matching article below for next steps. The information in the Response may also be helpful.
- Webhooks: how to investigate and fix "Connection to remote host denied"
- Webhooks: how to investigate and fix "TLS error"
- Webhooks: how to investigate and fix "Timed out"
- Webhooks: what to do when the HTTP status code starts with a three (3xx)
- Webhooks: what to do when the HTTP status code starts with a four (4xx) or five (5xx)
Note: you may need to follow these steps several times if you're experiencing several different delivery failure conditions.
Did this answer your question?
Related articles