# Fügt die Alerts API für die nutzungsbasierte Abrechnung hinzu ## Das ändert sich Führt die neue [Warnmeldung](https://docs.stripe.com/api/billing/alert.md?api-version=2024-09-30.acacia)-Ressource ein, mit der Sie Warnungen basierend auf Nutzung konfigurieren können. Weitere Informationen finden Sie unter [Abrechnungsbenachrichtigungen und Schwellenwerte](https://docs.stripe.com/billing/subscriptions/usage-based/monitor.md). ## Auswirkungen Ermöglicht die Einrichtung nutzungsbasierter Benachrichtigungen auf [Abrechnungszähler](https://docs.stripe.com/api/billing/meter.md?api-version=2024-09-30.acacia). Wenn eine Kundin/ein Kunde die Benachrichtigung auslöst, sendet Stripe ein [billing.alert.triggered](https://docs.stripe.com/api/events/types.md?api-version=2024-09-30.acacia#event_types-billing.alert.triggered)-Ereignis. Weitere Infos zur [nutzungsbasierten Abrechnung](https://docs.stripe.com/billing/subscriptions/usage-based.md). ## Änderungen #### REST API | | Change | Resources | | | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | Added | [Billing.AlertTriggered](/api/events/types?api-version=2024-09-30.acacia#event_types-billing.alert.triggered), [Billing.Alert](/api/billing/alert/object?api-version=2024-09-30.acacia) | #### Ruby | | Change | Resources | | | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | Added | [Billing.AlertTriggered](/api/events/types?api-version=2024-09-30.acacia#event_types-billing.alert.triggered), [Billing.Alert](/api/billing/alert/object?api-version=2024-09-30.acacia) | #### Python | | Change | Resource | | | ------ | ------------------------------------------------------------------------------- | | | Added | [stripe.billing.Alert](/api/billing/alert/object?api-version=2024-09-30.acacia) | #### PHP | | Change | Resources | | | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | Added | [Billing.AlertTriggered](/api/events/types?api-version=2024-09-30.acacia#event_types-billing.alert.triggered), [Billing.Alert](/api/billing/alert/object?api-version=2024-09-30.acacia) | #### Java | | Change | Resources | | | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | Added | [Billing.AlertTriggered](/api/events/types?api-version=2024-09-30.acacia#event_types-billing.alert.triggered), [Billing.Alert](/api/billing/alert/object?api-version=2024-09-30.acacia) | #### Node.js | | Change | Resources | | | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | Added | [Billing.AlertTriggered](/api/events/types?api-version=2024-09-30.acacia#event_types-billing.alert.triggered), [Billing.Alert](/api/billing/alert/object?api-version=2024-09-30.acacia) | #### Go | | Change | Resources | | | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | Added | [Billing.AlertTriggered](/api/events/types?api-version=2024-09-30.acacia#event_types-billing.alert.triggered), [Billing.Alert](/api/billing/alert/object?api-version=2024-09-30.acacia) | #### .NET | | Change | Resources | | | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | Added | [Billing.AlertTriggered](/api/events/types?api-version=2024-09-30.acacia#event_types-billing.alert.triggered), [Billing.Alert](/api/billing/alert/object?api-version=2024-09-30.acacia) | ## 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: 2024-09-30.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.0.0](https://github.com/stripe/stripe-ruby/releases/tag/v13.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 [v11.0.0](https://github.com/stripe/stripe-python/releases/tag/v11.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 [v16.0.0](https://github.com/stripe/stripe-php/releases/tag/v16.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 [v27.0.0](https://github.com/stripe/stripe-java/releases/tag/v27.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 [v17.0.0](https://github.com/stripe/stripe-node/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). #### 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 [v80.0.0](https://github.com/stripe/stripe-go/releases/tag/v80.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 [v46.0.0](https://github.com/stripe/stripe-dotnet/releases/tag/v46.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). ## Zugehörige Änderungen - [Fügt Abrechnungsbenachrichtigungen kontextbezogene Filter hinzu](https://docs.stripe.com/changelog/acacia/2024-09-30/billing-alerts-contextualizing-filters.md) - [Fügt ein Ereignis für ausgelöste Abrechnungsbenachrichtigungen hinzu](https://docs.stripe.com/changelog/acacia/2024-09-30/billing-alert-trigger-event.md) - [Fügt Unterstützung für die Überwachung ausgelöster Abrechnungsbenachrichtigungen hinzu](https://docs.stripe.com/changelog/acacia/2024-09-30/billing-alert-webhook-listener.md) - [Fügt Ressourcen und Endpoints für Abrechnungsbenachrichtigungen hinzu](https://docs.stripe.com/changelog/acacia/2024-09-30/adds-billing-alert-resources-endpoints.md) - [Fügt Unterstützung für Abonnements und Abonnementposten zu Abrechnungsbenachrichtigungen hinzu](https://docs.stripe.com/changelog/acacia/2024-09-30/billing-alerts-subscription-items-subscriptions.md) - [Fügt Meter Event v2 API-Endpoints hinzu](https://docs.stripe.com/changelog/acacia/2024-09-30/usage-based-billing-v2-meter-events-api.md)