Stripe 订阅付款失败:Smart Retry、重试次数和失败后状态怎么核对(2026)
摘要:独立站或 SaaS 用 Stripe 按期扣订阅时,续费失败后先在 Billing 的 Revenue recovery 里核对重试策略。新账户默认开启 Smart Retries,最多 8 次、窗口 2 周;也可改成自定义最多 3 次重试。重试用尽后,订阅会按你的设定变成 canceled、unpaid、past_due 或 paused。发卡行硬拒、没有可用付款方式、印度发行的卡或已断开的 Connect 账户,系统不会自动再扣。依据 Stripe 官方文档,查询日期 2026-11-19。只放官网普通链接(affiliate_later)。
本文依据 Stripe 文档 Automate payment retries、How subscriptions work、Pause subscriptions after payment failure。查询日期:2026-11-19(北京时间)。本文只放官网普通链接,本站暂无 Stripe 联盟返佣(
affiliate_later)。重试次数、窗口和失败后状态以你打开 Dashboard 时的设定,以及官方文档的当前页为准。不构成法律、税务或合规意见。
独立站或 SaaS 靠 Stripe 按月或按年扣订阅时,买家卡过期、余额不足或被发卡行拒掉,续费发票就会扣失败。这时先要在 Billing 的 Revenue recovery 里核对三件事:系统会不会自动重试、最多几次、窗口多长;哪些失败根本不会再扣;重试用尽后,订阅会变成 canceled、unpaid、past_due 还是 paused。买方在自己那一头看拒付码、换卡的步骤,见本站海外订阅续费失败:卡组织拒付码与换卡核对清单。下面只核商户账户里的重试策略和失败后状态,不写买方换卡操作,也不估计能追回多少收入。
发票付款链接的到期日、付款状态和到账,见Stripe 发票付款链接:到期日、付款状态和到账怎么核对。已经成功入账、要看自动提现计划的,见Stripe 自动提现:计划、可用余额和银行到账怎么核对。这三篇不要混在一次核对里。
1. 先打开 Revenue recovery,看默认 Smart Retries
在 Dashboard 里打开 Billing > Revenue recovery > Retries。文档写明:Smart Retries 会按你设定的次数和最长时间窗口,为失败的订阅付款和发票付款自动再扣,也包括用付款链接创建的订阅。一次性发票的重试入口在 Settings > Billing > Invoices 的 Advanced invoicing features;Direct Debit 要走付款方式自己的重试设置,不要和卡的重试策略当成同一处。
新开的 Stripe 账户默认开启 Smart Retries,并配置为在 2 周内最多重试 8 次。你可以把窗口改成 1 周、2 周、3 周、1 个月或 2 个月,并指定这段时间里重试几次。也可以用 automations 给不同客户分组配不同策略。文档还写,Smart Retries 会根据一些随时间变化的信号来选再扣时点,例如某张付款方式最近在多少台设备上出现过,以及部分国家借记卡在当地时间 12:01 a.m. 附近成功率可能略高。具体下一次何时再扣,以发票上的 next_payment_attempt 为准,不要用口口相传的“隔几天再扣一次”来推算。
如果你关掉 Smart Retries,改用自定义规则,最多可以设 3 次重试,每一次写明距离上一次尝试多少天。开启催收(dunning)后,发票的 next_payment_attempt 会标出下一次扣款时间。文档提醒:改订阅设置只影响以后的重试;最后一次尝试之后,系统不会再继续扣这一张发票。
2. 先核对哪些失败根本不会自动再扣
官方文档列出了四种不会重试的情况:没有可用的付款方式;发卡行返回硬拒码(hard decline code);付款卡由印度发行;Stripe Connect 账户已经断开。
硬拒码包括:incorrect_number、lost_card、pickup_card、stolen_card、revocation_of_authorization、revocation_of_all_authorizations、authentication_required、highest_risk_level、transaction_not_allowed。遇到这些码,系统仍会按计划排重试,并且 attempt_count 还会往上加,但只有在检测到新的付款方式之后,这次重试才会真正执行。未执行的重试不会生成新的 Charge。
更新付款方式时,要改当初失败的那一个字段。文档举的例子是:如果订阅上已经有 subscription.default_payment_method,你只改了 customer.invoice_settings.default_payment_method,系统仍会继续对着订阅自己的默认付款方式重试。重试时的选用顺序是:订阅的 default_payment_method,然后是订阅的 default_source,再然后是客户的默认付款方式,最后才是旧的 customer.default_source。
要接收失败和重试更新,文档建议监听 invoice.payment_failed。attempt_count 表示到目前已经尝试了多少次。用了 automations 之后,next_payment_attempt 改到 invoice.updated 事件里查看,不要再到 invoice.payment_failed 里找这一项。
3. 重试用尽后,订阅会落到哪一种状态
扣款方式为 collection_method=charge_automatically 时,续费失败会让订阅进入 past_due。系统仍会按你的重试设定继续开票并尝试扣款。重试结束后,Dashboard 里的失败付款设定决定下一步:
- Cancel the subscription:达到重试窗口的最大天数后,订阅变为
canceled。 - Mark the subscription as unpaid:订阅变为
unpaid。之后仍会生成发票,但发票会停在草稿状态。 - Leave the subscription past-due:订阅保持
past_due,系统仍会按重试设定继续向客户扣款并生成发票。 - Pause the subscription:如果这份订阅符合条件,会变为
paused。在恢复之前,系统不会再为它生成新的订阅发票。
文档写明,暂停只适用于符合条件、并且使用 flexible billing mode 的订阅。失败付款设定是账户级的,只有符合条件的订阅才能暂停。如果把最终动作设成暂停,但第一次失败后无法暂停,订阅会留在 past_due;如果最后一次失败后仍无法暂停,系统改为取消订阅。
要在 Dashboard 里看暂停时机,仍是 Billing > Revenue recovery > Retries 里的 Subscription status。你可以选择在第一次续费扣款失败后暂停,或在重试用尽后再暂停。第一次续费失败后的暂停,不适用于开通订阅时的那张初始发票。这份页面还写了暂停后如何恢复、未使用时长贷记只出现在“第一次续费失败即暂停”这一种情形。细节以Pause subscriptions after payment failure 的当前页为准,不要按口头规则去关客户的使用权。
4. 本地直接扣款的重试,不走卡的 Smart Retries
ACH、SEPA、Bacs 这类直接扣款,要在对应付款方式的设置里打开重试,不要沿用卡的重试策略。如果该付款方式没有启用重试,失败后系统不会再扣。文档给出的可重试失败类型都是余额不足,次数和窗口如下(查询当天口径):
| 付款方式 | 可重试失败 | 最多重试 | 最长窗口 |
|---|---|---|---|
| ACH Direct Debit | 余额不足 | 2 次 | 40 天 |
| Canadian pre-authorized debit | 余额不足 | 1 次 | 30 天 |
| Australia BECS Direct Debit | 余额不足 | 4 次 | 30 天 |
| Bacs Direct Debit | 余额不足 | 2 次 | 30 天 |
| New Zealand BECS Direct Debit | 余额不足 | 1 次 | 5 个日历日 |
| SEPA Direct Debit | 余额不足 | 2 次 | 30 天 |
文档加了一句:即便打开了本地付款方式重试,付款仍可能失败;Stripe 不为“没有重试到某笔本地付款”承担损失。核对这些数字时,以你打开文档当天的表格为准。
5. 发布前可以按这张清单过一遍
- □ Dashboard 已打开 Billing > Revenue recovery > Retries;新账户若仍是默认值,应能看到最多 8 次、窗口 2 周,或你后来改过的次数与窗口。
- □ 已分清:没有付款方式、硬拒码、印度发行的卡、已断开的 Connect 账户,不会自动再扣;硬拒后必须换到新的付款方式,重试才会真正执行。
- □ 更新付款方式时,改的是当初失败的那个字段,不要只改客户档案上的另一处默认项。
- □ 重试用尽后的动作已经选定:canceled、unpaid、past_due 或 paused;若选暂停,已对照文档确认订阅是否属于 flexible billing mode、是否符合暂停条件。
- □ 若使用 ACH、SEPA 等直接扣款,已在对应付款方式设置里核对过重试次数和窗口,不要只看卡的 Smart Retries。
- □ 失败事件里能对上
attempt_count和next_payment_attempt(automations 用户要在invoice.updated里看下一次扣款时间)。
3D Secure 验证失败、责任转移和测试卡,见Stripe 3D Secure:买家验证失败、责任转移和测试卡怎么核对。独立站在 PayPal、Stripe 和 Paddle 之间做收款方式对照,见出海独立站收款方式对比。本文不估计追回率,也不建议为了“多扣几次”把窗口拉得很长却不安排客户更新卡的路径。
相关阅读
- 海外订阅续费失败:卡组织拒付码与换卡核对清单
- Stripe 发票付款链接:到期日、付款状态和到账怎么核对
- Stripe 自动提现:计划、可用余额和银行到账怎么核对
- Stripe 3D Secure:买家验证失败、责任转移和测试卡怎么核对
- 出海独立站收款方式对比:PayPal、Stripe 与 Paddle(MoR)怎么选
官方来源(查询日期 2026-11-19,北京时间)
- Automate payment retries:https://docs.stripe.com/billing/revenue-recovery/smart-retries
- How subscriptions work:https://docs.stripe.com/billing/subscriptions/overview
- Pause subscriptions after payment failure:https://docs.stripe.com/billing/revenue-recovery/smart-retries/pause-on-payment-failure