Customer credit balance

Learn how to work with customer credit balances.

Customer balance types

This page is about customer credit balances, which are adjustments you can issue to customers that apply to future invoices. Credit balances are different from cash balances. Cash balances are connected to the customer balance payment method. To learn more, see Bank transfer. As explained below, some features work differently for customers with a cash balance.

Every customer has a credit balance. You can use this to issue a:

Credit adjustment—You owe the customer money.
Debit adjustment—The customer owes you money.

These adjustments sum up to a credit balance that you can apply to future invoices. Because Stripe computes the credit balance from a ledger—an immutable list of debit and credit transactions—it provides an audit trail of transactions for the customer. The Customer Balance Transactions can refer to the object related to the adjustment, such as a credit note, invoice, or metadata.

Some common use cases for customer credit balances include:

Issuing a credit note to create a credit that reduces the amount due on the next invoice.
Marking an invoice as paid and moving the amount owed to the credit balance as a debit. This happens when the amount due on an invoice is less than the minimum chargeable amount. This functionality only occurs for users without a cash balance.

Credit balances

Keep the following in mind when you work with credit balances:

The credit balance automatically applies to the next finalized invoice to a customer.
You can’t choose a specific invoice to apply the credit balance to.
The credit balance is in the customer’s currency.
Customers with a cash balance can’t keep a positive balance. In other words, they can’t increase the amount due on the next invoice.

Credits and debits

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) that you can apply to the next invoice.

Transactions

All modifications to the credit balance are recorded as Transactions. After you create a transaction, you can only update its description or metadata (you can’t edit other properties or delete it).

Transaction types

All Transactions that you create with the API or in the Dashboard have a type value of adjustment. A type value of adjustment represents a debit or credit that you manually created for the customer. The following table describes each of the type values:

Type	Description
`adjustment`	An explicitly created adjustment transaction to debit or credit the credit balance. This is the only type of transaction that you can create by using API integrations and the Dashboard.
`applied_to_invoice`	Traces the application of credit against a linked invoice.
`credit_note`	Traces the creation of credit to a credit note and its associated invoice.
`invoice_too_small`	When the amount due on an invoice is less than Stripe’s minimum chargeable amount and the customer does not have a cash balance, the invoice is debited from the credit balance and added to the amount due on the next invoice.
`invoice_too_large`	When the amount due on an invoice is greater than Stripe’s maximum chargeable amount and the customer does not have a cash balance, the invoice is debited from the credit balance and added to the amount due on the next invoice.
`unapplied_from_invoice`	Traces the reversal of an applied credit balance from a linked invoice. Paired with an earlier ‘applied_to_invoice’ transaction.
`unspent_receiver_credit`	When unspent funds in receiver Sources attached to a customer without cash balance aren’t fully charged after 60 days, Stripe automatically charges them on your behalf and credits your balance. When this happens, Stripe also creates a corresponding credit transaction.
`initial`	Represents the starting value of the credit balance when a customer is created by using the API with a non-zero credit balance.

Undo a transaction

You can only undo a transaction by creating a corresponding, reversing transaction. For example, if you credit the customer 10 USD, you’d have to debit them 10 USD in a new transaction, each canceling the other one out.

Modify the credit balance

You can modify a customer’s credit balance through both the Dashboard and API.

You can modify a customer’s credit balance through the Customers page on the Dashboard by creating a new Customer Balance Transaction adjustment.

In the Customers page, click on the customer and then click Adjust balance under Credit balance. From here, set the Adjustment type, a Currency (only available if the customer doesn’t have a currency set), an Amount, and an internal note.

The internal note is only visible to Dashboard users.

Balance transaction history

Audit a customer’s balance adjustments in the Customers page by scrolling down to the Credit balance section. This section displays the current value of the customer credit balance.