# Einführung neuer Arten von Kundensaldo-Transaktionen

## Das ändert sich

Wir führen zwei neue Arten von Kundensaldo-Transaktionen ein: `checkout_session_subscription_payment` und `checkout_session_subscription_payment_canceled` sowie das neue `checkout_session`-Feld für die Kundensaldo-Transaktion.

## Ergebnis

Diese Änderung wirkt sich wie folgt auf Nutzer/innen aus, die Checkout verwenden:

- Beim Abschließen des Bezahlvorgangs werden für das Kundenguthaben vorgenommene Transaktionen als Typ `checkout_session_subscription_payment` gekennzeichnet und `checkout_session` wird durch die entsprechende Sitzungs-ID ausgefüllt.
- Wenn die Sitzung abläuft, wird dadurch die Kundensaldo-Transaktion storniert, die Stornierung wird als Typ `checkout_session_subscription_payment_canceled` gekennzeichnet und `checkout_session` wird mit der entsprechenden Sitzungs-ID ausgefüllt.

## Änderungen

#### REST API

| Parameter          | Change | Resources or endpoints       |
| ------------------ | ------ | ---------------------------- |
| `checkout_session` | Added  | `CustomerBalanceTransaction` |

| Values                                                                                    | Change | Enum                         |
| ----------------------------------------------------------------------------------------- | ------ | ---------------------------- |
| `checkout_session_subscription_payment_canceled`, `checkout_session_subscription_payment` | Added  | `CustomerBalanceTransaction` |

#### Ruby

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

#### Python

| Parameter          | Change | Resources or methods         |
| ------------------ | ------ | ---------------------------- |
| `checkout_session` | Added  | `CustomerBalanceTransaction` |

| Values                                                                                    | Change | Enum                         |
| ----------------------------------------------------------------------------------------- | ------ | ---------------------------- |
| `checkout_session_subscription_payment_canceled`, `checkout_session_subscription_payment` | Added  | `CustomerBalanceTransaction` |

#### PHP

| Parameter          | Change | Resources or methods         |
| ------------------ | ------ | ---------------------------- |
| `checkout_session` | Added  | `CustomerBalanceTransaction` |

| Values                                                                                    | Change | Enum                         |
| ----------------------------------------------------------------------------------------- | ------ | ---------------------------- |
| `checkout_session_subscription_payment_canceled`, `checkout_session_subscription_payment` | Added  | `CustomerBalanceTransaction` |

#### Java

| Parameter         | Change | Resources or methods         |
| ----------------- | ------ | ---------------------------- |
| `checkoutSession` | Added  | `CustomerBalanceTransaction` |

#### Node.js

| Parameter          | Change | Resources or methods         |
| ------------------ | ------ | ---------------------------- |
| `checkout_session` | Added  | `CustomerBalanceTransaction` |

| Values                                                                                    | Change | Enum                         |
| ----------------------------------------------------------------------------------------- | ------ | ---------------------------- |
| `checkout_session_subscription_payment_canceled`, `checkout_session_subscription_payment` | Added  | `CustomerBalanceTransaction` |

#### Go

| Parameter         | Change | Resources or methods         |
| ----------------- | ------ | ---------------------------- |
| `CheckoutSession` | Added  | `CustomerBalanceTransaction` |

| Values                                                                                    | Change | Enum                         |
| ----------------------------------------------------------------------------------------- | ------ | ---------------------------- |
| `checkout_session_subscription_payment_canceled`, `checkout_session_subscription_payment` | Added  | `CustomerBalanceTransaction` |

#### .NET

| Parameter         | Change | Resources or methods         |
| ----------------- | ------ | ---------------------------- |
| `CheckoutSession` | Added  | `CustomerBalanceTransaction` |

## 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-03-31.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.0.0](https://github.com/stripe/stripe-ruby/releases/tag/v15.0.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.0.0](https://github.com/stripe/stripe-python/releases/tag/v12.0.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.0.0](https://github.com/stripe/stripe-php/releases/tag/v17.0.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.0.0](https://github.com/stripe/stripe-java/releases/tag/v29.0.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.0.0](https://github.com/stripe/stripe-node/releases/tag/v18.0.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.0.0](https://github.com/stripe/stripe-go/releases/tag/v82.0.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.0.0](https://github.com/stripe/stripe-dotnet/releases/tag/v48.0.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).