對外 Webhook 能把你學校發生的事件(訂單付款、學員入學、新的課程問答、新的社群貼文等等)即時推送到你自己的網址——串接 Zapier、Make 或自建服務,不需要官方外掛。這是 Pro 方案的功能。
設定方式
到「設定 → Webhook」:
1. 填入接收事件的網址(例如 Zapier「Webhooks by Zapier」提供的 Catch Hook URL)。
2. 勾選你想訂閱的事件類型。
3. 儲存後會生成一組 Signing Secret,複製到你接收端用來驗證簽章。
簽章驗證
每次推送都帶有 X-Webhook-Signature 表頭,是用你的 Signing Secret 對整包 JSON 內容做 HMAC-SHA256 運算的結果。你的接收端用同樣方式重算比對,就能確認請求真的來自本平台。推送失敗會自動重試(指數退避),每次結果都會記錄下來方便排查。
退款事件
order.refunded 會在訂單退款完成時送出(不論是按「退款」、「標記為已手動退款」,或在 Stripe 後台全額退款後自動同步),內容包含訂單編號、退款金額、幣別、課程與買家 email。老師自己的測試訂單不會送出。
訂閱續扣
Stripe Connect 訂閱每期續扣成功時也會送出 order.paid,欄位和一般結帳相同(含 orderId、buyerEmail),另外帶 autoRenewal: true,方便你區分首購和續期。
