Cosmic Module

O

Qubits of DPK

March 23, 2026

Core Open Source

What This Module Is (Big Picture)

The collateral module manages assets pledged by borrowers to secure loans.
Collateral reduces the lender’s risk because the borrower promises an asset that can be claimed if the loan is not repaid.
Examples of collateral include:
  • property
  • vehicles
  • jewelry
  • equipment
  • savings accounts
  • other valuable assets
The system tracks these assets and links them to loans.

Layman Example

Customer applies for a loan of ₹50,000.
The bank requires collateral.
Customer provides:
Motorcycle worth ₹60,000.
If the borrower fails to repay the loan, the bank can claim the collateral asset.
The fineract-collateral module tracks these pledged assets.

Where the Code Lives

Key Package

org.apache.fineract.portfolio.collateral
Responsibilities include:
  • defining collateral types
  • recording borrower collateral
  • linking collateral to loans
  • validating collateral value

Core Domain Entity:

Collateral.java

Path
fineract-collateral/src/main/java/org/apache/fineract/portfolio/collateral/domain/Collateral.java
This entity represents an asset pledged against a loan.

Key fields on

Collateral

Collateral Types

Collateral types define categories of assets accepted by the bank.
Examples:
These types are configured in the system.

Core Entity:

CollateralType.java

Path
fineract-collateral/src/main/java/org/apache/fineract/portfolio/collateral/domain/CollateralType.java
This entity defines categories of collateral assets.

Key fields on

CollateralType

Collateral Valuation

Collateral must be evaluated to determine whether it sufficiently covers the loan.
Example
Loan amount = ₹50,000
Collateral provided:
Gold value = ₹60,000
Collateral coverage = sufficient.

Example Collateral Validation Code

java
QUBITS OF DPK
1public boolean isCollateralSufficient(BigDecimal loanAmount, BigDecimal collateralValue) {
2    return collateralValue.compareTo(loanAmount) >= 0;
3}
This verifies that collateral value is enough to secure the loan.

Linking Collateral to Loans

Collateral records are linked to a loan account.
Relationship
Loan
↓
Collateral
↓
Asset
This allows the system to track which asset secures which loan.

API Layer

Main controller
CollateralApiResource
Example endpoints
plain text
QUBITS OF DPK
1GET  /v1/loans/{loanId}/collaterals
2POST /v1/loans/{loanId}/collaterals
3PUT  /v1/loans/{loanId}/collaterals/{collateralId}
4DELETE /v1/loans/{loanId}/collaterals/{collateralId}
These APIs allow administrators to:
  • add collateral
  • update collateral information
  • remove collateral
  • retrieve collateral records

Read Services

Read services retrieve collateral information.
Examples include:
  • retrieving collateral for a loan
  • retrieving collateral types
  • retrieving collateral valuation
These are used during loan approval and review.

Write Services

Write services manage collateral data.
Responsibilities include:
  • creating collateral records
  • linking collateral to loans
  • updating collateral values
  • releasing collateral after loan closure

Repository Layer

Exceptions

These ensure collateral information is valid.

How It All Connects (Full Flow)

Example: Adding collateral during loan approval
java
QUBITS OF DPK
1Loan Service
2    │ Loan application
3    ▼
4Collateral Service
5    │ Add collateral asset
6    ▼
7Collateral Validation
8    │ check asset value
9    ▼
10Database (collateral table)

Why This Module Matters

Collateral helps financial institutions:
  • reduce loan risk
  • secure large loans
  • recover funds in case of default
It provides asset-backed security for lending operations.

One-Sentence Summary

fineract-collateral manages assets pledged by borrowers to secure loans and reduce lending risk.