跳到正文

如何用 Webhooks 接收网店通知

创建 Webhook,当有新订单或订单付款、商品或库存变化、新增客户时,BizQ 会向你的服务器发送签名通知。

Webhook 让其他系统(你的网站、ERP 或自动化流程)第一时间知道网店里发生了什么,不用频繁去查询。

创建 Webhook

  1. 打开 独立站 › 网店设置,进入 Webhooks。
  2. 点 新建 Webhook,填写 名称 和 目标地址。
  3. 勾选 事件:新订单、订单已付款、订单已取消、商品变更、库存变化(按分钟合并)、新客户(仅 ID 和邮箱)。
  4. 点 创建 Webhook,并复制签名密钥:之后不会再显示。
  5. 点 发送测试,确认你的服务器能正常响应。

校验签名

每次通知都带 X-Bizq-Timestamp 和 X-Bizq-Signature 两个请求头(v1= + 用密钥对「时间戳 + 点 + 请求体」计算的 HMAC-SHA256)。请用收到的原始请求体校验签名,并拒绝超过 5 分钟的时间戳。

注意事项

  • 仅限 https 和公网地址;不跟随重定向,BizQ 最多等待响应 5 秒。
  • 发送失败会在 24 小时内重试。连续失败 5 天后 Webhook 自动停用;检查目标地址后可重新启用。
  • 在 发送记录 里可以看到每次发送、响应和发送的内容。
  • 密钥丢失时,点 更换密钥:旧密钥立即失效。
  • 每家店最多 10 个 Webhook。需要有修改网店设置的权限。
返回帮助中心