# Aktualisiert das Kategoriefeld der Gutschriftgewährungen auf optional

## Das ändert sich

Aktualisiert das Feld [Kategorie](https://docs.stripe.com/api/billing/credit-grant/object.md?api-version=2025-10-29.clover#billing_credit_grant_object-category) der [Gutschriftgewährung](https://docs.stripe.com/api/billing/credit-grant/object.md?api-version=2025-10-29.clovery) auf optional.

## Auswirkungen

Sie können das Feld `category` einer neuen Gutschriftgewährung weglassen, ohne Ihre bestehende Stripe-Integration zu beeinträchtigen. Stripe verwendet standardmäßig die Kategorie `paid`, falls es weggelassen wird.

## Änderungen

#### REST API

| Field | Change | From → to |
| --- | --- | --- |
| `Billing.CreditGrant#create.category` | Changed | `required → optional` |

#### Ruby

| Field | Change | From → to |
| --- | --- | --- |
| `Billing::CreditGrant::CreateParams.category` | Changed | `required → optional` |

#### Python

| Field | Change | From → to |
| --- | --- | --- |
| `billing.CreditGrant.CreateParams.category` | Changed | `required → optional` |

#### PHP

| Field | Change | From → to |
| --- | --- | --- |
| `Billing\CreditGrant.create().$params.category` | Changed | `required → optional` |

#### Java

| Field | Change | From → to |
| --- | --- | --- |
| `billing.CreditGrantCreateParams.category` | Changed | `required → optional` |

#### Node.js

| Field | Change | From → to |
| --- | --- | --- |
| `Billing.CreditGrantCreateParams.category` | Changed | `required → optional` |

#### Gehen Sie zu

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

#### .NET

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

## 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: 2025-10-29.clover` 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 [v17.1.0](https://github.com/stripe/stripe-ruby/releases/tag/v17.1.0)
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&nbsp;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 [v13.1.0](https://github.com/stripe/stripe-python/releases/tag/v13.1.0)
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&nbsp;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 [v18.1.0](https://github.com/stripe/stripe-php/releases/tag/v18.1.0)
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&nbsp;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 [v30.1.0](https://github.com/stripe/stripe-java/releases/tag/v30.1.0)
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&nbsp;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 [v19.2.0](https://github.com/stripe/stripe-node/releases/tag/v19.2.0)
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&nbsp;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 [v83.1.0](https://github.com/stripe/stripe-go/releases/tag/v83.1.0)
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&nbsp;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 [v49.1.0](https://github.com/stripe/stripe-dotnet/releases/tag/v49.1.0)
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&nbsp;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 Support für die Verwendung von Zahlungsdatensätzen mit Rechnungen und Gutschriften hinzu](https://docs.stripe.com/changelog/clover/2025-10-29/invoicing-payment-records.md)
- [Fügt einen Webhook-Ereignistyp für Rechnungen hinzu, die eine Zahlung ohne Stripe erfordern](https://docs.stripe.com/changelog/clover/2025-10-29/invoice-payment-attempt-required-event.md)
