Loan instalments and repayment

Loan instalments and repayment

This article explains how a loan is repaid: when an instalment comes off a payslip, what Pending, Due, Default and Paid mean, why an instalment was not deducted, how default interest is added, and how to record a payment made outside payroll, waive an instalment, or pause a deduction. Use it when an employee asks what they are paying, when it ends, or why a payslip changed.

Where: Benefits › Team Benefits › Team Loans › open a loan › select an instalment

You need:

  • The Loan Manager right to open the loan
  • Loan Payments to see the Payment Details card
  • Loan Payments and Loan Manager, both with write access, to add or delete payments and to pause a deduction

How to see a loan's schedule

  1. Open the loan from Team Loans or the Installments tab.
  2. Read the Installments table: one row per instalment with its Payment date, Due date, Principal, Outstanding, Installment amount and Status.
  3. Use Filters to show one status. Export downloads the schedule as a spreadsheet.
  4. Select a row to open its Installment details. The back arrow returns to the loan.

How to record a payment made outside payroll

Use this when the employee repays in cash or by bank transfer, pays off early, or you agree to forgive an instalment.

  1. Open the loan and select the instalment.
  2. In Payment Details, select Add Payment.
  3. Enter the Payment Amount, Payment date and Payment Method.
  4. Optionally add Payment Details, such as a transfer reference. If you leave it empty, KAMI writes which instalment and loan it was for.
  5. Select Submit.

When the payments on an instalment reach its full amount, the instalment becomes Paid and payroll stops deducting it. To forgive an instalment, record its full amount with the method Waived. To repay a whole loan early, record a payment on each remaining instalment.

To undo a payment, select the bin icon on it and confirm. Payments that payroll made cannot be deleted.

How to pause a deduction

  1. Open the instalment.
  2. In Payment Details, select Pause.

A paused instalment is not deducted on any payslip, does not turn Due or Default, and gathers no default interest. Select Resume to deduct it on the next eligible payslip. To pause many at once, use Bulk edit on the Installments tab.

How payroll deducts instalments

Each payslip takes, as separate lines named after the loan type:

  • every Pending instalment whose Payment date falls inside the payroll period
  • every Due or Default instalment not yet on another payslip, however old

It deducts what is left of the instalment after any payments already recorded. When the payslip is marked paid, those instalments become Paid and the loan balance falls. If the payslip goes back to unpaid, the payments are reversed.

These are never deducted: paused instalments, loans Pending Disbursement, Repaid or Restructured, and Default instalments on a loan type with Do not include default installments in payslip ticked.

Instalment statuses

StatusMeans
PendingScheduled. Its payment date has not arrived.
DueThe payment date has arrived and it is not fully paid.
DefaultThe due date has passed while it was still Due. The loan then shows Default, except loans added with Add Loan.
PaidFully paid, by payroll or recorded payments.
InternalA monthly record kept for reporting when the loan type splits instalments. Never deducted.

The Payment date is when the instalment should come off pay. The Due date is the payment date plus the loan type's Payment grace. Without a grace they are the same day.

Icons beside a status appear only on QuickPay advances: Payment pending verification, Payment confirmed or Payment unverified.

Installment details fields

FieldWhat it means
AmountThe instalment amount, including any default interest added.
Installment dateThe payment date.
Interest and Principal PaymentHow the instalment splits between interest and the loan principal.
Final Due DateThe due date, after the payment grace.
Default interestDefault interest added so far.
Outstanding principalThe loan's remaining principal.

A payment pays the instalment's interest, default interest and late interest first. The rest reduces the principal.

What Happens Next

  • When the outstanding principal reaches zero, the loan becomes Repaid.
  • Each night KAMI marks instalments Due or Default. While one stays in Default, KAMI works out default interest at the loan's Default interest rate (per day or per month) and adds it to the instalment amount. If the loan type has Charge late penalty ticked, late interest at the loan's yearly rate is added too.
  • Loans added with Add Loan turn Due and Default the same way but never gather default interest.
  • A payment recorded on an instalment that is already on a calculated payslip recalculates that payslip.

Tips

  • Pause, do not delete. Deleting a Pending instalment removes it for good. Pausing keeps it owed.
  • Record outside payments on the day they arrive. Otherwise the next payroll deducts the same instalment again.
  • Check the first instalment after the first payroll. If it came off as expected, the rest will.
  • Act on Default quickly. Default interest grows each night the instalment stays unpaid.

Troubleshooting / FAQ

Q: An instalment was not deducted. Check that the loan is Current, Current (Manually added) or Default, that the instalment is not paused, and that its payment date falls in the payroll period. A payslip calculated before the loan was disbursed needs recalculating.

Q: Two instalments came off one payslip. An older instalment was Due or Default and carried forward, or the loan splits instalments to match a semi-monthly payroll.

Q: An instalment amount went up. It is in Default and default interest was added.

Q: "Over payment of an installment is not allowed." The payments would exceed the instalment amount. Record only what remains.

Q: "Loan is not in a valid status for making payments." Payments can only be added to loans that are Current, Current (Manually added) or Default.

Q: "Loan payments generated against Loan Other Payment in payslip cannot be deleted." Payroll made that payment. Change the payslip instead.

Related articles