Breaking changes

Subscriptions no longer support modifying the source parameter directly Breaking changes

What’s new

Subscription endpoints no longer support the source parameter. If you want to change the default source for a customer, use the Source creation API to add the new source, and then the Customer update API to set it as the default.

Impact

This change removes the ability to directly update a subscription’s payment source through subscription endpoints. You must now use a two-step process: first adding a new source through the Source Creation API, then updating the customer’s default source using the Customer Update API. This modification might require significant updates to existing code that manages subscription payment sources

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: 2018-07-27

3. Upgrade the API version used for webhook endpoints .
4. Test your integration against the new version.
5. If you use Connect, test your Connect integration .
6. In Workbench, perform the upgrade . You can roll back the version for 72 hours.

Learn more about Stripe API upgrades.