订阅付款重试

在智能退避计划中自动重试失败的订阅续费付款，以无集成工作恢复收入。

Payment Retries 自动根据渐进退避计划重新尝试失败的订阅续费付款。当重试成功时，订阅会自动重新激活——无需客户操作或集成工作。

​

什么是付款重试？

当订阅续费付款失败时，订阅将被搁置。启用了付款重试后，Dodo Payments 会在智能计划中自动重新向客户的现有付款方式收费，直到付款成功或恢复窗口关闭。

这可以恢复因临时失败而损失的收入——过期卡持有、不足的资金被充值、瞬时网络错误——无需向客户发送电子邮件或要求他们更新任何信息。

付款重试仅适用于订阅续费付款。首次付款（授权设置）、一次性付款、计划更改费用和按需费用均不在此功能的重试范围内。

​

付款重试如何工作

1. Renewal fails

   一次订阅续费付款失败，订阅转移到状态 on_hold。

2. Retryability check

   检查故障的错误代码。软拒绝（资金不足、一般拒绝、处理或网络错误等）是可重试的。硬拒绝立即终止重试链，因为重试不会改变结果。

3. Scheduled retry

   如果拒绝是可重试的，并且恢复窗口允许，计划下次尝试。重试在客户现有付款方式的离线模式下根据渐进退避计划进行。

4. Recovery

   首次重试成功时，订阅返回到 active 并按正常方式推进下一个计费日期。如果在任何重试成功之前窗口关闭，则重试停止，订阅保持搁置。

​

配置付款重试

从您的仪表板中的设置 → 恢复启用和配置付款重试。

Payment Retries settings under Settings → Recovery

设置	描述	默认
启用付款重试	自动重试失败的订阅续费付款以恢复收入。	关闭（需选择加入）
恢复窗口（天数）	在放弃前重试失败付款的时间。必须在 1 和 30 之间。	13

恢复窗口锚定在失败的续费发票创建时。仅当累计退避延时仍然适合窗口时才安排重试。

​

重试计划

重试逐步退避。在恢复窗口内最多进行8次尝试：

尝试	先前尝试后的延迟	自故障以来的时间约
1	12 小时	12 小时
2	24 小时	36 小时
3	48 小时	~3.5 天
4	72 小时	~6.5 天
5	96 小时	~10.5 天
6	120 小时	~15.5 天
7	7 天	~22.5 天
8	7 天	~29.5 天

13天恢复窗口（默认）涵盖尝试1到5（尝试5触发于故障后的约10.5天）。如果您希望运行后来的更大间隔的尝试（6到8），请将窗口增加到30天的最大值。

​

订阅状态转换

事件	订阅状态
续费付款失败	active → on_hold
重试尝试失败	保持 on_hold (如果窗口允许则安排下一次重试)
重试尝试成功	on_hold → active, 下一个计费日期推进
恢复窗口耗尽	保持 on_hold
订阅取消	安排的重试立即停止（终止——无进一步尝试）

如果在重试仍在安排时取消订阅，则重试链立即结束，不再进行进一步的尝试。其他非活动状态（on_hold、expired、pending、failed）继续重试，因为他们的开放续费发票表示客户已消费期间的债务。

这些转换会发出标准的订阅 webhook 事件，因此您可以从中驱动权利逻辑，而无需特殊的重试处理：

事件	发生时
subscription.on_hold	续费失败，订阅被搁置时
subscription.active	重试成功并且订阅被重新激活时

Subscription Webhook Payloads

查看订阅生命周期事件的完整 webhook 负载模式。

​

可重试与不可重试的失败

失败类型	示例	是否重试？
软拒绝	资金不足、一般拒绝、卡片速度超限、处理错误、网络错误/超时、请稍后重试	是
硬拒绝	失窃/丢失卡、无效卡、拒绝服务、账户关闭及其他终端拒绝	否——链立即结束

重试硬拒绝不会改变结果，因此一旦观察到硬拒绝，重试链就会终止。将付款重试与订阅账单追讨配对，以提示客户在这些情况下更新他们的付款方式。

​

付款重试 vs. 账单追讨

付款重试和订阅账单追讨是互补的恢复工具：

	付款重试	订阅账单追讨
机制	静默重新收费现有的付款方式	向客户发送电子邮件以更新他们的付款方式
客户操作	无需操作	客户在门户中更新付款方式
最佳用途	可自行解决的暂时/软拒绝	需要更换的过期或无效的卡

同时启用这两者可为您提供最广泛的恢复覆盖：自动重试捕获瞬时失败，而账单追讨则召回需要真正更新其付款方式的客户。

​

相关

Subscription Dunning

促使客户更新其付款方式的电子邮件序列。

Abandoned Cart Recovery

通过目标电子邮件恢复不完整或失败的一次性结账。

Subscriptions

了解涉及恢复流的订阅状态。

Subscription Webhooks

对 subscription.on_hold 和 subscription.active 事件作出反应。