Glossary

Stripe Customer Credit Balance

A Stripe customer credit balance, also called the customer invoice balance, is a per-customer ledger of credit and debit adjustments that Stripe applies to the customer’s next finalized invoice: credits are negative and reduce what the customer owes, debits are positive and increase it.

Also called: Customer invoice balance, Stripe invoice balance, customer balance transactions

14-day free trial · card required · cancel anytime

Definition

Every Stripe customer has one. Stripe describes it as an invoice-adjustment ledger: “Customer credit balance and customer invoice balance are names for the same invoice-adjustment ledger.”

The balance is a running total of transactions. Some you create yourself, such as a goodwill credit after an outage. Most are created by Stripe as a side effect of something else: a credit note that credits the balance, a downgrade proration, or an invoice too small to charge. Stripe keeps every one of them, and you can’t edit or delete them. Stripe computes the balance from that ledger of debit and credit transactions, which is what makes it auditable: every change has a record.

The part that surprises people is how it gets used. You don’t spend a credit balance on an invoice you choose. By default it applies itself to the next invoice Stripe finalizes for that customer, in the same currency, whether that invoice is the one you had in mind or not.

It is not money. It holds no funds and pays nothing out. A credit balance is a promise to reduce a future invoice, and a debit balance is an amount Stripe will add to one.

Key points

  • +Customer credit balance and customer invoice balance are two names for the same ledger.
  • +Credits are negative values and reduce the next invoice. Debits are positive values and increase it.
  • +By default the balance applies to the next invoice finalized for the customer, in the matching currency.
  • +A credit applies up to the invoice total. A debit applies in full.
  • +Every change is a customer balance transaction with a type, such as adjustment, applied_to_invoice, credit_note or invoice_too_small.
  • +Transactions are immutable. You reverse one by creating an opposite adjustment.
  • +It is separate from the cash balance (bank transfer funds) and from billing credit grants (usage credit).

Credits, debits and the sign that trips people up

Stripe stores the balance as a signed number, and the sign is the reverse of what a bookkeeper expects from a customer account.

Stripe’s rule: “Credits are negative values (a reduction in the amount the customer owes) that you can apply to the next invoice. Debits, on the other hand, are positive values (an increase in the amount the customer owes).” So a customer showing minus $50 is a customer you owe $50 of credit, and a customer showing plus $12 is a customer who will be billed $12 extra on their next invoice.

The two apply differently. Stripe’s invoice balance guide says “A credit invoice balance is applied up to the invoice total amount,” while “A debit invoice balance applies the full balance to the invoice.” A $500 credit against a $200 invoice reduces it to zero and leaves minus $300 on the balance for the invoice after. A $12 debit is added to the next invoice in full.

The balance is in the customer’s currency, and Stripe says the invoice balance and the invoice currencies must match. A customer invoiced in two currencies doesn’t get one pooled credit.

The transaction types

Every change to the balance is a customer balance transaction, and its type says where it came from. Stripe lists these.

adjustment is a credit or debit someone created on purpose, in the Dashboard or through the API. It is the only type you create with an ordinary integration. In the Dashboard, open the customer and choose Adjust balance under Credit balance.

applied_to_invoice records credit being used on an invoice. Stripe describes it as tracing “the application of credit against a linked invoice.” This is the row you see each time the balance reduces an invoice.

unapplied_from_invoice is the reversal of that: it traces an applied credit being taken back off an invoice, and Stripe pairs it with the earlier applied_to_invoice transaction it reverses.

credit_note records credit created by a credit note on an invoice, the usual source of a credit balance on a paid invoice.

invoice_too_small and invoice_too_large handle invoices Stripe can’t charge. When the amount due is below Stripe’s minimum chargeable amount (or above its maximum) and the customer has no cash balance, “the invoice is debited from the credit balance and added to the amount due on the next invoice.”

initial is the starting value when a customer is created through the API with a non-zero balance, and unspent_receiver_credit covers a legacy Sources case.

After a transaction is created, Stripe lets you change only its description and metadata. To undo one, Stripe’s instruction is to create the opposite: “if you credit the customer 10 USD, you’d have to debit them 10 USD in a new transaction.”

When and where the balance applies

Stripe’s customer balance guide states the default plainly: “The credit balance automatically applies to the next finalized invoice to a customer,” and “You can’t choose a specific invoice to apply the credit balance to.”

Two refinements are worth knowing. First, Stripe’s comparison of credit types says the balance applies “after taxes and billing credits.” Tax is calculated on the full invoice and the credit then reduces the amount due, so applying a credit balance doesn’t lower the tax on the invoice. Second, Stripe now documents a public preview API, available with API version 2026-11-18.preview, that lets you “manually apply a customer’s existing invoice credit balance to a specific open invoice instead of waiting for Stripe to apply it automatically to a new invoice.” Unless you use it, the default rule holds.

The balance also skips some invoices. Stripe says it “doesn’t apply to invoices created by Checkout Sessions with invoice_creation enabled.” And if you edit an open invoice, Stripe applies any invoice balance to the revised invoice.

On each invoice, two fields show the ledger at work. starting_balance is the customer balance before the invoice was finalized, and ending_balance is the balance after. The difference is what this invoice consumed or added.

Not the cash balance, not billing credits, not a credit note

