Shopify Webhooks

Shopify Webhook orders/create 收不到

现象#

后台已订阅 orders/create,测试下单后端点无请求。Webhook 列表显示投递失败或从未投递。本地隧道以为连着,实际 Shopify 打到旧 URL。

原因#

订阅地址错误、HTTP 非 200、SSL 问题、应用未卸载重装导致订阅丢失、或事件名/API 版本不匹配。测试店与生产店搞混时也会“收不到”。

步骤#

  1. 在后台或 Partner 应用查看 Webhook 投递日志与最后响应码。
  2. 用cli/隧道确认公网 URL 与订阅一致,更新过期隧道。
  3. 端点先返回 200 再异步处理。
  4. 用 Admin API 列出 webhook 订阅核对 topic。
  5. 对照 Webhook 文档。
  6. 下测试单并在 Asia/Shanghai 记录到达时间。

验收#

连续三笔测试单均在 5 秒内到达且验签通过。

本文由 风格技术 技术团队整理,适用于 Shopify 标准版与 Plus 店铺。Shopify 平台能力迭代较快,具体操作路径与字段以官方文档和店铺后台实际版本为准。