Payment ledger
Open Payment Ledger at /tuition/admin/ledger.
The ledger is invoice-based. Billed amounts come from saved invoices; paid amounts come from active, non-voided payment records. A PDF delivery result does not change this balance.
Find an invoice
Use the Billing month input and the searchable Parent and Payment status dropdowns. You can also filter by invoice number and phone number.
Clear the month for all billing months. Parent selection uses its ID and refreshes the table immediately. Totals cover all matching invoices, not just the currently visible page.
Record a payment
- Select Record payment for the invoice.
- Enter the amount and payment date.
- Select the method: bank transfer, DuitNow/QR, cash, card, cheque, or other.
- Add a reference/receipt number and optional notes.
- Save and check the updated balance and payment history.
Amounts must be positive, have at most two decimal places, and not exceed the current outstanding balance. Future payment dates are rejected.
| Invoice state | Meaning |
|---|---|
| Unpaid | No active payment against a positive invoice amount |
| Partially paid | An active payment exists and a balance remains |
| Paid | Active payments cover the invoice amount; zero-value invoices also have no outstanding amount |
| Cancelled | New payments are blocked; the invoice has no payable ledger balance |
Correct a mistake
Open the payment history, choose Void payment, and enter the reason. The original record remains visible, along with its void information, but no longer contributes to paid totals.
Voiding is an accounting-record correction. It does not issue a bank refund or retract a Telegram/email message.
Safe retries and concurrent work
The client submits a UUID requestId. Retrying the same request does not create a second payment. Reusing that ID for different details returns a conflict.
Spring locks the invoice while recording or voiding payments. Two administrators cannot use stale balances to overpay the same invoice.
Existing payments
Old invoices appear unpaid until their payments are recorded. Legacy receipt CRUD and the new ledger are separate implementations; recording a payment does not currently generate a formal receipt PDF automatically.