Stripe pending invoice items at subscription cancel: invoice them or lose them
Decides what happens to Stripe pending invoice items on cancel. Use when canceling a subscription with unbilled one-off charges and you must choose to bill or forgive them. Not for recurring subscription charges.
TL;DR
When you cancel a Stripe subscription, pending invoice items do not vanish: they sit on the customer waiting for the next invoice, and if no invoice ever comes, they linger unbilled. At cancel time, make the call deliberately: invoice them now with a final one-off invoice if the charges are legitimate, or delete/void them if you are forgiving the balance. The worst outcome is the accidental third option, where items sit for months and then sweep into an unrelated future invoice, confusing everyone. Put this decision in your cancellation checklist.
The query
Stripe pending invoice items at subscription cancel: invoice them or lose themUse this when
- Canceling subscriptions with unbilled one-off charges
- Stray pending items appearing on unrelated future invoices
- Building a cancellation checklist for billing ops
Not for
- Recurring subscription line items (handled by the cancel itself)
- Refunding already-paid invoices (use credit notes)
Steps
- Before canceling, list pending invoice items for the customer.
Expected output: You see exactly what is unbilled.
- Decide per item: legitimate charges to bill, or amounts to forgive.
Expected output: The decision is explicit, not accidental.
- To bill: create a one-off invoice for the pending items, then cancel the subscription.
Expected output: The customer gets a clean final invoice.
- To forgive: delete the pending items (or void them) before canceling.
Expected output: Nothing lingers to surprise a future invoice.
- Add this check to your cancel flow or runbook so every cancel makes the call.
Expected output: No more mystery charges months later.
Variant phrasings
Stripe pending invoice items cancel subscription
what happens to pending invoice items on cancel Stripe
invoice pending items before canceling Stripe
Root cause
Pending items belong to the customer, not the subscription, so canceling the subscription does not touch them. That ownership model is the whole reason they survive cancellation and resurface later.
Edge cases
- auto_advance on the final invoice matters: a draft left unfinalized bills nothing
- If the customer might resubscribe, unbilled items will sweep into the new subscription's first invoice unless cleared
Provenance
Resolved from the public thread: https://vectle.com/posts/pst_othlftXAOYxunba1ONkaNA
Maintainer review
No maintainer verification is recorded for this version.
This records the version a maintainer checked. It does not assert that the version is the latest upstream release.