1803 = Display Message (Display Only) - Command 0x1803

81

01

Timeout - 0x00 = Infinite. Device leaves the requested message on the display until the host initiates a change.

B

O

0x00

- All other values = Timeout in seconds for the device to display the message.

82

01

Message ID. Specify a Display String ID from Display Strings.

B

O

0x14

End of any wrappers, at minimum including Request Message

1803 = Display Message (Display Only) - Command 0x1803

No parameters.

End of any wrappers, at minimum including Response Message

1804 = Command 0x1804 -

81

01

Enable - 0x00 = Disable. The device disables the barcode reader. In this case, the device ignores all other parameters. - 0x01 = Enable. The device enables the barcode reader.

B

R

0x00

82

01

Timeout - 0x00 = Infinite. The device leaves the barcode reader enabled until it reads a barcode, or until the host sends this command again to disable the barcode reader. - All other values = Timeout in seconds for the device to leave the barcode reader enabled without reading a barcode.

B

O

0x00

83

01

Encrypt Barcode Data - 0x00 = Do Not Encrypt. The device does not encrypt the barcode data when it sends User Interface Operation Complete. - Notification 0x1805 - 0x01 = Encrypt. The device encrypts the barcode data when it sends User Interface Operation Complete. - Notification 0x1805

B

O

0x00

End of any wrappers, at minimum including Request Message

1804 = Read Barcode (BCR Only) - Command 0x1804

No parameters.

End of any wrappers, at minimum including Response Message

1801 = Request Cardholder Signature (Touch Only) - Command 0x1801

81

01

Timeout — Timeout in seconds that the device should wait for the cardholder to sign and confirm completion.

B

R

82

01

Encryption on signature and user data. 0=disabled, 1=enabled.

B

O

0

A3

var

User data parameters for item #0 to item #3. The maximum total size of 0xA3 TLV is 4,000 bytes. This TLV may be present only if encryption is enabled.

T

O

/81

var

User data item #0, optional

B

O

/82

var

User data item #1, optional

B

O

/83

var

User data item #2, optional

B

O

/84

var

User data item #3, optional

B

O

End of any wrappers, at minimum including Request Message

1801 = Request Cardholder Signature (Touch Only) - Command 0x1801

No parameters.

End of any wrappers, at minimum including Response Message

1821 = Show Image (Display Only) - Command 0x1821

81

01

Custom Idle Page Image Number

• 0x01 = Show custom image 1

• 0x02 = Show custom image 2

• 0x03 = Show custom image 3

B

R

82

01

Display Option

• 0x00 = Default to cover/uncover the top status bar depends on the current status of the display. If the current display shows the top status bar, the Show Image command won’t cover the top status bar. If the current display doesn’t show the top status bar, the Show Image command will cover the top status bar.

• 0x01 = Cover the top status bar regardless of the current status of the display.

• 0x02 = Not cover the top status bar regardless of the current status of the display.

B

O

0

83

01

Display Time

• 0x00 = Show image until device changes state

B

O

0

End of any wrappers, at minimum including Request Message

1821 = Show Image (Display Only) - Command 0x1821

No parameters.

End of any wrappers, at minimum including Response Message

1806 = Command 0x1806 – Personal Info Entry

81

01

Capture Type

0x01 = Phone Number: Capture the phone number 0x02 = Social: Capture the social security number

0x03 = Zip code: Capture the zip code 0x04 = Employee ID: Capture Employee ID number 0x05 = Birth Date: Capture birth date in USA format 0xFF = Cancel Capture: Cancel any of the capture commands

B

R

82

01

Encryption for user data (Optional) 00 – No Encrypt

01 - Encrypt

B

R

Beginning of any wrappers, at minimum including Request Message

1806 = Command 0x1806 – Personal Info Entry

No parameters.

Beginning of any wrappers, at minimum including Response Message

1830 = Display Flexible UI Pages (Display Only) - Command 0x1830

81

01

Display Time

• 0x00 – Infinitive. Device leaves the requested page on the display until the host initiates a change.

