サブスクリプションごとに支払い方法を設定する

サブスクリプションの payment_settings パラメーターを使用すると、個々のサブスクリプションに対して特定の支払い方法を設定することができます。これにより、単一の default_payment_method を使用するよりも柔軟に対応したり、顧客に対してより詳細な設定をしたりすることが可能になります。

決済手段を有効にするには、まず Stripe ダッシュボードのアカウント設定で有効にする必要があります。

状況によっては、決済手段をサブスクリプションに使用できなくなるような制限が存在することがあります。たとえば、ある決済手段では、使用できる通貨が 1 つのみであったり、顧客が支払うことができる金額に制限があったりすることがあります。制限が原因で決済手段を使用できない場合、Stripe は決済手段を自動的に選択しません。詳しくは、支払い方法のサポートをご覧ください。

支払い方法を手動で選択する

payment settings (支払い設定) を変更することで、顧客がサブスクリプションの支払いに使用できる支払い方法を上書きできます。

curl https://api.stripe.com/v1/subscriptions/sub_49ty4767H20z6a \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "payment_settings[payment_method_types][]"=card \
  -d "payment_settings[payment_method_types][]"=customer_balance

Customer (顧客) オブジェクト、または Subscription (サブスクリプション) オブジェクトでデフォルトの支払い方法を設定した場合は、必ずそれを payment_method_types のリストに追加してください。追加されていない場合は、その支払い方法が使用されず、支払いが失敗する可能性があります。

支払い方法の優先順位

デフォルトでは、顧客は請求書のデフォルトの決済手段の設定で有効になっているいずれかの決済手段を使用して、サブスクリプションで生成された請求書を支払うことができます。これは、従来の default_source 顧客設定よりも優先されます。

サブスクリプションで payment_settings.payment_method_types が設定されている場合、そのサブスクリプションにおいてのみ、その設定がデフォルトの請求書設定より優先されます。支払い方法のタイプは、サブスクリプションの SetupIntent と請求書に渡されます。

さらに、サブスクリプションの default_payment_method や従来の default_source を指定することで、試行する支払い方法に優先順位を付けることができます。

ダッシュボードの請求書設定、または Subscription の save_default_payment_method パラメーターで 顧客の支払い情報を保存する を有効にすると、顧客が請求書の支払いに使用するすべての決済手段が新たなデフォルトになります。

顧客による決済手段の更新を有効化

ダッシュボードから、自動請求サブスクリプションの決済手段を顧客が更新できる 1 回限りのリンクを作成可能です。

更新リンクは、次の 2 箇所から作成できます。

• サブスクリプションの サブスクリプションの詳細 ページで、アクション メニューをクリックして、決済更新リンクを共有 を選択します。
• サブスクリプションページでサブスクリプションを探し、そのオーバーフローメニュー () をクリックし、決済更新リンクを共有 を選択します。

決済更新リンクを共有 ダイアログで、リンクを顧客に直接メールで送信するか、リンクをコピーして別の方法で共有できます。サブスクリプションの既存の決済更新リンクをすべて無効にすることもできます。

リンクは、Billing が Auto に設定されているサブスクリプションでのみ生成できます。Billing が Send に設定されているサブスクリプションでは、メニュー項目は表示されません。

サブスクリプションの決済更新リンクには、以下の制限があります。

• リンクは、関連付けられたサブスクリプションの決済手段のみを更新でき、顧客のデフォルトの決済手段は変更できません。
• サブスクリプションのステータスは、active、past_due、trialing にする必要があります。unpaid や ended にすることはできません。
• 新しい決済手段はカードにする必要があります。
• 各リンクで顧客が支払いの詳細を更新できるのは 1 回限りです。
• 使用されない場合、リンクは 30 日後に失効します。

支払い方法のエラー

支払い方法のエラーによりサブスクリプションを作成できないことがあります。これは以下のような場合に起こります。

• 手動で支払い方法を選択する際に、サポートされている通貨などの制限によりその支払い方法を使用できない。
• アカウントで支払い方法が有効になっていない

また、支払い時にエラーが発生し、Stripe が請求書を確定できないこともあります。詳細については、Invoicing の支払い方法のエラーをご覧ください。

支払い方法のオプション

一部の支払い方法には、顧客の支払い方法をカスタマイズできる追加オプションがあります。詳細については、支払い方法のオプションのドキュメントをご覧ください。