During the Accept Offer processing, a request will be sent from Interswitch Lending Service to Provider to notify them of the User’s decision. The Request and Response format expected are as follows:

Request Message description

Field #	Field name	Data type	Max length	Required	Description
1	customerId	String	50	true	The Email or Mobile Number of the User who is accepting this offer.
2	offerId	String	50	true	The id of the Offer that is being accepted. This is the code that was returned by the provider during “Get Offers” call to them.
3	destinationAccountNumber	Numeric String	20	true	The Account Number to which the loan is to be credited.
4	destinationBankCode	Numeric String	3	true	The CBN Bank Code of the Bank holding the Account. E.g 076
5	token	Numeric String	20	true	The Payment Card token from which the loan debt will be taken after the due date.
6	loanReferenceId	String	20	true	A unique identifier assigned to the loan.

Endpoint

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

Headers

As a Lender, please note that it is expected you have a basic authentication for each API spec . A sample screen shot is shown below.

Sample Request

Sample request

{ “customerId”: “2348123456789”, “offerId”: “8288948”, “destinationAccountNumber”: “0123456789”, “destinationBankCode”: “011”, “token”: “5123450558220138603” “loanReferenceId”: “XYZ123465262646469476276572726” }

Response Message  field description

Field #	Field name	Data Type	Max Length	Description
1	responseCode	Numeric String	5	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	responseMessage	String	255	The Description of the Response Code from above.
3	loanId	Numeric String	50	The Id of the new loan.

Sample Response (success)

{ “responseCode”: “00”, “responseMessage”: “Successful” “loanId”:”0329” }

Sample Response (failure)

{ “responseCode”: “4002”, “responseMessage”: “Offer has expired.” }