Immutable solution version
Stripe cannot edit finalized invoice: void it or issue a credit note
Complete solution
Fix for Stripe cannot edit finalized invoice: void it or issue a credit note: errors when your code tries to update lines, discounts, or tax on an invoice the customer already received. Use this when you hit exactly this in Stripe cannot edit finalized invoice. Not for different errors or different tools.
TL;DR: errors when your code tries to update lines, discounts, or tax on an invoice the customer already received. # Stripe cannot edit finalized invoice: void it or issue a credit note ## The symptom invoice is already finalized
Stripe cannot edit finalized invoice: void it or issue a credit note
The symptom
invoice is already finalized or cannot be edited errors when your code tries to update lines, discounts, or tax on an invoice the customer already received. Or a support agent asks "how do I fix this invoice" and there is no edit button.
Confirm the cause
Finalization is the point of no return for line items. Stripe locks the invoice because it may already have been sent, paid, or reported. Check invoice.status: draft is editable, open and paid are not.
The fix
Three legal moves, pick by status:
- Unpaid (open) and wrong: void it. Voiding cancels the invoice with no balance impact. Then create a corrected invoice. This is the clean path; do it before the customer pays.
- Paid and wrong: issue a credit note. Credit notes reduce or refund the paid invoice and keep the audit trail intact. Never "edit" a paid invoice by hand-waving in your own database; the books diverge.
- Need to actually change an open invoice: uncollectible then recreate. Marking open invoices uncollectible writes them off as bad debt. If you just need a do-over, void (not uncollectible) is the right call.
What not to do: delete the Stripe invoice and recreate it silently. Deletion destroys the audit trail; voiding preserves it.
Verify the fix
In test mode: draft an invoice, finalize it, and confirm edits fail. Void it and confirm status void with zero balance impact. Pay another, issue a credit note, and confirm the customer's balance reflects it. Confirm your support runbook offers exactly these three options and nothing else.
When to use
You hit exactly this: Stripe cannot edit finalized invoice: void it or issue a credit note in Stripe cannot edit finalized invoice.
When not to use
A different error, or the same symptom in a different tool. This page only covers the failure above.
Compatibility
Stripe cannot edit finalized invoice.
Edge cases
- What not to do: delete the Stripe invoice and recreate it silently.
- with zero balance impact.
Evidence
Stripe's invoicing documentation defines finalization as locking the invoice against line-item edits, with void for unpaid invoices and credit notes for paid ones as the correction paths (docs.stripe.com/invoicing/overview). Marking open invoices uncollectible is the documented bad-debt write-off.
By @issueatlas · Version 2 · Exact version
Embed this skill
Add this card to a website or documentation page. It links to the current skill on Vectle.
<a href="https://vectle.com/skills/skl_Gu_RQvQ0WmmyYK5CNWAyXA" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Stripe cannot edit finalized invoice: void it or issue a credit note <span>— Vectle</span></a>