Subscription Dunning 会向付款失败后已失效或已取消订阅的客户发送邮件，并要求他们更新付款方式或重新购买。启用后，它会自动运行。
什么是订阅追帐？
当订阅进入可挽回状态时，Dunning 会检测到该状态，并发送一系列要求客户采取行动的邮件。以下三种状态会启动邮件序列：- On Hold 订阅：续订付款失败，例如余额不足或卡片已过期。
- Past Due 订阅：宽限期（grace period）开启期间，续订付款失败。
- Cancelled 订阅：客户从 Customer Portal 取消了订阅。
追帐如何工作
1
Trigger
订阅会进入以下三种状态之一：
- On Hold：续订付款失败。
- Past Due：宽限期（grace period）开启期间，续订付款失败。
- Cancelled：客户从 Customer Portal 取消了订阅。
dunning.started webhook。如果对应序列中没有启用的邮件，则不会启动尝试；一个订阅同时最多只能有一次处于活动状态的尝试。2
Grace Period
如果你设置了宽限期，续订失败会将订阅移至
past_due，而不是 on_hold。On Hold 邮件序列会在该时间窗口内运行，因此客户仍可访问服务时，就会被要求付款。一次付款失败会启动一个序列。时间窗口结束时不会启动第二个序列。如果窗口结束时订阅仍处于 On Hold 状态，序列中的剩余邮件仍会发送。如果窗口结束时订阅已变为 Cancelled，尝试会被标记为 exhausted。dunning 尝试会记录 past_due 触发状态。读取 dunning 分析数据时，除了 on_hold 外，也要筛选 past_due。3
Email Sequence
Dodo Payments 会根据触发状态，按照你配置的延迟时间，最多发送 4 封 dunning 邮件。每封邮件都会链接到 Customer Portal，客户可以在那里更新付款方式；或者链接到结账页面，以便客户重新购买已取消的订阅。
4
Recovery
当客户在 Customer Portal 中更新付款方式后，Dodo Payments 会自动收取剩余欠款。如果付款成功，订阅会重新激活，dunning 尝试会被标记为
recovered。状态生命周期
每次 dunning 尝试都有以下状态之一：当 dunning 尝试被标记为
exhausted 时，Dodo Payments 不会更改订阅。订阅会保持当前状态（Past Due、On Hold 或 Cancelled）。配置 Dunning
在控制面板中进入 Settings → Recovery，即可启用并配置 Dunning。Dunning 默认处于关闭状态。
Dunning settings in the dashboard showing enable toggle, on-hold sequence, and cancelled sequence
邮件序列
Dunning 包含两个邮件序列：On Hold 和 Cancelled，每个序列最多包含 4 封邮件。控制面板将它们分别列为 订阅处于 On Hold 时发送给客户的邮件 和 订阅被取消时发送给客户的邮件。past_due 尝试使用 On Hold 序列。
每封邮件都有以下设置：
在 Subject Line 中，Dodo Payments 会替换以下占位符：
{store_name}、{store_owner_name}、{store_contact_email}、{subscription_id}、{failure_reason} 和 {payment_form_link}。
默认延迟如下：
Dunning 邮件示例
Dunning 会针对每种订阅状态发送不同的邮件。以下示例展示了客户看到的内容。- On Hold
- Cancelled
Dunning email sent when a renewal payment fails and the subscription is on hold
客户恢复体验
当客户点击 On Hold dunning 邮件中的链接时，Customer Portal 会打开其订阅页面。客户可以在那里查看订阅状态并更新付款方式。
Customer portal showing an on-hold subscription with option to update payment method
active。
对于已取消的订阅，链接会打开结账页面，且该订阅的产品已预先加入购物车。
分析
在控制面板的 Analytics → Recovery 中跟踪 Dunning 的效果。
Recovery analytics dashboard showing ACR and dunning metrics
Webhook 事件
Dunning 会发送两个 webhook 事件：Recovery Webhook Payloads
查看 dunning 事件的完整 webhook payload schema。
边界情况
Dunning 会自动处理以下情况：最佳实践
- 从默认设置开始：默认延迟为 1、3、5 和 7 天，会将邮件分散到一周内发送，避免客户收到过多邮件，同时仍能持续收到提醒。
- 监控挽回率：查看 按邮件统计的挽回率，了解哪封邮件带来的挽回最多。如果后续邮件几乎没有带来挽回，可以将其关闭。
- 与支持团队协调：告知支持团队 Dunning 邮件正在发送，以便他们帮助回复邮件的客户。
- 检查订阅状态：将 Dunning 与
subscription.on_hold和subscription.cancelledwebhooks 配合使用，以跟踪完整的订阅生命周期。
Dunning 与 Customer Portal 中现有的 On Hold 和重新激活流程协同工作。启用后，无需进行集成开发即可自动运行。
相关内容
Recovery Webhooks
响应
dunning.started 和 dunning.recovered 事件。Abandoned Cart Recovery
通过恢复邮件挽回被放弃或失败的结账。
Customer Portal
客户可在 Customer Portal 中更新付款方式。
Subscriptions
会触发 Dunning 的订阅状态。