現象
預期的支付事件已發生,但你的 Webhook 端點沒有收到請求。常見原因
- 設定的 Webhook URL 錯誤,或指向舊端點。
- URL 不是公開可存取地址。
- 你的端點返回非
2xx回應。 - 端點在回應前逾時。
- 防火牆、WAF 或反向代理攔截了請求。
- 本地開發未使用通道,或通道 URL 已失效。
- 預期事件類型與實際發生的動作不匹配。
在 Kyren 中檢查
- 將控制台設定的 Webhook URL 與目前端點逐字核對。
- 確認 URL 的協定、網域、路徑和尾部斜線行為正確。
- 確認你等待的是該支付狀態會傳送的事件類型。
在你的伺服器檢查
- 將存取日誌與設定的 Webhook URL 和事件時間進行比對。
- 確認端點公開可存取,並接受 HTTPS
POST請求。 - 快速返回
2xx,需要較長處理時使用非同步任務。 - 檢查防火牆、WAF、CDN 和負載平衡規則。
- 本地開發時,確認目前通道 URL 與控制台設定一致。
修復
更新設定的 Webhook URL,確保端點公開可存取,並快速返回2xx 回應。移除會攔截 Kyren 請求的網路規則。