Sign in

v1

latestOpenAPI 3.1.02026-07-26290731.0 KB

Get Offer - ILS Call to Providers

During the Get Offer processing, a request will be sent from Interswitch Lending Service to Provider to get the offers the Provider has for a User.

post/POST /endpoint goes here. The Provider is expected to provide this and configured on the ILS Platform.

Query parameters

customerIDstring

The Email or Mobile Number of the User who is accepting this offer.

channelCodestring

The Code of the Channel from which request is coming from.

amountinteger

The Amount of Loan that the Customer wish to take. This can be used to determine the offers that will be returned.

accountNumberstring

The Customer's account number

bvnstring

The Customer's bvn

dateOfBirthstring

The Customer's date of birth

serviceTypestring

The loan type being requested by the Customer

bankCodestring

The bank code of the related customer's account

Response

200

OR

Example response

{
  "responseCode": "00",
  "responseMessage": "Successful",
  "customerTcl": 4500,
  "offers": [
    {
      "offerId": "0001",
      "amountOffered": 100000,
      "interest": 10,
      "amountPayable": 110000,
      "fees": [
        {
          "name": "Tax",
          "amount": 100
        }
      ],
      "tenure": 30,
      "terms": "Please read the terms and conditions on https://onefi.com/terms",
      "expiryDate": "2017-06-12T11:46:15Z",
      "currency": "566",
      "repaymentModel": {
        "name": "INSTALMENT",
        "repaymentFrequency": [
          {
            "frequency": 30,
            "frequencyAmount": 76300000
          }
        ]
      }
    }
  ]
}