Salary Lending
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"¤cy="566" \
-H "Authorization: <token>" \
-H "Content-Type: application/json" \
-X GET
Response
{
"responseCode": "S201",
"responseMessage": "Salary loan payment notification Successful."
}
Updated 6 months ago