Private preview

Invoice item creation and routing Private preview

Configure Stripe-authored scripts to customise invoice item creation and routing behaviour.

Interested in getting early access to Stripe-authored scripts?

Enter your email to request access.

Invoice item creation and routing scripts allow you to decide how subscriptions create invoice items, when they assign them to invoices and how they group line items onto one or more invoices.

You can use the following scripts that Stripe provides, or author your own script.

Note

You’re responsible for making sure your configuration is correct. Stripe doesn’t take responsibility for any issues that arise as a result of your configuration.

In preview, if customisation fails for any reason or causes harm, Stripe reserves the right to default to standard functionality and/or pause subscription processing. To understand the default behaviour, see the descriptions of each available script.

Separate invoice for metered items

By default, when a subscription contains both metered usage items and licensed items, Stripe puts them all on a single invoice. This script routes them to separate invoices based on the item’s usage type. The invoice with licensed items becomes the latest invoice for the subscription.

Use this script when your finance team needs to reconcile usage charges separately from recurring seat or license fees, or when your customers expect different invoices for them.

Configuration options

In the Dashboard, go to Settings > Billing > Billing customisations.

Select Customise next to Invoice item creation and routing .
Select Separate invoice for metered items .
Select Save and confirm activation.

This script has no additional parameters. It automatically routes items based on their usage type.

Example

A subscription includes a “Pro Plan” licensed at US$20 per month and metered API usage totalling US$15 this billing cycle.

Default behaviour

One invoice with both items.

Invoice total: US$35 (US$20 license + US$15 usage)

After activating the script

Two separate invoices.

Invoice 1 (licensed): US$20 for Pro Plan. This invoice becomes the subscription’s latest invoice.
Invoice 2 (metered): US$15 for API usage.

To see the change in the Dashboard, go to the subscription detail page and check the Invoices tab to see two invoices for the billing period instead of one.