This Service receives a Transaction Notification response from a Value Financing Channel (such as Webpay). Subsequently, it is expected to send a request down to the Provider to notify them of the final status of the transaction. The Provider is in-turn expected to return a response acknowledging receipt of the request.<\/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>	requestCode<\/td>	String<\/td>	<\/td>	true<\/td>	The request code indicating the status of the loan application<\/td><\/tr>
2<\/td>	requestMessage<\/td>	String<\/td>	<\/td>	true<\/td>	The description of the requestCode. <\/td><\/tr>
3<\/td>	loanId<\/td>	String<\/td>	50<\/td>	true<\/td>	The Id of the accepted loan from the provider<\/td><\/tr>
4<\/td>	customerId<\/td>	String<\/td>	50<\/td>	true<\/td>	The Mobile Number of the User who is requesting the loan. <\/td><\/tr>
5<\/td>	customerRef <\/td>	string<\/td>	<\/td>	Optional <\/td>	Customer reference number <\/td><\/tr>
6<\/td>	loanStatus<\/td>	ENUM<\/td>	<\/td>	true<\/td>	The Status of the Loan whether it is successful or not. Expected values are “OPEN” or “FAILED”<\/td><\/tr>
7<\/td>	amount<\/td>	long<\/td>	<\/td>	true<\/td>	The loan amount<\/td><\/tr>
8<\/td>	transactionRef <\/td>	String<\/td>	50<\/td>	true<\/td>	Transaction Id generated by lending service to the downstream payment service. To be used for investigating the transaction.<\/td><\/tr>
9<\/td>	paymentRef <\/td>	String<\/td>	50<\/td>	false<\/td>	The Reference to the payment that was done. This can be used by the Provider to do dispute settlement or investigate.<\/td><\/tr>
10<\/td>	paymentDate<\/td>	Date Time (UTC)<\/td>	<\/td>	true<\/td>	The Date\/Time at which merchant was paid for the service for which the customer requested the loan.<\/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 { \u00a0\u00a0\u00a0 “customerId”:\u00a0“2348067517051”, \u00a0\u00a0\u00a0 “customerRef”:\u00a0“2348067517051”, \u00a0\u00a0\u00a0 “loanId”:\u00a0“BC7KL0000002”, \u00a0\u00a0\u00a0 “amount”:\u00a020000, \u00a0\u00a0\u00a0 “loanStatus”:\u00a0“OPEN”, \u00a0\u00a0\u00a0 “transactionRef”:\u00a0“zyPodVNkzNIvQ0F3ePcxzOKi4”, \u00a0\u00a0\u00a0 “paymentRef”:\u00a0“KSB|WEB|MX1065|07-02-2023|976453665|122316”, \u00a0\u00a0\u00a0 “paymentDate”:\u00a0“2023-02-07T10:54:02.020+00:00”, \u00a0\u00a0\u00a0 “requestCode”:\u00a0“00”, \u00a0\u00a0\u00a0 “requestMessage”:\u00a0“Approved\u00a0by\u00a0Financial\u00a0Institution” } <\/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 response message code<\/td><\/tr> 2<\/td> responseMessage<\/td> The message description for the response<\/td><\/tr><\/tbody><\/table>\n\n\n\n Sample Response (success)<\/h5>\n\n\n\n {<\/code>\"responseCode\"<\/code>: 00,<\/code>\"responseMessage\"<\/code>: <\/code>\"Successful\"<\/code>}<\/code><\/td><\/tr><\/tbody><\/table>\n\n\n\n Sample Response (failure)<\/h5>\n\n\n\n {<\/code>\"responseCode\"<\/code>: 500,<\/code>\"responseMessage\"<\/code>: <\/code>\"Something we wrong\"<\/code>}<\/code><\/td><\/tr><\/tbody><\/table>\n","protected":false},"author":228,"featured_media":0,"parent":2944,"menu_order":4,"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\/4304"}],"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=4304"}],"version-history":[{"count":2,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/4304\/revisions"}],"predecessor-version":[{"id":4429,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/4304\/revisions\/4429"}],"up":[{"embeddable":true,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/2944"}],"next":[{"title":"Accept merchant offer","link":"https:\/\/sandbox.interswitchng.com\/docbase\/docs\/ils\/value-financing\/accept-merchant-offer\/","href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/4388"}],"prev":[{"title":"Tokenization Using Hosted Fields","link":"https:\/\/sandbox.interswitchng.com\/docbase\/docs\/ils\/value-financing\/tokenization-using-hosted-fields\/","href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/3006"}],"wp:attachment":[{"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/media?parent=4304"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/doc_tag?post=4304"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}