# Fügt die Möglichkeit hinzu, Abonnements auf den flexiblen Abrechnungsmodus umzustellen

## Das ändert sich

Die neue Methode der [Abo](https://docs.stripe.com/api/subscriptions.md?api-version=2025-05-28.preview)-Ressource, `/v1/subscriptions/:subscription/migrate`, ermöglicht es, den [billing_mode](https://docs.stripe.com/api/subscriptions/create.md?api-version=2025-04-30.preview#create_subscription-billing_mode) bestehender Abos von `Klassisch` auf `Flexibel` zu migrieren. Mit dem Abrechnungsmodus können Sie die Berechnung und Steuerung von anteiligen Beträgen und Rechnungen für Abos festlegen.

Sie können den Zeitstempel Ihrer Migration auch mit dem neuen Feld `billing_mode_details.updated_at` im [Abo](https://docs.stripe.com/api/subscriptions.md?api-version=2025-05-28.preview)-Objekt verfolgen.

## Ergebnis

Um die `billing_mode` Ihrer bestehenden Abonnements zu migrieren, übergeben Sie `billing_mode: flexible` bei der Migrationsanfrage.

Erfahren Sie mehr darüber, wie der [Abrechnungsmodus flexibles Verhalten für Abonnements ermöglicht](https://docs.stripe.com/billing/subscriptions/billing-mode.md) und welche Einschränkungen gelten.

## Änderungen

#### 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) |

## Upgrade

#### REST API

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Wenn Sie ein SDK verwenden, aktualisieren Sie auf die entsprechende SDK-Version für diese API-Version.
   - Wenn Sie kein SDK verwenden, aktualisieren Sie Ihre [API-Anfragen](https://docs.stripe.com/api/versioning.md) auf `Stripe-Version: 2025-05-28.preview`
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### Ruby

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr Ruby SDK auf [v15.3.0-beta.1](https://github.com/stripe/stripe-ruby/releases/tag/v15.3.0-beta.1)
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### Python

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr Python SDK auf [v12.3.0b1](https://github.com/stripe/stripe-python/releases/tag/v12.3.0b1)
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### PHP

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr PHP SDK auf [v17.4.0-beta.2](https://github.com/stripe/stripe-php/releases/tag/v17.4.0-beta.2)
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### Java

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr Java SDK auf [v29.3.0-beta.1](https://github.com/stripe/stripe-java/releases/tag/v29.3.0-beta.1)
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### Node.js

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr Node SDK auf [v18.3.0-beta.1](https://github.com/stripe/stripe-node/releases/tag/v18.3.0-beta.1)
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### Go

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr Go SDK auf [v82.3.0-beta.1](https://github.com/stripe/stripe-go/releases/tag/v82.3.0-beta.1)
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### .NET

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr .NET SDK auf [v48.3.0-beta.1](https://github.com/stripe/stripe-dotnet/releases/tag/v48.3.0-beta.1)
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

## Zugehörige Änderungen

- [Bietet mehr Flexibilität bei der Verwaltung von Stornierungen von Abonnements am Ende des Zeitraums](https://docs.stripe.com/changelog/basil/2025-05-28/cancel-at-enums.md)