Accept Merchant Offer——Lenders implementation

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 Id that was returned by the provider during “Get Offers” call to them.
3	merchantId	String	20	true	The originating merchantId
4	customerAccountNumber	String	10	true	The customer’s account number
5	customerBankCode	String	5	true	The customer’s account bank code

Endpoint

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

Headers

Sample Request

Sample request

{ "customerId": "2348123456789", "offerId": "8288948", "merchantId" : "3IPG001", "customerAccountNumber": "0123456789", "customerBankCode": "011", }

Response Message  field description

Field #	Field name	Description
1	responseCode	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	The Description of the Response Code from above.
3	loanId	The Id of the accepted loan from the provider

Sample Response (success)

{ "responseCode": "00", "responseMessage": "Successful", "loanId":"0002" }

Sample Response (failure)

{ "responseCode": "4002", "responseMessage": "Offer has expired." }