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

サブスクリプションで利用できる支払い方法を指定する方法をご紹介します。

サブスクリプションの [payment_settings](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-payment_settings) パラメーターを使用すると、個々のサブスクリプションに対して特定の支払い方法を設定することができます。これにより、単一の `default_payment_method` を使用するよりも柔軟に対応したり、顧客に対してより詳細な設定をしたりすることが可能になります。

決済手段を有効にするには、まず Stripe ダッシュボードの[アカウント設定](https://dashboard.stripe.com/settings/payment_methods)で有効にする必要があります。

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

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

[payment settings (支払い設定)](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-payment_settings) を変更することで、顧客がサブスクリプションの支払いに使用できる支払い方法を上書きできます。

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

[Customer (顧客)](https://docs.stripe.com/api/customers/object.md#customer_object-invoice_settings-default_payment_method) オブジェクト、または [Subscription (サブスクリプション)](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-default_payment_method) オブジェクトでデフォルトの支払い方法を設定した場合は、必ずそれを `payment_method_types` のリストに追加してください。追加されていない場合は、その支払い方法が使用されず、支払いが失敗する可能性があります。

## 支払い方法の優先順位

デフォルトでは、顧客は[請求書のデフォルトの決済手段の設定](https://dashboard.stripe.com/settings/billing/invoice)で有効になっているいずれかの決済手段を使用して、サブスクリプションで生成された*請求書* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice)を支払うことができます。これは、従来の [default_source](https://docs.stripe.com/api/customers/object.md#customer_object-default_source) 顧客設定よりも優先されます。

サブスクリプションで `payment_settings.payment_method_types` が設定されている場合、そのサブスクリプションにおいてのみ、その設定がデフォルトの請求書設定より優先されます。支払い方法のタイプは、サブスクリプションの [SetupIntent](https://docs.stripe.com/api/setup_intents.md) と請求書に渡されます。

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

ダッシュボードの請求書設定、または `Subscription` の [save_default_payment_method](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-payment_settings-save_default_payment_method) パラメーターで **顧客の支払い情報を保存する** を有効にすると、顧客が請求書の支払いに使用するすべての決済手段が新たなデフォルトになります。

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

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

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

- サブスクリプションの **サブスクリプションの詳細** ページで、**アクション** メニューをクリックして、**決済更新リンクを共有** を選択します。
- [サブスクリプションページ](https://dashboard.stripe.com/subscriptions)でサブスクリプションを探し、そのオーバーフローメニュー (⋯) をクリックし、**決済更新リンクを共有** を選択します。

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

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

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

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

## 支払い方法のエラー

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

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

また、支払い時にエラーが発生し、Stripe が請求書を確定できないこともあります。詳細については、Invoicing の[支払い方法のエラー](https://docs.stripe.com/invoicing/payment-methods.md#payment-method-errors)をご覧ください。

## 支払い方法のオプション

一部の支払い方法には、顧客の支払い方法をカスタマイズできる追加オプションがあります。詳細については、[支払い方法のオプション](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-payment_settings)のドキュメントをご覧ください。