This manual specifies API endpoints for ILS Channel Providers to collect payments through Quickteller channels
Loan Status
This is a callback endpoint required to be provided by the channel provider to allow ILS get amount required to be paid back by the customer.
Request Message description
Field#
Field name
Data type
Max length
Required
Description
1
customerId
String
true
The customer’s identification on the channel provider’s system
EndpointEndpoint
GET /endpoint goes here. The Provider is expected to provide thisand configured on the ILS Platform.
HeadersHeaders
Authorization : Bearer {token}
Sample Request
Sample request
?customerId=2348012345678
Response Message field description
Field#
Field name
Data type
1
responseCode
Numeric String
5
true
The Code representing the status of the processing of the request. It shows whether the request to accept the offer is allowed or not.
2
responseMap
String
255
true
The Description of the Response Code from above.
3
loan
Object
An Object containing the details of the loan requested.
3a
reference
String
50
This field is REQUIRED for all loans NOT disbursed through ILS. The Reference is a unique loan identifier and should only be sent for loans that do NOT exist on the ILS platform
3b
status
ENUM
true
The Status of the Loan whether it has been paid or not, overdue or not.
3c
remainingAmount
Long
true
The Amount remaining for the Customer to paid that will make the loan fully paid.
3d
dueDate
Date Time (UTC)
true
The Date/Time at which the Customer is expected to have paid back the loan.