# Fügt Hilfsfunktionen zum Abbrechen von Abonnements für Rechnungsstellungszeiträume mit gemischten Intervallen hinzu.

## Das ändert sich

Wir haben die folgenden [cancel_at](https://docs.stripe.com/api/subscriptions/create.md?api-version=2025-07-30.basil#create_subscription-cancel_at) Enum-Werte eingeführt, um die Kündigung eines [gemischten Intervall-](https://docs.stripe.com/billing/subscriptions/mixed-interval.md) Abonnements am Ende eines Rechnungsstellungszeitraums zu vereinfachen:

- `min_period_end`: Legt die Kündigung des Abonnements zum frühesten Zeitpunkt `items.data.current_period_end` für alle Posten des Abonnements an.
- `max_period_end`: Plant die Beendigung des Abonnements zum spätesten `items.data.current_period_end` für alle Posten des Abonnements.

In Anfragen, die sowohl den Wert `current_period_end` eines Abo-Postens ändern als auch einen dieser neuen Werte festlegt, wird der aktualisierte Wert `current_period_end` als das entsprechende Kündigungsdatum verwendet. Im Gegensatz zu [cancel_at_period_end](https://docs.stripe.com/api/subscriptions/create.md?api-version=2025-07-30.basil#create_subscription-cancel_at_period_end) werden diese Werte sofort in Zeitstempel aufgelöst und weitere Änderungen an `items.data.current_period_end` wirken sich nicht auf sie aus.

> Bei Abos mit gemischten Intervallen wird die bestehende Funktion [cancel_at_period_end](https://docs.stripe.com/api/subscriptions/create.md?api-version=2025-07-30.basil#create_subscription-cancel_at_period_end) immer auf den frühesten Posten aufgelöst.

## Ergebnis

Die folgenden API-Endpoints unterstützen die neuen Enums:

- [Ein Abonnement erstellen](https://docs.stripe.com/api/subscriptions/create.md?api-version=2025-07-30.basil)
- [Ein Abo aktualisieren](https://docs.stripe.com/api/subscriptions/update.md?api-version=2025-07-30.basil)
- [Vorschau einer Rechnung erstellen](https://docs.stripe.com/api/invoices/create_preview.md?api-version=2025-07-30.basil)

Wenn Ihre Integration im flexiblen Billing-Modus derzeit [cancel_at_period_end](https://docs.stripe.com/api/subscriptions/create.md?api-version=2025-07-30.basil#create_subscription-cancel_at_period_end) verwendet, um Abos zu kündigen, aktualisieren Sie Ihre Integration wie folgt:

- Verwenden Sie die neuen Enum-Werte `min_period_end` oder `max_period_end`, um anzugeben, welches Intervall eine Stornierung auslöst.
- Füllen Sie [cancel_at](https://docs.stripe.com/api/subscriptions/create.md?api-version=2025-07-30.basil#create_subscription-cancel_at) mit einem expliziten ganzzahligen Zeitstempel aus.

Der Parameter `cancel_at_period_end` in einem Abonnement ist nicht mit den neuen `cancel_at`-Hilfsfunktionen kompatibel.

Wenn Sie den Wert `current_period_end` für Elemente in einem Abo aktualisieren, können Sie in derselben Anfrage `cancel_at: min_period_end` oder `cancel_at: max_period_end` hinzufügen, um den vorhandenen Zeitstempel [cancel_at](https://docs.stripe.com/api/subscriptions/object.md?api-version=2025-07-30.basil#subscription_object-cancel_at) des Abos zurückzusetzen.

> Diese Änderung wird im .NET SDK erst in Version `49.0.0` verfügbar sein und das Java SDK erst in Version `30.0.0`. Bis diese Versionen verfügbar sind, befolgen Sie die Anweisungen zum [ Senden nicht dokumentierte Parameter](https://docs.stripe.com/sdks/server-side.md#undocumented-params-and-fields) , um die neuen Enumerationswerte an die `cancel_at`-Parameter weiterzugeben.

## Änderungen

#### REST API

| Fields                                                                                                                    | Change  | From → to                                                       |
| ------------------------------------------------------------------------------------------------------------------------- | ------- | --------------------------------------------------------------- |
| `Invoice#create_preview.subscription_details.cancel_at`, `Subscription#create.cancel_at`, `Subscription#update.cancel_at` | Changed | `DateTime → DateTime | enum('max_period_end'|'min_period_end')` |

#### Ruby

| Fields                                                                                                                                       | Change  | From → to                                                       |
| -------------------------------------------------------------------------------------------------------------------------------------------- | ------- | --------------------------------------------------------------- |
| `Invoice::CreatePreviewParams::SubscriptionDetail.cancel_at`, `Subscription::CreateParams.cancel_at`, `Subscription::UpdateParams.cancel_at` | Changed | `DateTime → DateTime | enum('max_period_end'|'min_period_end')` |

#### Python

| Fields                                                                                                                                  | Change  | From → to                                                       |
| --------------------------------------------------------------------------------------------------------------------------------------- | ------- | --------------------------------------------------------------- |
| `Invoice.CreatePreviewParamsSubscriptionDetail.cancel_at`, `Subscription.CreateParams.cancel_at`, `Subscription.ModifyParams.cancel_at` | Changed | `DateTime → DateTime | enum('max_period_end'|'min_period_end')` |

#### PHP

Diese Änderung wirkt sich nicht auf das PHP SDK aus.

#### Java

| Fields                                                                                                                               | Change  | From → to                                                       |
| ------------------------------------------------------------------------------------------------------------------------------------ | ------- | --------------------------------------------------------------- |
| `InvoiceCreatePreviewParams.subscription_details.cancelAt`, `SubscriptionCreateParams.cancelAt`, `SubscriptionUpdateParams.cancelAt` | Changed | `DateTime → DateTime | enum('max_period_end'|'min_period_end')` |

#### Node.js

| Fields                                                                                                                                  | Change  | From → to                                                       |
| --------------------------------------------------------------------------------------------------------------------------------------- | ------- | --------------------------------------------------------------- |
| `InvoiceCreatePreviewParams.subscription_details.cancel_at`, `SubscriptionCreateParams.cancel_at`, `SubscriptionUpdateParams.cancel_at` | Changed | `DateTime → DateTime | enum('max_period_end'|'min_period_end')` |

#### Gehen Sie zu

| Fields                                                                                  | Change  | From → to                                                       |
| --------------------------------------------------------------------------------------- | ------- | --------------------------------------------------------------- |
| `InvoiceCreatePreviewSubscriptionDetailsParams.CancelAt`, `SubscriptionParams.CancelAt` | Changed | `DateTime → DateTime | enum('max_period_end'|'min_period_end')` |

#### .NET

| Fields                                                                                                                   | Change  | From → to                                                       |
| ------------------------------------------------------------------------------------------------------------------------ | ------- | --------------------------------------------------------------- |
| `InvoiceSubscriptionDetailsOptions.CancelAt`, `SubscriptionCreateOptions.CancelAt`, `SubscriptionUpdateOptions.CancelAt` | Changed | `DateTime → DateTime | enum('max_period_end'|'min_period_end')` |

## 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-07-30.basil`
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.4.0](https://github.com/stripe/stripe-ruby/releases/tag/v15.4.0)
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.4.0](https://github.com/stripe/stripe-python/releases/tag/v12.4.0)
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.5.0](https://github.com/stripe/stripe-php/releases/tag/v17.5.0)
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.4.0](https://github.com/stripe/stripe-java/releases/tag/v29.4.0)
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.4.0](https://github.com/stripe/stripe-node/releases/tag/v18.4.0)
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.4.0](https://github.com/stripe/stripe-go/releases/tag/v82.4.0)
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.4.0](https://github.com/stripe/stripe-dotnet/releases/tag/v48.4.0)
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

- [Fügt einen Parameter für die Dauer für Zeitplanphasen hinzu](https://docs.stripe.com/changelog/basil/2025-07-30/add-schedule-phase-duration.md)
- [Fügt Unterstützung für die Mengenanpassung zur API für die Konfiguration des Kundenportals hinzu](https://docs.stripe.com/changelog/basil/2025-07-30/customer-portal-subscription-update-quantity-limits.md)
- [Fügt Unterstützung für Abrechnungsschwellen für Abonnements mit flexiblem Abrechnungsmodus](https://docs.stripe.com/changelog/basil/2025-07-30/billing-thresholds.md)
- [Fügt Unterstützung für gemischte Intervalle für dasselbe Abonnement hinzu](https://docs.stripe.com/changelog/basil/2025-07-30/support-mixed-intervals.md)