在商户中心的「设置 - 配置 - 消息通知」页面，您可以配置新订单和日报表的实时提醒方式。
商户中心消息通知配置页面
通知方式
消息通知用于商户接收新订单和日报表的实时提醒，支持以下通知方式：
邮件通知
钉钉通知
企业微信
WebHook
使用建议
通常您只需要选择其中一个常用的通知方式即可。WebHook 通知可以自定义更多的通知信息。
WebHook 通知
WebHook 通知可以自定义更多的通知信息，适合需要与自有系统集成的场景。
订单相关钩子
| 事件 | 钩子名 |
|---|---|
| 订单创建 | order_create_hook |
| 订单支付 | order_pay_hook |
| 订单取消 | order_cancel_hook |
| 订单退款 | order_refund_hook |
| 订单缺货 | order_out_of_stock_hook |
| 订单完成 | order_finish_hook |
仓库相关钩子
| 事件 | 钩子名 |
|---|---|
| 库存不足报警 | stock_alarm_hook |
| 密钥不足报警 | key_stock_alarm_hook |
统计相关钩子
| 事件 | 钩子名 |
|---|---|
| 近两日单数及总额 | order_count_amount_hook |
签名验证
WebHook 密钥用于对请求内容进行签名验证，确保请求未被篡改且来源可靠。签名计算步骤：
- 将当前时间戳（毫秒）+
\n+ 密钥 拼接为签名字符串，使用 HmacSHA256 算法计算签名 - 对计算结果进行 Base64 encode
- 对 Base64 结果进行 urlEncode（使用 UTF-8 字符集），得到最终签名
Request Headers
| Header | 说明 |
|---|---|
Content-Type | application/json |
User-Agent | apsdai-hook（标识来自 APSDAI 的请求） |
X-Apsdai-Token | 密码或计算后的签名 |
X-Apsdai-Timestamp | 触发 WebHook 的时间戳 |
X-Apsdai-Event | 触发的钩子类型 |
测试功能
配置完成后，可以点击「测试」按钮验证 WebHook 是否配置正确。