Submit Loan Application

Submits a loan application for a customer. When the customer is given as nuban, the loan is paid out to that savings account on Disburse Loan to Savings; with a clientId, send linkedNuban for that. The response carries the new loan's loanAccountNo, which identifies the loan in every other request.

The customer is named with exactly one of clientId or nuban (the number of one of the customer's savings accounts). With a clientId, linkedNuban must be an account of that customer, otherwise the request is refused with 403.

Request Body

Field Name	Type	Required	Description
`clientId`	integer	FALSE	The customer's client id. Required if `nuban` is not sent.
`nuban`	string	FALSE	NUBAN of one of the customer's savings accounts. Required if `clientId` is not sent.
`linkedNuban`	string	FALSE	Savings account to pay the loan out to when the customer is given as `clientId`. Must belong to that customer.
`productId`	integer	TRUE	Loan product.
`principal`	number	TRUE	Amount applied for. Must be 0.01 or greater.
`loanTermFrequency`	integer	TRUE	Length of the loan, in units of `loanTermFrequencyType`.
`loanTermFrequencyType`	integer	TRUE	Unit of the loan term: 0 days, 1 weeks, 2 months, 3 years.
`numberOfRepayments`	integer	TRUE	Number of repayments.
`repaymentEvery`	integer	TRUE	Time between repayments, in units of `repaymentFrequencyType`.
`repaymentFrequencyType`	integer	TRUE	Unit between repayments: 0 days, 1 weeks, 2 months.
`expectedDisbursementDate`	string	TRUE	Format yyyy-MM-dd.
`interestRatePerPeriod`	number	FALSE	Interest rate per period.
`amortizationType`	integer	FALSE	0 equal principal payments, 1 equal installments.
`interestType`	integer	FALSE	0 declining balance, 1 flat.
`interestCalculationPeriodType`	integer	FALSE	0 daily, 1 same as the repayment period.
`transactionProcessingStrategyCode`	string	FALSE	How repayments are applied.
`submittedOnDate`	string	FALSE	Format yyyy-MM-dd. Defaults to today.
`loanType`	string	FALSE	Defaults to `individual`.
`externalId`	string	FALSE	Your own reference for the loan.

Response Body

Field Name	Type	Description
`loanAccountNo`	string	Account number of the loan.
`loanId`	integer	Internal loan id.
`clientId`	integer	Customer the loan belongs to.
`resourceId`	integer	Id of what was created or changed.
`changes`	object	The fields that changed.
`commandId`	integer	Present instead of the change when the operation is waiting for approval.

Request

Authorization

OAuth 2.0

Client Credentials

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Token URL: {{tpGatewayHostUrl}}/security/authenticate

Body Params application/json

Example

{
  "nuban": "0000000206",
  "productId": 1,
  "principal": 50000,
  "loanTermFrequency": 6,
  "loanTermFrequencyType": 2,
  "numberOfRepayments": 6,
  "repaymentEvery": 1,
  "repaymentFrequencyType": 2,
  "interestRatePerPeriod": 2,
  "amortizationType": 1,
  "interestType": 0,
  "interestCalculationPeriodType": 1,
  "expectedDisbursementDate": "2026-11-10",
  "externalId": "LN-2026-0001"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Application submitted

application/json

Application submitted

Bodyapplication/json

Example

{
  "officeId": 1,
  "clientId": 42,
  "loanId": 7,
  "loanAccountNo": "000000059",
  "resourceId": 7
}

🟠400Validation failed

🟠401The merchant's account has not been granted this operation,

🟠403`linkedNuban` is not the customer's account, or your API use

🟠404Not found

🔴500The request could not be completed

Request Body#

Response Body#

Request

Request Code Samples

Responses

Request Body

Response Body