1. Treat the first line-level choice as a commitment
A credit note reduces an invoice without voiding and replacing the original invoice.[1] Stripe supports crediting a fixed amount from an invoice line, crediting a quantity from that line, or adding a custom discount line.[1] These are not interchangeable correction methods once a real invoice line has been credited.
If you credit a line by quantity, future credit notes for that same line must also use quantity; if you credit it by amount, future notes must use amount.[1] The restriction concerns the invoice line, not a stated invoice-wide mode. Editorial recommendation: inspect previous credits before choosing a method, and record the chosen method alongside the line identifier so another operator does not plan an incompatible follow-up.
2. Prepare the correction before opening the form
Editorial workflow: identify the original invoice line, why it is wrong, previous credits, and whether the correction represents missing units or a price adjustment. Prefer linking the credit to a real invoice line: Stripe recommends this because custom lines lack that association and can complicate reporting and tracking.[1]
Hypothetical example: an undiscounted, untaxed line bills five units at USD 20, but only three arrive. Crediting two units produces USD 40 under the quantity-times-unit-price rule.[1] A later correction on that line must still use quantity, even if the team now describes its request as a cash amount.[1] Choosing amount instead would lock subsequent credits to amount.[1] Editorial recommendation: resolve likely follow-up needs before issuing, rather than treating the first correction as a disposable trial.
3. Calculate against discounts, not the sticker price
Invoice discounts apply proportionally across line items.[1] Stripe's percentage example has ten USD 10 lines and a 50% discount: crediting one line reduces the invoice by USD 5, not USD 10.[1] Its fixed-discount example spreads USD 10 across ten equal USD 10 lines, leaving USD 9 per line; crediting one line therefore reduces the invoice by USD 9.[1]
Stripe describes adding a USD 1 custom discount line to bridge the latter example back to USD 10.[1] That option must be checked against the automatic-tax restriction below. Editorial recommendation: document whether the intended concession is the discounted line value or its original value. Otherwise a correct line credit can still miss the commercial promise, prompting an incompatible follow-up or an unavailable custom-line workaround.
4. Check automatic tax and custom-line boundaries
When automatic tax is enabled, you cannot add a custom line to a credit note; Stripe directs you to an invoice line instead.[1] Custom lines do not identify the original line's tax treatment, which matters when invoice lines have different treatments.[1] Do not assume the discount top-up example overrides this restriction.
For API custom_line_item entries, provide unit_amount or unit_amount_decimal plus quantity, not a flat amount; tax_rates and tax_amounts cannot both be supplied.[1] Custom credit-note lines cannot carry negative credits.[1] Negative credits are supported only on lines tied to invoice lines, subject to the documented negative-line constraints, including a positive credit-note total.[1] Editorial recommendation: never invent a custom balancing line merely to force a desired total.
5. Issue deliberately; do not rely on voiding
In the Dashboard, select the open or paid invoice, choose More → Issue a credit note, select a reason, edit eligible quantities or amounts, and submit.[1] Open invoices cannot receive a credit note with a pending payment_intent.[1] All credit notes together cannot exceed the invoice total; for a paid invoice, refund, credit, and out-of-band amounts must sum to the note total.[1]
You can void a credit note only on an open invoice; voiding reverses its adjustment and increases the amount due.[1] A credit note that reduces an open invoice to zero changes its status to paid without recording a payment.[1] Consequently, do not budget for voiding after a zeroing correction. The source does not establish that voiding resets the line's mode lock; do not promise that recovery path.
6. Acceptance checklist
Editorial acceptance checklist: confirm invoice status and pending-payment eligibility; match the original line and its prior credit mode; reconcile discounted values and cumulative credits; exclude forbidden custom lines; verify any paid-invoice allocation; retain the reason and issued result. Stop before submission if any check fails. After issuance, compare the result with the approved correction, rather than assuming a successful submission proves the business outcome.
Sources and dates
Official Stripe documentation in English. No publication or update date is stated; retrieved and checked on 2026-09-21. The retrieval date is not a source publication date. This is editorial research, not a PayIn feature claim, account eligibility check, or legal advice.
- [1] Issue credit notes · Checked 2026-09-21; source date not stated.