API ReferenceDeveloper ConsoleDeveloper Community

Salary Lending

Suggest Edits

This is an Interswitch lending service (ILS) feature that enables third-party lending providers with the capability to digitize salary loan processing for their customers.

ILS forms a bridge between this channel provider and the lender.

Process Flow

Step 1: Request a salary loan

Request a salary loan for the customer by using the Get Salary Loan endpoint

Request

curl https://sandbox.interswitchng.com/lending-service/api/v1/salary/loan \
-H "Authorization: <token>" \
-H "Content-Type: application/json" \
-d '{
"customerId": "2348161286422",
"channelCode": "APT",
"providerCode": "MKT",
"bankName": "GTBank",
"bankCode": "011",
"accountNumber": "1234567899",
"amount": 100000,
"interest": 11.5,
"amountPayable": 110000,
"tenure": 14,
"loanSchemeCode": "SLY",
"offerId": "ISW8490716851"
}' 
-X GET

Response

{
  "responseCode": "S00",
  "responseMessage": "Salary loan successfully disbursed",
  "transactionRef": "BOL|LOC|CA|FBN|AC|180121151014|9MUN9QE94J",
  "transactionId": "0432529007994",
  "loanId": "APPMRT12345"
}

Step 2: Request loan re-payment from the customer when the due date is reached

Initiate the re-payment using the Salary Loan Repayment Notification Notification endpoint.

Request

curl https://sandbox.interswitchng.com/lending-service/api/v1/salary/notify-payment?customerId="234803058392"&channelCode="QTUSSD"&providerCode="MKT"&amount="10200"&loanId="QTUSSD1894059"&transactionRef="gtb|1232|debit"&currency="566" \
-H "Authorization: <token>" \
-H "Content-Type: application/json" \ 
-X GET

Response

{
  "responseCode": "S201",
  "responseMessage": "Salary loan payment notification Successful."
}

Updated 28 days ago