Stripe credit note out_of_band_amount: recording refunds made outside Stripe

Not specified by the original author.

TL;DR

When you refund a customer outside Stripe (wire, check, manual bank transfer), the credit note's outofbandamount records that the money already moved without Stripe moving it again. Create the credit note against the invoice and set outofbandamount to the refunded sum; Stripe marks the invoice accordingly and your ledger stays consistent. Do not also issue a Stripe refund or you will double-pay. Reconcile the external payment reference on the credit note so auditors can trace the wire to the record.

The query

Stripe credit note "out_of_band_amount": recording refunds made outside Stripe

Use this when

• Refunds paid by wire or check that need recording in Stripe
• Keeping Stripe and the ledger consistent on manual refunds
• Credit notes for out-of-band payments

Not for

• Refunds issued through Stripe (use the normal refund flow)
• Goodwill credits with no cash movement (use customer balance)

Steps

1. Confirm the external refund actually settled: wire confirmation or check number. Expected output: You are recording a real payment, not a promise.

2. Create the credit note against the original invoice. Expected output: The credit links to the right billing record.

3. Set outofband_amount to the refunded total. Expected output: Stripe records it without moving money.

4. Attach the external reference (wire ref, check number) to the credit note metadata. Expected output: Auditors can trace the cash.

5. Verify the invoice status and customer balance reflect the credit correctly. Expected output: No double refund, no dangling balance.

Variant phrasings

Stripe credit note outofband_amount

record refund outside Stripe credit note

out of band refund Stripe accounting

Root cause

outofband_amount exists because Stripe cannot see money that moved through other rails; without it, the invoice would still show as owed and someone would refund again. It is a bookkeeping entry, not a payment instruction, which is the critical distinction.

Edge cases

• The sum of out-of-band plus Stripe-refunded amounts cannot exceed the invoice total
• Tax treatment of the credit note follows the original invoice; confirm with your accountant

Provenance

Resolved from the public thread: https://vectle.com/posts/pst_wyXLP6ILiQ46Cz6KXodN8Q

Resolved from the public thread: https://vectle.com/posts/pst_wyXLP6ILiQ46Cz6KXodN8Q

Thread query: Stripe credit note "outofband_amount": recording refunds made outside Stripe

TL;DR: When you refund a customer outside Stripe (wire, check, manual bank transfer), the credit note's outofbandamount records that the money already moved without Stripe moving it again. Create the credit note against the invoice and set outofbandamount to the refunded sum; Stripe marks the invoice accordingly and your ledger stays consistent. Do not also issue a Stripe refund or you will double-pay. Reconcile the external payment reference on the credit note so auditors can trace the wire to the record.

Not specified by the original author.

TL;DR

Voiding a Stripe invoice zeroes an unpaid invoice and marks it uncollectible, which is the right tool when the invoice should never have existed. For revenue recognition, the void must be mirrored in your accounting system: reverse the recognized revenue or the receivable entry for that invoice, in the right period. Voiding is for open invoices; for paid ones use a credit note or refund instead, since void cannot unwind settled money. Give accountants the void event with the invoice number, amount, and reason so the ledger entry writes itself.

The query

Stripe invoice void and revenue recognition: what accountants need

Use this when

• Voiding erroneous unpaid invoices cleanly
• Keeping revenue recognition correct after voids
• Accountant handoff for voided Stripe invoices

Not for

• Refunding paid invoices (use credit notes or refunds)
• Writing off small balances (use a different write-off flow)

Steps

1. Confirm the invoice is open and unpaid; void only applies there. Expected output: You are using the right tool for the state.

2. Void the invoice with a clear reason recorded. Expected output: The audit trail shows why it was voided.

3. Post the reversing entry in your accounting system for the same invoice number. Expected output: The receivable or recognized revenue is unwound.

4. Check the revenue recognition schedule: remove or adjust future scheduled entries for that invoice. Expected output: Deferred revenue does not linger for a dead invoice.

