Shopify Webhooks

本地开发怎么接收 Shopify webhook

现象#

本地起的服务没有公网地址,无法配置 callback URL,只能反复部署到线上调试。

原因#

  • webhook 必须 HTTPS 公网可达
  • 隧道工具重启后域名变化,旧订阅失效
  • 本地未校验 HMAC,线上才暴露问题

处理步骤#

  1. 用 shopify app dev,CLI 会自动创建隧道并同步 webhook 配置
  2. 或使用 ngrok/cloudflared 固定子域名,减少重复配置
  3. 本地也开启 HMAC 校验,用 app secret 验签
  4. 准备一组样例 payload 做单元测试,减少对真实事件的依赖

验收标准#

本地能收到真实事件并完成验签与业务处理,隧道重启后订阅自动更新。

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