• 0x01 to 0xFF = RFU

B

R

82

01

UI page option

• 0x00 – Page with up to 5 lines of text and up to 1 functional button Middle. See Tag A1.

• 0x01 – Page with a title, up to 6 buttons with text, and up to 3 functional buttons. See Tag 83, A2 and A4.

• 0x02 – Page with a title, up to 6 buttons with $Amount, and up to 3 functional buttons. See Tag 83, A3 and A4.

B

R

83

02

Text String ID for a tile of UI page option: 0x01, 0x02, 0x03 See Table 361 – Default User Interface String IDs and Strings If host wants to disable this title, do not include this tag.

B

O

/81

var

Text string (<= 30 characters) for line 1, end with NULL char. If host wants to disable this line, do not include this tag.

B

O

/82

var

Text string (<= 30 characters) for line 2, end with NULL char. If host wants to disable this line, do not include this tag.

B

O

/83

var

Text string (<= 30 characters) for line 3, end with NULL char. If host wants to disable this line, do not include this tag.

B

O

/84

var

Text string (<= 30 characters) for line 4, end with NULL char. If host wants to disable this line, do not include this tag.

B

O

/85

var

Text string (<= 30 characters) for line 5, end with NULL char. If host wants to disable this line, do not include this tag.

B

O

/86

02

Function button Middle option. String ID = Enable functional button Middle with a String ID associated with a configured String message. See Table XXX – Default User Interface String IDs and Strings When user presses this button, device sends notification to the host to indicate the functional button Middle is pressed. See User Interface Host Action Request - Notification 0x1803 If host wants to disable this button, do not include this tag

B

O

A2

var

Button text String ID parameters for UI page option: 0x01 and 0x02. The parameter in this TLV data object allows the host to enable and disable the data base. When user presses any button, device sends notification to the host to indicate which button is pressed. See User Interface Host Action Request - Notification 0x1803

B

O

/81

02

Text String ID for button 1. See Table XXX – Default User Interface String IDs and Strings. If host wants to disable this button, don’t include this tag.

B

O

/82

02

Text String ID for button 2. See Table XXX – Default User Interface String IDs and Strings. If host wants to disable this button, don’t include this tag.

B

O

/83

02

Text String ID for button 3. See Table XXX – Default User Interface String IDs and Strings. If host wants to disable this button, don’t include this tag.

B

O

/84

02

Text String ID for button 4. See Table XXX – Default User Interface String IDs and Strings. If host wants to disable this button, don’t include this tag.

B

O

/85

02

Text String ID for button 5. See Table XXX – Default User Interface String IDs and Strings. If host wants to disable this button, don’t include this tag.

B

O

/86

02

Text String ID for button 6. See Table XXX – Default User Interface String IDs and Strings. If host wants to disable this button, don’t include this tag.

B

O

A3

var

Button $Amount parameters for UI page option: 0x01, 0x02 The parameter in this TLV data object allows the host to enable and disable the data base for UI page option 0x01 and 0x02 When user presses any button, device sends notification to the host to indicate which amount button is pressed. See User Interface Host Action Request - Notification 0x1803

B

O

/81

04

Value $Amount for button 1. If host wants to disable this button, don’t include this tag.

B

O

/82

04

Value $Amount for button 2. If host wants to disable this button, don’t include this tag.

B

O

/83

04

Value $Amount for button 3. If host wants to disable this button, don’t include this tag.

B

O

/84

04

Value $Amount for button 4. If host wants to disable this button, don’t include this tag.

B

O

/85

04

Value $Amount for button 5. If host wants to disable this button, don’t include this tag.

B

O

/86

04

Value $Amount for button 6. If host wants to disable this button, don’t include this tag.

B

O

A4

var

Functional buttons parameters for UI page option: 0x01 and 0x02. The parameter in this TLV data object allows the host to enable and disable the data base. When user presses any button, the device sends notification to the host to indicate which functional button is pressed. See User Interface Host Action Request - Notification 0x1803