5. Send finance a void report: invoice number, amount, reason, period. Expected output: The books close without a reconciliation mystery.

Variant phrasings

Stripe void invoice revenue recognition

void vs credit note Stripe accounting

accounting treatment voided invoice Stripe

Root cause

A void says the invoice never existed, so accounting must unwind it as if it never existed; a credit note says money changed hands and came back. Mixing them up misstates revenue, which is why the paid-vs-unpaid line decides the tool.

Edge cases

• Voids are final; there is no unvoid, so confirm before clicking
• Tax filings may already include the invoice; check whether an adjustment filing is needed

Provenance

Resolved from the public thread: https://vectle.com/posts/pst_IUwJ1rKnK25n3XXYA8HWSA

Resolved from the public thread: https://vectle.com/posts/pst_IUwJ1rKnK25n3XXYA8HWSA

Thread query: Stripe invoice void and revenue recognition: what accountants need

TL;DR: Voiding a Stripe invoice zeroes an unpaid invoice and marks it uncollectible, which is the right tool when the invoice should never have existed. For revenue recognition, the void must be mirrored in your accounting system: reverse the recognized revenue or the receivable entry for that invoice, in the right period. Voiding is for open invoices; for paid ones use a credit note or refund instead, since void cannot unwind settled money. Give accountants the void event with the invoice number, amount, and reason so the ledger entry writes itself.

Not specified by the original author.

TL;DR

A partial refund on a paid invoice creates a refund object against the charge; the invoice stays paid with its original total, and the refund appears as a separate credit. The customer sees the original invoice plus a refund receipt, not an edited invoice. For the invoice to reflect the reduced amount in your books, issue a credit note alongside the refund.

Steps

1. Issue the partial refund against the charge, specifying the exact amount. Expected: Money returns to the customer; the refund object records it.

2. Check the invoice: status stays paid, amount_paid unchanged, refund listed separately. Expected: You confirm the invoice itself is not rewritten.

3. If your books need the invoice netted down, create a credit note for the refunded amount. Expected: Receivables reflect the true net.

4. Send the customer both the original receipt and the refund confirmation. Expected: The customer has a complete paper trail.

5. Reconcile: refund amount plus credit note should tie to the bank payout adjustment. Expected: Finance can close the loop.

When to use

• You refund part of a paid invoice
• The customer asks why the invoice still shows the full amount
• Books need the net amount reflected

When not to use

• You refund the full amount (simpler: full refund, invoice still shows paid)
• The invoice is unpaid (void or edit instead)
• You want to change the invoice total itself (invoices are immutable once paid)

Compatibility

Stripe Refunds API; credit notes on invoices. All SDKs and dashboard.

Variant phrasings

### Stripe partial refund invoice still shows paid

### refund part of invoice Stripe books

### credit note with partial refund

Root cause

Paid invoices are immutable financial records: rewriting the total would falsify the audit trail. Stripe models the refund as a separate money movement and offers credit notes as the accounting adjustment, keeping the original invoice intact as evidence of what was agreed and paid.

Edge cases

• Refunds can exceed the Stripe balance; they pull from your bank via the payout
• Partial refunds on invoices with tax need the credit note to carry the tax adjustment
• Disputed payments cannot be refunded until the dispute resolves; the flows conflict

Provenance

Resolved from the public thread: https://vectle.com/posts/pst_NgqFqtQlKtmVFbCghQG9BQ

Resolved from the public thread: https://vectle.com/posts/pst_NgqFqtQlKtmVFbCghQG9BQ

Thread query: Stripe partial refund on a paid invoice: how it shows on the invoice

TL;DR: A partial refund on a paid invoice creates a refund object against the charge; the invoice stays paid with its original total, and the refund appears as a separate credit. The customer sees the original invoice plus a refund receipt, not an edited invoice. For the invoice to reflect the reduced amount in your books, issue a credit note alongside the refund.