# Gutschriftengewährungen können jetzt auf bestimmte Preise angewendet werden ## Das ändert sich Wenn Sie [eine Gutschriftgewährung erstellen](https://docs.stripe.com/api/billing/credit-grant/create.md?api-version=2025-02-24.acacia#create_billing_credit_grant-applicability_config-scope-price_type), können Sie jetzt den [Umfang](https://docs.stripe.com/api/billing/credit-grant/create.md?lang=curl&api-version=2025-02-24.acacia#create_billing_credit_grant-applicability_config-scope) der Gutschriftgewährungen definieren, um eine Liste bestimmter `Preise` oder einen [price_type](https://docs.stripe.com/api/billing/credit-grant/create.md?api-version=2025-02-24.acacia#create_billing_credit_grant-applicability_config-scope-price_type) abzudecken, der auf die Gutschriftgewährung angewendet werden soll. Sie müssen entweder `Preise` oder `price_type` angeben, wenn Sie die Gutschriftgewährung erstellen. Derzeit können Sie nur nutzungsbasierte Preise in der `Preisliste` angeben und nur `nutzungsbasierte` Preise werden für den `price_type` unterstützt. ## Ergebnis Diese Änderung ermöglicht eine differenzierte Kontrolle darüber, auf welche Preise ein Kredit gewährt werden kann. Die neuen Felder ermöglichen es Ihnen, eine Saldenübersicht für alle Kreditgewährungen abzurufen, die für eine bestimmte Preisliste gelten. ## Änderungen #### REST API | Parameters | Change | Resources or endpoints | | ---------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `price_type`, `prices` | Added | `Billing.CreditBalanceSummary#retrieve.filter.applicability_scope`, `Billing.CreditGrant#create.applicability_config.scope`, `Billing.CreditGrant.applicability_config.scope` | #### Ruby Diese Änderung wirkt sich nicht auf das Ruby SDK aus. #### Python | Parameters | Change | Resources or methods | | ------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `price_type` | Added | `stripe.billing.CreditBalanceSummary.RetrieveParamsFilterApplicabilityScope`, `stripe.billing.CreditGrant.CreateParamsApplicabilityConfigScope`, `stripe.billing.CreditGrant.ApplicabilityConfig.Scope` | | `prices` | Added | `stripe.billing.CreditBalanceSummary.RetrieveParamsFilterApplicabilityScope`, `stripe.billing.CreditGrant.CreateParamsApplicabilityConfigScope`, `stripe.billing.CreditGrant.ApplicabilityConfig.Scope` | #### PHP Diese Änderung wirkt sich nicht auf das PHP SDK aus. #### Java | Parameters | Change | Resources or methods | | ---------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `price_type`, `prices` | Added | `Billing.CreditGrant.applicability_config.scope`, `billing.CreditBalanceSummaryRetrieveParams.filter.applicability_scope`, `billing.CreditGrantCreateParams.applicability_config.scope` | #### Node.js | Parameters | Change | Resources or methods | | ---------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `price_type`, `prices` | Added | `Billing.CreditBalanceSummaryRetrieveParams.filter.applicability_scope`, `Billing.CreditGrant.applicability_config.scope`, `Billing.CreditGrantCreateParams.applicability_config.scope` | #### Go | Parameters | Change | Resources or methods | | --------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `PriceType`, `Prices` | Added | `BillingCreditBalanceSummaryFilterApplicabilityScopeParams`, `BillingCreditGrantApplicabilityConfigScopeParams`, `BillingCreditGrantApplicabilityConfigScope` | #### .NET | Parameters | Change | Resources or methods | | --------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `PriceType`, `Prices` | Added | `BillingCreditBalanceSummaryFilterApplicabilityScopeOptions`, `BillingCreditGrantApplicabilityConfigScopeOptions`, `BillingCreditGrantApplicabilityConfigScope` | ## 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-02-24.acacia` 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 [v13.5.0](https://github.com/stripe/stripe-ruby/releases/tag/v13.5.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 [v11.6.0](https://github.com/stripe/stripe-python/releases/tag/v11.6.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 [v16.6.0](https://github.com/stripe/stripe-php/releases/tag/v16.6.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 [v28.4.0](https://github.com/stripe/stripe-java/releases/tag/v28.4.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 [v17.7.0](https://github.com/stripe/stripe-node/releases/tag/v17.7.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 [v81.4.0](https://github.com/stripe/stripe-go/releases/tag/v81.4.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 [v47.4.0](https://github.com/stripe/stripe-dotnet/releases/tag/v47.4.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). ## Zugehörige Änderungen - [Gutschriftengewährungen können jetzt priorisiert werden](https://docs.stripe.com/changelog/acacia/2025-02-24/billing-credits-priority.md)