Stripe runs several customer-level balances, and they behave differently enough that mixing them up causes real errors.

The cash balance holds money a customer actually sent by bank transfer, waiting to be matched to invoices. Stripe says it is tracked by cash balance transactions and that an invoice balance adjustment doesn’t fund it. You can’t create a negative cash balance, because it represents money received. A customer with a cash balance also can’t carry a positive (debit) credit balance: Stripe says such customers “must maintain a zero or negative balance.” Our cash balance entry covers it in full.

Billing credits are prepaid or promotional usage credit, issued as credit grants and spent on metered prices. Stripe says they apply “after discounts and before taxes and the invoice balance,” can expire, and are recorded in their own credit balance transactions.

A credit note is a correction to one finalized invoice. On an open invoice it reduces what is owed. On a paid invoice you choose where the credit goes, and one option is the customer’s credit balance, which is how many credit balances start.

A rule of thumb: if the credit is real money the customer sent, it is the cash balance. If it is usage they prepaid for, it is billing credits. If it is a reduction you promised against future bills, it is the credit balance.

Reversing an applied credit

Taking credit back off an invoice is harder than putting it on.

An opposite adjustment restores the balance’s total, but Stripe is clear that it “doesn’t unapply credit from an invoice.” The invoice keeps the reduction it received. Stripe’s preview documentation adds that there is no standalone API to unapply credit from an invoice.

The route Stripe does document is voiding. “Voiding an eligible open invoice restores its applied credit to the customer’s balance,” so the credit goes back on the ledger, ready for the next finalized invoice. A paid invoice can’t be voided, so a credit already used on a paid invoice stays used.

In practice, check a customer’s balance before you finalize an invoice you want billed at its full amount. Once finalized, the credit is on it.

How the credit balance shows up in QuickBooks with Acodei

QuickBooks has no matching ledger. What reaches QuickBooks through Acodei’s Invoice Sync is the balance’s effect on each invoice.

Acodei’s documentation covers the applied balance directly. By default, when Stripe applies a customer balance to an invoice, Acodei includes that applied amount (Stripe’s starting_balance) as a line item on the QuickBooks invoice, so the QuickBooks invoice reflects the exact amount Stripe charged. An admin setting, Skip Applied Balance as line item on Invoice, does the opposite: Acodei ignores the applied balance and creates the invoice at the full gross amount, subtotal plus tax, so QuickBooks receivables carry the full value of the sale.

When an invoice is paid by a credit balance offset, Acodei’s documentation says it creates a QuickBooks payment receipt or credit memo and applies it to the invoice it created. A Stripe credit note becomes a QuickBooks credit memo, linked to the invoice when possible and otherwise posted to the customer.

The ledger itself stays in Stripe. Acodei’s documentation describes the balance reaching QuickBooks through invoices, payments and credit memos. It doesn’t describe a QuickBooks record for a standalone adjustment that hasn’t touched an invoice yet, and it lists two-way credit balance sync as something Acodei isn’t pursuing. It also doesn’t settle every case where credit covers an invoice in full, so check those invoices in QuickBooks against Stripe.

For the rest of the invoice lifecycle, see how an applied Stripe credit balance lands on the QuickBooks invoice.

Want to see this on your own Stripe data?

Start a free trial

14-day free trial · card required · cancel anytime

Frequently asked questions

What is the difference between a customer credit balance and a customer invoice balance in Stripe?

There isn’t one. Stripe says customer credit balance and customer invoice balance are names for the same invoice-adjustment ledger. It is separate from the cash balance, which holds bank transfer funds, and from billing credit grants.

Is a negative Stripe customer balance good or bad?

Negative is credit. Stripe treats negative values as a reduction in what the customer owes, so a customer at minus $50 has $50 of credit for their next invoice. A positive balance is a debit that Stripe adds to the next invoice.

Can I apply a Stripe credit balance to a specific invoice?

Not by default. Stripe applies the credit balance to the next invoice it finalizes for the customer, and its guide says you can’t choose a specific invoice. A public preview API, on version 2026-11-18.preview, can apply existing credit to a specific open invoice.

How do I remove credit from a Stripe customer balance?

Create an opposite adjustment. Transactions can’t be edited or deleted, so to reverse a 10 USD credit you debit 10 USD. That doesn’t unapply credit already used on an invoice. Voiding an eligible open invoice restores its applied credit to the balance.

Why was a small Stripe invoice marked paid without a charge?

If the amount due is below Stripe’s minimum chargeable amount and the customer has no cash balance, Stripe marks the invoice paid and records an invoice_too_small debit on the credit balance. The amount is added to the customer’s next invoice.

What customers say about running Stripe through Acodei

Stripe Verified Partner BadgeIntuit QuickBooks
★★★★★
“If you're testing out all the different Stripe/QuickBooks integration apps right now, let me save you some time. This one is the best one by far.”
RyanOwner at Indie Music Academy
★★★★★
“Works well and is really helpful for massive transactions. The support is really fast and helpful. 100% recommended.”
AndresCo-founder and CEO at Kanguro Collections and Reinsurance

Related reading

More glossary terms

See the full glossary

Ready to try Acodei?

Connect Stripe to QuickBooks Online in minutes and let the fees, refunds, and payouts land where your accountant expects them.

14-day free trial · card required · cancel anytime