Payments¶
Applies to: school staff with Payments.Create (record payments and see their own) or Payments.View (see all payments); Payments.Edit to void; Payments.Refund to refund. Plan must include Payments. Last reviewed: 2026-11-18.
A payment is money the school received from a student or walk-in customer. Every payment is recorded against one invoice, gets a receipt number and reduces that invoice's balance.
This page covers recording a payment by hand, receipts, what staff with limited access see, and payment for extra lessons. Related topics have their own pages: Online payments, Payment history, Outstanding balances, Refunds and voids.
Where to find it¶
Sidebar > FINANCE > Payments (page address /payments). The link is shown to users with Payments.View or Payments.Create, when the plan includes the Payments feature.
You can also record a payment from:
- the dashboard: Quick Actions > Record Payment;
- an invoice: FINANCE > Invoices > three-dot menu > Record Payment;
- the student's profile, Payments tab (see the student management documentation).
Who can do what¶
| Action | Permission |
|---|---|
| Receive Payment / Record Payment | Payments.Create |
| See every payment in the school | Payments.View |
| See only the payments you recorded yourself | Payments.Create without Payments.View |
| View Details, Download Receipt, Email Receipt | Payments.View, or Payments.Create for your own payments |
| Void | Payments.Edit |
| Refund | Payments.Refund |
Staff who record but may not view (for example a receptionist)¶
A user with Payments.Create but without Payments.View:
- sees the Payments page with the subtitle "Payments you have recorded, with their receipts." and only the payments they captured themselves;
- can open, download and email the receipts of those payments only; any other payment is reported as not found;
- sees dashboard payment figures for their own payments only ("My Payments Today", "Recorded by you"); see Dashboard;
- on a student's Payments tab sees the card Paid (recorded by you) instead of Total Paid;
- does not get View Payments on an invoice, the Financial Report, or the overdue-invoice notifications.
The restriction is applied on the server from the signed-in user; it cannot be bypassed by changing a filter.
Record a payment¶
Screenshot to be added
Screen: Receive Payment dialog. Should show: student picker, Invoice list, invoice summary box, Amount, Payment Method, Payment Date, Reference Number and Notes.
- Open FINANCE > Payments and click Receive Payment.
- Pick the student in the student picker. Until you do, the dialog shows "Select a student to see their outstanding invoices."
- In Invoice, choose the invoice being paid. The list shows the student's Pending, PartiallyPaid and Overdue invoices as "
<number>-<balance>outstanding", newest first; the first one is pre-selected. A summary box shows Invoice, Invoice Total, Paid and Outstanding.- If the student has none, the dialog shows "This student has no outstanding invoices." and there is nothing to save.
- Amount (required): pre-filled with the invoice's outstanding balance. Lower it for a part payment.
- Payment Method (required): see the table below.
- Payment Date (required): defaults to today. You can backdate it.
- Reference Number: optional ("EFT reference / card reference"), up to 100 characters.
- Notes: optional, up to 1000 characters. Notes print on the receipt.
- Click Receive Payment.
Paying from an invoice
When you start from an invoice's Record Payment menu item, steps 2 and 3 are skipped: the dialog opens on that invoice. This is also how a walk-in invoice is paid.
Payment methods¶
| Shown in the dialog | Shown in the Payments filter | Use for |
|---|---|---|
| Cash | Cash | Cash handed over. |
| Card | Card | Card machine payments. |
| EFT | EFT | Electronic funds transfer. |
| BankTransfer | Bank Transfer | Bank deposits or transfers. |
| MobilePayment | Online / Mobile | Mobile wallet payments. Payments made online through PayFast in the student portal are recorded automatically with this method. |
Note
The method is a label for your records and reports. Choosing Card or EFT does not charge anyone.
What happens after saving¶
- The message "Payment received." appears.
- A payment is stored with status Successful, the next receipt number for the branch (see VAT and numbering), and your user as the person who recorded it.
- The invoice's amount paid goes up by the payment. If it now covers the total, the invoice becomes Paid; otherwise PartiallyPaid.
- The Payment Received notification is sent to the student if the school has it switched on (see the notifications documentation). A notification failure never undoes the payment.
- Two payments saved at the same moment on the same invoice are both counted; the invoice is locked while each one is applied.
Part payments and over-payments¶
- Part payment: enter less than the outstanding amount. The invoice becomes PartiallyPaid and stays in the student's outstanding list with the reduced balance. Record the rest later as a second payment; payments add up.
- Over-payment: the dialog refuses an amount above the invoice's outstanding balance: "Payment cannot exceed the outstanding invoice balance." There is no screen for holding a deposit or credit on a student's account. To take money for something not yet invoiced, create the invoice first.
- One payment, one invoice: a payment cannot be split across several invoices. For a student paying two invoices at once, record two payments.
Messages you may see¶
| Message | Cause |
|---|---|
| "Please select an invoice." | No invoice chosen. |
| "Payment amount must be greater than zero." / "Amount must be greater than zero." | |
| "Payment cannot exceed the outstanding invoice balance." | Amount is more than the balance. |
| "Student is not active." | The student's status is Inactive or Licensed. Reactivate the student first. |
| "Student not found." / "Invoice not found." | The record was removed. |
| "Invoice does not belong to this student." | |
| "Payments cannot be recorded against a cancelled invoice." | |
| "This invoice belongs to a student. Record the payment from the student." | A student's invoice was submitted without the student. |
Example¶
Sipho Mokoena owes R 4 500.00 on invoice HQ-INV-00031. He pays R 2 000.00 in cash. Staff click Receive Payment, pick Sipho, leave the invoice selected, change Amount to 2000, choose Cash and click Receive Payment. Receipt HQ-REC-00058 is created, the invoice becomes PartiallyPaid with a balance of R 2 500.00.
Two weeks later Sipho pays the rest by EFT; staff record R 2 500.00 with method EFT and the bank reference. The invoice becomes Paid.
Receipts¶
Every successful payment has a receipt.
Download a receipt¶
FINANCE > Payments > three-dot menu on the payment > Download Receipt. The file is saved as Receipt-<receipt number>.pdf.
The receipt is an A5 page with the school's logo, name and branch, the heading PAYMENT RECEIPT and:
- Receipt Number
- Date (payment date and time)
- Student (or the walk-in customer's name)
- Student Number (or "Walk-in customer")
- Invoice
- Payment Method
- Reference (when entered)
- Status
- AMOUNT PAID
- Balance Outstanding on Invoice (the invoice's balance at the moment the PDF is generated, not at the time of payment)
- Notes
- "Thank you for your payment." and the generation time in UTC.
Screenshot to be added
Screen: Payment receipt PDF. Should show: header, receipt details and AMOUNT PAID box.
Email a receipt¶
Three-dot menu > Email Receipt. The email goes to the student's email address (or the walk-in customer's email on the invoice) with the receipt PDF attached. Subject: "Payment receipt: <receipt number>". It lists the receipt number, payment date, amount paid, payment method, invoice and balance outstanding, and is recorded in the notification history.
| Message | Meaning |
|---|---|
| "Receipt emailed to the student." | Sent. |
"Only successful payments have a receipt to send (this one is <status>)." |
The payment was voided, refunded or is not complete. |
| "This student has no email address. Add one to their profile and try again." | |
| "This customer has no email address on the invoice." | |
| "The receipt email could not be sent: ..." | Mail server problem. |
Download Receipt and Email Receipt are shown only for payments with status Successful.
Students can open their own receipts in the mobile app; the web student portal has no download button, and receipts reach them by email. See the student portal and mobile app documentation.
View payment details¶
Three-dot menu > View Details opens Payment Details with the amount paid, status, Payment Method, Payment Date, Reference, Receipt Number and Notes.
Paying for extra lessons (lesson top-ups)¶
An extra lesson beyond the student's package is added from the student's profile (see the student and lesson documentation for the steps). The financial side works as follows.
| Kind | Who may add it | What happens financially |
|---|---|---|
| Paid extra lesson | Staff with Invoices.Create; the plan must include Payments |
An invoice is raised for the student with the line "Extra driving lesson - <package name>", quantity 1, the fee entered, no tax, due 7 days later. The reason, if given, becomes the invoice note. The invoice is emailed if the Invoice Issued notification is on. Message: "Extra lesson added. Invoice <number> was emailed to the student." or, when it was not emailed, "Extra lesson added. Invoice <number> was created." |
| Free extra lesson | Staff with Lessons.Manage; a reason is required |
No invoice. Message: "Free extra lesson added." |
Rules:
- The fee must be more than zero and at most R 100 000. Otherwise: "Enter the fee for the extra lesson, or mark it as free." / "The fee may not be more than R 100 000."
- The student needs a training package and may not be Inactive.
- The extra lesson is available for booking as soon as it is added. It does not wait for the invoice to be paid.
- The invoice is paid like any other, with Receive Payment or online by the student.
- To remove a paid extra lesson, cancel its invoice (only possible while nothing has been paid on it). A free one is removed from the student's profile by a user with
Lessons.Manage, provided it has not been booked yet. - Until an extra lesson is booked, staff who manage lessons see an "Extra lesson to schedule" notification in the header bell (see Dashboard).
Money precision and rounding¶
- All amounts are stored with two decimal places (precision 18, scale 2).
- Percentage discounts are rounded to two decimals with halves rounded away from zero (R 10.005 becomes R 10.01).
- Amounts on screen use the server's currency format; PDFs and emails write amounts as
R 1,234.56. - An online payment is accepted only when the amount PayFast reports is within one cent of the amount requested.
- The currency is South African rand throughout. There is no currency setting for school billing.
Limitations and notes¶
Read before using Refund
Refunds do not move money except in one case that currently fails; read Refunds and voids before using Refund.
- Refunds do not move money except in one case that currently fails; see above.
- No unallocated payments or account credit in the screens: every payment needs an invoice. The API technically accepts a student payment without an invoice and an amount above the balance, but no screen does this.
- A payment cannot be edited. To correct a wrong amount, date or method, void the payment and record it again. The new payment gets a new receipt number.
- No bank or card integration for staff-recorded payments. Code for staff-created gateway checkouts exists (with Paystack, Flutterwave and Stripe adapters) but no screen uses it and it is not part of the supported product. Students paying online use PayFast only; see Online payments.
- No cash-up or till reconciliation screen. Use the Payments page filtered by date and method, or the Financial Report.
- The receipt always shows the invoice's current balance, so a reprinted receipt can show a different balance from the original.
Related articles¶
- Payment history: search and filter past payments.
- Outstanding balances: what students still owe.
- Online payments: students paying through PayFast.
- Refunds and voids: reversing a payment.
- Invoicing: the invoices payments are recorded against.