# 智慧重試機制 (/features/automation/retry)





智慧重試機制 [#智慧重試機制]

付款失敗不代表流失顧客。Recur 會自動在寬限期內重試扣款，大幅提升成功率。

<Callout type="info">
  重試機制僅在產品的「付款寬限期」啟用時生效。若產品關閉寬限期，付款失敗將立即取消訂閱，不會重試。詳見[催繳與寬限期](/features/automation/dunning)。
</Callout>

為什麼付款會失敗？ [#為什麼付款會失敗]

常見的付款失敗原因：

| 原因   | 說明       | 可重試 |
| ---- | -------- | --- |
| 餘額不足 | 帳戶暫時餘額不足 | ✓   |
| 卡片過期 | 信用卡已過期   | ✗   |
| 銀行拒絕 | 銀行暫時拒絕交易 | ✓   |
| 網路問題 | 連線暫時中斷   | ✓   |
| 風控攔截 | 銀行風控系統攔截 | 部分  |

重試策略 [#重試策略]

重試排程 [#重試排程]

* **第 1 次扣款**：訂閱到期當天自動發起
* **第 2 次重試**：首次失敗後 24 小時
* **第 3 次重試**：第 2 次失敗後 24 小時

最多重試 **3 次**，整個過程在 3 天寬限期內完成。

重試流程 [#重試流程]

```
扣款失敗（第 1 次）
  → 訂閱進入 PAST_DUE
  → 發送付款失敗郵件
  → 24 小時後自動重試

第 2 次重試
  ├─ 成功 → 訂閱恢復 ACTIVE
  └─ 失敗 → 24 小時後再重試

第 3 次重試
  ├─ 成功 → 訂閱恢復 ACTIVE
  └─ 失敗 → 寬限期結束，訂閱取消
```

重試成效 [#重試成效]

平均而言，自動重試可以挽回約 &#x2A;*15%** 的失敗付款。

Webhook 事件 [#webhook-事件]

* `invoice.payment_failed` - 付款失敗（每次重試失敗都會觸發）
* `invoice.paid` - 付款成功（重試成功時觸發）
* `subscription.past_due` - 訂閱進入逾期狀態（首次失敗時觸發）
* `subscription.renewed` - 訂閱續約成功（重試成功時觸發）