CreateSelfServiceLoanProductCommand
Overview​
Creates a new loan product with interest rate configuration, disbursement fee settings, and loan amount limits.
Command Structure​
{
"cmd": "CreateSelfServiceLoanProductCommand",
"data": "{\"name\":\"Personal Loan\",\"code\":\"PERSONAL\",\"currencyCode\":\"NGN\",\"interestRateCalculation\":2,\"interestRate\":3.5,\"disbursementFeeCalculation\":1,\"loanFee\":1.5,\"minimumAmount\":50000,\"maximumAmount\":5000000,\"maximumTenorInDays\":365}"
}
Parameters​
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Display name for the product |
code | string | Yes | Unique product code (used as identifier) |
currencyCode | string | Yes | ISO 4217 currency code (e.g. NGN, USD) |
interestRateCalculation | int | Yes | Interest rate period type (see enum below) |
interestRate | decimal | Yes | Interest rate percentage |
disbursementFeeCalculation | int | Yes | How the disbursement fee is calculated (see enum below) |
loanFee | decimal | Yes | Disbursement fee amount or percentage |
minimumAmount | decimal | No | Minimum loan amount |
maximumAmount | decimal | No | Maximum loan amount |
maximumTenorInDays | int | Yes | Maximum loan duration in days |
interestRateCalculation Enum​
| Value | Description |
|---|---|
0 | Daily |
1 | Weekly |
2 | Monthly |
3 | Yearly |
disbursementFeeCalculation Enum​
| Value | Description |
|---|---|
0 | Flat amount |
1 | Percentage of loan amount |
2 | Percentage of disbursed amount |
Validations​
nameandcodemust be unique — the command returns an error if either already existscurrencyCodecannot be changed after creation
Response​
{
"ok": true,
"statusCode": "00",
"message": "Loan product created successfully.",
"outData": {
"LoanProductId": 5,
"LoanProductName": "Personal Loan",
"LoanProductCode": "PERSONAL"
}
}