You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

测试模式下Stripe Connect账户状态变更时account.updated webhook未触发

Stripe Custom Connect 测试模式下account.updated事件未触发排查方案

按优先级从高到低排查以下问题:

  • 检查webhook的事件监听范围配置
    Stripe主账户事件和Connect子账户事件的webhook配置是完全独立的。如果配置端点时没有开启*监听已连接账户的事件(Listen to events on Connected accounts)*开关,没有在Connect专属事件列表中勾选account.updated,子账户的所有状态变更都不会推送到你的端点。注意不要和主账户侧的同名account.updated事件混淆,两者属于不同的事件域。
  • 确认测试环境onboarding流程符合触发规则
    测试模式下只有通过stripe.accountLinks.create生成的官方Account Link跳转完成表单提交,才会触发子账户状态从Restricted到Complete的流转,对应触发account.updated事件:
    • 如果你本地mock了表单提交流程、或者直接在Stripe后台手动修改子账户的能力开关/合规状态,Stripe不会生成对应的webhook事件
    • 如果创建Custom账户时就通过API传入了所有要求的合规字段(身份信息、经营信息、结算账户信息等),账户会在创建完成后直接进入Complete状态,对应的状态变更会合并到account.created事件中推送,不会单独触发后续的account.updated
  • 验证webhook端点连通性与事件生成记录
    进入webhook端点详情页,选择Connect域下的account.updated事件发送测试推送:
    • 如果测试推送失败,检查端点是否存在鉴权拦截、IP白名单限制、签名校验逻辑错误(注意Connect事件签名校验使用当前webhook端点的专属签名密钥,不要混用主账户密钥或其他端点的密钥),端点必须在3秒内返回2xx状态码才算接收成功
    • 如果测试推送正常,进入Stripe后台「Events & logs」页面,筛选对应子账户ID+account.updated事件类型:如果后台已存在对应事件记录但未送达端点,回到webhook配置页检查事件筛选规则;如果后台根本没有生成对应事件,说明之前的onboarding操作没有实际触发账户状态变更。
  • 排查测试模式特殊限制
    测试模式下如果onboarding表单提交后存在缺失的合规字段,账户会保持Restricted状态,不会触发代表开户完成的account.updated事件,只有当charges_enabled和payouts_enabled两个字段都变为true时,才会推送对应状态更新的事件。

内容的提问来源于stack exchange,提问作者Quentin Lerebours

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.30 14:06:22