Replaces top-level price fields with improved price modeling on Invoice Items and Invoice Line ItemsBreaking changes

What’s new

We’re introducing a new polymorphic pricing concept on Invoice Items and Invoice Line Items. It contains all price-related data and unifies the structure of pricing objects (Price and Plan) to prepare for adding new pricing object types. We’re also moving unit amount data into pricing.

Why is this a breaking change?

• price and plan fields are no longer available on Invoice Items and Invoice Line Items.
• Move unit_amount and unit_amount_decimal to the new pricing concept on Invoice Items and Invoice Line Items.

Impact

Replace all references to price or plan on Invoice Items or Invoice Line Items with the pricing field:

• Instead of invoice_item.price.id, use invoice_item.pricing.price_details.price after verifying that invoice_item.pricing.type is price_details
• When creating or updating Invoice Items, use the pricing parameter instead of price (e.g., set pricing.price instead of passing the price parameter)
• For unit amounts, use pricing.unit_amount_decimal instead of unit_amount or unit_amount_decimal
• When creating or updating Invoice Items, use the unit_amount_decimal parameter instead of unit_amount

Changes

Upgrade