Logon

You can perform a log on request using the REST API for Oracle Retail EFTLink.

Note:

A logon request must always be the first interation with EFTLink as this allows EFTLink to initialize the Core. The initialization process may involve actually logging on to a device but the primary purpose is to instantiate the Core for use.

To perform a log on request: URL:

URL:  wss://localhost:8443/logon

Sample request from client:

{
       "RequestType":"LOGIN",
       "ApplicationSender":"XSTORE",
       "WorkstationID":"1",
       "POSdata":
       {
                "LanguageCode":"en",
                "StoreID":"101",
                "TransactionNumber":"1"
       }
}

This will then be converted to the following IFSF XML request and sent over the SSL socket channel 0:

<?xml version="1.0" encoding="UTF-8"?>
<ServiceRequest RequestID="1" WorkstationID="1" ApplicationSender="XSTORE" RequestType="Login">
   <POSdata LanguageCode="en">
   <StoreID>101</StoreID>
  </POSdata>
</ServiceRequest>
15:36:54,494 [Service handler[3]] (log.EPSLogger:733) INFO  - 2460 received from 10100/65141-TLS:
<?xml version="1.0" encoding="UTF-8"?>

Sample response from EFTLink sent back to channel 0:

<?xml version="1.0" encoding="UTF-8"?>
<ServiceResponse RequestID="1" WorkstationID="1" OverallResult="Success" ApplicationSender="XSTORE" RequestType="Login">
<CommsErrorMessage>Certificates are valid</CommsErrorMessage>
                  	<Certificates Expired="False">
                          	<ValidTo>261220</ValidTo>
                  	</Certificates>
                </ServiceResponse>

This will then be converted to the following JSON response to the thin client application:

{
   "RequestType":"LOGIN",
   "ApplicationSender":"XSTORE",
   "WorkstationID":"1", 
   "RequestID":"1",
   "OverallResult":"Success", 
   "CommsErrorMessage":"Certificates are valid",
   "Certificates": {
	     "Expired": "false",
	     "ValidTo": "261220"
   }
   "success":true4
}