# Adds semantic thin events for subscriptions, invoicing, and Financial Connections

## What’s new

Adds approximately 50 semantic [thin event](https://docs.stripe.com/api/v2/core/events/object.md?api-version=2026-10-28.endive) types to API v2 across several product areas. Each event represents a specific business milestone, such as a subscription becoming active, an invoice line item being added, or a Financial Connections data refresh succeeding or failing.

The new events cover the following areas:

- [Subscriptions](https://docs.stripe.com/billing/subscriptions/overview.md): Subscription status changes, such as `v1.customer.subscription.active` and `v1.customer.subscription.past_due`; item-level changes, such as `v1.customer.subscription.item_added` and `v1.customer.subscription.item_price_changed`; and changes to subscription schedules, discounts, [entitlements](https://docs.stripe.com/billing/entitlements.md), [prices and products](https://docs.stripe.com/products-prices.md), and promotion codes.
- [Invoicing](https://docs.stripe.com/invoicing.md): Invoice-level changes, such as `v1.invoice.line_item_added` and `v1.invoice.discount_removed`; invoice payment status changes; and invoice item updates.
- [Financial Connections](https://docs.stripe.com/financial-connections.md): Successful and failed data refreshes for balances, inferred balances, ownership, risk intelligence, and transactions. For example, `v1.financial_connections.account.balance_refresh_succeeded` and `v1.financial_connections.account.balance_refresh_failed` distinguish between successful and failed balance refreshes.

Each thin event contains the event type and a reference to the related object. Retrieve the complete resource separately using the URL in the event payload.

## Impact

If your integration subscribes to broad `*.updated` events and filters for specific changes, you can [subscribe to semantic events](https://docs.stripe.com/webhooks/migrate-snapshot-to-thin-events.md) instead to receive notifications for specific business milestones. Existing integrations don’t require changes.

## Changes

#### REST API

|  | Change | Event types |
| --- | --- | --- |
| `V1CustomerDiscountSourceChangedEvent`, `V1EntitlementsActiveEntitlementSummaryEntitlementAddedEvent`, `V1EntitlementsActiveEntitlementSummaryEntitlementRemovedEvent` | Added | `` |
| `V1CustomerSubscriptionActiveEvent`, `V1CustomerSubscriptionCancelAtChangedEvent`, `V1CustomerSubscriptionDefaultPaymentMethodChangedEvent`, `V1CustomerSubscriptionIncompleteEvent`, `V1CustomerSubscriptionIncompleteExpiredEvent`, `V1CustomerSubscriptionItemAddedEvent`, `V1CustomerSubscriptionItemPriceChangedEvent`, `V1CustomerSubscriptionItemQuantityChangedEvent`, `V1CustomerSubscriptionItemRemovedEvent`, `V1CustomerSubscriptionItemTaxRatesChangedEvent`, `V1CustomerSubscriptionPastDueEvent`, `V1CustomerSubscriptionTrialingEvent`, `V1CustomerSubscriptionUnpaidEvent` | Added | `Subscription` |
| `V1FinancialConnectionsAccountBalanceRefreshFailedEvent`, `V1FinancialConnectionsAccountBalanceRefreshSucceededEvent`, `V1FinancialConnectionsAccountInferredBalancesRefreshFailedEvent`, `V1FinancialConnectionsAccountInferredBalancesRefreshSucceededEvent`, `V1FinancialConnectionsAccountOwnershipRefreshFailedEvent`, `V1FinancialConnectionsAccountOwnershipRefreshSucceededEvent`, `V1FinancialConnectionsAccountRiskIntelligenceRefreshFailedEvent`, `V1FinancialConnectionsAccountRiskIntelligenceRefreshSucceededEvent`, `V1FinancialConnectionsAccountTransactionsRefreshFailedEvent`, `V1FinancialConnectionsAccountTransactionsRefreshSucceededEvent` | Added | `FinancialConnections.Account` |
| `V1InvoiceDiscountAddedEvent`, `V1InvoiceDiscountRemovedEvent`, `V1InvoiceLineItemAddedEvent`, `V1InvoiceLineItemPricingChangedEvent`, `V1InvoiceLineItemQuantityChangedEvent`, `V1InvoiceLineItemRemovedEvent` | Added | `Invoice` |
| `V1InvoicePaymentCanceledEvent`, `V1InvoicePaymentOpenEvent` | Added | `InvoicePayment` |
| `V1InvoiceitemAmountChangedEvent`, `V1InvoiceitemDiscountAddedEvent`, `V1InvoiceitemDiscountRemovedEvent` | Added | `InvoiceItem` |
| `V1PriceActivatedEvent`, `V1PriceDeactivatedEvent`, `V1PriceLookupKeyChangedEvent`, `V1PriceTaxBehaviorChangedEvent` | Added | `Price` |
| `V1ProductActivatedEvent`, `V1ProductDeactivatedEvent`, `V1ProductDefaultPriceChangedEvent`, `V1ProductTaxCodeChangedEvent` | Added | `Product` |
| `V1PromotionCodeFullyRedeemedEvent` | Added | `PromotionCode` |
| `V1SubscriptionSchedulePhaseAddedEvent`, `V1SubscriptionSchedulePhaseDefaultTaxRatesChangedEvent`, `V1SubscriptionSchedulePhaseEndDateChangedEvent`, `V1SubscriptionSchedulePhaseRemovedEvent`, `V1SubscriptionSchedulePhaseTrialEndChangedEvent` | Added | `SubscriptionSchedule` |

#### Ruby

|  | Change | Event types |
| --- | --- | --- |
| `V1CustomerDiscountSourceChangedEvent`, `V1EntitlementsActiveEntitlementSummaryEntitlementAddedEvent`, `V1EntitlementsActiveEntitlementSummaryEntitlementRemovedEvent` | Added | `` |
| `V1CustomerSubscriptionActiveEvent`, `V1CustomerSubscriptionCancelAtChangedEvent`, `V1CustomerSubscriptionDefaultPaymentMethodChangedEvent`, `V1CustomerSubscriptionIncompleteEvent`, `V1CustomerSubscriptionIncompleteExpiredEvent`, `V1CustomerSubscriptionItemAddedEvent`, `V1CustomerSubscriptionItemPriceChangedEvent`, `V1CustomerSubscriptionItemQuantityChangedEvent`, `V1CustomerSubscriptionItemRemovedEvent`, `V1CustomerSubscriptionItemTaxRatesChangedEvent`, `V1CustomerSubscriptionPastDueEvent`, `V1CustomerSubscriptionTrialingEvent`, `V1CustomerSubscriptionUnpaidEvent` | Added | `Subscription` |
| `V1FinancialConnectionsAccountBalanceRefreshFailedEvent`, `V1FinancialConnectionsAccountBalanceRefreshSucceededEvent`, `V1FinancialConnectionsAccountInferredBalancesRefreshFailedEvent`, `V1FinancialConnectionsAccountInferredBalancesRefreshSucceededEvent`, `V1FinancialConnectionsAccountOwnershipRefreshFailedEvent`, `V1FinancialConnectionsAccountOwnershipRefreshSucceededEvent`, `V1FinancialConnectionsAccountRiskIntelligenceRefreshFailedEvent`, `V1FinancialConnectionsAccountRiskIntelligenceRefreshSucceededEvent`, `V1FinancialConnectionsAccountTransactionsRefreshFailedEvent`, `V1FinancialConnectionsAccountTransactionsRefreshSucceededEvent` | Added | `FinancialConnections::Account` |
| `V1InvoiceDiscountAddedEvent`, `V1InvoiceDiscountRemovedEvent`, `V1InvoiceLineItemAddedEvent`, `V1InvoiceLineItemPricingChangedEvent`, `V1InvoiceLineItemQuantityChangedEvent`, `V1InvoiceLineItemRemovedEvent` | Added | `Invoice` |
| `V1InvoicePaymentCanceledEvent`, `V1InvoicePaymentOpenEvent` | Added | `InvoicePayment` |
| `V1InvoiceitemAmountChangedEvent`, `V1InvoiceitemDiscountAddedEvent`, `V1InvoiceitemDiscountRemovedEvent` | Added | `InvoiceItem` |
| `V1PriceActivatedEvent`, `V1PriceDeactivatedEvent`, `V1PriceLookupKeyChangedEvent`, `V1PriceTaxBehaviorChangedEvent` | Added | `Price` |
| `V1ProductActivatedEvent`, `V1ProductDeactivatedEvent`, `V1ProductDefaultPriceChangedEvent`, `V1ProductTaxCodeChangedEvent` | Added | `Product` |
| `V1PromotionCodeFullyRedeemedEvent` | Added | `PromotionCode` |
| `V1SubscriptionSchedulePhaseAddedEvent`, `V1SubscriptionSchedulePhaseDefaultTaxRatesChangedEvent`, `V1SubscriptionSchedulePhaseEndDateChangedEvent`, `V1SubscriptionSchedulePhaseRemovedEvent`, `V1SubscriptionSchedulePhaseTrialEndChangedEvent` | Added | `SubscriptionSchedule` |

#### Python

|  | Change | Event types |
| --- | --- | --- |
| `V1CustomerDiscountSourceChangedEvent`, `V1EntitlementsActiveEntitlementSummaryEntitlementAddedEvent`, `V1EntitlementsActiveEntitlementSummaryEntitlementRemovedEvent` | Added | `` |
| `V1CustomerSubscriptionActiveEvent`, `V1CustomerSubscriptionCancelAtChangedEvent`, `V1CustomerSubscriptionDefaultPaymentMethodChangedEvent`, `V1CustomerSubscriptionIncompleteEvent`, `V1CustomerSubscriptionIncompleteExpiredEvent`, `V1CustomerSubscriptionItemAddedEvent`, `V1CustomerSubscriptionItemPriceChangedEvent`, `V1CustomerSubscriptionItemQuantityChangedEvent`, `V1CustomerSubscriptionItemRemovedEvent`, `V1CustomerSubscriptionItemTaxRatesChangedEvent`, `V1CustomerSubscriptionPastDueEvent`, `V1CustomerSubscriptionTrialingEvent`, `V1CustomerSubscriptionUnpaidEvent` | Added | `Subscription` |
| `V1FinancialConnectionsAccountBalanceRefreshFailedEvent`, `V1FinancialConnectionsAccountBalanceRefreshSucceededEvent`, `V1FinancialConnectionsAccountInferredBalancesRefreshFailedEvent`, `V1FinancialConnectionsAccountInferredBalancesRefreshSucceededEvent`, `V1FinancialConnectionsAccountOwnershipRefreshFailedEvent`, `V1FinancialConnectionsAccountOwnershipRefreshSucceededEvent`, `V1FinancialConnectionsAccountRiskIntelligenceRefreshFailedEvent`, `V1FinancialConnectionsAccountRiskIntelligenceRefreshSucceededEvent`, `V1FinancialConnectionsAccountTransactionsRefreshFailedEvent`, `V1FinancialConnectionsAccountTransactionsRefreshSucceededEvent` | Added | `financial_connections.Account` |
| `V1InvoiceDiscountAddedEvent`, `V1InvoiceDiscountRemovedEvent`, `V1InvoiceLineItemAddedEvent`, `V1InvoiceLineItemPricingChangedEvent`, `V1InvoiceLineItemQuantityChangedEvent`, `V1InvoiceLineItemRemovedEvent` | Added | `Invoice` |
| `V1InvoicePaymentCanceledEvent`, `V1InvoicePaymentOpenEvent` | Added | `InvoicePayment` |
| `V1InvoiceitemAmountChangedEvent`, `V1InvoiceitemDiscountAddedEvent`, `V1InvoiceitemDiscountRemovedEvent` | Added | `InvoiceItem` |
| `V1PriceActivatedEvent`, `V1PriceDeactivatedEvent`, `V1PriceLookupKeyChangedEvent`, `V1PriceTaxBehaviorChangedEvent` | Added | `Price` |
| `V1ProductActivatedEvent`, `V1ProductDeactivatedEvent`, `V1ProductDefaultPriceChangedEvent`, `V1ProductTaxCodeChangedEvent` | Added | `Product` |
| `V1PromotionCodeFullyRedeemedEvent` | Added | `PromotionCode` |
| `V1SubscriptionSchedulePhaseAddedEvent`, `V1SubscriptionSchedulePhaseDefaultTaxRatesChangedEvent`, `V1SubscriptionSchedulePhaseEndDateChangedEvent`, `V1SubscriptionSchedulePhaseRemovedEvent`, `V1SubscriptionSchedulePhaseTrialEndChangedEvent` | Added | `SubscriptionSchedule` |

#### PHP

|  | Change | Event types |
| --- | --- | --- |
| `V1CustomerDiscountSourceChangedEvent`, `V1EntitlementsActiveEntitlementSummaryEntitlementAddedEvent`, `V1EntitlementsActiveEntitlementSummaryEntitlementRemovedEvent` | Added | `` |
| `V1CustomerSubscriptionActiveEvent`, `V1CustomerSubscriptionCancelAtChangedEvent`, `V1CustomerSubscriptionDefaultPaymentMethodChangedEvent`, `V1CustomerSubscriptionIncompleteEvent`, `V1CustomerSubscriptionIncompleteExpiredEvent`, `V1CustomerSubscriptionItemAddedEvent`, `V1CustomerSubscriptionItemPriceChangedEvent`, `V1CustomerSubscriptionItemQuantityChangedEvent`, `V1CustomerSubscriptionItemRemovedEvent`, `V1CustomerSubscriptionItemTaxRatesChangedEvent`, `V1CustomerSubscriptionPastDueEvent`, `V1CustomerSubscriptionTrialingEvent`, `V1CustomerSubscriptionUnpaidEvent` | Added | `Subscription` |
| `V1FinancialConnectionsAccountBalanceRefreshFailedEvent`, `V1FinancialConnectionsAccountBalanceRefreshSucceededEvent`, `V1FinancialConnectionsAccountInferredBalancesRefreshFailedEvent`, `V1FinancialConnectionsAccountInferredBalancesRefreshSucceededEvent`, `V1FinancialConnectionsAccountOwnershipRefreshFailedEvent`, `V1FinancialConnectionsAccountOwnershipRefreshSucceededEvent`, `V1FinancialConnectionsAccountRiskIntelligenceRefreshFailedEvent`, `V1FinancialConnectionsAccountRiskIntelligenceRefreshSucceededEvent`, `V1FinancialConnectionsAccountTransactionsRefreshFailedEvent`, `V1FinancialConnectionsAccountTransactionsRefreshSucceededEvent` | Added | `FinancialConnections.Account` |
| `V1InvoiceDiscountAddedEvent`, `V1InvoiceDiscountRemovedEvent`, `V1InvoiceLineItemAddedEvent`, `V1InvoiceLineItemPricingChangedEvent`, `V1InvoiceLineItemQuantityChangedEvent`, `V1InvoiceLineItemRemovedEvent` | Added | `Invoice` |
| `V1InvoicePaymentCanceledEvent`, `V1InvoicePaymentOpenEvent` | Added | `InvoicePayment` |
| `V1InvoiceitemAmountChangedEvent`, `V1InvoiceitemDiscountAddedEvent`, `V1InvoiceitemDiscountRemovedEvent` | Added | `InvoiceItem` |
| `V1PriceActivatedEvent`, `V1PriceDeactivatedEvent`, `V1PriceLookupKeyChangedEvent`, `V1PriceTaxBehaviorChangedEvent` | Added | `Price` |
| `V1ProductActivatedEvent`, `V1ProductDeactivatedEvent`, `V1ProductDefaultPriceChangedEvent`, `V1ProductTaxCodeChangedEvent` | Added | `Product` |
| `V1PromotionCodeFullyRedeemedEvent` | Added | `PromotionCode` |
| `V1SubscriptionSchedulePhaseAddedEvent`, `V1SubscriptionSchedulePhaseDefaultTaxRatesChangedEvent`, `V1SubscriptionSchedulePhaseEndDateChangedEvent`, `V1SubscriptionSchedulePhaseRemovedEvent`, `V1SubscriptionSchedulePhaseTrialEndChangedEvent` | Added | `SubscriptionSchedule` |

#### Java

|  | Change | Event types |
| --- | --- | --- |
| `V1CustomerDiscountSourceChangedEvent`, `V1EntitlementsActiveEntitlementSummaryEntitlementAddedEvent`, `V1EntitlementsActiveEntitlementSummaryEntitlementRemovedEvent` | Added | `` |
| `V1CustomerSubscriptionActiveEvent`, `V1CustomerSubscriptionCancelAtChangedEvent`, `V1CustomerSubscriptionDefaultPaymentMethodChangedEvent`, `V1CustomerSubscriptionIncompleteEvent`, `V1CustomerSubscriptionIncompleteExpiredEvent`, `V1CustomerSubscriptionItemAddedEvent`, `V1CustomerSubscriptionItemPriceChangedEvent`, `V1CustomerSubscriptionItemQuantityChangedEvent`, `V1CustomerSubscriptionItemRemovedEvent`, `V1CustomerSubscriptionItemTaxRatesChangedEvent`, `V1CustomerSubscriptionPastDueEvent`, `V1CustomerSubscriptionTrialingEvent`, `V1CustomerSubscriptionUnpaidEvent` | Added | `Subscription` |
| `V1FinancialConnectionsAccountBalanceRefreshFailedEvent`, `V1FinancialConnectionsAccountBalanceRefreshSucceededEvent`, `V1FinancialConnectionsAccountInferredBalancesRefreshFailedEvent`, `V1FinancialConnectionsAccountInferredBalancesRefreshSucceededEvent`, `V1FinancialConnectionsAccountOwnershipRefreshFailedEvent`, `V1FinancialConnectionsAccountOwnershipRefreshSucceededEvent`, `V1FinancialConnectionsAccountRiskIntelligenceRefreshFailedEvent`, `V1FinancialConnectionsAccountRiskIntelligenceRefreshSucceededEvent`, `V1FinancialConnectionsAccountTransactionsRefreshFailedEvent`, `V1FinancialConnectionsAccountTransactionsRefreshSucceededEvent` | Added | `financialconnections.Account` |
| `V1InvoiceDiscountAddedEvent`, `V1InvoiceDiscountRemovedEvent`, `V1InvoiceLineItemAddedEvent`, `V1InvoiceLineItemPricingChangedEvent`, `V1InvoiceLineItemQuantityChangedEvent`, `V1InvoiceLineItemRemovedEvent` | Added | `Invoice` |
| `V1InvoicePaymentCanceledEvent`, `V1InvoicePaymentOpenEvent` | Added | `InvoicePayment` |
| `V1InvoiceitemAmountChangedEvent`, `V1InvoiceitemDiscountAddedEvent`, `V1InvoiceitemDiscountRemovedEvent` | Added | `InvoiceItem` |
| `V1PriceActivatedEvent`, `V1PriceDeactivatedEvent`, `V1PriceLookupKeyChangedEvent`, `V1PriceTaxBehaviorChangedEvent` | Added | `Price` |
| `V1ProductActivatedEvent`, `V1ProductDeactivatedEvent`, `V1ProductDefaultPriceChangedEvent`, `V1ProductTaxCodeChangedEvent` | Added | `Product` |
| `V1PromotionCodeFullyRedeemedEvent` | Added | `PromotionCode` |
| `V1SubscriptionSchedulePhaseAddedEvent`, `V1SubscriptionSchedulePhaseDefaultTaxRatesChangedEvent`, `V1SubscriptionSchedulePhaseEndDateChangedEvent`, `V1SubscriptionSchedulePhaseRemovedEvent`, `V1SubscriptionSchedulePhaseTrialEndChangedEvent` | Added | `SubscriptionSchedule` |

#### Node.js

|  | Change | Event types |
| --- | --- | --- |
| `V1CustomerDiscountSourceChangedEvent`, `V1EntitlementsActiveEntitlementSummaryEntitlementAddedEvent`, `V1EntitlementsActiveEntitlementSummaryEntitlementRemovedEvent` | Added | `` |
| `V1CustomerSubscriptionActiveEvent`, `V1CustomerSubscriptionCancelAtChangedEvent`, `V1CustomerSubscriptionDefaultPaymentMethodChangedEvent`, `V1CustomerSubscriptionIncompleteEvent`, `V1CustomerSubscriptionIncompleteExpiredEvent`, `V1CustomerSubscriptionItemAddedEvent`, `V1CustomerSubscriptionItemPriceChangedEvent`, `V1CustomerSubscriptionItemQuantityChangedEvent`, `V1CustomerSubscriptionItemRemovedEvent`, `V1CustomerSubscriptionItemTaxRatesChangedEvent`, `V1CustomerSubscriptionPastDueEvent`, `V1CustomerSubscriptionTrialingEvent`, `V1CustomerSubscriptionUnpaidEvent` | Added | `Subscription` |
| `V1FinancialConnectionsAccountBalanceRefreshFailedEvent`, `V1FinancialConnectionsAccountBalanceRefreshSucceededEvent`, `V1FinancialConnectionsAccountInferredBalancesRefreshFailedEvent`, `V1FinancialConnectionsAccountInferredBalancesRefreshSucceededEvent`, `V1FinancialConnectionsAccountOwnershipRefreshFailedEvent`, `V1FinancialConnectionsAccountOwnershipRefreshSucceededEvent`, `V1FinancialConnectionsAccountRiskIntelligenceRefreshFailedEvent`, `V1FinancialConnectionsAccountRiskIntelligenceRefreshSucceededEvent`, `V1FinancialConnectionsAccountTransactionsRefreshFailedEvent`, `V1FinancialConnectionsAccountTransactionsRefreshSucceededEvent` | Added | `FinancialConnections.Account` |
| `V1InvoiceDiscountAddedEvent`, `V1InvoiceDiscountRemovedEvent`, `V1InvoiceLineItemAddedEvent`, `V1InvoiceLineItemPricingChangedEvent`, `V1InvoiceLineItemQuantityChangedEvent`, `V1InvoiceLineItemRemovedEvent` | Added | `Invoice` |
| `V1InvoicePaymentCanceledEvent`, `V1InvoicePaymentOpenEvent` | Added | `InvoicePayment` |
| `V1InvoiceitemAmountChangedEvent`, `V1InvoiceitemDiscountAddedEvent`, `V1InvoiceitemDiscountRemovedEvent` | Added | `InvoiceItem` |
| `V1PriceActivatedEvent`, `V1PriceDeactivatedEvent`, `V1PriceLookupKeyChangedEvent`, `V1PriceTaxBehaviorChangedEvent` | Added | `Price` |
| `V1ProductActivatedEvent`, `V1ProductDeactivatedEvent`, `V1ProductDefaultPriceChangedEvent`, `V1ProductTaxCodeChangedEvent` | Added | `Product` |
| `V1PromotionCodeFullyRedeemedEvent` | Added | `PromotionCode` |
| `V1SubscriptionSchedulePhaseAddedEvent`, `V1SubscriptionSchedulePhaseDefaultTaxRatesChangedEvent`, `V1SubscriptionSchedulePhaseEndDateChangedEvent`, `V1SubscriptionSchedulePhaseRemovedEvent`, `V1SubscriptionSchedulePhaseTrialEndChangedEvent` | Added | `SubscriptionSchedule` |

#### Go

|  | Change | Event types |
| --- | --- | --- |
| `V1CustomerDiscountSourceChangedEvent`, `V1EntitlementsActiveEntitlementSummaryEntitlementAddedEvent`, `V1EntitlementsActiveEntitlementSummaryEntitlementRemovedEvent` | Added | `` |
| `V1CustomerSubscriptionActiveEvent`, `V1CustomerSubscriptionCancelAtChangedEvent`, `V1CustomerSubscriptionDefaultPaymentMethodChangedEvent`, `V1CustomerSubscriptionIncompleteEvent`, `V1CustomerSubscriptionIncompleteExpiredEvent`, `V1CustomerSubscriptionItemAddedEvent`, `V1CustomerSubscriptionItemPriceChangedEvent`, `V1CustomerSubscriptionItemQuantityChangedEvent`, `V1CustomerSubscriptionItemRemovedEvent`, `V1CustomerSubscriptionItemTaxRatesChangedEvent`, `V1CustomerSubscriptionPastDueEvent`, `V1CustomerSubscriptionTrialingEvent`, `V1CustomerSubscriptionUnpaidEvent` | Added | `Subscription` |
| `V1FinancialConnectionsAccountBalanceRefreshFailedEvent`, `V1FinancialConnectionsAccountBalanceRefreshSucceededEvent`, `V1FinancialConnectionsAccountInferredBalancesRefreshFailedEvent`, `V1FinancialConnectionsAccountInferredBalancesRefreshSucceededEvent`, `V1FinancialConnectionsAccountOwnershipRefreshFailedEvent`, `V1FinancialConnectionsAccountOwnershipRefreshSucceededEvent`, `V1FinancialConnectionsAccountRiskIntelligenceRefreshFailedEvent`, `V1FinancialConnectionsAccountRiskIntelligenceRefreshSucceededEvent`, `V1FinancialConnectionsAccountTransactionsRefreshFailedEvent`, `V1FinancialConnectionsAccountTransactionsRefreshSucceededEvent` | Added | `FinancialConnectionsAccount` |
| `V1InvoiceDiscountAddedEvent`, `V1InvoiceDiscountRemovedEvent`, `V1InvoiceLineItemAddedEvent`, `V1InvoiceLineItemPricingChangedEvent`, `V1InvoiceLineItemQuantityChangedEvent`, `V1InvoiceLineItemRemovedEvent` | Added | `Invoice` |
| `V1InvoicePaymentCanceledEvent`, `V1InvoicePaymentOpenEvent` | Added | `InvoicePayment` |
| `V1InvoiceitemAmountChangedEvent`, `V1InvoiceitemDiscountAddedEvent`, `V1InvoiceitemDiscountRemovedEvent` | Added | `InvoiceItem` |
| `V1PriceActivatedEvent`, `V1PriceDeactivatedEvent`, `V1PriceLookupKeyChangedEvent`, `V1PriceTaxBehaviorChangedEvent` | Added | `Price` |
| `V1ProductActivatedEvent`, `V1ProductDeactivatedEvent`, `V1ProductDefaultPriceChangedEvent`, `V1ProductTaxCodeChangedEvent` | Added | `Product` |
| `V1PromotionCodeFullyRedeemedEvent` | Added | `PromotionCode` |
| `V1SubscriptionSchedulePhaseAddedEvent`, `V1SubscriptionSchedulePhaseDefaultTaxRatesChangedEvent`, `V1SubscriptionSchedulePhaseEndDateChangedEvent`, `V1SubscriptionSchedulePhaseRemovedEvent`, `V1SubscriptionSchedulePhaseTrialEndChangedEvent` | Added | `SubscriptionSchedule` |

#### .NET

|  | Change | Event types |
| --- | --- | --- |
| `V1CustomerDiscountSourceChangedEvent`, `V1EntitlementsActiveEntitlementSummaryEntitlementAddedEvent`, `V1EntitlementsActiveEntitlementSummaryEntitlementRemovedEvent` | Added | `` |
| `V1CustomerSubscriptionActiveEvent`, `V1CustomerSubscriptionCancelAtChangedEvent`, `V1CustomerSubscriptionDefaultPaymentMethodChangedEvent`, `V1CustomerSubscriptionIncompleteEvent`, `V1CustomerSubscriptionIncompleteExpiredEvent`, `V1CustomerSubscriptionItemAddedEvent`, `V1CustomerSubscriptionItemPriceChangedEvent`, `V1CustomerSubscriptionItemQuantityChangedEvent`, `V1CustomerSubscriptionItemRemovedEvent`, `V1CustomerSubscriptionItemTaxRatesChangedEvent`, `V1CustomerSubscriptionPastDueEvent`, `V1CustomerSubscriptionTrialingEvent`, `V1CustomerSubscriptionUnpaidEvent` | Added | `Subscription` |
| `V1FinancialConnectionsAccountBalanceRefreshFailedEvent`, `V1FinancialConnectionsAccountBalanceRefreshSucceededEvent`, `V1FinancialConnectionsAccountInferredBalancesRefreshFailedEvent`, `V1FinancialConnectionsAccountInferredBalancesRefreshSucceededEvent`, `V1FinancialConnectionsAccountOwnershipRefreshFailedEvent`, `V1FinancialConnectionsAccountOwnershipRefreshSucceededEvent`, `V1FinancialConnectionsAccountRiskIntelligenceRefreshFailedEvent`, `V1FinancialConnectionsAccountRiskIntelligenceRefreshSucceededEvent`, `V1FinancialConnectionsAccountTransactionsRefreshFailedEvent`, `V1FinancialConnectionsAccountTransactionsRefreshSucceededEvent` | Added | `FinancialConnections.Account` |
| `V1InvoiceDiscountAddedEvent`, `V1InvoiceDiscountRemovedEvent`, `V1InvoiceLineItemAddedEvent`, `V1InvoiceLineItemPricingChangedEvent`, `V1InvoiceLineItemQuantityChangedEvent`, `V1InvoiceLineItemRemovedEvent` | Added | `Invoice` |
| `V1InvoicePaymentCanceledEvent`, `V1InvoicePaymentOpenEvent` | Added | `InvoicePayment` |
| `V1InvoiceitemAmountChangedEvent`, `V1InvoiceitemDiscountAddedEvent`, `V1InvoiceitemDiscountRemovedEvent` | Added | `InvoiceItem` |
| `V1PriceActivatedEvent`, `V1PriceDeactivatedEvent`, `V1PriceLookupKeyChangedEvent`, `V1PriceTaxBehaviorChangedEvent` | Added | `Price` |
| `V1ProductActivatedEvent`, `V1ProductDeactivatedEvent`, `V1ProductDefaultPriceChangedEvent`, `V1ProductTaxCodeChangedEvent` | Added | `Product` |
| `V1PromotionCodeFullyRedeemedEvent` | Added | `PromotionCode` |
| `V1SubscriptionSchedulePhaseAddedEvent`, `V1SubscriptionSchedulePhaseDefaultTaxRatesChangedEvent`, `V1SubscriptionSchedulePhaseEndDateChangedEvent`, `V1SubscriptionSchedulePhaseRemovedEvent`, `V1SubscriptionSchedulePhaseTrialEndChangedEvent` | Added | `SubscriptionSchedule` |

## Upgrade

#### REST API

1. [View your current API version](https://docs.stripe.com/workbench/guides.md#view-api-versions) in Workbench.
2. 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-versions.md#how-versions-are-specified-in-requests) to include `Stripe-Version: 2026-10-28.endive`
3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
4. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).

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.
2. Upgrade your Ruby SDK to the latest version.
3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
4. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
6. 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.
2. Upgrade your Python SDK to the latest version.
3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
4. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
6. 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.
2. Upgrade your PHP SDK to the latest version.
3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
4. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
6. 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.
2. Upgrade your Java SDK to the latest version.
3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
4. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
6. 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.
2. Upgrade your Node SDK to the latest version.
3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
4. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
6. 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.
2. Upgrade your Go SDK to the latest version.
3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
4. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
6. 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.
2. Upgrade your .NET SDK to the latest version.
3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
4. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
6. 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).