B

O

/81

03

Text String ID and color option for functional button Left. See Table XXX – Default User Interface String IDs and Strings. Byte 0-1: String ID Byte 2: color option 0x00 = red 0x01 = green 0x02 = yellow If host wants to disable this button, don’t include this tag.

B

O

/82

03

Text String ID and color option for functional button Middle. See Table XXX – Default User Interface String IDs and Strings. Byte 0-1: String ID Byte 2: color option 0x00 = red 0x01 = green 0x02 = yellow If host wants to disable this button, don’t include this tag.

B

O

/83

03

Text String ID and color option for functional button Right. See Table XXX – Default User Interface String IDs and Strings. Byte 0-1: String ID Byte 2: color option 0x00 = red 0x01 = green 0x02 = yellow If host wants to disable this button, don’t include this tag.

B

O

A5

var

Parameters for UI page option 0x03 The parameter in this TLV data object allow the host to enable and disable the data base

B

O

/81

02

Text String ID for green functional button Right. See Table XXX – Default User Interface String IDs and Strings. When user presses this button, device sends notification to the host to indicate the functional button Right is pressed. See User Interface Host Action Request - Notification 0x1803 If host wants to disable this button, don’t include this tag.

B

O

/82

02

X Position. If host wants device to display the image in the center of the loading image area, don’t include this tag.

B

O

/83

02

Y Position. If host want device to display the image in the center of the loading image area, don’t include this tag Note: Y pos >= 50px Y pos + Image Height <= 190px Landscape Screen Orientation Y pos + Image Height <= 270px Portrait Screen Orientation

B

O

/84

var

Bitmap Image encoded in full BMP file format as defined by Microsoft (e.g, starting with “BM”) Image Width Max = 320px Landscape Screen Orientation Image Height Max = 140px Landscape Screen Orientation Image Width Max = 240px Portrait Screen Orientation Image Height Max = 220px Portrait Screen Orientation

B

O

/85

var

Bottom left corner option Byte 0 = option

• 0x00 = Disable

• 0x01 = show Device Serial Number

• 0x02 = show text

B

0

A8

Var

Parameters for UI page option 0x06

B

O

/81

2

Image X position (omit for default centered position)

B

O

/82

2

Image Y position (omit for default centered position)

B

O

/83

1

Image ID (for image stored on device). Value is 0-3 for the 4 available image ‘slots’. Must be signed image for touch notifications to be sent. Cannot be used in the same command as /84.

B

O

/84

var

Image data. Image encoded in full BMP file format as defined by Microsoft (e.g, starting with “BM”) OR contents of .bin file for Magtek signed image file. Must be signed .bin data for touch notifications to be sent. Cannot be used in the same command as /83.

B

O

End of any wrappers, at minimum Response Message

1830 = Display Flexible UI Pages (Display Only) - Command 0x1830

No parameters

End of any wrappers, at minimum including Response Message

81

01

Display Time

• 0x00 – Infinite. Device leaves the requested page on the display until the host initiates a change.

B

R

82

01

UI page option

• 0x00 – Enter Sale Amount page. Device responds with User Interface Host Action Request with ‘Touchscreen, $Amount button selected’ content - Notification 0x1803.

B

R

/83

<= 254

URL

URL to use as card data. Required when starting card emulation. Optional and ignored if canceling emulation. Example: https://www.magtek.com/

O/R

1806 = Personal Info Entry - Command 0x1806

81

01

Capture Type: 0x01 = Phone Number; 0x02 = Social; 0x03 = Zip code; 0x04 = Employee ID; 0x05 = Birth Date (USA format); 0xFF = Cancel Capture

B

R

Beginning of any wrappers, at minimum including Request Message

1806 = Personal Info Entry - Command 0x1806

No parameters.

Beginning of any wrappers, at minimum including Response Message

1823 = Show Bitmap Image (Display Only) - Command 0x1823

81

01

Display Time: 0x00 = Indefinite; 0x01 to 0xFF = 1 to 255 seconds

B

O

