You can customize invoices in several ways, including:
Add extra invoice items to a future invoice
You can add up to 250 invoice items to an invoice. To add extra invoice items to the next invoice in the cycle:
These one-off items are added to the next invoice created for this customer. To make sure this is added to a specific subscription, use the optional
subscription parameter to apply it to that subscription.
Invoice pending items more frequently
Other than changing the billing cycle, there are a few ways to invoice these items without adjusting the normal subscription cycle:
Include a one-time charge or discount to the first subscription invoice using
add_invoice_items with one-time price:
Add invoice items to a draft subscription invoice
When a subscription renews and creates an invoice, Stripe sends the
invoice.created webhook event. Stripe waits approximately one hour before finalizing the invoice and attempting payment, or sending an email.
During that delay, the invoice is a
draft and is editable. You can create invoice items on that invoice. Make sure to provide the invoice parameter when you create these invoice items. Otherwise, they’re added as pending items and are included in the next subscription period.
These invoice items behave slightly differently than invoice items automatically generated by Stripe:
Pending invoice items are always charged when the billing period ends for any canceled subscription. Canceling a customer’s subscription prevents them from being billed again if no invoice items exist.
Pending invoice items aren’t prorated when a customer’s subscription changes.
If pending invoice items remain after a subscription cancels, Stripe generates an invoice and attempts to bill the customer for them at the end of the next billing period. These invoice items are (similarly) not prorated when a subscription changes.
Manage pending invoice items
You can see a customer’s pending invoice items by navigating to the Customers page, and clicking on their name. If the customer has a pending invoice item, it appears under Pending invoice items. An invoice item appears as pending if it’s not attached to any invoice.
Under Pending invoice items, you can also choose to create a new invoice item, or instantly invoice everything listed. When you click Invoice now, a dialog appears that lets you select whether to charge the default source or email the invoice to the customer. Additionally, the dialog gives you the option to calculate tax automatically.
Generate an invoice for subscription items outside the billing cycle
You can invoice pending invoice items outside of the regular billing cycle by generating a one-off invoice. Generating a one-off invoice pulls in any pending invoice items that would have been added to the regularly scheduled invoice.
When you manually generate an invoice, Stripe does not apply the tax rates you may have established on the subscription. If taxes should apply, you must explicitly add the tax rates to the invoice.
Pause a subscription invoice for review
Rather than automatically attempting payment at the end of a billing period, you can pause the invoice for review or corrections. To pause an invoice:
Pause automatic collection within one hour of receiving the
invoice.created event. You can do this by setting
auto_advance=false in the API, or by going to Subscriptions and emails in the Dashboard. Locate the pause payment section, and click Set up to make changes. This feature prevents Stripe from automatically attempting payment from your customer for the invoice amount, and from emailing the invoice.
Review the invoice.
After you’re ready to charge the customer, resume automatic collection. You can this by either setting auto_advance=true, or by updating the pause payment options in the Dashboard.
Issue a subscription invoice with configurable item prices
You can issue invoices with line item prices that exclude inclusive tax. Tax-exclusive prices are only shown in the invoice PDF. That means, when using inclusive tax, the Hosted Invoice Page and invoice emails show tax-inclusive prices. You can define the settings for net prices in the Dashboard or API.
- Include inclusive tax—The invoice PDF displays line item prices including the inclusive tax. (This is the default.)
- Exclude tax—The invoice PDF displays line item prices excluding tax.
If you set a default for line item prices at the customer level, it takes precedence over account-level settings.