# サブスクリプションを柔軟な請求モードに移行する機能を追加 ## 新規情報 [サブスクリプション](https://docs.stripe.com/api/subscriptions.md?api-version=2025-05-28.preview)リソースの新しいメソッドである `/v1/subscriptions/:subscription/migrate` を使用すると、既存のサブスクリプションの [billing_mode](https://docs.stripe.com/api/subscriptions/create.md?api-version=2025-04-30.preview#create_subscription-billing_mode) を `classic` から `flexible` に移行できます。請求モードを使用して、比例配分の計算とオーケストレーション、サブスクリプションの請求書を制御できます。 [サブスクリプション](https://docs.stripe.com/api/subscriptions.md?api-version=2025-05-28.preview)オブジェクトの新しい `billing_mode_details.updated_at` フィールドを使用して、移行のタイムスタンプもトラックできます。 ## 影響 既存のサブスクリプションの `billing_mode` を移行するには、移行リクエストを行う際に `billing_mode: flexible` を渡します。 サブスクリプションと制限事項の詳細については、[請求モードで動作を柔軟にする方法](https://docs.stripe.com/billing/subscriptions/billing-mode.md)をご覧ください。 ## 変更点 #### REST API | Endpoint | Change | Resource | | --------- | ------ | ------------------------------------------------------------------------ | | `migrate` | Added | [Subscription](/api/subscriptions/object?api-version=2025-05-28.preview) | | Parameter | Change | Resources or endpoints | | ---------------------- | ------ | ------------------------------------------------------------------------ | | `billing_mode_details` | Added | [Subscription](/api/subscriptions/object?api-version=2025-05-28.preview) | #### Ruby | Method | Change | Resource | | --------- | ------ | ------------------------------------------------------------------------ | | `migrate` | Added | [Subscription](/api/subscriptions/object?api-version=2025-05-28.preview) | | Parameter | Change | Resources or methods | | ---------------------- | ------ | ------------------------------------------------------------------------ | | `billing_mode_details` | Added | [Subscription](/api/subscriptions/object?api-version=2025-05-28.preview) | #### Python | Method | Change | Resource | | --------- | ------ | ------------------------------------------------------------------------ | | `migrate` | Added | [Subscription](/api/subscriptions/object?api-version=2025-05-28.preview) | | Parameter | Change | Resources or methods | | ---------------------- | ------ | ------------------------------------------------------------------------ | | `billing_mode_details` | Added | [Subscription](/api/subscriptions/object?api-version=2025-05-28.preview) | #### PHP | Method | Change | Resource | | --------- | ------ | ------------------------------------------------------------------------ | | `migrate` | Added | [Subscription](/api/subscriptions/object?api-version=2025-05-28.preview) | | Parameter | Change | Resources or methods | | ---------------------- | ------ | ------------------------------------------------------------------------ | | `billing_mode_details` | Added | [Subscription](/api/subscriptions/object?api-version=2025-05-28.preview) | #### Java | Method | Change | Resource | | --------- | ------ | ------------------------------------------------------------------------ | | `migrate` | Added | [Subscription](/api/subscriptions/object?api-version=2025-05-28.preview) | | Parameter | Change | Resources or methods | | -------------------- | ------ | ------------------------------------------------------------------------ | | `billingModeDetails` | Added | [Subscription](/api/subscriptions/object?api-version=2025-05-28.preview) | #### Node.js | Method | Change | Resource | | --------- | ------ | ------------------------------------------------------------------------ | | `migrate` | Added | [Subscription](/api/subscriptions/object?api-version=2025-05-28.preview) | | Parameter | Change | Resources or methods | | ---------------------- | ------ | ------------------------------------------------------------------------ | | `billing_mode_details` | Added | [Subscription](/api/subscriptions/object?api-version=2025-05-28.preview) | #### Go | Method | Change | Resource | | --------- | ------ | ------------------------------------------------------------------------ | | `Migrate` | Added | [Subscription](/api/subscriptions/object?api-version=2025-05-28.preview) | | Parameter | Change | Resources or methods | | -------------------- | ------ | ------------------------------------------------------------------------ | | `BillingModeDetails` | Added | [Subscription](/api/subscriptions/object?api-version=2025-05-28.preview) | #### .NET | Method | Change | Resource | | --------- | ------ | ------------------------------------------------------------------------ | | `Migrate` | Added | [Subscription](/api/subscriptions/object?api-version=2025-05-28.preview) | | Parameter | Change | Resources or methods | | -------------------- | ------ | ------------------------------------------------------------------------ | | `BillingModeDetails` | Added | [Subscription](/api/subscriptions/object?api-version=2025-05-28.preview) | ## アップグレード #### REST API 1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。 1. SDK を使用している場合は、この API バージョンに対応する SDK バージョンにアップグレードします。 - SDK を使用していない場合は、`Stripe-Version: 2025-05-28.preview` を含めるように [API リクエスト](https://docs.stripe.com/api/versioning.md)を更新してください。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. 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)。 1. Ruby SDK を [v15.3.0-beta.1](https://github.com/stripe/stripe-ruby/releases/tag/v15.3.0-beta.1)にアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. 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)。 1. Python SDK を [v12.3.0b1](https://github.com/stripe/stripe-python/releases/tag/v12.3.0b1)にアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. 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)。 1. PHP SDK を [v17.4.0-beta.2](https://github.com/stripe/stripe-php/releases/tag/v17.4.0-beta.2)にアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. 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)。 1. Java SDK を [v29.3.0-beta.1](https://github.com/stripe/stripe-java/releases/tag/v29.3.0-beta.1)にアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. 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)。 1. Node SDK を [v18.3.0-beta.1](https://github.com/stripe/stripe-node/releases/tag/v18.3.0-beta.1)にアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. 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)。 1. Go SDK を [v82.3.0-beta.1](https://github.com/stripe/stripe-go/releases/tag/v82.3.0-beta.1)にアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. 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)。 1. .NET SDK を [v48.3.0-beta.1](https://github.com/stripe/stripe-dotnet/releases/tag/v48.3.0-beta.1)にアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. 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)について、詳細をご確認ください。 ## 関連する変更 - [サブスクリプションの期間終了時のキャンセルを管理する方式に柔軟さを追加](https://docs.stripe.com/changelog/basil/2025-05-28/cancel-at-enums.md)