0x00

82

03

Background Color. Use RRGGBB format.

B

O

N/A

83

02

X Position.

The device places the left edge of the image at this pixel position relative to the left edge of the display, which is position 0x0000. This parameter plus the pixel width of the image must be less than the pixel width of the display. The display’s pixel width depends on the device’s orientation set by Custom Idle Page Image Device Locked (Display Only) - Property 1.2.3.1.1.2. For information about the resolution of the display, see the specifications in the device’s Installation and Operation Manual.

B

O

Centered

84

02

Y Position.

The device places the top edge of the image at this pixel position relative to the top edge of the display, which is position 0x0000. This parameter plus the pixel height of the image must be less than the pixel height of the display. The display’s pixel height depends on the device’s orientation set by Custom Idle Page Image Device Locked (Display Only) - Property 1.2.3.1.1.2. For information about the resolution of the display, see the specifications in the device’s Installation and Operation Manual.

B

O

Centered

85

var

Bitmap

Image encoded in full BMP file format as defined by Microsoft (e.g., starting with “BM”) or Magtek signed image file format

B

R

86

01

Display Option:

• 0x00 = Default (cover/uncover the top status bar depends on the current status of the display). If the current display shows the top status bar, the Show Bitmap Image command won’t cover the top status bar. If the current display doesn’t show the top status bar, the Show Bitmap Image command will cover the top status bar.

• 0x01 = Cover the top status bar regardless of the current status of the display.

• 0x02 = Not cover the top status bar regardless of the current status of the display.

B

O

0

End of any wrappers, at minimum including Request Message

1823 = Show Bitmap Image (Display Only) - Command 0x1823

No parameters.

End of any wrappers, at minimum including Response Message

1822 = Show QR Code (Display Only) - Command 0x1822

81

01

Display Time - 0x00 = Indefinite - 0x01 to 0xFF = 1 to 255 seconds

B

O

0x00

82

var

Data to Encode — See ISO/IEC 18004:2015

B

R

83

01

Error Correction - 0x00 = Low - 0x01 = Medium - 0x02 = Quartile - 0x03 = High See ISO/IEC 18004:2015

B

O

0x00

84

01

Mask Pattern - 0x00 to 0x07 = Mask Pattern - 0xFF = Device Select Optimal Mask Pattern — See ISO/IEC 18004:2015

B

O

0xFF

85

01

Minimum Version — Must be less than or equal to Maximum Version - 0x01 to 0x28 = Version 1 to Version 40 — See ISO/IEC 18004:2015

B

O

0x01

86

01

Maximum Version — Must be greater than or equal to Minimum Version - 0x01 to 0x28 = Version 1 to Version 40

See ISO/IEC 18004:2015

B

O

0x28

87

03

Block Color — Use RRGGBB format.

B

O

0x000000 (Black)

88

03

Background Color — Use RRGGBB format.

B

O

0xFFFFFF (White)

89

var

Prompt

Text for the device to display below the QR code. Because the device shows the Prompt using a proportional font, the maximum length that fits the display depends on the text and the device’s orientation set by Property 1.2.3.1.1.2 Custom Idle Page Image Device Locked (Display Only). In Landscape orientation, the upper limit is approximately 30 characters. In Portrait orientation, the limit is approximately 22 characters.

B

)

No prompt

End of any wrappers, at minimum including Request Message

1822 = Show QR Code (Display Only) - Command 0x1822

No parameters

End of any wrappers, at minimum including Request Message

1807 = LED Control - ‎Command 0x1807 –

81 bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb

02

Byte 1 - User Control LED

• 0x00 – Stop User Control LED. This will stop User control LED and resume the current system’s LED status.

• 0x01 – Start User Control LED.

Byte 2 – Duration in unit of second

B

R

82

02

Byte 1 - LED number

• Bit 1 = LED 1

• Bit 2 = LED 2

• Bit 3 = LED 3

B

R

End of any wrappers, at minimum including Request Message

No parameters.

End of any wrappers, at minimum including Response Message