> For the complete documentation index, see [llms.txt](https://learn.withessential.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.withessential.com/revenue/invoices/manage-customer-and-invoice-credits.md).

# Manage customer and invoice credits

A credit lowers what the customer owes. Keep it separate from a payment: money received by cash, check, or another system belongs in **Record payment**. Adding a credit does not record money received or issue a refund.

> **Where to find it:** Customer or property page → **Billing** → **Available credit** (**+ Add credit** or **View credits**), or open an invoice → **Additional options → Credits and deposits → + Add credits**. When credit is available, that invoice section also shows the available amount and **Apply all**. A saved invoice also offers **Add Credits** at the bottom of the editing section in its ⋮ actions menu. Hover **Credits and deposits** for a short description of what it covers. If a saved invoice has unsaved edits, these actions are unavailable until you save them.

You need invoice editing permission to change credits. Customer credits work without Stripe; collecting a new quote deposit online still requires connected payments.

## Credits, discounts, and payments

* A **customer credit** or a paid **quote deposit** lowers the balance due. The invoice's item prices and tax do not change.
* To lower the price itself, edit the draft's prices or add a [discount](https://learn.withessential.com/revenue/invoices/apply-a-discount-to-an-invoice.md). For an unpaid invoice that was already sent, choose **Revert to Draft** from the ⋮ menu first (see [Why can't I edit an invoice?](https://learn.withessential.com/revenue/invoices/why-cant-i-edit-an-invoice.md)).
* Money the customer paid outside Essential is a payment: use **Record payment**.

Essential no longer creates new price credits (reductions to an issued invoice's original charges and tax). Price credits recorded earlier still appear under **View credits**, can be applied to invoices, and can be reduced; their accounting is unchanged.

## See a customer's credit

The **Billing** panel on the customer or property page shows **Available credit**: the total credit not yet applied to an invoice.

Select **View credits** to open the **Credits** list. Each credit shows its source kind, how much is available, its total, and when it was added. The source kind is **Customer credit**, **Quote deposit**, or **Price credit**; hover it to learn what that kind means. A staff note, when present, appears below the kind. Available credits appear newest first. Select **Show used credits** to switch to fully used credits, and **Hide used credits** to return to available credits. Use **Next** and **Previous** to browse longer lists. **Available credit** always shows the full balance across all pages.

Each credit offers:

* **Edit** for a manually added customer credit or a price credit.
* **View quote** or **View invoice** for a deposit or a price credit, to open where it came from.
* **History**, which lists changes newest first: when the credit was issued, adjusted, applied to or released from an invoice, or adjusted after a refund, with any note. Use the history's **Next** and **Previous** controls to browse older changes.

## Add or edit a customer credit

1. Open the customer or property's **Billing** panel.
2. Next to **Available credit**, select **+ Add credit**.
3. Enter the **Amount**. A **Note** is optional and appears under the credit's source kind in the list.
4. Select **Save**.

To change a credit, select **View credits**, then **Edit** beside it. Enter the new **Total credit amount** and, if you like, a **Note** explaining the change, then select **Save**. You return to the **Credits** list. You cannot reduce a credit below the amount already applied to invoices; release those applications first. Lowering a credit records an audited adjustment and does not refund money.

A price credit's total includes the related original tax. It can only be reduced, which restores the original charges and tax proportionally. Quote deposit totals are read-only because they come from the recorded payment and refunds. If a price credit's source invoice is marked uncollectible, its **Edit** action is disabled and the reason is shown under it. Other credits on the same billing profile remain editable.

Credits stay with their billing profile and currency. A property with its own billing profile uses that profile's credits. Merging accounts preserves their credit history; a split needs an unambiguous owner for remaining credit.

An invoice with saved credit keeps that original credit account. Before enabling separate Property Billing, release or remove active credit sourced from or applied to that property. Once no active credit remains, enabling it clears only that property's inactive saved account pins; sibling properties and historical credit records stay with the customer account. Other profile changes do not silently move an invoice's applied credit.

## Apply credit to an invoice

1. On the invoice, open **Additional options** and select **+ Add credits** (or **Add Credits** in the ⋮ actions menu). Select **Apply all** as an explicit shortcut to open the same review window with the maximum available amount filled in.
2. The **Add credits** window shows **Available credit**: the customer credit and deposits this invoice can use, including any already applied to it.
3. Enter the **Credit to apply**. When nothing is applied yet, it starts at the most the invoice can take: the available credit, up to the balance after payments. When credit is already applied, it starts at that amount.
4. Optionally add a **Note**.
5. Check the **New balance**, then select **Save**. **Apply all** and changing an amount only prepare a preview; neither applies or saves credit by itself.

The amount cannot be more than the available credit or what the invoice still owes after payments; Essential explains the limit under the field.

Essential takes the amount from the oldest credits first. Lowering the amount releases the most recently applied credit first, and the released amount stays available as customer credit for another invoice.

### Choose which credits to use

Select **Show details** to see each credit with its own amount, what is available, what is already applied, and when it was added. Change any credit's amount and **Credit to apply** updates to match; changing **Credit to apply** splits it across the credits again. Select **Hide details** to return to the single amount.

When a credit's amount goes down, details also show **Released amount**:

* **Keep available** (the default) returns it to customer credit for another invoice.
* **Remove through an adjustment** removes that credit entitlement and records an audited adjustment. It does not refund money.

For example, reducing an applied $200 deposit to $150 releases $50. You decide whether that $50 stays available or is removed through an adjustment. The original $200 payment receipt is preserved in either case. Use the separate [refund process](https://learn.withessential.com/revenue/invoices/refunds-what-the-app-can-and-cant-do.md) if money should be returned to the customer.

If a price credit came from an invoice marked uncollectible, you can keep the released amount available. **Remove through an adjustment** is unavailable because it would change the original invoice's write-off accounting.

If money is later refunded from a price credit's source invoice, any of that price credit held for future use is consumed by the refund and cannot be applied again.

A deposit transferred from another quote leaves draft prices and discounts editable. The revised total must still cover all applied payments and credits. The deposit from the invoice's own approved quote continues to protect its agreed charges.

### New invoices

On a new invoice, the available amount can appear in **Credits and deposits** before you open the window. **Save** in the **Add credits** window keeps your choice with the invoice; it is applied when you save the invoice. Leaving the new invoice without saving does not apply those credits. Reopening **+ Add credits** before saving shows the amount and note you chose. Restoring an unsaved invoice asks you to review the current credit preview again.

## Reminders and later edits

When an automatic payment reminder is currently scheduled and the preview reaches zero, the window explains that it will stop when the balance reaches $0.00. Saving closes that current reminder batch. If a later credit edit leaves a balance and automatic payment reminders are already stopped, the invoice tells you to resend it to restart reminders. Explicitly resend the invoice when you want to notify the customer and restart its configured invoice follow-up process.

When noncash credit first settles an issued invoice, or an invoice is first issued fully funded by a deposit and credit, Essential runs the normal invoice-paid tasks and configured workflows once, including any customer messages configured for that workflow. Noncash credit does not create a payment, receipt, or `payment.succeeded` event; a real deposit keeps its existing receipt references. Retrying the same settlement does not repeat the paid workflow, and releasing credit later does not restart reminders. A later real payment still follows the normal payment lifecycle.

If the invoice email is delivered but the paid follow-up step fails, retrying **Send** repairs only the missing paid follow-up and does not send the customer a second email. Essential uses this repair only when it has a durable record of successful delivery. A rejected send remains failed; the invoice's paid status or send date alone is not treated as proof of delivery.

A pending payment or refund blocks credit changes until it completes or is canceled, so the amount being charged cannot change mid-payment. Credits remain editable on a settled invoice. Credits cannot be changed on an invoice marked uncollectible because its balance has already been written off. Release applied credits and remove active price credits before changing the protected original charges or deleting their source invoice.

An invoice with applied credit or a quote deposit cannot be deleted, including a saved draft. Release the applied amount back to available credit first, then delete the invoice. The credit remains available to the customer; releasing it does not refund the payment.

## QuickBooks full transaction sync

Credits and quote deposits sync to QuickBooks only with **Summary journal entries**. With **Full transactions** sync, you can't add or change credits on an invoice once it syncs as a full transaction (after it leaves Draft); **+ Add credits** shows why. A quote deposit paid after that point still applies to the invoice; its deposit invoice waits in Sync activity for your bookkeeper. An invoice that was issued with a deposit or credit already applied waits in Sync activity for your bookkeeper. See [What syncs to QuickBooks](https://learn.withessential.com/reporting-and-integrations/accounting/what-syncs-to-quickbooks.md).

Related guides:

* [Record a payment on an invoice](https://learn.withessential.com/revenue/invoices/record-a-payment-on-an-invoice.md)
* [Apply a discount to an invoice](https://learn.withessential.com/revenue/invoices/apply-a-discount-to-an-invoice.md)
* [Collect a deposit when a quote is signed](https://learn.withessential.com/revenue/quotes/collect-a-deposit-when-a-quote-is-signed.md)
* [Set customer billing](https://learn.withessential.com/customers-and-work/customers/set-a-customers-billing-profile-payment-terms-tax-exempt-autopay.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://learn.withessential.com/revenue/invoices/manage-customer-and-invoice-credits.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
