在商戶中心的「設定 - 配置 - 訊息通知」頁面,您可以配置新訂單和日報表的即時提醒方式。
商戶中心訊息通知配置頁面
通知方式
訊息通知用於商戶接收新訂單和日報表的即時提醒,支援以下通知方式:
郵件通知
釘釘通知
企業微信
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 是否配置正確。