Accept Offer for Salary Lending<\/h3>\n\n\n\n

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:<\/p>\n\n\n\n

Request Message Description<\/h4>\n\n\n\n

Field#<\/th>	Field name<\/th>	Data type<\/th>	Max length<\/th>	Required<\/th>	Description<\/th><\/tr><\/thead>
1<\/td>	customerId<\/td>	String<\/td>	50<\/td>	true<\/td>	The Email or Mobile Number of the User who is accepting this offer.<\/td><\/tr>
2<\/td>	offerId<\/td>	String<\/td>	50<\/td>	true<\/td>	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.<\/td><\/tr>
3<\/td>	accountNumber<\/td>	Numeric String<\/td>	20<\/td>	true<\/td>	The Account Number to which the loan is to be credited.<\/td><\/tr>
4<\/td>	bankCode<\/td>	Numeric String<\/td>	3<\/td>	true<\/td>	The CBN Bank Code of the Bank holding the Account. E.g 076<\/td><\/tr>
5<\/td>	token<\/td>	Numeric String<\/td>	20<\/td>	true<\/td>	The Payment Card token from which the loan debt will be taken after the due date.<\/td><\/tr>
6<\/td>	loanReferenceId<\/td>	String<\/td>	50<\/td>	true<\/td>	A unique identifier assigned to the loan.<\/td><\/tr>
7<\/td>	borrowerName<\/td>	String<\/td>	50<\/td>	true<\/td>	The customer’s name<\/td><\/tr>
8<\/td>	accountName<\/td>	String<\/td>	50<\/td>	true<\/td>	The customer’s account name<\/td><\/tr>
9<\/td>	companyName<\/td>	String<\/td>	100<\/td>	true<\/td>	The customer’s company name<\/td><\/tr>
10<\/td>	phoneNumber<\/td>	String<\/td>	20<\/td>	true<\/td>	The phone number of the customer in 234 format<\/td><\/tr>
11<\/td>	bvn<\/td>	String<\/td>	11<\/td>	false<\/td>	The customer’s BVN<\/td><\/tr>
12<\/td>	tenure <\/td>	int <\/td>	<\/td>	fales<\/td>	The duration of loan <\/td><\/tr>
13<\/td>	amount<\/td>	double<\/td>	<\/td>	<\/td>	The amount specified for Loan <\/td><\/tr>
14<\/td>	amountPayable <\/td>	long<\/td>	<\/td>	<\/td>	The payable amount after loan collection which include loanAmount + interest <\/td><\/tr>
15<\/td>	interest<\/td>	double <\/td>	<\/td>	<\/td>	The interest amount on loan collected. <\/td><\/tr><\/tbody><\/table>\n\n\n\n Endpoint<\/strong><\/p>\n\n\n\n POST \/endpoint goes here. The Provider is expected to provide this and configured on the ILS Platform.<\/code><\/td><\/tr><\/tbody><\/table>\n\n\n\n Sample Request<\/h5>\n\n\n\n Sample request<\/strong><\/p>\n\n\n\n {<\/code> \"customerId\": \"2348123456789\",<\/code> \"offerId\": \"8288948\",<\/code> \"accountNumber\": \"0123456789\",<\/code> \"bankCode\": \"011\",<\/code> \"providerCode\":\"MKT\",<\/code> \"channelCode\":\"QTUSSD\",<\/code> \"token\": \"5123450558220138603\",<\/code> \"loanSchemeCode\":\"SYZ\",<\/code> \"loanReferenceId\":\"XYZ123465262646469476276572726\",<\/code> \"borrowerName\": \"John Ade\",<\/code> \"accountName\": \"John Ade Umaru\",<\/code> \"companyName\": \"ABC and Co\",<\/code> \"phoneNumber\": \"23480600\",<\/code> \"bvn\": \"1234567890\"<\/code> \"tenure\":30,<\/code> \"amount\":23000,<\/code> \"amountPayable\":26500,<\/code> \"interest\":1.0   <\/code> }<\/code> <\/td><\/tr><\/tbody><\/table>\n\n\n\n Response Message  field description<\/h4>\n\n\n\n Field#<\/th> Field name<\/th> Description<\/th><\/tr><\/thead> 1<\/td> responseCode<\/td> The Code representing the status of the processing of the request. It shows whether the request to accept the offer is allowed or not.<\/td><\/tr> 2<\/td> responseMessage<\/td> The Description of the Response Code from above.<\/td><\/tr> 3<\/td> loanId<\/td> The Id of the accepted loan from the provider<\/td><\/tr><\/tbody><\/table>\n\n\n\n Sample Response (success)<\/h5>\n\n\n\n {<\/code>\"responseCode\"<\/code>: <\/code>\"00\"<\/code>,<\/code>\"responseMessage\"<\/code>: <\/code>\"Successful\"<\/code>,<\/code>\"loanId\"<\/code>:<\/code>\"0002\"<\/code>}<\/code><\/td><\/tr><\/tbody><\/table>\n\n\n\n Sample Response (failure)<\/h5>\n\n\n\n {<\/code>\"responseCode\"<\/code>: <\/code>\"4002\"<\/code>,<\/code>\"responseMessage\"<\/code>: <\/code>\"Offer has expired.\"<\/code>}<\/code><\/td><\/tr><\/tbody><\/table>\n","protected":false},"author":228,"featured_media":0,"parent":2297,"menu_order":7,"comment_status":"open","ping_status":"closed","template":"","meta":{"spay_email":""},"doc_tag":[],"_links":{"self":[{"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/4255"}],"collection":[{"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/users\/228"}],"replies":[{"embeddable":true,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/comments?post=4255"}],"version-history":[{"count":4,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/4255\/revisions"}],"predecessor-version":[{"id":4371,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/4255\/revisions\/4371"}],"up":[{"embeddable":true,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/2297"}],"prev":[{"title":"Appendix","link":"https:\/\/sandbox.interswitchng.com\/docbase\/docs\/ils\/ils-to-providers\/appendix\/","href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/2306"}],"wp:attachment":[{"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/media?parent=4255"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/doc_tag?post=4255"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}