喺商戶中心嘅「設置 - 配置 - 消息通知」頁面，你可以配置新訂單和日報表嘅實時提醒方式。
商戶中心消息通知配置頁面
通知方式
消息通知用於商戶接收新訂單和日報表嘅實時提醒，支援以下通知方式：
郵件通知
釘釘通知
企業微信
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 是否配置正確。