Breaking changes
Invoicing resources now specify how they were generated Breaking changes
What’s new
We’re introducing a new parent field on invoices, invoice items, and invoice line items. The parent field allows you to view the details of the upstream object that generated the invoice, invoice item, or invoice line item (such as a subscription, a quote, or other). It replaces top level fields that we previously used to reference these objects.
Why is this a breaking change?
- On the Invoice object, we deprecated the quote , subscription , subscription _ details , and subscription _ proration _ date fields.
- On the Invoice Item object, we deprecated the subscription _ item and subscription fields.
- On the Invoice Line Item object, we deprecated the type , subscription , subscription _ item , invoice _ item , proration , and proration _ details fields.
Impact
Replace field references on invoicing objects with their new locations in the parent field.
On Invoice objects:
- Use invoice. parent. subscription _ details. subscription (verify invoice. parent. type is subscription _ details ) instead of invoice. subscription .
- This also applies to:
- quote
- subscription _ details
- subscription _ proration _ date
On Invoice Item objects:
- Use invoiceitem. parent. subscription _ details. subscription (verify invoiceitem. parent. type is subscription _ details ) instead of invoice _ item. subscription
- This also applies to the subscription _ item field
On Invoice Line Item objects:
- Use line _ item. parent. subscription _ item _ details. subscription _ item (verify line _ item. parent. type is subscription _ item _ details ) instead of line _ item. subscription _ item .
- This also applies to:
- subscription
- invoice _ item
- proration
- proration _ details
Changes
| Parameters | Change | Resources or endpoints |
|---|---|---|
| subscription subscription_item | Removed | InvoiceItem |
| quote subscription subscription_details subscription_proration_date | Removed | Invoice |
| invoice_item proration proration_details subscription subscription_item type | Removed | InvoiceLineItem |
| parent | Added | Invoice InvoiceItem InvoiceLineItem |
Upgrade
- View your current API version in Workbench.
- 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: 2025-03-31. basil
- Upgrade the API version used for webhook endpoints .
- Test your integration against the new version.
- If you use Connect, test your Connect integration .
- In Workbench, perform the upgrade . You can roll back the version for 72 hours.
Learn more about Stripe API upgrades.