> ## Documentation Index
> Fetch the complete documentation index at: https://docs.withorb.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Customer balance

Customer balance in Orb functions like a **"digital wallet"** that tracks accounts receivable amounts in Orb.

<Info>
  **Not to be confused with prepaid credits.** Customer balance is separate from the [prepaid credit ledger](/product-catalog/prepurchase). See [Credit systems](/product-catalog/credit-systems) for a detailed comparison of when to use each.
</Info>

* It is always maintained in the customer’s billing currency.
* It is automatically applied to the subsequent invoice upon issuance, and modifies the final amount due. 
* **<u>Customer balance does not affect revenue recognition.</u>** Revenue in Orb continues to be recognized based on invoice line items, based on actual accrual + delivery of performance obligations.
* **Customer balance does not create deferred revenue**. It is strictly an accounts receivable (AR) adjustment in Orb, and is not associated with any standalone billing event or payment.
* However, it **does** impact [accounts receivable (AR)](https://docs.withorb.com/financial-operations/ar-aging), collections, and cash/payment reporting, since it represents real outstanding value owed between you and your customer.

<img src="https://mintcdn.com/orb-9bba378a/BzuD7C4ApMgh9IV1/images/customerbalance.png?fit=max&auto=format&n=BzuD7C4ApMgh9IV1&q=85&s=c6e0f6e37fde82dfce04e94e696a5ba7" alt="Customerbalance Pn" width="2932" height="1596" data-path="images/customerbalance.png" />

### How customer balance is modified

1. **Manual adjustment**
   1. You can directly increase or decrease a customer’s balance. 
   2. Manual increases can result from a “good will” account credit, or concessions to a customer for unsatisfactory service. 
   3. Manual decreases are typically used for corrections / reconciliation.
2. [**<u>Orb facilitated refunds</u>**](https://docs.withorb.com/invoicing/credit-notes#issuing-a-refund-credit-note)
   1. When a credit note is applied to a <u>paid invoice</u>, or that <u>paid invoice</u> is voided, Orb  increases the customer balance to represent the refunded value. 
3. [**<u>Small Balance Carryovers</u>**](https://docs.withorb.com/invoicing/payments#automatic-balance-carryover-for-small-invoices)
   1. Payment providers like Adyen and Stripe require a minimum charge amount of \$0.50 (or current equivalent).
   2. If an invoice is issued with an amount below this threshold, it is automatically marked as paid and the small amount is carried over to the customer balance. This amount is then applied to the subsequent invoice, and increases the final amount due. 

<Tip>
  **Recommended refund workflow for payment provider-initiated refunds**

  * To actually return money back to a customer, you should **initiate a refund directly in your payment provider** (such as Adyen or Stripe). 
  * To keep accounts receivable (AR), cash, and billings reporting aligned, it’s ******<u>best practice to create a </u>******[******<u>refund credit note</u>******](https://docs.withorb.com/invoicing/credit-notes#issuing-a-refund-credit-note)******<u> in Orb and then manually decrease the customer balance in Orb</u>****** to reflect that the cash refund already occurred outside Orb.
</Tip>

### Accounting impact (T-accounts)

This is how customer balance impacts the ledger for the following example:

1. Invoice A (\$100) issued.
2. Invoice A (\$100) is paid.
3. Credit note A (\$20) is issued.
4. Invoice B (\$50) issued.
5. Invoice B (\$50) paid.

<img src="https://mintcdn.com/orb-9bba378a/Uk0wi4tTHZH7R1Q1/images/cbttaccounts.png?fit=max&auto=format&n=Uk0wi4tTHZH7R1Q1&q=85&s=c0362fbb66d5d3a77b720a94ac14f71e" alt="Cbttaccounts" width="663" height="950" data-path="images/cbttaccounts.png" />
