Stripe staging环境invoice.paid事件未触发，环境事件差异排查求助

• 核对环境间的订阅逻辑一致性
  确认staging环境与开发环境使用完全相同的API参数与操作流程：

  • 检查创建订阅时的payment_behavior（是否为default_incomplete/allow_incomplete）、collection_method（charge_automatically或send_invoice）、start_date等参数是否一致
  • 确认订阅激活方式：是调用subscription.activate API，还是依赖自动激活逻辑？激活时是否触发了付款尝试

• 让客户协助检查Stripe Dashboard核心记录

  • 查看目标订阅对应的发票状态：若发票为open/voided而非paid，则不会触发invoice.paid
  • 检查付款记录：是否存在付款成功/失败的记录？付款失败（如卡片拒付、余额不足）会导致发票无法变为已支付状态
  • 搜索事件日志：查找该订阅/发票关联的invoice.created、invoice.finalized、payment_intent.succeeded等事件，定位流程断点

• 排查Webhook配置问题

  • 确认staging账户的Webhook已订阅invoice.paid事件，且端点URL正确、状态正常（无Stripe标记的失败记录）
  • 检查Webhook是否设置了事件过滤规则，是否误排除了invoice.paid
  • 验证签名配置：若签名验证失败，Stripe会停止向该端点发送事件，可能造成“事件未触发”的假象

• 检查账户全局设置差异

  • 确认账户是否开启自动付款功能：若collection_method设为charge_automatically但自动付款被禁用，发票不会自动完成支付
  • 查看预付款配置：未来式订阅是否要求预付款？若未完成预付款，订阅激活后发票会处于待支付状态
  • 排查是否存在账户级事件通知限制：是否关闭了invoice.paid的事件通知，或设置了严格的事件白名单

• 执行最小化测试
  让客户在staging环境用测试卡片（如4242 4242 4242 4242）创建最简未来式订阅，手动激活后观察发票状态与事件生成情况，对比开发环境的测试流程缩小问题范围

• 对比API响应差异
  保存staging环境创建/激活订阅时的完整API响应，与开发环境的响应做对比：

  • 重点核对订阅、发票、付款意向的status字段
  • 对比next_payment_attempt、collection_method等关键参数的取值差异

内容的提问来源于stack exchange，提问作者Ritwik Math