Invoice Item

An invoice item is a single pending charge or credit attached to a customer that will appear as a line on their next invoice. In Stripe it is the invoiceitem object — the building block invoices are assembled from, whether the amount comes from a subscription, metered usage, a one-off fee, or a manual adjustment.

How invoice items work

When Stripe finalizes an invoice, it sweeps up every pending invoice item for that customer and turns each one into a line on the invoice. You can create an item with a fixed amount and currency, or point it at a Price so it inherits pricing and tax behavior.

• Subscription-generated items — each billing period, Stripe creates items for every active subscription line automatically.
• Standalone items — you add a one-off charge (setup fee, overage, manual credit) that rides along on the next invoice instead of billing immediately.
• Negative items — an item with a negative amount acts as a credit, reducing the invoice total.

Items sit in a pending state until an invoice picks them up, so you can stage several charges and let them settle on the customer's normal billing cycle.

Where invoice items come from

• Prorations — when a subscription changes mid-cycle, Stripe writes proration invoice items to charge or credit the unused portion.
• Metered usage — usage-based billing totals reported usage into an invoice item at period end.
• Manual charges — you can attach a bespoke fee to a customer's next bill without creating a new subscription.

Why it matters

Invoice items are why a subscription invoice can carry more than the plan price — a $24/month line plus a usage overage plus a mid-cycle proration all land on one invoice. Reading the items on an invoice tells you exactly what a customer is being charged for and why the total is what it is.