Stripe Connect的account.updated事件Webhook未触发问题求助

核心问题 #

配置Stripe Connect Webhook监听account.updated事件，关联账户完成信息填写后未触发该事件，但本地CLI测试正常，其他事件（如checkout.session.completed）可正常接收，已创建Connect和Account两种类型Webhook。

排查与解决步骤 #

1. 确认Webhook类型的正确性 #

• 关联账户（Connected Account）的account.updated事件仅会发送给Connect类型的Webhook，Account类型Webhook仅监听平台自身账户的更新事件，不会接收关联账户的变更通知。
• 检查Connect类型Webhook的配置：确保创建时选择了“接收来自所有连接账户的事件”，或指定了目标关联账户；若仅选择平台自身，关联账户的事件不会被推送。

2. 验证事件是否实际生成 #

• 登录Stripe Dashboard，进入目标关联账户的「事件」页面，查看是否存在account.updated事件记录：
  • 若Dashboard中无该事件，说明用户完成关联流程的操作未触发account.updated（比如仅完成账户关联，未修改核心字段）。
  • 若Dashboard中有该事件但Webhook未收到，再排查Webhook的推送问题。

3. 检查Webhook的事件订阅配置 #

• 在Stripe Dashboard的Webhook详情页，确认Connect类型Webhook已勾选account.updated事件。避免创建时漏选或后续修改时误取消订阅。

4. 查看Webhook推送日志 #

• 进入Webhook详情页的「事件尝试」日志，查看是否有account.updated事件的推送记录：
  • 若显示推送失败，根据错误信息排查（如签名验证失败、端点不可达、超时等）。
  • 若无该事件的推送记录，说明Stripe未触发该事件，需重新审视业务触发条件。

5. 区分首次关联与账户更新的触发事件 #

• 用户首次完成关联账户流程时，Stripe通常触发account.created（新账户创建）或account.application.authorized（账户授权关联）事件，而非account.updated。
• account.updated仅在关联账户的核心字段发生变更时触发（如修改个人信息、绑定银行账户、更新账户状态等）。若业务逻辑需要在用户首次完成关联时触发通知，应调整为监听上述对应事件。

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