Skip to main content

​
Overview

Recording loan payments is a critical daily operation that updates member loan balances, tracks arrears, and ensures accurate financial reporting. When members make loan repayments, the payment is deducted from their savings balance and allocated between principal, interest, and penalties. Use this when: A member wants to pay toward their loan from their savings balance (full installment, partial payment, or extra payment).

​
Before You Begin

Prerequisites:
  • You have loans:write permission
  • The loan exists and is in active status (not fully repaid or written off)
  • The member has sufficient savings balance to cover the payment amount
  • You know the exact payment amount and date
Finding the loan: You can search for loans by borrower name, loan ID, or application number in the Loans section.

​
Step-by-Step Instructions

​
Step 1: Navigate to the Loan

1

Open Loans section

Click Loans in the left sidebar
2

Find the loan

  • Use the search bar to find the borrower’s name
  • Or browse the active loans list
  • Click on the loan to open details
3

Open payment dialog

Click “Record Payment” button (usually near the top of loan details)

​
Step 2: Enter Payment Details

The payment recording dialog contains the following fields:
FieldDescriptionRequiredExample
AmountPayment amount to deduct from member’s savingsYes50,000 RWF
Payment DateDate of the paymentYes2026-06-08
DocumentUpload payment receipt or proof (optional)NoPDF/image of receipt
Important: Payments are deducted from the member’s savings balance. The member must have sufficient savings to cover the payment amount. If they don’t have enough savings, the payment will be rejected.

​
Example: Recording a Full Installment Payment

Amount: 44,500 RWF
Payment Date: 2026-06-08
Document: receipt.pdf (optional)

​
Step 3: Review Payment Allocation

Before submitting, Agatabo displays how the payment will be allocated: Example allocation for 50,000 RWF payment:
ComponentAmountNew Balance
Interest12,000 RWF0 RWF (interest paid in full)
Principal38,000 RWF400,000 RWF (reduced from 438,000)
Penalty (if any)0 RWF0 RWF
Total Payment50,000 RWF-
The allocation follows the Payment Allocation Order set when the loan was created:
  • INTEREST_FIRST: Pays interest fully, then principal
  • PRINCIPAL_FIRST: Pays principal fully, then interest
  • PROPORTIONAL: Splits based on ratio of principal to interest
Most loans use INTEREST_FIRST to ensure interest revenue is collected.

​
Step 4: Submit Payment

1

Verify allocation

Review the payment breakdown - ensure it looks correct
2

Check remaining balance

Note the new outstanding balance after this payment
3

Click 'Save' or 'Record Payment'

Submits the transaction

​
What Happens Next

When you record a loan payment, Agatabo automatically:
  1. Validates savings balance: Checks that the member has sufficient savings to cover the payment
  2. Deducts from member’s savings: The payment amount is deducted from their savings balance
  3. Allocates the payment between interest, principal, and penalties based on the loan’s payment allocation order
  4. Updates the loan balance: Reduces the outstanding principal and marks installments as paid
  5. Creates a journal entry:
    • Debit: Savings (member’s account, -50,000 RWF)
    • Credit: Loan Receivable (-38,000 RWF)
    • Credit: Interest Receivable (-12,000 RWF)
  6. Marks installments as paid: If the payment covers one or more installments, they’re marked as “Paid”
  7. Updates arrears: If the loan was overdue, arrears are recalculated
  8. Records in audit trail: Logs payment with user ID, timestamp, and all details
  9. Sends notification (if enabled): Borrower may receive payment confirmation

​
Example Journal Entry Created

For the payment above (50,000 RWF payment with 38,000 principal and 12,000 interest), Agatabo creates:
DateAccountDebitCredit
2026-06-08Savings (John Mugisha)50,000-
2026-06-08Loan Receivable-38,000
2026-06-08Interest Receivable-12,000
This ensures the accounting equation stays balanced.

​
Common Scenarios

​
Recording a Full Installment Payment

When a member pays exactly the scheduled installment amount:
1

Enter the installment amount

The amount should match the scheduled installment (shown in loan details)
2

Verify full allocation

Payment should cover the entire installment’s principal and interest
3

Submit

The installment is marked as “Paid” with no arrears

​
Recording a Partial Payment

When a member pays less than the scheduled installment:
1

Enter the actual amount received

Example: 20,000 RWF when 44,500 RWF is due
2

Review allocation

  • If INTEREST_FIRST: 20,000 goes to interest, leaving 24,500 interest unpaid
  • Principal remains unchanged
3

Note arrears

The unpaid portion becomes arrears and may trigger late fees
Partial payments increase arrears: If a member consistently pays less than the installment amount, arrears accumulate. You may need to apply penalties or restructure the loan.Learn about applying penalties →

​
Recording an Extra Payment (Overpayment)

When a member pays more than the scheduled installment:
1

Enter the full amount received

Example: 100,000 RWF when 44,500 RWF is due
2

Review allocation

  • Current installment paid in full (44,500)
  • Excess (55,500) applies to future installments or principal
3

Check new schedule

Future installments may be marked as prepaid, or principal reduces faster
Encouraging prepayment: Overpayments reduce the loan balance faster and may reduce total interest paid (depending on interest calculation type). This is beneficial for both member and organization.

​
Member Needs to Deposit First

