Managing loan closures and write-offs
A loan may reach the end of its lifecycle through full repayment, an early settlement, or a write-off.
These events have different operational and accounting implications.
Closing a loan
A loan can be closed when the outstanding obligation has been satisfied or otherwise resolved through an authorised process.
The current loan status API supports a closed status, with validation preventing ordinary closure while an outstanding balance remains.
Writing off a loan
A write-off records the institution's decision to treat an outstanding facility as written off under its policies.
The loan status API supports written_off as a status.
The institution should retain the original loan record, the reason for the action, and any outstanding amount associated with the facility.
Recording these changes
Supported loan status changes are available through the authenticated loan API, including PATCH /api/loans/{loanId}/status.
Institutions should use the current API documentation to confirm permitted transitions, required approvals, and any balance adjustments needed before changing a loan's status.
Changes that affect credit reporting should also be reflected in the applicable bureau workflow.
Related documentation
DocumentationStill need help? Contact Support.