The short answer on Flint
Flint invoices take credit notes through the API. Name the invoice lines and a quantity or amount for each, and Flint works out each line's share of tax and discount, numbers the note, renders the PDF, and emails it to the buyer. In the same call it applies the credit to an unpaid balance or refunds it on a paid invoice. Flint never lets credit notes and returns together take back more than a line billed. The Flint requests are below.
What a credit note does
An issued invoice is a record both sides keep. Once the customer has it, you don't change it. When the amount turns out to be wrong, you issue a second document that points back at the first and says how much to take off. That second document is the credit note.
Say invoice 1042 billed six oak chairs at $150.00 each with a 10% discount and sales tax. Two arrive damaged and come back. The credit note lists two chairs, the discount and tax that went with them, and the total credited. The invoice still says six chairs; the pair of documents together says four.
Credit note line for two of six chairs
Subtotalsubtotal_money
2 × $150.00
$300.00
Discountdiscount_money
Their share of the 10% discount
−$30.00
Taxtax_money
Their share of the tax charged
$22.28
$292.28
What happens to that $292.28 depends on whether the invoice is paid:
- Unpaid or partly paid: the credit comes off the balance. The customer pays less, and no money moves.
- Paid in full: the credit is owed back. You refund it to the customer's original payment, or, in systems that keep a customer balance, hold it against their next invoice.
Credit note vs credit memo vs refund
The terms get mixed up because they often happen together. A return can produce a credit note and a refund on the same day, but they are different things:
| Term | What it is | Who issues it | Money moves? |
|---|
| Credit note | A document that reduces an issued invoice | The seller | Not by itself |
| Credit memo | The same document. US accounting software, such as QuickBooks, calls it a credit memo | The seller | Not by itself |
| Refund | Money returned to the customer's card, bank account, or gift card | The seller, through its payment processor | Yes |
| Debit note or debit memo | A document that raises what is owed, the opposite adjustment | The seller, or a buyer claiming a deduction | Not by itself |
| Store credit | Value the customer can spend with you later, such as a gift card | The seller | No cash leaves the business |
A refund without a credit note is fine when the invoice itself was right, such as a goodwill refund on a correctly billed order. When the invoice billed too much, issue the credit note too, so your books and tax filings show why the sale went down.
When to issue a credit note
- Returned goods. The customer sent back some or all of what they were billed for.
- Billing error. The invoice charged the wrong item, quantity, rate, or tax.
- Order change. You shipped three of five items and the rest are canceled, or the scope of a job shrank after you invoiced.
- Goodwill. You agreed to a discount after the fact, such as for a late delivery.
Don't use one while the invoice is still a draft: edit the draft. And don't issue a new, smaller invoice to replace one the customer already has. Two live invoices for one sale is how the same order gets paid twice.
What a credit note must include
The exact rules depend on where you sell, but a credit note that holds up for a customer and an auditor shows:
- Its own unique number and issue date
- Your business name and address, and your tax registration number where you have one
- The customer's name and address
- The number and date of the invoice it corrects
- Each credited item, with its quantity and amount
- The tax credited, with its rate, and the total credited before and after tax
- The reason, such as returned goods or a billing error
For UK VAT, HMRC's VAT Notice 700, paragraph 18.2.3, lists these fields for a valid VAT credit note, and a note that corrects overcharged VAT must reference the original invoice's number and date. For US sales tax, keep each credit note with the invoice it corrects, so the tax you credited is documented when you file. This is not tax advice; confirm the rules where you are registered.
Where credit notes go wrong
Credit notes on Flint
A Flint credit note belongs to one issued invoice. Create a draft naming the invoice lines to correct, each by quantity or by amount, and a reason that prints on the document: returned_goods, order_adjustment, billing_error, goodwill, or other.
curl -X POST https://api.withflintpay.com/v1/credit-notes \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Idempotency-Key: credit-note-inv-1042-1" \
-H "Content-Type: application/json" \
-d '{
"invoice_id": "inv_01KF3Q8V2M6N4P7R9S1T3W5X7Y",
"reason": "returned_goods",
"memo": "Two chairs arrived damaged, and the table has a scratch.",
"line_items": [
{
"invoice_line_item_id": "invli_01KF3Q8V2M6N4P7R9S1T3W5X80",
"correction": {"type": "quantity", "quantity": 2}
},
{
"invoice_line_item_id": "invli_01KF3Q8V2M6N4P7R9S1T3W5X81",
"correction": {"type": "amount", "amount_money": {"amount": 4000, "currency": "USD"}}
}
]
}'
Flint prices each line from the invoice as it was frozen at issue, never from today's catalog. Crediting two of six chairs takes a third of the line's subtotal, discount, and tax:
{
"invoice_line_item_id": "invli_01KF3Q8V2M6N4P7R9S1T3W5X80",
"name": "Oak side chair",
"correction": {"type": "quantity", "quantity": 2},
"subtotal_money": {"amount": 30000, "currency": "USD"},
"discount_money": {"amount": 3000, "currency": "USD"},
"tax_money": {"amount": 2228, "currency": "USD"},
"total_money": {"amount": 29228, "currency": "USD"}
}
Issued credit notes and returns draw on the same remaining value for each invoice line, so together they can never credit more than the line billed. A request that would return 409 LIMIT_EXCEEDED with what is left.
Issue it and apply the credit
Issuing numbers the note (CN-1001 and up, with your own prefix if you set one), freezes it, copies the tax identities from the invoice, and renders the PDF. On an unpaid invoice, add allocation to take the credit off the balance in the same call. If the allocation is refused, the note stays a draft:
curl -X POST https://api.withflintpay.com/v1/credit-notes/cn_01KF4B2C6D8E0F2G4H6J8K0M2N/issue \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Idempotency-Key: issue-cn-inv-1042-1" \
-H "Content-Type: application/json" \
-d '{"expected_version": 1, "allocation": {}}'
On a paid invoice, issue and refund in one call instead:
curl -X POST https://api.withflintpay.com/v1/credit-notes/cn_01KF5D3E5F7G9H1J3K5M7N9P1Q/issue \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Idempotency-Key: issue-cn-inv-1043-1" \
-H "Content-Type: application/json" \
-d '{
"refund": {
"reason": "other",
"reason_message": "Shelf billed at the wrong rate"
}
}'
The refund goes back to the payments collected through Flint on that invoice, gift cards first, then cards and bank payments. If you already paid the customer back by check or wire, record that refund against the note instead, and Flint moves no money.
The document, the email, and the events
curl https://api.withflintpay.com/v1/credit-notes/cn_01KF4B2C6D8E0F2G4H6J8K0M2N/pdf \
-H "Authorization: Bearer YOUR_API_KEY" \
-o CN-1001.pdf
The PDF carries your branding, the credited lines, the tax identities, and the invoice number. When the invoice was emailed, Flint emails the credit note to the same recipients with the PDF attached and, when the credit was applied, the new balance. Buyers see issued notes on their invoices through GET /v1/me/credit-notes. Your systems follow credit_note.issued, credit_note_allocation.created, and the refund's events, and GET /v1/credit-notes filters by invoice, customer, reason, and status.
Every note tracks where its value sits: allocated_money, pending_refund_money, refunded_money, and available_money always add up to total_money. An issued note with no active allocation or refund can be voided, and its value returns to the invoice lines. The credit notes guide covers reversals, rounding, and every error.
Who Flint is built for
US businesses invoicing customers in USD, such as wholesalers, agencies, and service companies, that want invoices, credit notes, returns, and refunds on the same orders as the rest of their sales. See Flint invoices. Invoices are an add-on at 0.40% of the payments collected through them, with no monthly fee.
Stripe and Flint credit notes
Stripe Invoicing has credit notes too, for open and paid invoices. Here is where the two differ:
| Stripe Invoicing credit notes | Flint credit notes |
|---|
| On a paid invoice | Refund through Stripe, credit the customer balance, or record a refund outside Stripe | Refund to the original payments in the issue call, or record a refund you paid yourself |
| Crediting a line | By quantity or by amount; once a line is credited one way, later notes must use the same way | By quantity or by amount, in any order, from the line's remaining value |
| Voiding | Only while the invoice is open | Any issued note with no active allocation or refund |
Questions, answered
What is a credit note?
A credit note is a document a seller issues to reduce what a customer owes on an invoice it already sent, because goods came back, the invoice billed the wrong amount, or the seller is giving a credit. It names the original invoice, the lines and amounts credited, and the tax credited, and either lowers the unpaid balance or backs a refund.
Is a credit note the same as a credit memo?
Yes. Credit memo is the more common name in US accounting software such as QuickBooks; credit note is the more common name in the UK and in VAT rules. Both are a seller's document that reduces an invoice. A debit note, or debit memo, does the opposite and raises what the customer owes.
What is the difference between a credit note and a refund?
A credit note is a document; a refund is money moving. A credit note on an unpaid invoice lowers the balance and no money moves. On a paid invoice, the credit note records why money is owed back, and the refund returns it to the customer's card or bank account.
When should I issue a credit note?
Issue one after an invoice is sent when the customer returns goods, the invoice billed the wrong item, quantity, or price, an order changed after invoicing, or you agree to a courtesy credit. If the invoice is still a draft, edit it instead.
What must a credit note include?
Its own number and date, your business details, the customer's details, the number and date of the invoice it corrects, a description of what is credited with quantities and amounts, the tax credited, and the total. Under UK VAT rules, HMRC's VAT Notice 700 paragraph 18.2.3 lists these fields for a valid VAT credit note.
Can you void a credit note?
On Flint, yes: void an issued credit note once its allocations are reversed and it has no pending or succeeded refund, and its value returns to the invoice lines. On Stripe, a credit note can be voided only while its invoice is open.
Which API handles credit notes with line-item tax?
Flint's credit notes API credits invoice lines by quantity or amount, computes each line's share of tax and discount from the frozen invoice, numbers the note, renders a PDF, emails the buyer, and in the same call applies the credit to the unpaid balance or refunds it on a paid invoice.
Sources
All sources accessed November 21, 2026.
- Accounts receivable aging report: how credit notes change what a customer owes, bucket by bucket.
- The RMA process: authorizing, receiving, and refunding a return.
- How to refund a line item in Stripe: credit notes and per-unit proration on Stripe.
- Flint credit notes guide: drafts, issue, allocation, refunds, voids, and webhooks.
- Flint invoicing guide: payment terms, reminders, late fees, and offline payments.