How to record a payment on an order¶
Who can do this: Users whose role allows Sales · Available on: Mobile · Web
Use this when a customer pays some or all of the balance on an invoice or an unpaid sale. You can take the payment in one payment mode or split it across several.
Before you start¶
- The order must have a balance due and must not be voided or credited.
- At least one payment mode must be set up. See Payment modes.
Steps¶
- Open the order from the Orders tab or the Invoices list. See Sales & orders.
- On the summary card, tap Record payment. (On web: Record Payment in the Payment section, or Actions → Record payment.)
Screenshot coming soon: Invoice Detail — summary card with Record payment
- The Record payment screen shows the TOTAL, what has been PAID and the BALANCE. Choose how much to take:
- Full balance: the whole balance due.
- Half · amount: half the balance.
- Custom split: split the payment across several payment modes (see below).
- For a single payment, fill in Payment details: | Field | Required | What to enter | |---|---|---| | Amount received | Yes | Pre-filled from your choice above. You can type a smaller amount. | | Payment method | Yes | The payment mode, such as Cash or M-Pesa | | Customer phone | No | Only shown for M-Pesa modes | | Payment date | Yes | Today by default. Tap to change it. | | Reference / note | No | A transaction code, for example |
If the amount clears the balance, the message This payment settles the invoice in full. Status will change to paid. appears. 5. For Custom split, tap Add Payment Method for each mode and enter its amount. Allocated and Unallocated show your running totals. 6. Tap Pay amount. If your company requires a PIN, enter it.
Screenshot coming soon: Record payment — payment details
Apply a customer's unused credits¶
If the customer has an open credit note, the invoice's Customer section shows Unused credits and an Apply to invoice button (on web: Apply).
- Tap Apply to invoice. The Apply unused credits sheet shows Unused credits, Invoice balance due and Max you can apply.
- Choose Full or Half, or type an Amount.
- Tap Apply credits. The message Credits applied confirms it.
What happens next¶
- The message Payment recorded confirms the payment.
- The order's PAID and BALANCE DUE amounts update. Once the balance reaches zero, the status changes to Paid / Completed.
- The payment appears under Customer payments, and the customer's balance goes down.
Tips & common issues¶
- "Amount cannot exceed balance (…)": you entered more than is owed. Lower the amount.
- "Allocated amount exceeds balance due": in a split, the amounts add up to more than the balance.
- "Select a payment method": choose a payment mode before you tap Pay.
- "Payment failed: …": the payment wasn't saved. Check your connection and try again.
- No Record payment button: the order is already paid, voided or credited.
- "No open credit notes available for this customer": the customer's credit has already been used up.