Webhook 與事件通知

當 Receipt Roller 端發生任何事件時，如果您想自動將通知傳送到外部系統，可以使用 Webhook。無需輪詢，即可即時接收事件。

註冊 Webhook

• 開啟組織管理畫面的「開發者」→「Webhook」
• 從「新增註冊」中輸入接收 URL（必須為 HTTPS），並選擇要接收的事件
• 系統會發行用於簽章驗證的密鑰，請妥善保存

主要事件

• 銷售・訂單事件（新增銷售、退款、取消）
• 收據事件（電子收據發行、下載）
• 商品・庫存事件（價格變更、庫存異動）
• 店舖・員工事件（新增店舖、員工新增・離職）

接收端的實作要點

• 請驗證傳送過來的簽章標頭（防止偽造）
• 請盡快回傳 2xx 系列的回應。建議以非同步方式進行處理
• 失敗時系統會自動重試，請將處理設計為冪等（idempotent）

給開發者的詳細資訊

各事件的酬載規格、簽章驗證的範例程式碼、重試間隔等，請參閱開發者說明文件。

https://receiptroller.io/zh-Hant-TW/developer/help

相關文章

• 開發者 API 概要
• API 參考手冊