Use this guide to understand loan statuses and how they reflect a loan’s position within its lifecycle, from origination through closure.

Loan statuses

Loans can have the following statuses.

• PENDING—The loan is created but not yet booked. Terms may still be under review.
• BOOKED—The loan is approved and booked. The payment schedule is set and the loan is ready for disbursement. No transfers (repayments or disbursements) related to the loan account have been executed yet.
• ACTIVE—The loan is considered active based on the configuration of the loan product. Depending on lender requirements, this status can mean that at least one transfer related to the loan has been registered or simply that the loan has been booked.
• CANCELED—Operations on this loan are no longer supported and all the expected transfers have been canceled. No repayment is expected.
• RENEGOTIATED—The lender and borrower have agreed to new terms, resulting in a new loan; the original loan is no longer active for new transactions. This status is final and cannot be changed because a new loan is created during the restructure.
• SETTLED—The loan has been fully repaid and is now closed, with a zero balance remaining. This status occurs when the borrower completes all scheduled payments or settles the loan early.

Disbursement statuses

Disbursements can have the following statuses.

• SCHEDULED—A disbursement is due on or before its scheduled date.
• PROCESSING—A temporary state while a status change is in progress. A common use case is when a disbursement request has been submitted and is being processed (Scheduled → Processing → Paid)
• PAID—This disbursement was paid in full on or before the expected disbursement date.
• NOT PAID—The disbursement was not paid.
• EXPIRED—The scheduled disbursement expired before it was processed, so it can no longer be processed.
• CANCELED—A disbursement is no longer expected to be paid.

Installment statuses

Installments (repayments) can have the following statuses.

• PENDING—This installment was created as part of the repayment schedule but is not yet active.
• PROCESSING—A temporary state while a status change is in progress.
• SCHEDULED—The repayment for this installment is due on or before its due date.
• PAST_DUE—The due date has passed, and the repayment for this installment was not paid in full.
• PAID—The repayment for this installment was paid in full on or before the due date.
• PARTIALLY_PAID—Only part of the repayment for this installment was made, and the due date has not passed. The borrower can still make the payment on time.
• CANCELED—The repayment for this installment is not expected to be paid.
• PENDING—A payment for this installment was initiated and is being processed.
• PAST_DUE_PENDING_PAYMENT—The due date for this installment has passed but a payment was initiated and is being processed.
• ACTIVE—Funds have been disbursed and repayment for this installment is in progress.
• OVERDUE—The repayment for this installment has remained past due beyond configured thresholds and is now overdue.
• OVERDUE_PENDING_PAYMENT—The repayment for this installment is overdue but a payment was initiated and is being processed.
• IN_GRACE_PERIOD—The installment is within the configured grace period after the due date.
• IN_GRACE_PERIOD_PENDING_PAYMENT—The installment is in the grace period and a payment attempt is currently pending.
• PAID_WITHIN_GRACE—The installment was paid in full during the grace period.

Three paths exist for installments based on whether the grace period has passed.

Paid before the grace period has passed

Paid during the grace period

Paid after the grace period has passed