> ## 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>
  订阅追帐会自动向因支付失败或客户取消而失效的订阅的客户发送电子邮件序列，提示他们更新支付方式并重新激活。
</Info>

## 什么是订阅追帐？

追帐会自动检测当订阅进入可恢复状态时，并发送一系列电子邮件提示客户采取行动：

* **暂停订阅**：续订支付失败（资金不足，卡片过期等）
* **取消订阅**：客户从客户门户取消订阅

## 追帐如何工作

<Steps>
  <Step title="Trigger">
    当订阅进入以下两种状态之一时触发追帐：

    * **暂停**：续订支付失败（资金不足，卡片过期等）
    * **取消**：客户从客户门户取消他们的订阅
  </Step>

  <Step title="Email Sequence">
    根据触发状态，系统会在配置的时间间隔内发送最多4封追帐电子邮件。每封电子邮件都包含一个链接，客户可以在客户门户中更新其支付方式或重新购买订阅。
  </Step>

  <Step title="Recovery">
    当客户通过客户门户更新他们的支付方式时，会自动为剩余欠款创建一笔付款。如果付款成功，订阅将被重新激活，并且追帐尝试被标记为已恢复。
  </Step>
</Steps>

## 状态生命周期

| 状态           | 描述                       |
| ------------ | ------------------------ |
| `recovering` | 追帐尝试是活跃的；正在发送电子邮件        |
| `recovered`  | 客户更新支付方式并且支付成功           |
| `exhausted`  | 所有电子邮件发送完毕且未恢复，或订阅状态意外更改 |

<Info>
  当追帐尝试被标记为 `exhausted` 时，订阅状态不会被修改。订阅仍保持在其当前状态（暂停或取消）。
</Info>

## 配置追帐

从仪表板的**设置**中启用和配置追帐。

<Frame caption="Dunning settings in the dashboard showing enable toggle, on-hold sequence, and cancelled sequence">
  <img src="https://mintcdn.com/dodopayments/tvJ2MmXYymW0IZ3R/images/recovery/dunning-settings.png?fit=max&auto=format&n=tvJ2MmXYymW0IZ3R&q=85&s=7389a9413d6008800e7ca8a5c4cd1ee5" alt="追帐设置页面，带有启用切换，四个暂停的电子邮件间隔为1, 3, 5, 和7天，及四个取消的电子邮件在同一间隔内" style={{ maxHeight: '500px', width: 'auto' }} width="2250" height="1628" data-path="images/recovery/dunning-settings.png" />
</Frame>

### 电子邮件序列

追帐支持两种电子邮件序列——**暂停**和**取消**——每种最多支持4封可配置的电子邮件。

每封电子邮件具有以下可配置字段：

| 设置      | 描述                 |
| ------- | ------------------ |
| **启用**  | 打开或关闭个别电子邮件而不删除它们  |
| **延迟**  | 触发事件后多长时间发送此电子邮件   |
| **主题**  | 带有变量占位符的电子邮件主题行    |
| **正文**  | 带有变量占位符的HTML电子邮件正文 |
| **回复至** | 客户回复的电子邮件地址        |

**默认电子邮件时间安排：**

| 序列 | 邮件 # | 默认延迟 |
| -- | ---- | ---- |
| 暂停 | 1    | 1天   |
| 暂停 | 2    | 3天   |
| 暂停 | 3    | 5天   |
| 暂停 | 4    | 7天   |
| 取消 | 1    | 1天   |
| 取消 | 2    | 3天   |
| 取消 | 3    | 5天   |
| 取消 | 4    | 7天   |

### 示例追帐电子邮件

追帐根据订阅状态发送不同的电子邮件。以下是客户所见的每种类型的示例。

<Tabs>
  <Tab title="On Hold">
    <Frame caption="Dunning email sent when a renewal payment fails and the subscription is on hold">
      <img src="https://mintcdn.com/dodopayments/tvJ2MmXYymW0IZ3R/images/recovery/dunning-on-hold-email.png?fit=max&auto=format&n=tvJ2MmXYymW0IZ3R&q=85&s=5e46040ed49a4da84569afdeeb87c813" alt="一个暂停订阅的追帐电子邮件，显示商店名称，有关支付失败的消息，带有计划和金额的订阅详细信息，以及更新支付方式按钮" style={{ maxHeight: '500px', width: 'auto' }} width="1070" height="1502" data-path="images/recovery/dunning-on-hold-email.png" />
    </Frame>
  </Tab>

  <Tab title="Cancelled">
    <Frame caption="Dunning email sent when a customer cancels their subscription">
      <img src="https://mintcdn.com/dodopayments/tvJ2MmXYymW0IZ3R/images/recovery/dunning-cancelled-email.png?fit=max&auto=format&n=tvJ2MmXYymW0IZ3R&q=85&s=f404fbf9415df4e4bd01562a90bd2456" alt="一个取消订阅的追帐电子邮件，显示商店名称，有关取消的消息，带有计划和金额的订阅详细信息，以及重新购买订阅按钮" style={{ maxHeight: '500px', width: 'auto' }} width="1070" height="1502" data-path="images/recovery/dunning-cancelled-email.png" />
    </Frame>
  </Tab>
