Recording and managing payments
The Payments area is where you record money your clients pay against their invoices, keep track of what has cleared, and issue refunds. Every payment is tied to a specific invoice, so recording one here keeps that invoice's balance and your account ledgers accurate and audit-ready.
This page covers the firm side: recording payments from the dashboard, marking pending payments as cleared, changing a payment's status, viewing details, refunding, and reading the payments list and trend chart. Online payments your clients make through a payment link are recorded automatically (see How clients pay invoices).
Before you begin
A few things to have in place before you record payments.
- Permission. You need Create access for payments to record a payment, and Edit access to mark payments cleared, change a status, or issue a refund. If your role does not include these, the Record payment button and the row actions will not appear. Firm owners and administrators have full access by default; attorneys can record and manage payments; staff can view, record, and edit them.
- At least one invoice. A payment is always recorded against an invoice. The invoice must be in a state that can accept money: open (unpaid), partially paid, or paid. Cancelled or draft invoices cannot accept payments.
- At least one account. You need an active operating or savings account to deposit funds into. For trust-related flows (overpayments and trust transfers) you also need an active trust (escrow) account. You can create an account on the fly from inside the payment form.
Note: A trust account (sometimes called an IOLTA or escrow account) holds money that belongs to the client, not the firm, until it is earned or owed. Esqase keeps trust funds separate from your operating funds so you stay compliant with the rules that govern client money.
Record a payment against an invoice
This is the everyday case: a client pays an invoice and you deposit the money into your operating (business) account. Only payments marked Cleared move the invoice's balance, so use this flow when the funds are in hand.
- In the sidebar, click Payments.
- In the top right, click Record payment.
- In the Record payment dialog, choose the Client, then the Matter, then the Invoice. (If you opened the dialog from a specific invoice, these are already filled in and locked.) The dialog header shows the invoice and the client, and the description shows the Outstanding balance so you know how much is still owed.
- The Amount field defaults to the invoice's outstanding balance. Adjust it if the client paid less or more.
- Set the Payment date. It defaults to today.
- Choose the Payment method: Wire, Check, Cash, Credit Card, Trust / Escrow Transfer, or Other. (Pick Trust / Escrow Transfer only for the trust-transfer flow described below.)
- Set the Status:
- Cleared (the default) records the payment as received and immediately reduces the invoice balance.
- Pending records the payment but waits to apply it to the invoice until you mark it cleared (useful for a check that has not cleared the bank yet).
- Failed records a payment that did not go through.
- Under Deposit to account, pick the operating or savings account the money lands in. To create a new account without leaving the form, click New account at the bottom of the list.
- Optionally fill in the Payer (who actually paid), a Check or reference no., and a Description with any notes.
- Click Record payment.
When you save, Esqase records the payment, deposits the amount into the chosen account, updates the invoice (to Partially paid or Paid if the payment cleared), and writes an entry to the account ledger. You will see a "Payment recorded" confirmation.
📷 Screenshot: The Record payment dialog with the Client, Matter, and Invoice pickers filled in, the Amount defaulted to the outstanding balance, and the Deposit to account field expanded to show the New account option. Highlight the Status field set to Cleared.
Suggested image: images/payments/record-payment-dialog.png
Tip: You can also start this flow straight from an invoice. On the Invoices list, open a row's actions and click Record payment, or use Record payment on the invoice's detail page. The client, matter, and invoice are pre-selected for you.
Record a payment with overpayment parked in a trust account
Sometimes a client pays more than the invoice owes (for example, a round-number retainer check). Esqase applies what the invoice needs and parks the extra in a trust account as client credit, so the surplus is held safely instead of inflating the invoice.
- Start a payment as described above, with the Payment method set to anything other than Trust / Escrow Transfer.
- In the Amount field, enter a figure larger than the invoice's outstanding balance.
- An Overpayment detected notice appears, telling you exactly how much will be applied to the invoice and how much will be deposited to trust.
- In the Trust / Escrow account for overpayment field that appears inside the notice, pick the trust account that will hold the surplus.
- Finish the rest of the form (date, method, deposit account for the applied portion, optional payer/reference/notes) and click Record payment.
On save, the invoice is paid in full from the applied portion, the deposit account receives that portion, and the overpayment is deposited into the chosen trust account. In the payments list, the Remarks column will show the amount routed "to trust."
Important: You must choose a trust account for the overpayment. If you leave it blank, the form will not let you save and will prompt you to "Pick a trust account to hold the overpayment."
📷 Screenshot: The payment form with an Amount higher than the outstanding balance, showing the amber Overpayment detected notice and the Trust / Escrow account for overpayment picker inside it.
Suggested image: images/payments/overpayment-to-trust.png
Record a trust-transfer payment (pay an invoice from trust funds)
When a client already has money sitting in trust (for example, a retainer you collected earlier), you can move some of those funds to your operating account to pay an invoice. This is a trust transfer: the firm earns the fee and the client's trust balance goes down by the same amount.
- Start a payment and select the invoice as usual.
- Set the Payment method to Trust / Escrow Transfer. The account fields change to two pickers.
- In From account (Trust / Escrow), pick the trust account to draw from. Each option shows the client's current available balance in that account, so you can see what is available before you transfer.
- In To account (Operating / Savings), pick the operating account that will receive the funds.
- Enter the Amount to transfer. For a trust transfer, the amount cannot be more than the invoice's outstanding balance.
- Set the date, optional payer/reference/notes, and click Record payment.
On save, Esqase moves the funds out of the trust account and into the operating account, applies the payment to the invoice, and updates both account ledgers.
Important: The amount cannot exceed the client's available trust balance in the chosen account. If it does, an Insufficient trust balance message appears telling you how much is available, and the form will block the save. Lower the amount or pick a different trust account.
Note: The From and To accounts must be different accounts.
📷 Screenshot: The payment form in trust-transfer mode, showing the From account (Trust / Escrow) picker with a client balance displayed next to each account and the To account (Operating / Savings) picker below it.
Suggested image: images/payments/trust-transfer-payment.png
Mark a pending payment as cleared
A Pending payment is recorded but has not yet been applied to the invoice (typical for a check you are waiting to clear the bank). When the funds arrive, mark it cleared so the invoice balance updates.
- On the Payments list, find the pending payment. Pending rows show a Review button in the actions column.
- Click Review.
- In the Review payment dialog, confirm the details (amount, date, method, account, client, matter) and check any attached proof of payment.
- Click Mark Cleared.
The payment becomes Cleared, the deposit posts to the account ledger, and the invoice moves to Partially paid or Paid. You will see a "Payment cleared" confirmation.
If the payment did not go through after all, click Mark Failed in the same dialog instead. The payment is recorded as Failed and never touches the invoice balance.
📷 Screenshot: The Review payment dialog showing the payment details block, the attachments section, and the Mark Failed and Mark Cleared buttons in the footer.
Suggested image: images/payments/review-payment-dialog.png
Change a payment status
You can adjust the status of a payment that has not yet been applied or refunded directly from the list, without reopening the full form.
- On the Payments list, find the payment in the Status column.
- If the status is Pending or Failed, it shows as a clickable badge. Click it.
- Choose the new status from the menu (Pending or Failed).
The status updates in place and a "Payment status updated" confirmation appears.
Note: Only Pending and Failed payments can be switched this way. To move a pending payment to Cleared, use the Review flow above (this is what actually applies the money to the invoice). Cleared, Refunded, Voided, and Archived statuses are shown as read-only badges and cannot be changed inline; to reverse a cleared payment, issue a refund instead.
View a payment's details
Every payment, regardless of status, has a read-only details view.
- On the Payments list, click View in the actions column of any row.
- The Payment details dialog opens, showing the invoice, amount, payment date, method, status, the account it landed in (or the From and To accounts for a trust transfer), payer, reference number, and description.
- If the payment included an overpayment, the dialog also shows the Applied to invoice amount, the amount Held in trust, and the Overpayment trust account.
- Click Close when you are done.
Tip: The View action is always available, even when a payment is cleared, refunded, or archived. The Review button (for clearing) and the Refund action only appear when they apply to that payment's status.
Refund a cleared payment
You can refund a payment once it is Cleared. A refund can go back to the client out of your operating account, or be held as client credit by depositing it into a trust account. Refunds can be full or partial.
- On the Payments list, open the actions menu (the ... button) on a cleared payment.
- Click Refund.
- In the Refund payment dialog, the top summary shows how much was originally applied, how much has already been refunded, and how much is refundable now.
- Choose the Refund destination:
- Refund to client (out of operating account) sends money back to the client and reduces your operating account balance.
- Hold as client credit (deposit to trust) keeps the money for the client by depositing it into a trust account. If you pick this, a Trust account field appears so you can choose which one.
- For a payment that was itself a trust transfer, the default is Return to ... (Trust), which puts the money back into the client's original trust account, with the operating refund offered as the alternative.
- Enter the Refund amount. It defaults to the full refundable balance; lower it for a partial refund. You cannot exceed the refundable balance, and the form warns you if you try.
- Set the Refund date, and optionally a Payee, a Check or reference no., and a Description.
- Click Record refund.
On save, Esqase records the refund, adjusts the account ledger (and the trust account if you chose to hold credit), and updates the invoice balance. A full refund sets the payment's status to Refunded; a partial refund leaves the payment cleared but reduces how much is still refundable.
Important: Only money that actually left your operating account is refundable. A trust transfer moves funds between your own accounts and is net-neutral, so for that case the natural destination is returning the funds to the original trust account.
📷 Screenshot: The Refund payment dialog showing the summary block (applied / already refunded / refundable now), the Refund destination picker, and the Refund amount prefilled to the refundable balance.
Suggested image: images/payments/refund-payment-dialog.png
Refund to the operating account or into a trust account
The two destinations behave differently, so pick the one that matches what you mean to do.
- Refund to client (out of operating account): Choose this when you are actually returning the client's money. It decreases your operating account balance by the refund amount.
- Hold as client credit (deposit to trust): Choose this when the client should keep a balance with the firm rather than receive cash back. The refund amount is deposited into the trust account you select and stays available for future invoices.
Browse, search, filter, and sort the payments list
The Payments page lists every payment your firm has recorded. Use the controls along the top to narrow it down.
- In the sidebar, click Payments.
- Use the status tabs above the table to filter by state: All, Pending, Cleared, Failed, or Refunded.
- Use the toolbar to refine further:
- Search payments matches by client, invoice, reference, and related details.
- The date range filter limits the list to payments whose payment date falls in the range you pick.
- The Method filter lets you show only certain payment methods (Wire, Check, Cash, Credit Card, Stripe Card, PayPal, Trust / Escrow Transfer, Other).
- When any filter is active, a Clear filters button appears to reset everything.
- Sort by clicking a column header. You can sort by Payment date, Amount, or Last updated.
- The table columns are Actions, Payment date, Invoice (a link to the invoice), Amount, Method, Client, Matter, Status, Remarks (shows overpayments routed to trust), Updated by, and Last updated. Use the view options menu to show or hide columns, and the refresh control to reload the latest data.
📷 Screenshot: The Payments page showing the status tabs, the trend chart, the search/date-range/method toolbar, and the table with the Invoice, Amount, Method, and Status columns.
Suggested image: images/payments/payments-list.png
Tip: The Invoice column links straight to the invoice. Click it to open the invoice and see the full picture of what is billed, paid, and outstanding. See Creating and sending invoices.
Read the payments trend chart and the date-range filter
Above the table sits a payments trend chart that shows your cleared payment volume over time, with an optional comparison against a previous period. Its filter controls run across the top of the chart, and the period total sits just below them.
- The headline figure is the total payments collected for the selected period, with a percentage badge showing the change versus the comparison period (green for up, red for down).
- The date range control, in the filter row at the top of the chart, sets the period the chart covers. This is separate from the date filter on the table below.
- The comparison control lets you compare the selected period against the Previous period (the equally long stretch immediately before it) or a custom range you choose. The dashed line is the comparison period; the solid line is the current one.
- The member filter narrows the chart to payments tied to specific firm members.
- The refresh control reloads the chart with the latest figures.
Note: The trend chart reflects cleared payment activity. Pending and failed payments do not contribute to the totals.
📷 Screenshot: The payments trend chart with its filter controls (date range, comparison, member, and refresh) across the top, the headline total and change badge just below them, and the solid current-period line beside the dashed comparison line.
Suggested image: images/payments/payments-trend-chart.png
For a firm-wide view of revenue, outstanding balances, and collections, see The billing overview dashboard.
Attach a receipt or proof of payment
Payments can carry attached files, such as a scanned check, a wire confirmation, or a receipt, so the proof lives alongside the record.
- On the Payments list, click Review on a pending payment (or View on any payment).
- In the Attachments section, you will see any files already attached to the payment.
- For each attachment, use the preview control (the eye icon) to open it in a new tab, or the download control to save a copy.
Most attachments arrive automatically: when a client pays online or uploads a receipt during checkout, that proof is attached to the payment for you. Accepted file types are PDF, PNG, JPG, WebP, and GIF, up to 25 MB each.
Note: Attachments are previewed and downloaded through the Review payment dialog. If a payment has no files, the section reads "No attachments were uploaded with this payment."
Common questions
- Why didn't recording a payment change the invoice balance? The payment was probably saved as Pending. Only Cleared payments reduce the invoice balance. Use Review then Mark Cleared to apply it.
- Why can't I record a payment against this invoice? The invoice must be open, partially paid, or paid to accept money. Draft and cancelled invoices cannot. Open the invoice to check its state.
- I don't see a Refund option on a payment. Refunds are only available on Cleared payments. Pending, failed, refunded, and archived payments cannot be refunded.
- Why is the Record payment button missing? Your role does not include Create access for payments. Ask a firm owner or administrator to adjust your role. See Roles and permissions.