1. Home
  2. Interswitch lending Service
  3. Interswitch Lending Service (Channels)
  4. Get Multiple Provider Offers

Get Multiple Provider Offers

This endpoint is to get offers available to a user/customer from all available providers.

Request Message Description

Field#Field nameData typeMax lengthRequiredDescription
1customerIdString
trueThe Email or Mobile Number of the Customer for which offers are been requested.
2channelCodeString
trueThe Code of the Channel from which this request is originating.
4fullnameString
falseThe Full name of the Customer.
5amountNumeric String
falseThe Amount of Loan that the customer wishes to take (in Kobo).
6serviceTypeString
falseThe service type code

Endpoint

GET /v2/offers?customerId={customerId}&channelCode={channelCode}&amount={amount}&serviceType={serviceType}

Headers

 Authorization: Bearer {{token}}

Sample Request

/v2/offers?customerId=2348123456789&channelCode=0002&amount=5000000&serviceType=LOAN

Response Message  field description

Field#Field nameDescription
1responseCodeThe Code representing the result of the request processing.
2responseMessageThe Description of the responseCode.
4offersArrays of the available offers.
4a.offerId
4b.amountOfferedThe Amount which the Credit Company is ready to loan the customer/user.
4c.interestThe Interest Percentage that applies to the loan.
4d.amountPayableThe Compound Interest which is to be paid by the Customer at the end of the loan tenure.
4e.feesArray of the many fees that applied with the offer.
4f.tenureThe Duration for which the loan is applied. After this duration, the loan is marked as due. (in days)
4g.termsThe Terms and Conditions that applied to the offer.
4h.expiryDateThe Date and Time at which this offer becomes invalid.(UTC)
4i.currencyThe Currency Code of the Amount offered.
5providerThe provider for the specified loan

Sample Response (success)

{
"responseCode": "00",
"offers": [
{
"offerId": "OFFER1511245980103",
"amountOffered": 3500000,
"interest": 15,
"amountPayable": 3875000,
"tenure": 14,
"expiryDate": "2017-06-30T09:24:09Z",
"currency": "566",
"description": "N35000 to pay N3875000 in 14 days",
"provider": {
"code": "MKT",
"name": "MKT Loans",
"description": "MKT"
}
}
]
}

Sample Response (failure)

{
"responseCode": "3001",
"responseMessage": "No offers available",
"offers": []
}

Was this article helpful to you? Yes No

How can we help?