Webhook Reliability Playbooks

Start with the symptom

It never arrived Shopify Webhook Not Arriving

Determine whether Shopify never attempted delivery, the intake rejected it, Webhook Guard did not match an integration, or processing failed later.

It arrived, but nothing happened Webhook Received, but Nothing Happened

Trace the event after HTTP acceptance through routing, queueing, workers, database work, and downstream APIs.

It happened twice Duplicate Shopify Webhooks

Separate repeated Shopify delivery, Webhook Guard retry, worker retry, and duplicate business side effects.

Shopify rejected the signature Shopify HMAC Verification Failed

Diagnose raw-body, secret, encoding, middleware, and environment mismatches.

Shopify keeps retrying Shopify Webhook Timeouts and Retries

Identify which retry layer is active and move slow work behind a durable acknowledgment boundary.

The order is missing in ERP Shopify Order Missing in ERP

Find the last completed stage, check partial side effects, and choose replay or reconciliation safely.

Recovery guidance

Choose a recovery method

Replay, redelivery, and reconciliation solve different problems. Choose only after confirming how far the original event progressed.

Compare recovery methods

Pipeline diagnostic map

Shopify Business object and topic trigger Subscription Topic and destination configuration Shopify delivery Delivery ID, status, response time Webhook Guard intake Event record, headers, payload Integration match Matched topic and destination Downstream delivery Attempt status and response Customer processing Queue, worker, transaction Business state ERP, OMS, WMS, or database record

Text equivalent: diagnose the event from source action, subscription, provider delivery, intake, routing, downstream delivery, customer processing, and final business state.

Choose by failure stage

Shopify action and subscription Shopify Webhook Not Arriving Shopify delivery and timeout Shopify Webhook Timeouts and Retries Webhook Guard intake and authentication Shopify HMAC Verification Failed Downstream endpoint delivery Webhook Received, but Nothing Happened Customer application processing Webhook Received, but Nothing Happened ERP or final business state Shopify Order Missing in ERP

Need the event history before you can diagnose the failure?

Webhook Guard records received events, matched integrations, destination attempts, response status, response time, duplicate classification, invalid signatures, and retry activity so teams can investigate from evidence.