Webhook 沒有送達

釐清步驟

步驟 1：查看開發者入口網站的傳送紀錄

開發者入口網站 → 應用程式 → Webhook → 相關端點 → 「傳送紀錄」

步驟 2：「連紀錄本身都沒有」時的檢查

• ☐ 端點是否為「啟用」狀態（停用中原本就不會傳送）
• ☐ 是否有訂閱相關事件
• ☐ 在目標店鋪篩選中，自己是否未被排除
• ☐ 該事件是否真的有發生（狀態頁面是否出現延遲）
• ☐ 應用程式本身是否未被停止、撤銷

步驟 3：「逾時」「連線失敗」時

• ☐ 接收 URL 是否可從外部到達（以瀏覽器嘗試存取）
• ☐ 是否不在公司內 VPN 內
• ☐ TLS 憑證是否有效（自簽 NG）
• ☐ 防火牆是否允許 ReceiptRoller 的送出來源 IP
• ☐ 接收處理是否在 10 秒內回傳 2xx

步驟 4：「4xx 拒絕」時

• ☐ 是否未在簽章驗證失敗（回傳 401）
• ☐ 在路由中相關 URL 是否未變成 404
• ☐ 回應本文是否未出現實作來源的錯誤

以測試傳送確認

可從開發者入口網站的「測試傳送」按鈕，送出樣本事件來驗證接收端。

1. 相關端點 → 「測試傳送」
2. 選擇事件類型
3. 「傳送」
4. 確認接收端的日誌與回應碼

失敗訊息（dead letter）的重新傳送

修正接收端之後，可從傳送紀錄的「dead letter」篩選手動重新傳送。自傳送起 30 天內有效。

相關指南

• Webhook 監控與失敗時的因應
• 簽章驗證與安全性
• 重送、順序、冪等性的設計
• 返回開發者幫助中心