Set Time Zone on Card Reader

Code Samples

CWS

Request

PropertyDescription
method
string | required
setTimeZoneOnCardReader
requestId
string | required
Transaction Request ID
targetType
string | required
cardReader
parameters
JSONObject | required
posTimeZone (example: US_EAST)

Response

PropertyDescription
requestId
string
Transaction Request ID
As specified in the request.
statusDetails
string
Request Status
data
JSONObject
Object holding various responses.

Request

{
  "method" : "setTimeZoneOnCardReader",
  "requestId" : "CwsWrapper-9e919507-9438-4dbb-bffb-ac39cf4e67bb",
  "targetType" : "cardReader",
  "version" : "1.0",
  "parameters" : {
    "posTimeZone" : "US_EAST"
  }
}

Response

{
  "requestId" : "CwsWrapper-95f58d1a-acd2-49b2-9281-22cc819cb4ec",
  "statusDetails" : "REQUEST_ACCEPTED",
  "data" : {
    "cardReaderCommand" : {
      "id" : "CwsWrapper-9e919507-9438-4dbb-bffb-ac39cf4e67bb",
      "completed" : true,
      "eventQueue" : [ {
        "timeStamp" : "1684535217363",
        "statusDetails" : "CARD_READER_UPDATE_TIME_ZONE_COMPLETED"
      }, {
        "timeStamp" : "1684535217363",
        "statusDetails" : "SET_TIME_ZONE_SUCCEEDED"
      } ]
    }
  }
}

Java

ECLTimeZone finalTimezone = timezone;
cardReaderInterface.updateTimeZone(timezone, new ECLCardReaderSetTimeZoneOffsetFromUTCListener()
{
    @Override public void deviceOperationCompleted(ECLCardReaderInterface eclCardReaderInterface,
        ECLTransactionProgress eclTransactionProgress)
    {
        displayMessage("Successfully updated timezone on Card Reader to " + finalTimezone.toString());
    }
 
    @Override public void deviceOperationError(ECLCardReaderInterface eclCardReaderInterface, ECCError eccError)
    {
        displayMessage("setTimezoneError: " + eccError.getDebugDescription());
    }
 
    @Override public void deviceOperationProgress(ECLCardReaderInterface eclCardReaderInterface,
        ECLTransactionProgress eclTransactionProgress)
    {
    }
});

C#

string timeZone; // example US_EAST, CA_PACIFIC, ...
 
// Asynchronous
    m_CWS.StartSetTimeZoneOnCardReader(timeZone, ne, completionDelegate);
  
// Synchronous
    SetTimeZoneOnCardReaderResults results = m_CWS.SetTimeZoneOnCardReader(timeZone, MyNotifyCWSEvent);
    MySetTimeZoneOnCardReaderComplete(results);
  
// MultiDevice && Asynchronous
    CWSTransactionWsManager.Instance.StartSetTimeZoneOnCardReader(selectedDeviceSerialNumber, timeZone, ne, completionDelegate);
  
// MultiDevice && Synchronous
    not supported
  
// do something with results
    public void MySetTimeZoneOnCardReaderComplete(SetTimeZoneOnCardReaderResults results)
    {
        Log("----------- SetTimeZoneOnCardReader Complete ------------");
        if (results != null)
        {
            Log(String.Format("Status: {0}", results.StatusDetails));
            Log(String.Format("Completed: {0}", results.Completed));
        }
        else
        {
            Log("NULL RESULT");
        }
    }