If a member wants to make a loan payment but doesn’t have sufficient savings:
1

Member deposits cash

Record the deposit to increase their savings balance
2

Then record loan payment

Once savings balance is sufficient, record the loan payment
Two-step process: If a member brings cash to pay their loan, first record it as a savings deposit, then immediately record the loan payment. This ensures proper accounting of both the cash receipt and the loan payment.

​
Backdated Payment (Past Date)

If recording a payment that occurred in the past:
1

Check period status

Ensure the target date is in an open period (not closed)
2

Select correct payment date

Change the Payment Date field to the actual date payment was received
3

Add explanatory note

Example: “Payment received on 2026-05-28, recorded on 2026-06-08 (late entry)”
Period closing restriction: You cannot record payments in closed accounting periods. If the period is closed, contact your accountant about proper handling (may require adjusting entries).Learn about period closing →

​
Viewing Payment History

After recording, you can verify the payment:
1

Check loan details

Loans → [Loan] shows updated balance and payment history table
2

Check installment schedule

Installments are marked as “Paid”, “Partially Paid”, or “Overdue”
3

Check journal entries

General Ledger → Journal Entries → Search by date or reference

​
Handling Payment Errors

​
Recorded Wrong Amount

  1. Navigate to Loans → [Loan] → Payment History
  2. Find the incorrect payment
  3. Click Edit (if available based on permissions)
  4. Correct the amount
  5. Save changes
Note: Editing capabilities depend on organization settings and period status.
Payments in closed periods cannot be modified. You must:
  1. Record a reversal payment (negative amount) in the current period to cancel the error
  2. Record the correct payment with proper amount
  3. Document both transactions clearly in notes
  4. Consult with accountant to ensure proper handling

​
Recorded Payment to Wrong Loan

  1. Delete the incorrect payment (if deletion is enabled)
  2. Navigate to the correct loan
  3. Record the payment properly
  4. If deletion is not enabled, contact your accountant for reversal process
Requires accountant assistance:
  1. Reversal entries on the wrong loan
  2. Correcting entries on the right loan
  3. Full documentation of the correction

​
Common Issues

Cause: Member doesn’t have enough savings to cover the payment amount.Solution:
  • Check member’s current savings balance in Organization Users → User Details
  • If member is bringing cash, first record a deposit to increase their savings
  • Then record the loan payment
  • Navigate to Savings → Deposit History → Record Deposit
Cause: Loan ID is invalid or loan has been written off/fully repaid.Solution:
  • Verify the loan exists in Loans section
  • Check loan status - you cannot record payments on closed loans
  • If loan is fully repaid, no additional payments are needed
Cause: Your user account doesn’t have loans:write permission.Solution:
  • Contact your administrator to request payment recording permissions
  • If you have loans:write with SELF scope, you can only record payments for your own loans
Learn about permissions →
Cause: Payment date is in a closed period or in the future.Solution:
  • Ensure the date is in the current open period
  • Payment date cannot be after today
  • Check Advanced → Period Closing for period status
Cause: Payment allocation order (set when loan was created) may not match your expectation.Solution:
  • Review the loan’s Payment Allocation Order in loan details
  • INTEREST_FIRST pays all interest before principal
  • PRINCIPAL_FIRST pays all principal before interest
  • PROPORTIONAL splits based on ratio
  • This cannot be changed after loan creation
Cause: Payment amount is too small to cover overdue interest, or allocation order prioritizes current installment over arrears.Solution:
  • Check the arrears breakdown in loan details
  • Larger payment may be needed to clear overdue amounts
  • Contact accountant if arrears calculation seems incorrect

​
Best Practices

Payment recording tips:
  • Ensure member has sufficient savings balance before recording payment
  • If member brings cash, first record it as a deposit, then record the loan payment
  • Verify the borrower’s name and loan ID before submitting
  • For large payments, double-check the amount before submitting
  • Upload payment receipts or proof using the Document field
  • Record payments promptly to keep arrears accurate
  • Check the payment allocation preview before submitting

​
Understanding Payment Impact

​
Effect on Loan Balance

Each payment reduces the outstanding loan balance:
Payment #PaymentInterestPrincipalBalance BeforeBalance After
0 (Disbursement)---0500,000
144,50012,00032,500500,000467,500
244,50011,20033,300467,500434,200
344,50010,40034,100434,200400,100
Notice how principal portion increases and interest decreases (for reducing balance loans).

​
Effect on Arrears

  • On-time payment: Clears current installment, no arrears added
  • Partial payment: Unpaid portion becomes arrears, may trigger late fees
  • Overpayment: Reduces arrears, may prepay future installments

​
Effect on Financial Reports

  • Member savings decreases: Borrower’s savings balance is reduced
  • Loan receivable decreases: Portfolio outstanding reduces
  • Interest receivable decreases: Recognized interest revenue is collected
After recording payments, you may need to:

View Loan Details

Review installment schedule and payment history

Apply Penalties

Charge late fees for overdue payments

Loan Analytics

Monitor portfolio health and arrears

Recording Deposits

Add cash deposits to increase member savings

​
Need Help?

Understanding Payment Allocation

Learn how payments are split between principal and interest

Managing Arrears

Handle overdue payments and late fees

Viewing Loan Details

Check payment history and remaining balance

Common Errors

Troubleshooting payment recording issues