# Adds an Alerts API for usage-based billing ## What’s new Introduces the new [Alerts](https://docs.stripe.com/api/billing/alert.md?api-version=2024-09-30.acacia) resource, which allows you to configure alerts based on usage. Learn more about [billing alerts and thresholds](https://docs.stripe.com/billing/subscriptions/usage-based/monitor.md). ## Impact Lets you set up usage-based alerting on billing [Meters](https://docs.stripe.com/api/billing/meter.md?api-version=2024-09-30.acacia). When a customer triggers the alert, Stripe sends a [billing.alert.triggered](https://docs.stripe.com/api/events/types.md?api-version=2024-09-30.acacia#event_types-billing.alert.triggered) event. Learn more about [usage-based billing](https://docs.stripe.com/billing/subscriptions/usage-based.md). ## Changes #### 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. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. If you use an SDK, upgrade to the corresponding SDK version for this API version. - If you don’t use an SDK, update your [API requests](https://docs.stripe.com/api/versioning.md) to include `Stripe-Version: 2024-09-30.acacia` 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Ruby 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your Ruby SDK to [v13.0.0](https://github.com/stripe/stripe-ruby/releases/tag/v13.0.0) 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Python 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your Python SDK to [v11.0.0](https://github.com/stripe/stripe-python/releases/tag/v11.0.0) 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### PHP 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your PHP SDK to [v16.0.0](https://github.com/stripe/stripe-php/releases/tag/v16.0.0) 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Java 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your Java SDK to [v27.0.0](https://github.com/stripe/stripe-java/releases/tag/v27.0.0) 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Node.js 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your Node SDK to [v17.0.0](https://github.com/stripe/stripe-node/releases/tag/v17.0.0) 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Go 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your Go SDK to [v80.0.0](https://github.com/stripe/stripe-go/releases/tag/v80.0.0) 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### .NET 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your .NET SDK to [v46.0.0](https://github.com/stripe/stripe-dotnet/releases/tag/v46.0.0) 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). ## Related changes - [Adds contextual filters to billing alerts](https://docs.stripe.com/changelog/acacia/2024-09-30/billing-alerts-contextualizing-filters.md) - [Adds an event for triggered billing alerts](https://docs.stripe.com/changelog/acacia/2024-09-30/billing-alert-trigger-event.md) - [Adds support for listening to triggered billing alerts](https://docs.stripe.com/changelog/acacia/2024-09-30/billing-alert-webhook-listener.md) - [Adds billing alert resources and endpoints](https://docs.stripe.com/changelog/acacia/2024-09-30/adds-billing-alert-resources-endpoints.md) - [Adds support for subscriptions and subscription items to billing alerts](https://docs.stripe.com/changelog/acacia/2024-09-30/billing-alerts-subscription-items-subscriptions.md) - [Adds Meter Event v2 API endpoints](https://docs.stripe.com/changelog/acacia/2024-09-30/usage-based-billing-v2-meter-events-api.md)