# 支払いの再試行を自動化する 失敗したサブスクリプションと請求書決済を自動的に再試行して、意図しない解約を減らします。 Connect プラットフォームが [customer-configured Accounts](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-configuration-customer) を使用している場合は、Stripe の [ガイド](https://docs.stripe.com/connect/use-accounts-as-customers.md)をご確認の上、コード内の `Customer` およびイベント参照を同等の Accounts v2 API リファレンスに置き換えてください。 決済はさまざまな理由で失敗する可能性がありますが、その多くは回復可能です。Stripe Billing は、失敗したサブスクリプションと請求書決済を自動的に再試行します。 ダッシュボードでサブスクリプションの再試行を設定するには、**請求書** > **売上 (の) 回収** > [再試行](https://dashboard.stripe.com/revenue_recovery/retries)に移動します。1 回限りの請求書の再試行の場合は、**設定** > **請求書** > [請求書](https://dashboard.stripe.com/settings/billing/invoice)の **前払い請求機能** に移動します。 Stripe は Smart Retries の使用を推奨していますが、[カスタムのリトライスケジュール](https://docs.stripe.com/billing/revenue-recovery/smart-retries.md#custom-retry-schedule)を作成することもできます。 > Stripe は、以下の場合には決済を再試行しません。 > > - 決済手段がありません。 - カード発行会社から[ハードデクラインコード](https://docs.stripe.com/billing/revenue-recovery/smart-retries.md#non-retryable-decline-codes)が返されました。 - 決済カードが[インド発行](https://docs.stripe.com/india-recurring-payments.md)。 - Stripe {% glossary term=“connect” %}Connect** アカウントの連携が解除されました。 ## 支払い方法の注文 再試行時に、Stripe はこのリストで最初に使用可能な決済手段をこの順序で使用します。 | 優先度 | 決済手段 | API 属性 | | --- | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | | 1 | サブスクリプションのデフォルト決済手段 | [subscription.default_payment_method](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-default_payment_method) | | 2 | サブスクリプションデフォルト決済ソース | [subscription.default_source](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-default_source) | | 3 | 顧客請求書のデフォルト決済手段 | [customer.invoice_settings.default_payment_method](https://docs.stripe.com/api/customers/object.md#customer_object-invoice_settings-default_payment_method) | | 4 | (レガシー)顧客デフォルト支払い元 | [customer.default_source](https://docs.stripe.com/api/customers/object.md#customer_object-default_source) | 支払いが失敗した後に支払い方法を更新する際、前回の支払いが失敗したフィールドを更新します。たとえば、サブスクリプションに `default_payment_method` が設定されているときに、`customer.invoice_settings.default_payment_method` のみを更新すると、Stripe は引き続き、サブスクリプションの `default_payment_method` で再試行します。 ## Smart Retries Smart Retries は AI を使用して、失敗した支払いの再試行に最適なタイミングを選択し、請求書の支払い成功率を高めます。Smart Retries を支える AI モデルは、次のような時間に依存する動的なシグナルを使用します。 - 過去_「N」_時間に特定の支払い方法を提示した、異なるデバイスの数。 - 支払いに最適な時間 (一部の国ではローカルタイムゾーンの午前 12:01 にデビットカードで行われる支払いが成功する確率が若干高くなります)。 Stripe はこの情報を使用して、支払いを再試行するタイミングを評価します。Stripe は新しい購入者の行動と取引から継続的に学習するため、従来のルールベースの支払い再試行ロジックよりもターゲットを絞ったアプローチが可能になります。 Smart Retries は、指定した再試行回数と最大期間に従って支払いを再試行します。Smart Retry ポリシーを設定して、1 週間、2 週間、3 週間、1 か月、2 か月のいずれかの期間内に特定の回数の支払いを再試行できます。推奨されるデフォルト設定は、2 週間以内に 8 回の再試行です。[自動化](https://docs.stripe.com/billing/automations.md)を使用して、顧客セグメントごとに異なる再試行ポリシーを作成することもできます。 この動作は、[Smart Retries を無効にして](https://dashboard.stripe.com/revenue_recovery/retries)、自社のカスタムリトライルールを定義することで上書きできます。督促を有効にすると、[next_payment_attempt](https://docs.stripe.com/api/invoices/object.md#invoice_object-next_payment_attempt) 属性に、次に回収が試行されるタイミングが示されます。 ## Webhook イベント Smart Retries とカスタムのリトライスケジュールのどちらでも、Stripe は指定のスケジュールに従って支払いを再試行します。`invoice.payment_failed` *Webhook* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests) を使用して、サブスクリプションの支払い失敗イベントと、再試行回数の更新を受信します。 `invoice.payment_failed` Webhook の[attempt_count](https://docs.stripe.com/api/invoices/object.md#invoice_object-attempt_count) 属性は、これまでに行われた試行回数を示します。失敗によって*ハードデクラインコード* (A hard decline code means the issuing bank has rejected the transaction and you can't retry it)が返された場合、新しい決済手段がなければ請求書の決済を再試行できません。再試行は引き続きスケジュールされ、[attempt_count](https://docs.stripe.com/api/invoices/object.md#invoice_object-attempt_count) は増加し続けますが、再試行は新しい決済手段が検出された後にのみ実行されます。未実行の再試行では、新しい[Charge](https://docs.stripe.com/api/charges.md) は作成されません。 請求書の [next_payment_attempt](https://docs.stripe.com/api/invoices/object.md#invoice_object-next_payment_attempt) 属性は、 Stripe が次回の回収を試行する日付を示します。[自動化](https://docs.stripe.com/billing/automations.md)ユーザーの場合、`invoice.payment_failed` Webhook では[next_payment_attempt](https://docs.stripe.com/api/invoices/object.md#invoice_object-next_payment_attempt) の設定がなくなりましたが、`invoice.updated` Webhook では設定されます。 ### 再試行不可能な支払い拒否コード Stripe では、カード発行会社がこれらのハードデクラインコードを返した場合、自動的に決済を再試行することはできません。 - `incorrect_number` - `lost_card` - `pickup_card` - `stolen_card` - `revocation_of_authorization` - `revocation_of_all_authorizations` - `authentication_required` - `highest_risk_level` - `transaction_not_allowed` これらの失敗の場合、スケジュール済みの再試行は引き続き行われますが、支払いはお客様が新しい決済手段を取得した場合にのみ実行されます。 ## カスタムの再試行スケジュール [カスタムルール](https://dashboard.stripe.com/revenue_recovery/retries)で再試行スケジュールを変更することもできます。前回の試行から特定の日数を空けて、最大 3 回の再試行を設定できます。 [invoice.payment_failed](https://docs.stripe.com/billing/revenue-recovery/smart-retries.md#invoice-payment-failed-webhook) イベントを使用して、サブスクリプション決済失敗イベントを監視し、更新を再試行できます。請求書の決済試行後、ダッシュボードの現在のサブスクリプション設定を使用して、その [next_payment_attempt](https://docs.stripe.com/api.md#invoice_object-next_payment_attempt) 値が設定されます。 > 自動化を使用する場合、`invoice.payment_failed` Webhook では [next_payment_attempt](https://docs.stripe.com/api/invoices/object.md#invoice_object-next_payment_attempt) の設定がなくなりましたが、`invoice.updated` Webhook では設定されます。 回収に失敗した場合には、サブスクリプションが設定に基づいて遷移します。オプションは以下の通りです。 | 設定 | 説明 | | -------------------- | --------------------------------------------------------------------------------------------- | | サブスクリプションをキャンセルする | リトライスケジュールで定義された最大日数の経過後にサブスクリプションは `canceled`ステータスに変わります。 | | サブスクリプションを未払いとしてマーク | リトライスケジュールで定義された最大日数の経過後にサブスクリプションは `unpaid`ステータスに変わります。請求書が引き続き生成されますが、下書きの状態で保持されます。 | | サブスクリプションを期日超過のままにする | リトライスケジュールで定義された最大日数の経過後もサブスクリプションは `past_due` ステータスに維持されます。請求書が引き続き生成され、リトライ設定に従って顧客に請求されます。 | 最後の支払い試行が行われると、Stripe はそれ以降、支払いの試行を行いません。サブスクリプションの設定の変更は、以降の再試行にのみ影響します。 ## 口座振替の再試行 口座振替の再試行を有効にすると、残高不足が原因で失敗した口座振替決済を Stripe が自動的に再試行します。[継続課金のサブスクリプション請求書](https://dashboard.stripe.com/revenue_recovery/retries)、[1 回限りの請求書](https://dashboard.stripe.com/settings/billing/invoices/general)、またはその両方で再試行を有効にできます。 > 口座振替の再試行を有効にしても、決済が失敗することがあります。口座振替が再試行されなかった場合の損失については、Stripe は責任を負いません。 デフォルトでは、Stripe は、一般的に利用可能な ACH Direct Debit を除き、失敗した口座振替決済を自動的に再試行しません。その他の口座振替決済手段で自動再試行を有効にするには、次の表に記載されている対応するプライベートプレビュー機能に登録する必要があります。 | 口座引き落とし | 最大再試行回数 | 最大再試行期間 | 最低請求額 | 義務化の要件 | ステータス | | ----------------------- | ------- | ------- | ------------- | --------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | | ACH ダイレクトデビット | 2 | 40 日 | 0 USD | [ACH ダイレクトデビットの義務化](https://docs.stripe.com/payments/ach-direct-debit.md#mandates) | [一般提供](https://docs.stripe.com/payments/ach-direct-debit.md#ach-debit-retries) | | ACSS ダイレクトデビット | 1 | 30 日 | 20 カナダドル | [ACSS ダイレクトデビットの義務化](https://docs.stripe.com/payments/acss-debit.md#mandates) | [プライベートプレビュー版](https://docs.stripe.com/payments/acss-debit.md#acss-retries) | | オーストラリアの BECS ダイレクトデビット | 2 | 30 日 | 15 オーストラリアドル | [AU BECS ダイレクトデビットの義務化](https://docs.stripe.com/payments/au-becs-debit.md#mandates) | [プライベートプレビュー版](https://docs.stripe.com/payments/au-becs-debit.md#au-becs-retries) | | Bacs ダイレクトデビット | 2 | 30 日 | 0 GBP | [Bacs ダイレクトデビットの義務化](https://docs.stripe.com/payments/payment-methods/bacs-debit.md#mandates) | [プライベートプレビュー版](https://docs.stripe.com/payments/payment-methods/bacs-debit.md#bacs-retries) | | ニュージーランド BECS ダイレクトデビット | 1 | 30 日 | 20 ニュージーランドドル | [NZ BECS ダイレクトデビットの義務化](https://docs.stripe.com/payments/nz-bank-account.md#mandates) | [プライベートプレビュー版](https://docs.stripe.com/payments/nz-bank-account.md#nz-becs-retries) | | SEPA ダイレクトデビット | 2 | 30 日 | 20 EUR | [SEPA ダイレクトデビットの義務化](https://docs.stripe.com/payments/sepa-debit.md) | [プライベートプレビュー版](https://docs.stripe.com/payments/sepa-debit.md#sepa-debit-retries) |