SET DATE AND TIME
Last updated: 04-Dec-2024
This command is used to set the device to a specific date and time.
Device UI Required: Yes
Request Packet
| Field | Rule | Type | Min | Max | Value | Comments |
|---|---|---|---|---|---|---|
| FUNCTION_TYPE | Required | Static Value |
|
|
ADMIN | Type of function |
| COMMAND | Required | Static Value |
|
|
SETTIME | Command name |
| TIME | Required | Character | 12 | 14 | This indicates the time. The format would be YYYYMMDDhhmmss. |
|
| CONFIG_TIME | Optional | Boolean |
|
|
0 - Disable 1 - Enable |
Configuring time. If the value is set 1 then the applicationwould take the time from Congiration parameter instead of TIME field. |
| POS_RECON | Optional | Character | 1 | 30 | Ex: RetailPOS1 | POS reconciliation. NOTE: POS Reconciliation field to be echoed back in response to POS. |
| COUNTER | Required | Numeric | 1 | 10 | Ex: 100 | COUNTER is used for a given MAC label. Each COUNTER should be higher than the last one. NOTE: Used to authenticate the POS. |
| MAC | Required | Base64 Encoded Data |
|
|
Message Authentication Code. COUNTER value encrypted by 128-AES MAC_KEY. This value is Base64 encoded. NOTE: Used to authenticate the POS. |
|
| MAC_LABEL | Required | Character | 1 | 50 | Ex: REG1 | Associated label that tells the device which MAC_KEY to use to decrypt the value of MAC. NOTE: Used to authenticate the POS. |
Example
Following is an example of request packet
<TRANSACTION>
<FUNCTION_TYPE>ADMIN</FUNCTION_TYPE>
<COMMAND>SETTIME</COMMAND>
<TIME>20210712091900</TIME>
<POS_RECON>RetailPOS1</POS_RECON>
</TRANSACTION>
Response Packet
| Field | Type | Value | Comments |
|---|---|---|---|
| RESPONSE_TEXT | Character | Ex: Operation Successful | Processor response text |
| RESULT | Character | Ex: OK | This indicates the Result details. |
| RESULT_CODE | Numeric | -1 59001 59003 59006 59040 |
This indicates the result code. NOTE: Refer to Result/Error Codes section. |
| TERMINATION_STATUS | Character | SUCCESS or FAILURE |
This indicates the transaction termination status. This is the overall status of the transaction irrespective of approved or declined. Like, if the output is generated then the status is SUCCESS and if no output is generated then the status will be FAILURE. |
| TIME | Character | Ex: 20160521122005 | Current time in YYYYMMDDhhmmss format. SCA is required to query and return the current date/time after it is set. |
| POS_RECON | Character | Ex: RetailPOS1 | POS reconciliation field echoed back if sent in request. |
| COUNTER | Numeric | Ex: 100 | Echoes COUNTER sent in the request. |
Example
<RESPONSE>
<RESPONSE_TEXT>Operation SUCCESSFUL</RESPONSE_TEXT>
<RESULT>OK</RESULT>
<RESULT_CODE>-1</RESULT_CODE>
<TERMINATION_STATUS>SUCCESS</TERMINATION_STATUS>
<TIME>20210712091900</TIME>
<POS_RECON>RetailPOS1</POS_RECON>
</RESPONSE>
Rate this article:
