授權事件通知

當授權啟用、續期或被撤銷時，Licentivo 可以向你的伺服器發一條通知，用來同步訂單、客戶和售後系統。

要實現授權到期與續費提醒，可以訂閱即將到期、到期和續期事件，由你的網站核對最新狀態后傳送客戶電子郵件。事件通知提供狀態變化，不會自動替廠商向客戶傳送提醒。

添加通知位址

打開“授權事件通知”，添加你伺服器的 HTTPS 位址，選擇需要的事件。儲存時會顯示一次簽章金鑰，把它儲存在接收通知的伺服器上。正式環境不允許請求本機或內網位址。

接收后檢查簽章

讀取 X-Licentivo-Timestamp、X-Licentivo-Event 和原始請求正文。拼接為“時間戳記 + 點號 + 事件 ID + 點號 + 正文”，用簽章金鑰計算 HMAC-SHA256。加上 sha256= 前綴后，與 X-Licentivo-Signature 做恒定時間比較。時間戳記與當前時間相差超過 5 分鐘時拒絕。

事件 ID 是去重依據。先檢查簽章，再把事件放入自己的事務或隊列，持久化成功后返回 2xx。重復事件返回 2xx 即可，不重復執行訂單操作。

失敗會怎樣？

系統最多自動嘗試 8 次，逐步延長重試間隔。控制臺能查看每次 HTTP 狀態、嘗試時間和錯誤，也可以手動重新投遞。事件與授權操作在同一個資料庫事務里記錄，服務重啟后會繼續投遞。

支援建立、更新、續期、撤銷、啟用、釋放、功能消耗、即將到期、到期和維護期變化事件。通知只帶授權前綴，不包含完整授權金鑰。