</Tabs>

## 客户恢复体验

当客户点击追帐电子邮件中的链接时，他们将被带到客户门户，在那里他们可以查看其订阅状态并更新其支付方式。

<Frame caption="Customer portal showing an on-hold subscription with option to update payment method">
  <img src="https://mintcdn.com/dodopayments/tvJ2MmXYymW0IZ3R/images/recovery/customer-recovery-page.png?fit=max&auto=format&n=tvJ2MmXYymW0IZ3R&q=85&s=f498d3654afd3d70447b7b8ce7bf3767" alt="客户门户显示Pro Plan的暂停订阅，每年$95.00，更新支付方式按钮和有关支付失败的警告横幅" style={{ maxHeight: '500px', width: 'auto' }} width="2144" height="734" data-path="images/recovery/customer-recovery-page.png" />
</Frame>

当客户更新其支付方式后，会自动为任何未付款创建一笔费用。如果付款成功，订阅将立即重新激活。

对于已取消的订阅，客户会被导向包含已添加订阅的结账页面。

## 分析

从仪表板的**分析**部分的**恢复**选项卡中跟踪追帐的表现。

<Frame caption="Recovery analytics dashboard showing ACR and dunning metrics">
  <img src="https://mintcdn.com/dodopayments/B3-0kuKcZDP1TiJD/images/recovery/recovery-analytics.png?fit=max&auto=format&n=B3-0kuKcZDP1TiJD&q=85&s=d3bf0c7474818bc4584b75654423e14c" alt="恢复分析仪表板，显示追帐条目次数，成功率，恢复的收入和每封电子邮件的表现细分" style={{ maxHeight: '500px', width: 'auto' }} width="2548" height="2190" data-path="images/recovery/recovery-analytics.png" />
</Frame>

| 指标        | 描述                |
| --------- | ----------------- |
| **追帐条目**  | 创建的追帐尝试的总数        |
| **成功率**   | 追帐尝试导致恢复的百分比      |
| **恢复的收入** | 通过追帐恢复的总收入        |
| **按尝试恢复** | 分析哪个序列中的电子邮件驱动了恢复 |

## Webhook 事件

| 事件                  | 描述           |
| ------------------- | ------------ |
| `dunning.started`   | 已为某个订阅启动追帐尝试 |
| `dunning.recovered` | 订阅通过追帐已恢复    |

<Card title="Recovery Webhook Payloads" icon="code" href="/developer-resources/webhooks/intents/recovery">
  查看追帐事件的完整 webhook 负载架构。
</Card>

## 边缘情况

| 场景              | 行为                 |
| --------------- | ------------------ |
| 客户在任何邮件之前更新支付方式 | 检测到恢复；追帐尝试被标记为已恢复  |
| 客户从同一商家购买另一个订阅  | 追帐尝试被标记为耗尽         |
| 所有追帐邮件耗尽        | 追帐尝试被标记为耗尽；订阅状态未修改 |

## 最佳实践

* **从默认值开始**：默认电子邮件的时间安排设计合理，间隔为1, 3, 5和7天，以避免让客户感到不知所措，同时保持紧迫性。
* **监测成功率**：跟踪哪个序列中的邮件推动了最大的恢复。如果后续的电子邮件几乎没有转换率，考虑禁用它们。
* **与支持协调**：确保您的支持团队知道正在发送追帐电子邮件，以便他们可以帮助联系的客户。
* **检查订阅状态**：将追帐与 `subscription.on_hold` 和 `subscription.cancelled` webhooks 配对，实现全面的生命周期跟踪。

<Info>
  追帐与客户门户中的现有订阅暂停和重新激活流程一起工作。一旦启用，它会自动运行，无需额外的集成。
</Info>

## 相关

<CardGroup cols={2}>
  <Card title="Recovery Webhooks" icon="webhook" href="/developer-resources/webhooks/intents/recovery">
    响应 `dunning.started` 和 `dunning.recovered` 事件。
  </Card>

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

  <Card title="Customer Portal" icon="id-card" href="/features/customer-portal">
    客户通过客户门户更新支付方式。
  </Card>

  <Card title="Subscriptions" icon="repeat" href="/features/subscription">
    了解触发追帐工作流的订阅状态。
  </Card>
</CardGroup>