付款重试会根据渐进的回退计划，自动重新尝试失败的订阅续费付款。当重试成功时，订阅会自动重新激活 — 无需客户操作或集成工作。
什么是付款重试？
当订阅续费付款失败时，订阅会被置于暂停状态。启用付款重试后，Dodo Payments 会自动在智能计划上使用客户现有的付款方式重新扣款，直到付款成功或恢复窗口关闭。 这可以恢复因临时故障而损失的收入 — 过期的卡片持有、不足的资金被补充、短暂的网络错误 — 无需给客户发送电子邮件或要求他们更新任何信息。付款重试仅适用于订阅的续费付款。首次付款（授权设置）、一次性付款、计划更改费用和按需收费不适用于此功能。
付款重试的工作原理
配置付款重试
在控制台中的 设置 → 恢复 中启用和配置付款重试。
| 设置 | 描述 | 默认值 |
|---|---|---|
| 启用付款重试 | 自动重试失败的订阅续费付款以恢复收入。 | 关闭（选择加入） |
| 恢复窗口（天） | 在放弃之前重试失败付款的时间长度。必须在 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 天 |
订阅状态转换
| 事件 | 订阅状态 |
|---|---|
| 续费付款失败 | active → on_hold |
| 重试尝试失败 | 保持 on_hold（如果窗口允许则安排下次重试） |
| 重试尝试成功 | on_hold → active，接下来的账单日期推进 |
| 恢复窗口耗尽 | 保持 on_hold |
| 事件 | 触发时机 |
|---|---|
subscription.on_hold | 续费失败且订阅被暂停时 |
subscription.active | 重试成功且订阅重新激活时 |
Subscription Webhook Payloads
查看完整的订阅生命周期事件的 webhook 有效负载模式。
可重试与不可重试的失败
| 失败类型 | 示例 | 是否重试？ |
|---|---|---|
| 软拒绝 | 资金不足、通用拒绝、卡额度超限、处理错误、网络错误/超时、稍后再试 | 是 |
| 硬拒绝 | 被盗/丢失的卡，无效卡，不予认可，账户关闭，及其他终端拒绝 | 否 — 链立即结束 |
重试硬拒绝不会改变结果，因此一旦观察到硬拒绝，重试链即终止。在这些情况下，将付款重试与订阅扣款配对，以提示客户更新其付款方式。
付款重试与扣款
付款重试和订阅扣款是互补的恢复工具：| 付款重试 | 订阅扣款 | |
|---|---|---|
| 机制 | 静默重新扣款现有付款方式 | 通过电子邮件通知客户更新其付款方式 |
| 客户操作 | 无需操作 | 客户在门户中更新付款方式 |
| 最佳适用 | 自行解决的临时/软拒绝 | 需要更换的过期或无效卡 |
相关
Subscription Dunning
电子邮件序列提示客户更新其付款方式。
Abandoned Cart Recovery
通过定向邮件找回未完成或失败的一次性结账。
Subscriptions
了解涉及恢复流程的订阅状态。
Subscription Webhooks
对
subscription.on_hold 和 subscription.active 事件进行响应。