Skip to main content

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​

  1. Select Record payment for the invoice.
  2. Enter the amount and payment date.
  3. Select the method: bank transfer, DuitNow/QR, cash, card, cheque, or other.
  4. Add a reference/receipt number and optional notes.
  5. 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 stateMeaning
UnpaidNo active payment against a positive invoice amount
Partially paidAn active payment exists and a balance remains
PaidActive payments cover the invoice amount; zero-value invoices also have no outstanding amount
CancelledNew 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.