Help for owners
Shopify says it sent the message, but my system never got it
Short answer
Shopify counts a webhook as failed if your endpoint does not answer with a 200-series code within five seconds. It retries up to eight times over four hours, and if failures persist the subscription is removed. Do not recreate anything yet. Note when messages stopped and send that to your developer.
Does this sound like your situation?
- Orders exist in Shopify but never appear in my other system.
- It worked for months and stopped on one day.
- My developer says the webhook was deleted and nobody deleted it.
- Some updates arrive twice and others never arrive.
- My connected app shows no recent activity from Shopify.
Why does this happen?
The receiving address did not answer fast enough
Shopify states that any response outside the 200 series is a failed delivery, and that the app has five seconds to respond. Its advice is to send the response first and process the data afterwards.
Confirmed by shopify.dev
After repeated failures the subscription is removed
Shopify retries a failed call up to eight times in a four-hour period, with longer waits each time. If failures persist, the subscription is removed, and it receives nothing until it is created again.
Confirmed by shopify.devTechnical detail: nginx gives up waiting for the app and returns 504
A moved server or changed certificate breaks the delivery
Shopify treats redirects (3XX codes) as errors and uses a one-second connection timeout. A new host, a new address that redirects, or a certificate problem can make every delivery fail even though the app itself is fine.
Confirmed by shopify.devTechnical detail: The site looks fine in a browser but its SSL chain is incomplete
The app rejects genuine messages after a secret change
Each HTTPS delivery carries a signature made with the app's client secret and the raw request body, and the app is told to verify it. After a secret rotation, Shopify says the new secret can take up to an hour to be used for the signature.
Confirmed by shopify.dev
Webhooks were never meant to be the only source
Shopify says an app should not rely on receiving data from webhooks, and recommends a job that periodically fetches data from Shopify as a backup. It also says order is not assured and duplicates must be ignored.
Confirmed by shopify.dev
What can I do about it today?
- Write down when it stoppedFind the last order or update that did arrive, with its date and number. That marks the gap that must be filled.
- Do not uninstall or reinstall the connected appReinstalling can change keys and settings and break parts that still work. Leave it until someone has looked.
- Do not re-enter orders by handIf a webhook later catches up, a hand-typed order becomes a duplicate. Keep a plain list of missing order numbers instead.
- Ask whether the server or domain changedA new host, a renewed or changed certificate, a new address or a plugin update just before the problem is the most useful clue.
- Send your developer the listThe last good order, the first missing one, and the name of the app or system that should receive them.
When should I bring someone in?
- Paid orders are not being fulfilled or shipped.
- Nobody knows which app or server is meant to receive the messages.
- You changed hosting, domain or certificate shortly before it stopped.
How do I handle it?
- Find the first failureI compare Shopify's delivery information with your receiving server's logs and find the first delivery that failed and why.
- Fix the causeReachability, certificate, signature secret or slow handling. I make the endpoint answer immediately and do the real work in a queue.
- Check the subscriptionsI list the subscriptions that exist and create any that were removed, instead of guessing.
- Fill the gap safelyI fetch the records from the outage period and run them through the same processing, with checks that ignore duplicates.
- Add a backup pathA scheduled reconciliation compares Shopify with your system, and an alert tells you when deliveries start failing.
The price depends on what I find, so I quote in writing after a short discovery call. Tell me what is happening and I reply within 24 hours.
What do owners ask about this?
Are the missed orders lost?
No. The orders are still in Shopify. Shopify advises fetching the records from the outage period and passing them through the same processing code.
How long does Shopify keep retrying?
Up to eight times in a four-hour period. After that the delivery is not retried, so a longer outage leaves a gap that has to be filled from Shopify's data.
Why did the webhook disappear without anyone deleting it?
Shopify states that if failures persist the subscription is removed. For subscriptions created through the Admin API it may delete them after the failed retries.
Sources
How was this page made?
I drafted this page with AI assistance from the official documents listed under Sources. Found a mistake? Tell me.
For your developer: the technical fixes
504 Gateway Time-outnginx gives up waiting for the app and returns 504Is this SSL certificate chain broken?The site looks fine in a browser but its SSL chain is incompleteWebhook signature verification failed. Err: No signatures found matching the expected signature for payload.Stripe webhook: no signatures found matching the expected signature