---
title: 催繳與寬限期
description: 付款失敗後的催繳流程與寬限期管理，減少非自願流失
---

# 催繳與寬限期

付款失敗後不立即取消訂閱，給顧客一段時間處理付款問題，減少非自願流失。

## 寬限期

寬限期是付款失敗後，訂閱仍保持有效的緩衝時間。預設為 **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 事件

- `invoice.payment_failed` - 付款失敗（每次失敗都會觸發，包含關閉寬限期的情境）
- `subscription.past_due` - 訂閱進入逾期狀態（僅寬限期啟用時觸發）
- `subscription.revoked` - 訂閱因付款失敗被撤銷
- `subscription.payment_method_required` - 訂閱無付款方式（僅寬限期啟用時觸發）

## 最佳實踐

1. **一般訂閱建議啟用寬限期** — 多數付款失敗是暫時性的（餘額不足、銀行暫時拒絕），重試可挽回約 15% 的失敗付款
2. **高風險產品可關閉寬限期** — 如果產品容易被利用寬限期白嫖，可考慮關閉
3. **清楚的通知** — 讓顧客明確知道需要採取的行動
4. **提供更新入口** — 郵件中包含 Customer Portal 連結，方便顧客更新付款方式