如何用 Webhooks 接收网店通知
创建 Webhook,当有新订单或订单付款、商品或库存变化、新增客户时,BizQ 会向你的服务器发送签名通知。
Webhook 让其他系统(你的网站、ERP 或自动化流程)第一时间知道网店里发生了什么,不用频繁去查询。
创建 Webhook
- 打开 独立站 › 网店设置,进入 Webhooks。
- 点 新建 Webhook,填写 名称 和 目标地址。
- 勾选 事件:新订单、订单已付款、订单已取消、商品变更、库存变化(按分钟合并)、新客户(仅 ID 和邮箱)。
- 点 创建 Webhook,并复制签名密钥:之后不会再显示。
- 点 发送测试,确认你的服务器能正常响应。
校验签名
每次通知都带 X-Bizq-Timestamp 和 X-Bizq-Signature 两个请求头(v1= + 用密钥对「时间戳 + 点 + 请求体」计算的 HMAC-SHA256)。请用收到的原始请求体校验签名,并拒绝超过 5 分钟的时间戳。
注意事项
- 仅限 https 和公网地址;不跟随重定向,BizQ 最多等待响应 5 秒。
- 发送失败会在 24 小时内重试。连续失败 5 天后 Webhook 自动停用;检查目标地址后可重新启用。
- 在 发送记录 里可以看到每次发送、响应和发送的内容。
- 密钥丢失时,点 更换密钥:旧密钥立即失效。
- 每家店最多 10 个 Webhook。需要有修改网店设置的权限。