# 催繳與寬限期 (/features/automation/dunning)
催繳與寬限期 [#催繳與寬限期]
付款失敗後不立即取消訂閱，給顧客一段時間處理付款問題，減少非自願流失。
寬限期 [#寬限期]
寬限期是付款失敗後，訂閱仍保持有效的緩衝時間。預設為 **3 天**。
寬限期行為 [#寬限期行為]
當付款失敗且寬限期啟用時：
1. 訂閱進入 `PAST_DUE` 狀態
2. **顧客仍保有完整存取權限**（權限檢查視 PAST\_DUE 為有效狀態）
3. 系統在寬限期內自動重試扣款（每 24 小時一次，最多 3 次）
4. 自動發送付款失敗通知郵件，引導顧客更新付款方式
寬限期結束 [#寬限期結束]
寬限期（3 天）結束後，如果仍未成功收款：
* 訂閱自動轉為 `CANCELED` 狀態
* 顧客失去存取權限
* 系統發送訂閱取消通知郵件（附重新訂閱連結）
* 觸發 `subscription.revoked` Webhook
關閉寬限期 [#關閉寬限期]
關閉寬限期後，付款失敗的訂閱將**立即取消**，不會自動重試扣款。請確認這是您需要的行為。
部分創作者希望扣款失敗時立即取消權益，避免被取巧。您可以在**產品層級**關閉寬限期：
1. 前往「商品管理」→ 選擇要設定的商品
2. 取消勾選「**啟用付款寬限期**」
3. 儲存
關閉寬限期的行為 [#關閉寬限期的行為]
當付款失敗且寬限期關閉時：
1. 訂閱**立即**轉為 `CANCELED` 狀態
2. 顧客**立即**失去存取權限
3. **不會**進入 `PAST_DUE` 狀態
4. **不會**自動重試扣款
5. 系統發送訂閱取消通知郵件
6. 直接觸發 `subscription.revoked` Webhook（不會觸發 `subscription.past_due`）
行為比較 [#行為比較]
| | 寬限期啟用（預設） | 寬限期關閉 |
| ---------- | ------------------------------------------------ | ---------------------- |
| 扣款失敗後的狀態 | `PAST_DUE` | `CANCELED` |
| 顧客是否保有權限 | 是（寬限期間） | 否（立即失去） |
| 自動重試 | 最多 3 次（每 24 小時） | 不重試 |
| 取消時機 | 寬限期（3 天）結束後 | 立即 |
| Webhook 事件 | `subscription.past_due` → `subscription.revoked` | `subscription.revoked` |
寬限期設定是針對每個**產品**獨立設定的。同一帳戶下的不同產品可以有不同的寬限期設定。
催繳通知 [#催繳通知]
系統自動發送付款提醒郵件（僅在寬限期啟用時）：
| 時間點 | 郵件內容 |
| --------- | --------------------------- |
| 付款失敗當天 | 通知付款失敗，請更新付款方式（附 Portal 連結） |
| 第 3 次重試失敗 | 提醒即將取消服務 |
| 訂閱取消 | 通知訂閱已取消（附重新訂閱連結） |
相關 Webhook 事件 [#相關-webhook-事件]
* `invoice.payment_failed` - 付款失敗（每次失敗都會觸發，包含關閉寬限期的情境）
* `subscription.past_due` - 訂閱進入逾期狀態（僅寬限期啟用時觸發）
* `subscription.revoked` - 訂閱因付款失敗被撤銷
* `subscription.payment_method_required` - 訂閱無付款方式（僅寬限期啟用時觸發）
最佳實踐 [#最佳實踐]
1. **一般訂閱建議啟用寬限期** — 多數付款失敗是暫時性的（餘額不足、銀行暫時拒絕），重試可挽回約 15% 的失敗付款
2. **高風險產品可關閉寬限期** — 如果產品容易被利用寬限期白嫖，可考慮關閉
3. **清楚的通知** — 讓顧客明確知道需要採取的行動
4. **提供更新入口** — 郵件中包含 Customer Portal 連結，方便顧客更新付款方式