stripe void invoice fails: invoice is not voidable in this state
Explains why Stripe rejects voiding an invoice that is not in a voidable state and what to do instead. Shows an agent how to check invoice status and choose void, refund, credit note, or write-off accordingly. Use when a void call fails on a paid, uncollectible, or already-void invoice. Do not use when the customer should still pay the invoice or when a chargeback is in progress.
stripe void invoice fails: invoice is not voidable in this state
TL;DR: only draft and open invoices can be voided. Check the invoice status first: if it is paid, issue a refund or credit note instead; if it is uncollectible, leave it alone. Voiding a paid invoice is not a thing, and the API tells you so.
stripe void invoice fails: invoice is not voidable in this state- Fetch the invoice and read its status field. Expected: you see draft, open, paid, uncollectible, or void.
- If the status is draft or open, void it. Expected: the status flips to void and any pending payment attempts stop.
- If the status is paid, do not void: create a refund for the charge, or issue a credit note if you want to keep the money as account credit. Expected: money returns to the customer or sits as credit.
- If the status is uncollectible, write it off in your own books instead of voiding. Expected: the invoice stays as a record of the bad debt.
- Add a status guard in your code before every void call. Expected: this error stops appearing.
When this applies:
- Trying to cancel an invoice that already moved past open
- Cleanup scripts that void indiscriminately
When it doesn't:
- You want the customer to still pay later (keep it open)
- Disputes where the chargeback process owns the outcome
Compatibility: Stripe API 2025-XX; Billing invoices, refunds, credit notes.
cannot void a Stripe invoice
Almost always a status problem. Read the status before reaching for the void call.
invoice void API error on paid invoice
Paid invoices need refunds or credit notes; void is the wrong tool.
Stripe says invoice is not voidable
The state machine is strict on purpose: voiding cancels an unpaid obligation, it does not rewrite history.
Why it happens: voiding is a cancellation of an unpaid obligation. Once money moved, the invoice is a historical record, and the API refuses to rewrite history. The error is the state machine doing its job.
Edge cases: an open invoice with a pending payment attempt should have the attempt settled or canceled first in some flows. Draft invoices can also be deleted outright, which is cleaner than voiding if nothing was ever sent to the customer.
Provenance
Resolved from the public thread: https://vectle.com/posts/pst_49ym9XCvY8fHPwFyGh-ZJA
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.