PayPal沙箱订阅Webhook触发异常：仪表盘取消无通知

问题背景 #

已在PayPal沙箱环境配置订阅相关Webhook：

• 通过PayPal API取消订阅时，Webhook能正常触发并接收通知（API取消时的Webhook记录截图：）
• 直接在PayPal沙箱仪表盘手动取消订阅时，完全收不到Webhook通知，且PayPal端的Webhook事件日志、错误日志里找不到任何相关记录
• 用webhook.site测试过，我的Express(Node.js)服务能正常接收API触发的Webhook

1. 确认Webhook事件订阅范围 #

登录PayPal沙箱开发者后台，找到你的Webhook配置：

• 必须勾选SUBSCRIPTION.CANCELLED事件——仪表盘手动取消订阅只会触发这个事件，没订阅的话肯定收不到通知
• 注意区分事件触发场景：部分事件仅支持API操作触发，但SUBSCRIPTION.CANCELLED是同时覆盖手动和API两种操作的

2. 检查沙箱账号与操作对象的匹配性 #

• 仪表盘操作的订阅，必须和Webhook绑定的应用属于同一沙箱开发者账户下的资源，跨账户的订阅操作无法触发Webhook通知
• 手动取消时使用的账号角色需正确：只能是该订阅的买家账号或商家账号，使用无关账号操作不会触发事件

3. 排查沙箱环境延迟问题 #

PayPal沙箱的事件推送和日志刷新存在1-5分钟的延迟，手动取消后不要立即查看日志，等待一段时间后刷新Webhook事件日志页面再确认
若日志仍无记录，尝试重新创建一个测试订阅并通过仪表盘取消，排除单个订阅的异常情况

4. 验证Webhook端点的兼容性 #

虽然API触发能正常接收，但仍需确认：

• 端点是否为公网可访问状态？本地开发服务需通过ngrok等工具暴露公网地址，沙箱无法访问内网资源
• 服务器是否存在针对仪表盘请求的拦截规则？部分防火墙会过滤PayPal仪表盘来源的请求，可临时将端点切换至webhook.site，测试手动取消是否能触发通知，以此排除服务端拦截问题

5. 模拟事件验证端点可用性 #

调用PayPal的Webhook事件模拟API，模拟SUBSCRIPTION.CANCELLED事件：

• 若模拟成功，说明端点配置无问题，问题集中在仪表盘操作的事件触发逻辑，可联系PayPal开发者支持排查沙箱环境的触发机制
• 若模拟失败，需重新检查端点的签名验证、响应状态码（必须返回200 OK）等配置细节

内容的提问来源于stack exchange，提问作者Muhammad Hamza