Recur Docs

系統在訂閱到期前自動發起扣款,無需人工介入,確保訂閱順利續約。

運作方式

  1. 自動扣款 - 在本期結束前 1 小時內發起續費扣款
  2. 結果通知 - 扣款成功/失敗即時通知

試用期轉正式扣款

當訂閱設有試用期時,系統在試用到期日使用相同的排程任務自動將訂閱從 trialing 轉為 active 並發起首次全額扣款。扣款失敗時的處理取決於產品的寬限期設定:

  • 寬限期啟用(預設):進入 PAST_DUE 並自動重試
  • 寬限期關閉:立即取消訂閱

完整的試用期流程請參考試用期文件。

計費週期

支援多種計費週期:

週期扣款間隔
月繳每月
季繳每 3 個月
年繳每年
自訂自訂天數

月底扣款日處理

月繳訂閱以「每月同一天」扣款。若該日期在某月份不存在,系統會自動調整到該月份的最後一天。

計算範例

原扣款日下次扣款日說明
1/152/15正常:2 月有 15 日
1/312/28 或 2/292 月無 31 日,調整至月底
2/283/28維持 28 日
3/314/304 月無 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 - 訂閱續約成功

最佳實踐

  1. 設定提醒郵件 - 讓顧客知道即將扣款
  2. 確保付款方式有效 - 定期提醒顧客更新過期卡片
  3. 監控失敗率 - 關注扣款失敗趨勢

Last updated on