# Schafft die Parameter „prorate“ und „subscription_prorate“ für Abonnements ab

## Das ändert sich

Die Parameter `prorate` und `subscription_prorate` werden nicht mehr unterstützt und durch `proration_behavior` ersetzt.

## Auswirkungen

Indem die Parameter `prorate` und `subscription_prorate` nicht mehr unterstützt und durch die umfassenderen Parameter `proration_behavior` ersetzt werden, können Sie präziser konfigurieren, wie die anteilsmäßige Verrechnung gehandhabt werden soll.

## Änderungen

#### REST API

| Parameters | Change | Resources or endpoints |
| --- | --- | --- |
| `prorate` | Removed | [Subscription#create](/api/subscriptions/create?api-version=2024-06-20), [Subscription#update](/api/subscriptions/update?api-version=2024-06-20), [SubscriptionItem#create](/api/subscription_items/create?api-version=2024-06-20), [SubscriptionItem#delete](/api/subscription_items/delete?api-version=2024-06-20), [SubscriptionItem#update](/api/subscription_items/update?api-version=2024-06-20), [SubscriptionSchedule#update](/api/subscription_schedules/update?api-version=2024-06-20), [SubscriptionSchedule.phases[]](/api/subscription_schedules/object?api-version=2024-06-20#subscription_schedule_object-phases) |
| `proration_behavior` | Added | [SubscriptionSchedule.phases[]](/api/subscription_schedules/object?api-version=2024-06-20#subscription_schedule_object-phases-proration_behavior) |

#### Ruby

| Parameters | Change | Resources or methods |
| --- | --- | --- |
| `prorate` | Removed | [SubscriptionCreateParams](/api/subscriptions/create?api-version=2024-06-20), [SubscriptionItemCreateParams](/api/subscription_items/create?api-version=2024-06-20), [SubscriptionItemDeleteParams](/api/subscription_items/delete?api-version=2024-06-20), [SubscriptionItemUpdateParams](/api/subscription_items/update?api-version=2024-06-20), [SubscriptionSchedule::Phase](/api/subscription_schedules/object?api-version=2024-06-20#subscription_schedule_object-phases), [SubscriptionScheduleUpdateParams](/api/subscription_schedules/update?api-version=2024-06-20), [SubscriptionUpdateParams](/api/subscriptions/update?api-version=2024-06-20) |
| `proration_behavior` | Added | [SubscriptionSchedule::Phase](/api/subscription_schedules/object?api-version=2024-06-20#subscription_schedule_object-phases-proration_behavior) |

#### Python

| Parameters | Change | Resources or methods |
| --- | --- | --- |
| `prorate` | Removed | [SubscriptionCreateParams](/api/subscriptions/create?api-version=2024-06-20), [SubscriptionItemCreateParams](/api/subscription_items/create?api-version=2024-06-20), [SubscriptionItemDeleteParams](/api/subscription_items/delete?api-version=2024-06-20), [SubscriptionItemModifyParams](/api/subscription_items/update?api-version=2024-06-20), [SubscriptionModifyParams](/api/subscriptions/update?api-version=2024-06-20), [SubscriptionSchedule.Phase](/api/subscription_schedules/object?api-version=2024-06-20#subscription_schedule_object-phases), [SubscriptionScheduleModifyParams](/api/subscription_schedules/update?api-version=2024-06-20) |
| `proration_behavior` | Added | [SubscriptionSchedule.Phase](/api/subscription_schedules/object?api-version=2024-06-20#subscription_schedule_object-phases-proration_behavior) |

#### PHP

| Parameters | Change | Resources or methods |
| --- | --- | --- |
| `prorate` | Removed | [Subscription.create().$params](/api/subscriptions/create?api-version=2024-06-20), [Subscription.update().$params](/api/subscriptions/update?api-version=2024-06-20), [SubscriptionItem.create().$params](/api/subscription_items/create?api-version=2024-06-20), [SubscriptionItem.delete().$params](/api/subscription_items/delete?api-version=2024-06-20), [SubscriptionItem.update().$params](/api/subscription_items/update?api-version=2024-06-20), [SubscriptionSchedule.phases[]](/api/subscription_schedules/object?api-version=2024-06-20#subscription_schedule_object-phases), [SubscriptionSchedule.update().$params](/api/subscription_schedules/update?api-version=2024-06-20) |
| `proration_behavior` | Added | [SubscriptionSchedule.phases[]](/api/subscription_schedules/object?api-version=2024-06-20#subscription_schedule_object-phases-proration_behavior) |

#### Java

| Parameters | Change | Resources or methods |
| --- | --- | --- |
| `prorate` | Removed | [SubscriptionCreateParams](/api/subscriptions/create?api-version=2024-06-20), [SubscriptionItemCreateParams](/api/subscription_items/create?api-version=2024-06-20), [SubscriptionItemDeleteParams](/api/subscription_items/delete?api-version=2024-06-20), [SubscriptionItemUpdateParams](/api/subscription_items/update?api-version=2024-06-20), [SubscriptionSchedule.phases[]](/api/subscription_schedules/object?api-version=2024-06-20#subscription_schedule_object-phases), [SubscriptionScheduleUpdateParams](/api/subscription_schedules/update?api-version=2024-06-20), [SubscriptionUpdateParams](/api/subscriptions/update?api-version=2024-06-20) |
| `prorationBehavior` | Added | [SubscriptionSchedule.phases[]](/api/subscription_schedules/object?api-version=2024-06-20#subscription_schedule_object-phases-proration_behavior) |

#### Node.js

| Parameters | Change | Resources or methods |
| --- | --- | --- |
| `prorate` | Removed | [SubscriptionCreateParams](/api/subscriptions/create?api-version=2024-06-20), [SubscriptionItemCreateParams](/api/subscription_items/create?api-version=2024-06-20), [SubscriptionItemDeleteParams](/api/subscription_items/delete?api-version=2024-06-20), [SubscriptionItemUpdateParams](/api/subscription_items/update?api-version=2024-06-20), [SubscriptionSchedule.phases[]](/api/subscription_schedules/object?api-version=2024-06-20#subscription_schedule_object-phases), [SubscriptionScheduleUpdateParams](/api/subscription_schedules/update?api-version=2024-06-20), [SubscriptionUpdateParams](/api/subscriptions/update?api-version=2024-06-20) |
| `proration_behavior` | Added | [SubscriptionSchedule.phases[]](/api/subscription_schedules/object?api-version=2024-06-20#subscription_schedule_object-phases-proration_behavior) |

#### Go

| Parameters | Change | Resources or methods |
| --- | --- | --- |
| `Prorate` | Removed | [SubscriptionItemParams](/api/subscription_items/delete?api-version=2024-06-20), [SubscriptionParams](/api/subscriptions/update?api-version=2024-06-20), [SubscriptionScheduleParams](/api/subscription_schedules/update?api-version=2024-06-20), [SubscriptionSchedulePhase](/api/subscription_schedules/object?api-version=2024-06-20#subscription_schedule_object-phases) |
| `ProrationBehavior` | Added | [SubscriptionSchedulePhase](/api/subscription_schedules/object?api-version=2024-06-20#subscription_schedule_object-phases-proration_behavior) |

#### .NET

| Parameters | Change | Resources or methods |
| --- | --- | --- |
| `Prorate` | Removed | [SubscriptionCreateOptions](/api/subscriptions/create?api-version=2024-06-20), [SubscriptionItemCreateOptions](/api/subscription_items/create?api-version=2024-06-20), [SubscriptionItemDeleteOptions](/api/subscription_items/delete?api-version=2024-06-20), [SubscriptionItemUpdateOptions](/api/subscription_items/update?api-version=2024-06-20), [SubscriptionSchedule.Phase](/api/subscription_schedules/object?api-version=2024-06-20#subscription_schedule_object-phases), [SubscriptionScheduleUpdateOptions](/api/subscription_schedules/update?api-version=2024-06-20), [SubscriptionUpdateOptions](/api/subscriptions/update?api-version=2024-06-20) |
| `ProrationBehavior` | Added | [SubscriptionSchedule.Phase](/api/subscription_schedules/object?api-version=2024-06-20#subscription_schedule_object-phases-proration_behavior) |

## Upgrade

#### REST API

1. [Rufen Sie Ihre aktuelle API-Version](https://docs.stripe.com/workbench/guides.md#view-api-versions) in Workbench ab.
2. Wenn Sie ein SDK verwenden, aktualisieren Sie auf die entsprechende SDK-Version für diese API-Version.
   - Falls Sie kein SDK verwenden, passen Sie Ihre [API-Anfragen](https://docs.stripe.com/api-versions.md#how-versions-are-specified-in-requests) so an, dass sie `Stripe-Version: 2020-08-27` enthalten.
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).

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