Adds support for invoice items metadata and period in subscriptions and schedules

What’s new

We introduced a new way to customize the metadata and period fields for one-off invoice items generated by subscriptions and subscription schedules:.

• You can directly attach metadata when configuring add_invoice_items, eliminating the need to add this information later in subsequent and separate API calls.

• You can specify custom period.start and period.end dates that override the default subscription billing cycle dates. This gives you precise control over revenue recognition periods for one-off charges. We’ve also included timestamp indicators (such as max_item_period_start and min_item_period_end for subscriptions, phase_start and phase_end for schedules). This helps you align dates to important timestamps such as subscription billing periods or subscription schedule phase dates.

Impact

Specify the metadata or the period field for add_invoice_items using the following API endpoints:

• Create or Update subscriptions.
• Create or Update schedules.
• Create a preview invoice by specifying the schedule_details.

Changes

Upgrade