Maaz Zindani

Loading the index…

↑↓ move↵ openesc close4072 pages

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.

  • Written for business owners
  • Updated
  • By Maaz Zindani, Senior Software Engineer

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?

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

What can I do about it today?

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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?

  1. Find the first failureI compare Shopify's delivery information with your receiving server's logs and find the first delivery that failed and why.
  2. Fix the causeReachability, certificate, signature secret or slow handling. I make the endpoint answer immediately and do the real work in a queue.
  3. Check the subscriptionsI list the subscriptions that exist and create any that were removed, instead of guessing.
  4. Fill the gap safelyI fetch the records from the outage period and run them through the same processing, with checks that ignore duplicates.
  5. 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

Next step

Want this off your desk?

Send me a few lines on where things stand. I reply within 24 hours.