Payment Retries は、失敗したサブスクリプション更新支払いを進行的なバックオフスケジュールで自動的に再試行します。再試行が成功すると、サブスクリプションは自動的に再アクティブ化されます—顧客のアクションや統合作業は不要です。
支払いの再試行とは？
サブスクリプションの更新支払いが失敗した場合、サブスクリプションは保留状態になります。Payment Retries が有効になると、Dodo Payments はスマートスケジュールで顧客の既存の支払い方法に自動的に再請求を行い、支払いが成功するか回復ウィンドウが閉じるまで続けます。 これは、顧客にメールを送信したり更新を依頼したりせずに、一時的な失敗による収益を回復します — 期限切れのカードの保留、補充された不足分、短期間のネットワークエラーなど。Payment Retries はサブスクリプション更新支払いにのみ適用されます。初回の支払い（マンデートセットアップ）、一度限りの支払い、プラン変更の請求、およびオンデマンドの請求はこの機能では再試行されません。
支払いの再試行の仕組み
Retryability check
失敗のエラーコードがチェックされます。ソフトデクライン（資金不足、一般的な拒否、処理やネットワークのエラーなど）は再試行可能です。ハードデクラインは再試行しても結果は変わらないため、直ちに再試行チェーンが終了します。
Scheduled retry
デクラインが再試行可能であり、回復ウィンドウが許可する場合、次の試行がスケジュールされます。再試行は顧客の既存の支払い方法に対してオフセッションで行われ、進行的なバックオフスケジュールに沿って行われます。
支払いの再試行の設定
設定→回復からPayment Retriesを有効にし、構成します。
| 設定 | 説明 | デフォルト |
|---|---|---|
| 支払いの再試行を有効化 | 失敗したサブスクリプション更新支払いを自動的に再試行して収益を回復します。 | オフ（オプトイン） |
| 回復ウィンドウ（日数） | 支払いの失敗を諦める前に再試行し続ける期間。1から30まででなければなりません。 | 13 |
再試行スケジュール
再試行は進行的にバックオフします。回復ウィンドウに収まる限り、最大8回の試行が行われます：| 試行 | 前回の試行後の遅延 | 失敗からの大まかな時間 |
|---|---|---|
| 1 | 12時間 | 12時間 |
| 2 | 24時間 | 36時間 |
| 3 | 48時間 | ~3.5日 |
| 4 | 72時間 | ~6.5日 |
| 5 | 96時間 | ~10.5日 |
| 6 | 120時間 | ~15.5日 |
| 7 | 7日 | ~22.5日 |
| 8 | 7日 | ~29.5日 |
サブスクリプションステータスの遷移
| イベント | サブスクリプションのステータス |
|---|---|
| 更新支払いが失敗 | active → on_hold |
| 再試行の試行が失敗 | stays on_hold （ウィンドウが許可する場合、次の再試行がスケジュールされます） |
| 再試行の試行が成功 | on_hold → active、次の請求日が進行されます |
| 回復ウィンドウが終了 | stays on_hold |
| イベント | 発生時 |
|---|---|
subscription.on_hold | 更新が失敗し、サブスクリプションが保留状態になるとき |
subscription.active | 再試行が成功し、サブスクリプションが再アクティブ化されるとき |
Subscription Webhook Payloads
サブスクリプションライフサイクルイベントの完全なWebHookペイロードスキーマを表示します。
再試行可能な失敗と非再試行可能な失敗
| 失敗の種類 | 例 | 再試行？ |
|---|---|---|
| ソフトデクライン | 資金不足、一般的な拒否、カード速度超過、処理エラー、ネットワークエラー/タイムアウト、後でやり直してください | はい |
| ハードデクライン | 盗難/紛失カード、無効なカード、名誉の禁止、口座閉鎖、その他の最終拒否 | いいえ — チェーンは直ちに終了します |
ハードデクラインを再試行しても結果は変わらないため、ハードデクラインが観察されるとすぐに再試行チェーンが終了します。その場合には、Payment Retriesをサブスクリプションダニングと組み合わせて、顧客に支払い方法の更新を促すことをお勧めします。
支払いの再試行とダニング
Payment Retries とサブスクリプションダニングは補完的な回復ツールです：| 支払いの再試行 | サブスクリプションダニング | |
|---|---|---|
| メカニズム | 既存の支払い方法に静かに再請求します | 顧客に支払い方法の更新を促すメールを送信します |
| 顧客のアクション | 必要なし | 顧客はポータルで支払い方法を更新します |
| 最適 | 自然に解決する一時的/ソフトデクライン | 交換が必要な期限切れまたは無効なカード |
関連情報
Subscription Dunning
顧客に支払い方法の更新を促すメールシーケンス。
Abandoned Cart Recovery
一回限りのチェックアウトの未完了または失敗をターゲットメールで回復します。
Subscriptions
回復フローに関与するサブスクリプションステートを理解します。
Subscription Webhooks
subscription.on_hold および subscription.active イベントに対応します。