PayPal沙箱Webhook正常，切换至生产环境后无响应求助

• 验证Webhook事件订阅范围
  确认生产环境Webhook已明确勾选PAYMENT.CAPTURE.COMPLETED事件，沙箱与生产环境的Webhook配置完全独立，不可直接复用沙箱的订阅设置。

• 检查端点公网可达性与请求处理能力

  • 生产环境Webhook端点必须为公网可访问地址，PayPal服务器无法访问内网或本地地址；
  • 模拟PayPal Webhook请求结构发送测试POST请求，验证端点是否能在15秒内返回200状态码（PayPal要求超时阈值为15秒，超时会触发重试但可能无日志）；
  • 检查服务器防火墙、安全组规则，确保放行PayPal生产环境的IP段，避免请求被拦截。

• 核对签名验证配置

  • 替换沙箱签名秘钥为生产环境专属的Webhook签名秘钥，在PayPal后台Webhook详情页重新复制秘钥并更新至代码配置；
  • 确认签名验证逻辑正确性：使用PayPal官方SDK或HMAC-SHA256算法验证请求头中的Paypal-Transmission-Sig，避免因签名验证失败导致请求被静默丢弃。

• 查看PayPal生产环境Webhook投递日志
  登录PayPal生产后台进入Webhook仪表盘，查看事件投递记录：

  • 若显示“已投递”，说明问题出在端点接收或后续处理环节，需排查自身服务的日志（如请求是否被路由、是否被中间件拦截）；
  • 若显示“投递失败”，根据失败原因（如连接超时、拒绝连接）针对性修复；
  • 若无任何记录，确认测试支付是否实际触发了PAYMENT.CAPTURE.COMPLETED事件——只有成功完成的资金捕获操作才会触发该事件，需确保支付流程完成了捕获步骤（而非仅授权）。

• 确认应用状态与权限

  • 检查生产环境PayPal应用是否已通过审核并处于“上线”状态，未审核通过的应用可能无法触发Webhook事件；
  • 确认应用已申请并获得payments.capture.read等相关权限，权限不足会导致事件无法正常推送。

内容的提问来源于stack exchange，提问作者Misha Mikhail