Stripe | Financial Infrastructure to Grow Your Revenue

Stripe | Financial Infrastructure to Grow Your Revenue

5282 articles

Customers now support multiple subscriptions


Breaking changes

Customers now support multiple subscriptions Breaking changes

What’s new

Replaces the subscription property on the Customer object with the subscriptions property, as customers can have multiple subscriptions.

Impact

Replacing the subscription property on the Customer object with subscriptions opens up the possibility of managing multiple subscriptions.

Changes

ParametersChangeResources or endpoints
subscriptionsAddedCustomer
subscriptionRemovedCustomer

Upgrade

  1. View your current API version 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 to include Stripe-Version: 2014-01-31
  1. Upgrade the API version used for webhook endpoints .
  2. Test your integration against the new version.
  3. If you use Connect, test your Connect integration .

Learn more about Stripe API upgrades.

Last verified 2026-09-25

Is this helpful?