# カスタマーポータルから更新されたサブスクリプションは、請求サイクルの起点も変更できるようになりました ## 新機能 顧客が[カスタマーポータル](https://docs.stripe.com/customer-management.md)からサブスクリプションを更新するときに、[カスタマーポータル設定](https://docs.stripe.com/api/customer_portal/configurations.md?api-version=2025-12-15.clover)を指定することで、更新されたサブスクリプションに適用される [billing_cycle_anchor](https://docs.stripe.com/api/customer_portal/configurations/create.md?api-version=2025-12-15.clover#create_portal_configuration-features-subscription_update-billing_cycle_anchor) を設定できるようになりました。請求書サイクルアンカーは、将来の請求期間の日付を揃える基準点であり、現在のエポックからの秒数または`現在` (現在の UTC タイムスタンプ) の UNIX タイムスタンプとして定義されます。 ## 影響 カスタマーポータルで行われたサブスクリプションの更新に適用される請求書サイクルの起点を制御できるようになりました。この変更により、サブスクリプションの更新中に請求日をリセットする際の柔軟性が高まります。以前は、カスタマーポータルで行われた更新では、既存の請求書サイクルの起点が常に維持されていました。 ## 変更点 #### REST API | Parameter | Change | Resources or endpoints | | ---------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `billing_cycle_anchor` | Added | [BillingPortal.Configuration#create.features.subscription_update](/api/customer_portal/configurations/create?api-version=2025-12-15.clover#create_billing_portal_configuration-features-subscription_update), [BillingPortal.Configuration#update.features.subscription_update](/api/customer_portal/configurations/update?api-version=2025-12-15.clover#update_billing_portal_configuration-features-subscription_update), [BillingPortal.Configuration.features.subscription_update](/api/customer_portal/configurations/object?api-version=2025-12-15.clover#billing_portal_configuration_object-features-subscription_update) | #### Ruby | Parameter | Change | Resources or methods | | ---------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `billing_cycle_anchor` | Added | [BillingPortal::Configuration::Feature::SubscriptionUpdate](/api/customer_portal/configurations/object?api-version=2025-12-15.clover#billing_portal_configuration_object-features-subscription_update), [BillingPortal::ConfigurationCreateParams::Feature::SubscriptionUpdate](/api/customer_portal/configurations/create?api-version=2025-12-15.clover#create_billing_portal_configuration-features-subscription_update), [BillingPortal::ConfigurationUpdateParams::Feature::SubscriptionUpdate](/api/customer_portal/configurations/update?api-version=2025-12-15.clover#update_billing_portal_configuration-features-subscription_update) | #### Python | Parameter | Change | Resources or methods | | ---------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `billing_cycle_anchor` | Added | [BillingPortal.Configuration.Feature.SubscriptionUpdate](/api/customer_portal/configurations/object?api-version=2025-12-15.clover#billing_portal_configuration_object-features-subscription_update), [billing_portal.ConfigurationCreateParamsFeatureSubscriptionUpdate](/api/customer_portal/configurations/create?api-version=2025-12-15.clover#create_billing_portal_configuration-features-subscription_update), [billing_portal.ConfigurationModifyParamsFeatureSubscriptionUpdate](/api/customer_portal/configurations/update?api-version=2025-12-15.clover#update_billing_portal_configuration-features-subscription_update) | #### PHP | Parameter | Change | Resources or methods | | ---------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `billing_cycle_anchor` | Added | [BillingPortal.Configuration.features.subscription_update](/api/customer_portal/configurations/object?api-version=2025-12-15.clover#billing_portal_configuration_object-features-subscription_update), [BillingPortal\Configuration.create().$params.feature.subscription_update](/api/customer_portal/configurations/create?api-version=2025-12-15.clover#create_billing_portal_configuration-features-subscription_update), [BillingPortal\Configuration.update().$params.feature.subscription_update](/api/customer_portal/configurations/update?api-version=2025-12-15.clover#update_billing_portal_configuration-features-subscription_update) | #### Java | Parameter | Change | Resources or methods | | -------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `billingCycleAnchor` | Added | [billingportal.Configuration.features.subscription_update](/api/customer_portal/configurations/object?api-version=2025-12-15.clover#billing_portal_configuration_object-features-subscription_update), [billingportal.ConfigurationCreateParams.features.subscription_update](/api/customer_portal/configurations/create?api-version=2025-12-15.clover#create_billing_portal_configuration-features-subscription_update), [billingportal.ConfigurationUpdateParams.features.subscription_update](/api/customer_portal/configurations/update?api-version=2025-12-15.clover#update_billing_portal_configuration-features-subscription_update) | #### Node.js | Parameter | Change | Resources or methods | | ---------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `billing_cycle_anchor` | Added | [BillingPortal.Configuration.features.subscription_update](/api/customer_portal/configurations/object?api-version=2025-12-15.clover#billing_portal_configuration_object-features-subscription_update), [BillingPortal.ConfigurationCreateParams.features.subscription_update](/api/customer_portal/configurations/create?api-version=2025-12-15.clover#create_billing_portal_configuration-features-subscription_update), [BillingPortal.ConfigurationUpdateParams.features.subscription_update](/api/customer_portal/configurations/update?api-version=2025-12-15.clover#update_billing_portal_configuration-features-subscription_update) | #### Go | Parameter | Change | Resources or methods | | -------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `BillingCycleAnchor` | Added | [BillingPortalConfigurationFeaturesSubscriptionUpdate](/api/customer_portal/configurations/object?api-version=2025-12-15.clover#billing_portal_configuration_object-features-subscription_update), [BillingPortalConfigurationFeaturesSubscriptionUpdateParams](/api/customer_portal/configurations/create?api-version=2025-12-15.clover#create_billing_portal_configuration-features-subscription_update) | #### .NET | Parameter | Change | Resources or methods | | -------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `BillingCycleAnchor` | Added | [BillingPortal.Configuration.Features.SubscriptionUpdate](/api/customer_portal/configurations/object?api-version=2025-12-15.clover#billing_portal_configuration_object-features-subscription_update), [BillingPortalConfigurationFeaturesSubscriptionUpdateOptions](/api/customer_portal/configurations/create?api-version=2025-12-15.clover#create_billing_portal_configuration-features-subscription_update) | ## アップグレード #### 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-12-15.clover` を含めるように [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 を [v18.2.0](https://github.com/stripe/stripe-ruby/releases/tag/v18.2.0)にアップグレードします。 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 を [v14.2.0](https://github.com/stripe/stripe-python/releases/tag/v14.2.0)にアップグレードします。 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 を [v19.2.0](https://github.com/stripe/stripe-php/releases/tag/v19.2.0)にアップグレードします。 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 を [v31.2.0](https://github.com/stripe/stripe-java/releases/tag/v31.2.0)にアップグレードします。 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 を [v20.2.0](https://github.com/stripe/stripe-node/releases/tag/v20.2.0)にアップグレードします。 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 を [v84.2.0](https://github.com/stripe/stripe-go/releases/tag/v84.2.0)にアップグレードします。 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 を [v50.2.0](https://github.com/stripe/stripe-dotnet/releases/tag/v50.2.0)にアップグレードします。 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/clover/2025-12-15/customer-balance-transations-list-invoice.md) - [請求書の料金体系の詳細の拡張が可能](https://docs.stripe.com/changelog/clover/2025-12-15/expandable-price-details-price.md) - [請求書の項目に小計プロパティを追加](https://docs.stripe.com/changelog/clover/2025-12-15/invoice-line-item-subtotal.md)