功能自動化管理
催繳與寬限期
付款失敗後的催繳流程與寬限期管理，減少非自願流失
催繳與寬限期
付款失敗後不立即取消訂閱，給顧客一段時間處理付款問題，減少非自願流失。
寬限期
寬限期是付款失敗後，訂閱仍保持有效的緩衝時間。預設為 3 天。
寬限期行為
當付款失敗且寬限期啟用時：
- 訂閱進入
PAST_DUE狀態 - 顧客仍保有完整存取權限（權限檢查視 PAST_DUE 為有效狀態）
- 系統在寬限期內自動重試扣款（每 24 小時一次，最多 3 次）
- 自動發送付款失敗通知郵件，引導顧客更新付款方式
寬限期結束
寬限期（3 天）結束後，如果仍未成功收款：
- 訂閱自動轉為
CANCELED狀態 - 顧客失去存取權限
- 系統發送訂閱取消通知郵件（附重新訂閱連結）
- 觸發
subscription.revokedWebhook
關閉寬限期
關閉寬限期後，付款失敗的訂閱將立即取消，不會自動重試扣款。請確認這是您需要的行為。
部分創作者希望扣款失敗時立即取消權益，避免被取巧。您可以在產品層級關閉寬限期：
- 前往「商品管理」→ 選擇要設定的商品
- 取消勾選「啟用付款寬限期」
- 儲存
關閉寬限期的行為
當付款失敗且寬限期關閉時：
- 訂閱立即轉為
CANCELED狀態 - 顧客立即失去存取權限
- 不會進入
PAST_DUE狀態 - 不會自動重試扣款
- 系統發送訂閱取消通知郵件
- 直接觸發
subscription.revokedWebhook（不會觸發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- 訂閱無付款方式（僅寬限期啟用時觸發）
最佳實踐
- 一般訂閱建議啟用寬限期 — 多數付款失敗是暫時性的（餘額不足、銀行暫時拒絕），重試可挽回約 15% 的失敗付款
- 高風險產品可關閉寬限期 — 如果產品容易被利用寬限期白嫖，可考慮關閉
- 清楚的通知 — 讓顧客明確知道需要採取的行動
- 提供更新入口 — 郵件中包含 Customer Portal 連結，方便顧客更新付款方式
Last updated on