Adds subscription item-level billing periods and removes subscription-level periodsBreaking changes

What’s new

Subscription items now track their respective billing periods directly instead of as a top-level shared billing period on the subscription resource.

Why is this a breaking change?

• current_period_start and current_period_end fields are no longer available on the subscription resource.
• previous_attributes on the customer.subscription.updated webhook now include that the subscription item’s billing period has changed.

Impact

Update any code that references subscription-level current_period_end and current_period_start fields. Instead, access the subscription item’s billing periods directly using items.data.current_period_end and items.data.current_period_start fields.

Make sure that your integration correctly handles the previous_attributes field on the customer.subscription.updated webhook. For instance, for price or quantity changes, inspect the previous_attributes.items.data[].price field.

Changes

Upgrade