# PaymentIntent と SetupIntent の自動の支払い手段をデフォルトで有効にしました

## 新機能

[PaymentIntents](https://docs.stripe.com/api/payment_intents.md?api-version=2024-06-20) と [SetupIntents](https://docs.stripe.com/api/setup_intents.md?api-version=2024-06-20) では、動的な `automatic_payment_methods` がデフォルトで有効になりました。これにより、[ダッシュボード](https://dashboard.stripe.com/settings/payment_methods) から決済手段の設定を行うことができます。以前のデフォルトでは、`payment_method_types` と `automatic_payment_methods` の両方が指定されていない場合、カード決済のみが受け付けられました。詳細については、[アップグレードガイド](https://docs.stripe.com/upgrades/manage-payment-methods.md) をご覧ください。

- PaymentIntent を確定するときは、`off_session=true` である場合を除き、`return_url` を指定する必要があります。
- PaymentIntent を確定するときは、`error_on_requires_action` を使用できません。PaymentIntents が `requires_action` に移行する場合に支払いの試行を失敗させたい場合は、`error_on_requires_action` を指定した `payment_method_types` を使用します。
- SetupIntent を確定する場合は、`return_url` を指定する必要があります。
- `automatic_payment_methods[allow_redirects]=never` を使用すると、`return_url` 要件を回避できます。これにより、ダッシュボードで有効になっていたとしても、[リダイレクトが必要](https://docs.stripe.com/payments/payment-methods/payment-method-support.md#additional-api-supportability)な決済手段が自動的に除外されます。

## 影響

PaymentIntents と SetupIntents では、デフォルトで自動の[動的決済手段](https://docs.stripe.com/payments/payment-methods/dynamic-payment-methods.md)が使用されるようになり、Stripe ダッシュボードで設定できるようになっています。

## アップグレード

#### REST API

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
2. SDK を使用している場合は、この API バージョンに対応する SDK バージョンにアップグレードします。
   - SDK を使用していない場合は、`Stripe-Version: 2023-08-16` を含めるように [API リクエスト](https://docs.stripe.com/api/versioning.md)を更新してください。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### Ruby

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
2. Ruby SDK を 最新バージョンにアップグレードします。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### Python

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
2. Python SDK を 最新バージョンにアップグレードします。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### PHP

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
2. PHP SDK を 最新バージョンにアップグレードします。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### Java

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
2. Java SDK を 最新バージョンにアップグレードします。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### Node.js

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
2. Node SDK を 最新バージョンにアップグレードします。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### Go

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
2. Go SDK を 最新バージョンにアップグレードします。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。

#### .NET

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
2. .NET SDK を 最新バージョンにアップグレードします。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。

[Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。
