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 trial14-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

“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.”
“Works well and is really helpful for massive transactions. The support is really fast and helpful. 100% recommended.”
Related reading
- Stripe customer cash balance
- Stripe credit note
- QuickBooks credit memo
- QuickBooks Customer Balance Detail report
- Stripe customer balance and credits in QuickBooks
- Stripe invoice reminders and overdue invoices in QuickBooks
More glossary terms
- Undeposited Funds
- Stripe Balance Transaction
- Available vs Pending Balance
- Stripe Dispute
- Stripe Dispute Evidence
- Stripe Fee
- Stripe Balance Adjustment
- QuickBooks Credit Memo
- Stripe Tax
- QuickBooks Tax Code
- Stripe Reserve
- Stripe Tax Rate
- Stripe Fee Credit
- Stripe Credit Note
- QuickBooks Product/Service Item
- Stripe Payout
- QuickBooks Sales Receipt
- QuickBooks Bank Deposit
- QuickBooks Transfer
- Stripe Authorization Hold
- QuickBooks Refund Receipt
- QuickBooks Payment
- QuickBooks Expense
- QuickBooks Journal Entry
- Stripe Financial Account
- Holding Account
- Accounts Receivable
- Bank Feed
- Deferred Revenue
- Stripe PaymentIntent
- Stripe Checkout Session
- Stripe SetupIntent
- Stripe PaymentMethod
- Stripe Charge
- Stripe Refund
- QuickBooks Invoice
- QuickBooks Class Tracking
- QuickBooks Location Tracking
- QuickBooks Project
- QuickBooks Closing Date
- Stripe Invoice Line Item
- Stripe Proration
- Stripe Invoice Status
- Stripe Shipping Rate
- Stripe Transfer
- Stripe Mandate
- Stripe on_behalf_of
- Stripe Invoice Item
- QuickBooks Estimate
- Stripe Invoice Payment
- Stripe Invoice Payment Settings
- Stripe Billing Meter
- Stripe Invoice Template
- Stripe Price
- Stripe Subscription Schedule
- Stripe Subscription Item
- QuickBooks Recurring Transaction
- QuickBooks Sub-Customer
- QuickBooks Audit Log
- QuickBooks Bank Rule
- Stripe Subscription Status
- Stripe Mixed Interval Subscription
- Stripe Trial Settings
- QuickBooks Payment Terms
- Stripe Pending Update
- QuickBooks Tags
- QuickBooks Credit Card Credit
- QuickBooks Vendor Credit
- QuickBooks Bill
- QuickBooks Delayed Charge
- Stripe Billing Mode
- QuickBooks Billable Expense
- Stripe Customer Cash Balance
- QuickBooks Purchase Order
- QuickBooks Opening Balance
- QuickBooks Account Type
- QuickBooks Sales Tax Center
- Stripe Webhook
- Stripe Metadata
- Stripe Outbound Payment
- Stripe Received Credit
- Stripe Outbound Transfer
- Stripe Inbound Transfer
- Stripe Received Debit
- Stripe Payout Method
- Stripe Financial Account Transaction
- Stripe Financial Address
- Stripe Application Fee
- Stripe Connected Account
- Stripe Destination Charge
- Stripe Separate Charges and Transfers
- Stripe Direct Charge
- Stripe Payment Method Configuration
- Stripe Dynamic Payment Methods
- Stripe Payment Method Rules
- QuickBooks Bundle
- Stripe Account Capability
- Stripe Merchant of Record
- Stripe Data Pipeline
- Settlement Currency
- Hosted Invoice Page
- Stripe Customer
- Stripe Product
- QuickBooks Home Currency
- QuickBooks Exchange Gain or Loss
- QuickBooks Trial Balance
- QuickBooks General Ledger Report
- QuickBooks Retained Earnings
- QuickBooks Profit and Loss Report
- QuickBooks Balance Sheet Report
- QuickBooks Account Register
- QuickBooks Reclassify Transactions
- QuickBooks A/R Aging Report
- QuickBooks Sales Tax Liability Report
- QuickBooks Sales Tax Payable
- Stripe Tax Transaction
- Stripe Tax Location Report
- Stripe Tax Summarized Export
- Stripe Tax Itemized Export
- Stripe Product Tax Code
- QuickBooks Vendor
- Economic Nexus
- Reverse Charge
- Stripe Statement Descriptor
- Stripe Taxability Reason
- Stripe Tax Filing Currency
- Stripe Tax Cross-Border Goods Option
- Stripe Tax Threshold Monitoring
- QuickBooks Uncategorized Income
- QuickBooks Sales by Product/Service Report
- QuickBooks Sales by Customer Report
- QuickBooks Group Tax Rate
- Form 1099-NEC
- SEPA Direct Debit
- Bacs Direct Debit
- Canadian Pre-Authorized Debit (PAD)
- Australia BECS Direct Debit
- Stripe PayTo
- Stripe Test Clock
- QuickBooks Customer Display Name
- Backup Withholding
- QuickBooks Multicurrency
- Form 1042-S
- Form W-8BEN
- Form W-9
- Form 8233
- Form 1042
- Form 1099-K
- Form W-8BEN-E
- Stripe Tax Behavior
- Stripe Customer Tax ID
- Form 945
- ITIN (Individual Taxpayer Identification Number)
- Form 1099-MISC
- Stripe Customer Tax Exempt Status
- EFTPS (Electronic Federal Tax Payment System)
- Tax Representative (Fiscal Representative)
- Nil Return
- Sales Tax Exemption Certificate
- EU One Stop Shop (OSS)
- Place of Supply
- Simplified Tax Invoice
- Input VAT (Input Tax)
- Streamlined Sales Tax (SST)
- Fixed Establishment (VAT)
- VIES VAT Number Validation
- E-Invoicing Mandate
- Tax Point (Time of Supply)
- Sales Tax Holiday
- Digital Services Tax
- VAT Invoice (Full Tax Invoice)
- Output VAT (Output Tax)
- VAT Bad Debt Relief
- Sales Tax Sourcing
- Gross Receipts Tax
- VAT Cash Accounting Scheme
- Reduced VAT Rate
- VAT Flat Rate Scheme (UK)
- VAT Annual Accounting Scheme (UK)
- EU VAT SME Scheme
- Making Tax Digital for VAT
- VAT Payments on Account (UK)
- Stripe Tax Registration
- Non-Established Taxable Person (NETP)
- VAT Group Registration (UK)
- Zero-Rated vs Exempt Supply
- Electronically Supplied Services (ESS)
- Zero-Decimal Currency
- UK VAT Registration Threshold
- QuickBooks Deposit Detail Report
- Payment Settlement Entity (PSE)
- QuickBooks Reconcile
- QuickBooks Bad Debt Write-Off
- Stripe Radar
- Stripe Smart Retries
- Stripe Decline Code
- QuickBooks Voided Transaction
- Stripe Minimum Charge Amount
- Stripe 3D Secure
- Stripe Preview Invoice
- Stripe Quantity Transformation (transform_quantity)
- Stripe Customer-Chosen Price (custom_unit_amount)
- Stripe Adjustable Quantity (adjustable_quantity)
- Stripe Inline Price (price_data)
- Stripe Default Payment Method
- Stripe Multi-Currency Price
- QuickBooks Automatic Application
- QuickBooks Open Invoices Report
- QuickBooks Customer Balance Detail Report
- Stripe Customer Tax Location Status
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