This endpoint is to get offers available to a user/customer from all available providers.
Request Message Description
Field# | Field name | Data type | Max length | Required | Description |
---|---|---|---|---|---|
1 | customerId | String | true | The Email or Mobile Number of the Customer for which offers are been requested. | |
2 | channelCode | String | true | The Code of the Channel from which this request is originating. | |
4 | fullname | String | false | The Full name of the Customer. | |
5 | amount | Numeric String | false | The Amount of Loan that the customer wishes to take (in Kobo). | |
6 | serviceType | String | false | The 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 name | Description |
---|---|---|
1 | responseCode | The Code representing the result of the request processing. |
2 | responseMessage | The Description of the responseCode. |
4 | offers | Arrays of the available offers. |
4a. | offerId | |
4b. | amountOffered | The Amount which the Credit Company is ready to loan the customer/user. |
4c. | interest | The Interest Percentage that applies to the loan. |
4d. | amountPayable | The Compound Interest which is to be paid by the Customer at the end of the loan tenure. |
4e. | fees | Array of the many fees that applied with the offer. |
4f. | tenure | The Duration for which the loan is applied. After this duration, the loan is marked as due. (in days) |
4g. | terms | The Terms and Conditions that applied to the offer. |
4h. | expiryDate | The Date and Time at which this offer becomes invalid.(UTC) |
4i. | currency | The Currency Code of the Amount offered. |
5 | provider | The 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": []
}