# Benennt die Verlängerungseigenschaften eines Abonnementplans um und aktualisiert diese

## Das ändert sich

Enthält mehrere Änderungen an Abonnementplänen:

- Benennt `renewal_behavior` in `end_behavior` um und gibt die Werte `cancel` und `release` an.
- Entfernt `renewal_interval`.

Diese Änderung hat den folgenden Nebeneffekt: Wenn Sie das `renewal_behavior` `none` in einer alten API-Version erstellt haben, wird `end_behavior` jetzt in `cancel` konvertiert, wenn der Wert ausgelesen wird. Für den Fall, dass Sie Ihre API aktualisieren und `renewal_behavior` als `renew` festlegen, wird `end_behavior` als `renew` angezeigt, wenn diese API-Version aktiviert ist. Sie können `renewal_interval` jedoch nicht mehr aktualisieren oder `end_behavior` auf `renew` setzen, da es sich in einem schreibgeschützten Zustand befindet.

## Auswirkungen

Mit der `end_behavior`-Eigenschaft können Sie intuitiver steuern, wie ein Abonnementplan endet. Die Änderung sorgt für Abwärtskompatibilität, indem der alte `renewal_behavior`-Wert `none`dem „none“ automatisch dem Verhalten beim Ende aufgrund von Kündigung zugeordnet wird.

## Änderungen

#### REST API

| Parameters | Change | Resources or endpoints |
| --- | --- | --- |
| `renewal_behavior` | Removed | [SubscriptionSchedule#create](/api/subscription_schedules/create?api-version=2024-06-20), [SubscriptionSchedule#update](/api/subscription_schedules/update?api-version=2024-06-20) |
| `end_behavior` | Added | [SubscriptionSchedule](/api/subscription_schedules/object?api-version=2024-06-20#subscription_schedule_object-end_behavior) |
| `renewal_interval` | Removed | [SubscriptionSchedule](/api/subscription_schedules/object?api-version=2024-06-20) |

| Field | Change | From → to |
| --- | --- | --- |
| `SubscriptionSchedule.renewal_behavior` | Changed | `nullable(enum('cancel'|'none'|'release'|'renew')) → enum('cancel'|'none'|'release'|'renew')` |

#### Ruby

| Parameters | Change | Resources or methods |
| --- | --- | --- |
| `renewal_behavior` | Removed | [SubscriptionScheduleCreateParams](/api/subscription_schedules/create?api-version=2024-06-20), [SubscriptionScheduleUpdateParams](/api/subscription_schedules/update?api-version=2024-06-20) |
| `end_behavior` | Added | [SubscriptionSchedule](/api/subscription_schedules/object?api-version=2024-06-20#subscription_schedule_object-end_behavior) |

| Field | Change | From → to |
| --- | --- | --- |
| `SubscriptionSchedule.renewal_behavior` | Changed | `nullable(enum('cancel'|'none'|'release'|'renew')) → enum('cancel'|'none'|'release'|'renew')` |

#### Python

| Parameters | Change | Resources or methods |
| --- | --- | --- |
| `renewal_behavior` | Removed | [SubscriptionScheduleCreateParams](/api/subscription_schedules/create?api-version=2024-06-20), [SubscriptionScheduleModifyParams](/api/subscription_schedules/update?api-version=2024-06-20) |
| `end_behavior` | Added | [SubscriptionSchedule](/api/subscription_schedules/object?api-version=2024-06-20#subscription_schedule_object-end_behavior) |

| Field | Change | From → to |
| --- | --- | --- |
| `SubscriptionSchedule.renewal_behavior` | Changed | `nullable(enum('cancel'|'none'|'release'|'renew')) → enum('cancel'|'none'|'release'|'renew')` |

#### PHP

| Parameters | Change | Resources or methods |
| --- | --- | --- |
| `renewal_behavior` | Removed | [SubscriptionSchedule.create().$params](/api/subscription_schedules/create?api-version=2024-06-20), [SubscriptionSchedule.update().$params](/api/subscription_schedules/update?api-version=2024-06-20) |
| `end_behavior` | Added | [SubscriptionSchedule](/api/subscription_schedules/object?api-version=2024-06-20#subscription_schedule_object-end_behavior) |

| Field | Change | From → to |
| --- | --- | --- |
| `SubscriptionSchedule.renewal_behavior` | Changed | `nullable(enum('cancel'|'none'|'release'|'renew')) → enum('cancel'|'none'|'release'|'renew')` |

#### Java

| Parameters | Change | Resources or methods |
| --- | --- | --- |
| `renewalBehavior` | Removed | [SubscriptionScheduleCreateParams](/api/subscription_schedules/create?api-version=2024-06-20), [SubscriptionScheduleUpdateParams](/api/subscription_schedules/update?api-version=2024-06-20) |
| `endBehavior` | Added | [SubscriptionSchedule](/api/subscription_schedules/object?api-version=2024-06-20#subscription_schedule_object-end_behavior) |

#### Node.js

| Parameters | Change | Resources or methods |
| --- | --- | --- |
| `renewal_behavior` | Removed | [SubscriptionScheduleCreateParams](/api/subscription_schedules/create?api-version=2024-06-20), [SubscriptionScheduleUpdateParams](/api/subscription_schedules/update?api-version=2024-06-20) |
| `end_behavior` | Added | [SubscriptionSchedule](/api/subscription_schedules/object?api-version=2024-06-20#subscription_schedule_object-end_behavior) |

| Field | Change | From → to |
| --- | --- | --- |
| `SubscriptionSchedule.renewal_behavior` | Changed | `enum('cancel'|'none'|'release'|'renew') | null → enum('cancel'|'none'|'release'|'renew')` |

#### Go

| Parameters | Change | Resources or methods |
| --- | --- | --- |
| `RenewalBehavior` | Removed | [SubscriptionScheduleParams](/api/subscription_schedules/create?api-version=2024-06-20) |
| `EndBehavior` | Added | [SubscriptionSchedule](/api/subscription_schedules/object?api-version=2024-06-20#subscription_schedule_object-end_behavior) |

#### .NET

| Parameters | Change | Resources or methods |
| --- | --- | --- |
| `RenewalBehavior` | Removed | [SubscriptionScheduleCreateOptions](/api/subscription_schedules/create?api-version=2024-06-20), [SubscriptionScheduleUpdateOptions](/api/subscription_schedules/update?api-version=2024-06-20) |
| `EndBehavior` | Added | [SubscriptionSchedule](/api/subscription_schedules/object?api-version=2024-06-20#subscription_schedule_object-end_behavior) |

## 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.
2. 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: 2019-10-17`
3. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
4. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
5. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
6. 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.
2. Aktualisieren Sie Ihr Ruby SDK auf die neueste Version.
3. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
4. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
5. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
6. 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.
2. Aktualisieren Sie Ihr Python SDK auf die neueste Version.
3. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
4. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
5. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
6. 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.
2. Aktualisieren Sie Ihr PHP SDK auf die neueste Version.
3. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
4. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
5. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
6. 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.
2. Aktualisieren Sie Ihr Java SDK auf die neueste Version.
3. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
4. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
5. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
6. 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.
2. Aktualisieren Sie Ihr Node SDK auf die neueste Version.
3. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
4. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
5. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
6. 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.
2. Aktualisieren Sie Ihr Go SDK auf die neueste Version.
3. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
4. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
5. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
6. 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.
2. Aktualisieren Sie Ihr .NET SDK auf die neueste Version.
3. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
4. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
5. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
6. 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).