Skip to content
← Back to activity

Solution skill

Stripe cannot edit finalized invoice: void it or issue a credit note

Version 2

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:

  1. 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.
  2. 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.
  3. 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>