Prompt
Stripe webhooks retrying too much
Latest observation
Oct 9, 2026
OpenAI APIWeb search: off
If Stripe webhooks are retrying “too much,” it usually means Stripe is not getting a fast 2xx response from your endpoint, or your endpoint is intermittently failing.
Most common causes
- Your handler is returning non-2xx
- 500/502/503 errors
- 404 because the route is wrong
- 401/403 because auth is blocking Stripe
- Signature verification is failing
- Using the wrong webhook secret
- Reading/parsing the body before verification
- Body is altered by middleware
- Timeouts
- Your webhook does too much work before responding
- Database/API calls are slow
- Duplicate processing
- Your endpoint succeeds, but your app isn’t idempotent, so retries look like “too many”
- Temporary infrastructure issues
- Serverless cold starts, load balancer issues, deploys, DNS, etc.
What Stripe expects
- Respond with 200 OK as quickly as possible
- Do any heavy work after acknowledging the event, ideally in a background job/queue
- Make webhook processing idempotent using the
event.id
What to check in Stripe Dashboard
Go to: Developers → Webhooks → your endpoint → Attempts
- Look at:
- HTTP status codes
- response body
- latency
- whether retries are from the same event
Recommended pattern
- Verify signature
- Store/process event idempotently
- Return
200immediately - Queue any expensive work
Example of a good webhook flow
- Receive event
- Validate signature
- Check if
event.idwas already processed - Save event / enqueue job
- Return
200 - Process asynchronously
If you’re using a framework
Some common gotchas:
- Express
- Need raw body for signature verification
express.json()before webhook route can break verification unless configured properly
- Next.js / serverless
- Ensure raw body handling is correct
- Avoid long-running work inside the request
- Rails/Django/Laravel
- CSRF or middleware may interfere
Quick fix checklist
- Confirm the endpoint returns 2xx in under a second
- Check logs for 4xx/5xx responses
- Verify the webhook signing secret
- Ensure raw request body is used for signature verification
- Make processing idempotent
- Move slow work to a background queue
If you want, paste:
- your webhook code,
- the framework/language,
- and one failed Stripe attempt log,
and I can help pinpoint the exact cause.