系統在訂閱到期前自動發起扣款,無需人工介入,確保訂閱順利續約。
運作方式
- 自動扣款 - 在本期結束前 1 小時內發起續費扣款
- 結果通知 - 扣款成功/失敗即時通知
試用期轉正式扣款
當訂閱設有試用期時,系統在試用到期日使用相同的排程任務自動將訂閱從 trialing 轉為 active 並發起首次全額扣款。扣款失敗時的處理取決於產品的寬限期設定:
- 寬限期啟用(預設):進入
PAST_DUE並自動重試 - 寬限期關閉:立即取消訂閱
完整的試用期流程請參考試用期文件。
計費週期
支援多種計費週期:
| 週期 | 扣款間隔 |
|---|---|
| 月繳 | 每月 |
| 季繳 | 每 3 個月 |
| 年繳 | 每年 |
| 自訂 | 自訂天數 |
月底扣款日處理
月繳訂閱以「每月同一天」扣款。若該日期在某月份不存在,系統會自動調整到該月份的最後一天。
計算範例
| 原扣款日 | 下次扣款日 | 說明 |
|---|---|---|
| 1/15 | 2/15 | 正常:2 月有 15 日 |
| 1/31 | 2/28 或 2/29 | 2 月無 31 日,調整至月底 |
| 2/28 | 3/28 | 維持 28 日 |
| 3/31 | 4/30 | 4 月無 31 日,調整至 4/30 |
日期漂移說明
當扣款日遇到短月份時,會自動調整到該月份的最後一天,調整後的日期會成為新的固定扣款日。
例如,顧客於 12/31 訂閱月繳方案:
12/31 首次訂閱
→ 1/31 第一次續約
→ 2/28 第二次續約(2 月無 31 日,調整至月底)
→ 3/28 第三次續約(維持 28 日)
→ 4/28 第四次續約
→ ...之後固定每月 28 日扣款
這是業界標準做法,與 Stripe 等主流訂閱平台的行為一致。
扣款時間
續費排程每小時執行一次,會對本期將在 1 小時內結束的訂閱扣款,讓續費在 current_period_end 之前完成,訂閱不會出現沒有付費期間的空窗(已排程切換方案的訂閱除外,見下方)。
- 新的一期從原本的
current_period_end起算,不會因為提前扣款而往前移動。 - 若排程延遲,續費最晚仍會在下一次排程時完成。
- 試用期不會提前扣款:試用到期後才轉為正式訂閱並扣款。
- 已排程在本期結束時切換方案的訂閱,會在本期結束後才切換並扣款,避免提前失去已付費方案的權限。
- 提前扣款失敗時,不會縮短顧客已付費的期間:關閉寬限期的產品會立即取消(觸發
invoice.payment_failed與subscription.revoked),但 Entitlements 仍保留權限到原本的current_period_end(即 payload 中的current_period_end),若您依subscription.revoked關閉權限,請保留到該時間。Recur 代管的會員權益以訂閱狀態判斷:Discord、Circle 與會員限定文章會在扣款失敗時即移除(最多比到期時間早 1 小時),beehiiv 則在下一次每小時同步時移除;啟用寬限期的產品進入past_due,3 天寬限期從本期結束時起算。
請用訂閱狀態判斷權限,不要用 current_period_end > now。
active、trialing、past_due 都應保有權限(past_due 是寬限期內的重試中)。扣款與 webhook 送達仍可能有幾分鐘的誤差;若您一定要用時間判斷,請在 current_period_end 上多保留一段寬限時間。也可以直接查詢 權限檢查(Entitlements)。
Webhook 事件
訂閱自動扣款相關事件:
invoice.created- 發票建立(扣款前)invoice.paid- 發票付款成功invoice.payment_failed- 發票付款失敗subscription.renewed- 訂閱續約成功
最佳實踐
- 設定提醒郵件 - 讓顧客知道即將扣款
- 確保付款方式有效 - 定期提醒顧客更新過期卡片
- 監控失敗率 - 關注扣款失敗趨勢