# Gutschriftengewährungen können jetzt priorisiert werden

## Das ändert sich

Durch diese Änderung wird der [Priorität](https://docs.stripe.com/api/billing/credit-grant/object.md?api-version=2025-02-24.acacia#billing_credit_grant_object-priority)-Parameter zur Ressource [Gutschriftgewährung](https://docs.stripe.com/api/billing/credit-grant.md?api-version=2025-02-24.acacia) hinzugefügt.

## Ergebnis

Sie können benutzerdefinierte Prioritäten für die Anwendung von Gutschriftgewährungen festlegen. Wenn Sie mehrere Gutschriftgewährungen auf eine Rechnung oder einen Posten anwenden, können Sie [Priorität](https://docs.stripe.com/api/billing/credit-grant/object.md?api-version=2025-02-24.acacia#billing_credit_grant_object-priority)-Werte für jede Gutschrift definieren, um festzulegen, welche Gutschriften zuerst berücksichtigt werden sollen. Diese Werte reichen von `0` bis `100`, wobei niedrigere Werte eine höhere Priorität darstellen.

Erfahren Sie, wie Sie [Kredite beantragen](https://docs.stripe.com/billing/subscriptions/usage-based/billing-credits.md#multiple-credit-grants).

## Änderungen

#### REST API

| Parameter | Change | Resources or endpoints |
| --- | --- | --- |
| `priority` | Added | `Billing.CreditGrant#create`, [Billing.CreditGrant](/api/billing/credit-grant?api-version=2025-02-24.acacia) |

#### Ruby

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

#### Python

| Parameter | Change | Resources or methods |
| --- | --- | --- |
| `priority` | Added | `stripe.billing.CreditGrant.CreateParams`, `stripe.billing.CreditGrant` |

#### PHP

| Parameter | Change | Resources or methods |
| --- | --- | --- |
| `priority` | Added | [Billing.CreditGrant](/api/billing/credit-grant?api-version=2025-02-24.acacia) |

#### Java

| Parameter | Change | Resources or methods |
| --- | --- | --- |
| `priority` | Added | [Billing.CreditGrant](/api/billing/credit-grant?api-version=2025-02-24.acacia), `billing.CreditGrantCreateParams` |

#### Node.js

| Parameter | Change | Resources or methods |
| --- | --- | --- |
| `priority` | Added | `Billing.CreditGrantCreateParams`, [Billing.CreditGrant](/api/billing/credit-grant?api-version=2025-02-24.acacia) |

#### Go

| Parameter | Change | Resources or methods |
| --- | --- | --- |
| `Priority` | Added | `BillingCreditGrantParams`, `BillingCreditGrant` |

#### .NET

| Parameter | Change | Resources or methods |
| --- | --- | --- |
| `Priority` | Added | `Billing.CreditGrantCreateOptions`, `BillingCreditGrant` |

## 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: 2025-02-24.acacia`
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 [v13.5.0](https://github.com/stripe/stripe-ruby/releases/tag/v13.5.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 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 [v11.6.0](https://github.com/stripe/stripe-python/releases/tag/v11.6.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 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 [v16.6.0](https://github.com/stripe/stripe-php/releases/tag/v16.6.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 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 [v28.4.0](https://github.com/stripe/stripe-java/releases/tag/v28.4.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 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 [v17.7.0](https://github.com/stripe/stripe-node/releases/tag/v17.7.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 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 [v81.4.0](https://github.com/stripe/stripe-go/releases/tag/v81.4.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 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 [v47.4.0](https://github.com/stripe/stripe-dotnet/releases/tag/v47.4.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 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

- [Gutschriftengewährungen können jetzt auf bestimmte Preise angewendet werden](https://docs.stripe.com/changelog/acacia/2025-02-24/billing-credits-price-level-applicability.md)