How to change the status of (approve, close) loan accounts

How to approve or close a single loan account

Before loans can be disbursed, they must be approved by someone with the appropriate permissions. The same procedure is used to cancel loan applications.

The following table explains the meanings of the statuses that a loan can have. When you configure Mifos, you can decide which of these statuses is available for use. See the Configuration guide for information.



Partial Application

Save the loan account in this status when:

The information entered is not complete; or

Is required by the MFI as part of the loan approval process; or

Want to save it with this status for the time being.

Most loan account attributes can be modified when the account is in this status.

Use the Save for later button when saving the loan account

Pending Approval

This is an optional status showing that loan account information is complete information.  This status allows the MFI to execute offline process with regard to the loan account before approving it in the system.

The loan account can be cancelled when it is in this status.

Use the Submit for Approval button when saving the loan account


The loan amount and repayment schedule have been approved by the MFI. All loan account parameters including the interest amount, loan term and funding source of the account are frozen and cannot be changed at this state

The loan account can be cancelled when it is in this status.

Active in good standing

  1. Can be changed to this status once the loan has been disbursed to the customer.
  2. The Actual disbursement date can be entered at this point and the loan account grace period starts counting where applicable.
  3. This status confirms that the loan has been issued to the client.

Closed - Rescheduled

A loan can be rescheduled if the MFI allows rescheduling. The current loan account has to be closed with the status marked as Closed- Rescheduled, and a new loan account must be created; it can have the same or different conditions and rules compared to the previous loan.

The system will not link the old and new accounts.

Transactions can still be applied to accounts in this status, but the user will be given a warning before proceeding.

In performance reporting and other reporting, this loan will not be counted as part of the loan cycle.

Closed - Obligations met

  1. The system moves the account to this state automatically when the loan amount is completely paid off.
  2. The account can be moved to this status manually without validating if the amount has been paid off.

Active- Bad standing

The system moves to this status any time the loan account terms are violated, for example, if there is nonpayment of an installment.

The system automatically moves the account to Active in Good Standing once the amount overdue has been paid.

Closed- Written Off

The loan account can be written off if the MFI or Loan Officer  determines that the loan cannot be repaid.


A loan can be cancelled before it gets to Active and in Good Standing status.  The loan can be cancelled if the customer withdraws the application or an officer of the MFI rejects the application.


To approve (or cancel) a loan, follow these instructions:

  1. From any Search screen, search for the borrower name (client or group), or the loan account number if you know it.
  2. In the list of clients or groups that appears, click the correct one.
  3.  In the Account Information section, find the loan you need to approve (all loans that need approval have a yellow square next to them). Click that link.
  4. Click Edit Account Status.

    A screen like the following appears:
    approve loan

  5. Click either Partial Application, Application Approved, or Cancel. If you click Cancel, you must click an explanation from the list that appears, such as Rejected. If the application was withdrawn, click Withdraw. If neither explanation fits, click Other.
  6. In the Note box, type a note explaining any reasons for your action.
  7. Click Preview to review your work.
  8. If a survey is required for this loan product, you must check the Client has Completed Loan Survey box.
  9. Click Submit.

The loan now appears on the details page with a green square, showing that it is approved.
approved loan

How to approve multiple accounts

See How to approve multiple loans (bulk loan approval) under bulk transactions.


How to writing off a loan

Mifos provides functionality to write off transactions. You may specify a date for writing off loan, it can be current date or backdate.

To write off loan account, follow instructions below. Status of Loan Account will be changed to  “Closed- Written Off”.

1. Click on Clients&Accounts tab, type a name of group or client and click Search. You will see a list of groups/clients with Loan Accounts assigned to them.


list of clients 

2. Choose appropriate loan account and click on it to display its details.

 You will see a page like following.

 loan account details

3. Click Edit account status to write-off transaction .

You will see a screen like following:

Edit account status

4. Date of transaction is default set as current date. You can specify different transaction date e.g. enter backdate, but it can not be less then the last payment date or the last meeting date.


You will be able to write off loan with backdate only if 'Back dated transactions allowed: Yes' option is enabled in the system. You can check if this option is enabled in your system in Admin tab on 'View organization settings' page.

If LSIM option is enabled, only the last payment matters and you can enter date which cannot be before the last payment date. If LSIM is disabled, then transaction date must not be before the previous meeting date or last payment date.

  1. Type all necessary fields and click Preview to check your entries or Cancel if you don't want to change anything at this time.

  2. If you like to change anything, click Edit status to return to the earlier screen.

  3. When the entries are correct, click Submit to save them or if you decide not to change any label at this time, click Cancel.