> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 订阅付款重试

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

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

## 什么是付款重试？

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

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

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

## 付款重试如何工作

<Steps>
  <Step title="Renewal fails">
    一次订阅续费付款失败，订阅转移到状态 `on_hold`。
  </Step>

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

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

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

## 配置付款重试

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

<Frame caption="Payment Retries settings under Settings → Recovery">
  <img src="https://mintcdn.com/dodopayments/4RYIEvZenmAs_JI3/images/recovery/payment-retries-settings.png?fit=max&auto=format&n=4RYIEvZenmAs_JI3&q=85&s=349af2dd649bbbeb89367448e3e4b125" alt="恢复设置页面，启用付款重试切换开关，恢复窗口（天数）字段设置为13" style={{ maxHeight: '500px', width: 'auto' }} width="2874" height="1566" data-path="images/recovery/payment-retries-settings.png" />
</Frame>

| 设置           | 描述                               | 默认        |
| ------------ | -------------------------------- | --------- |
| **启用付款重试**   | 自动重试失败的订阅续费付款以恢复收入。              | 关闭（需选择加入） |
| **恢复窗口（天数）** | 在放弃前重试失败付款的时间。必须在 **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 天  |

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

## 订阅状态转换

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

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

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

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

<Card title="Subscription Webhook Payloads" icon="webhook" href="/developer-resources/webhooks/intents/subscription">
  查看订阅生命周期事件的完整 webhook 负载模式。
</Card>

## 可重试与不可重试的失败

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

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

## 付款重试 vs. 账单追讨

付款重试和[订阅账单追讨](/features/recovery/subscription-dunning)是互补的恢复工具：

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

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

## 相关

<CardGroup cols={2}>
  <Card title="Subscription Dunning" icon="repeat" href="/features/recovery/subscription-dunning">
    促使客户更新其付款方式的电子邮件序列。
  </Card>

  <Card title="Abandoned Cart Recovery" icon="cart-shopping" href="/features/recovery/abandoned-cart-recovery">
    通过目标电子邮件恢复不完整或失败的一次性结账。
  </Card>

  <Card title="Subscriptions" icon="repeat" href="/features/subscription">
    了解涉及恢复流的订阅状态。
  </Card>

  <Card title="Subscription Webhooks" icon="webhook" href="/developer-resources/webhooks/intents/subscription">
    对 `subscription.on_hold` 和 `subscription.active` 事件作出反应。
  </Card>
</CardGroup>