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

订阅账单支付失败时对应的正确Stripe事件是什么?

问题解答

你的猜想完全正确,invoice.payment_failed 事件完全适配 collection_method 设为 send_invoice 的订阅场景,同时覆盖你提到的两类异常情况:

  • 客户主动付款操作失败:比如客户提交支付后出现卡片余额不足、银行卡权限受限、卡号信息错误等场景会触发该事件
  • 客户超时未支付账单:当账单超过设置的付款截止日期(due_date)后仍未收到客户支付款项,Stripe也会自动触发该事件

额外注意事项

  • 如果你在Stripe后台配置了账单自动重试规则,每一次重试支付失败都会触发一次invoice.payment_failed事件,你可以通过事件返回参数中的attempt_count字段判断当前是第几次支付尝试
  • 若账单最终被系统标记为无法收回,会额外触发invoice.marked_uncollectible事件,你可以根据业务需要选择性监听该事件做坏账、暂停服务等后续处理

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.03 00:09:04