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.

Last reviewed 15 November 2026

Was this article helpful?

Still need help? Contact Support.