> For the complete documentation index, see [llms.txt](https://developer.magtek.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.magtek.com/api-and-command-reference/scra-dynafamily-programmers-manual/configuration/device-settings-property-group-1.2.nnnn/user-interface-settings-property-subgroup-1.2.3.nnn-a.md).

# User Interface Settings - Property Subgroup 1.2.3.nnn - A

## Table - Property 1.2.3.1.1.1 Custom Idle Page Image (Display Only)

<table data-header-hidden><thead><tr><th width="208.6666259765625" valign="top"></th><th></th></tr></thead><tbody><tr><td valign="top">Property Description</td><td></td></tr><tr><td valign="top">Property OID</td><td>1.2.3.1.1.1 / 0x010203010101</td></tr><tr><td valign="top">Name</td><td>Custom Idle Page Image</td></tr><tr><td valign="top"><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p>Description</p></td><td><p>The device uses this property to set which custom image it displays when idle. If the selected image does not exist, the device falls back to showing text. This property does not take effect instantly; it takes effect the next time the device transitions to idle (for example, after a transaction or after resetting).</p><p> </p><p>·         0x00 = Show text “Welcome”</p><p>·         0x01 = Show custom image 1</p><p>·         0x02 = Show custom image 2</p><p>·         0x03 = Show custom image 3</p><p>·         0x04 = Show custom image 4</p><p> </p><p>To use this feature, the host must first load an image into the selected slot using Command 0xD812 - Start Send File to Device (Unsecured). Images must be BMP format, 160KB or smaller with no compression, maximum 320px by 240px, with color depth 16 color, 256 color, 16-bit color, 24-bit color. Images smaller than the maximum size are centered on the display. Note images at full screen size must be 16-bit color or lower to meet the size requirement.</p></td></tr><tr><td valign="top">Securing Key</td><td>None</td></tr><tr><td valign="top">Min. Len (b)</td><td>1</td></tr><tr><td valign="top">Max. Len (b)</td><td>1</td></tr><tr><td valign="top">Data Type</td><td>Binary</td></tr><tr><td valign="top">Valid Values</td><td>Any number</td></tr><tr><td valign="top">Default</td><td>0x00</td></tr></tbody></table>

## Table - Get Request Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top"><p>AA 00 81 04 01 5E D1 01 84 1A D1 01 81 07 2B 06 01 04 01 F6 09 85 01 01 89 0A E2 08 E3 06 E1 04</p><p>E1 02 C1 00</p></td></tr></tbody></table>

## Table - Get Response Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top"><p>AA 00 81 04 82 5E D1 01 82 04 00 00 00 00 84 82 00 1B D1 01 81 07 2B 06 01 04 01 F6 09 85 01 01</p><p>89 0B E2 09 E3 07 E1 05 E1 03 C1 01 03</p></td></tr></tbody></table>

## Table - Set Request Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top"><p>AA 00 81 04 01 5D D1 11 84 1B D1 11 81 07 2B 06 01 04 01 F6 09 85 01 01 89 0B E2 09 E3 07 E1 05</p><p>E1 03 C1 01 03</p></td></tr></tbody></table>

## Table - Set Response Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top"><p>AA 00 81 04 82 5D D1 11 82 04 00 00 00 00 84 82 00 1B D1 11 81 07 2B 06 01 04 01 F6 09 85 01 01</p><p>89 0B E2 09 E3 07 E1 05 E1 03 C1 01 03</p></td></tr></tbody></table>

## Table - Property 1.2.3.1.1.2 Custom Idle Page Image Device Locked (Display Only)

<table data-header-hidden><thead><tr><th valign="top"></th><th></th></tr></thead><tbody><tr><td valign="top">Property Description</td><td></td></tr><tr><td valign="top">Property OID</td><td>1.2.3.1.1.2 / 0x010203010102</td></tr><tr><td valign="top">Name</td><td>Custom Idle Page Image Device Locked</td></tr><tr><td valign="top"><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p>Description</p></td><td><p>The device uses this property to set which custom image it displays when idle and locked. If the selected image does not exist, the device falls back to showing text. This property does not take effect instantly; it takes effect the next time the device transitions to idle (for example, after a transaction or after resetting). See Device Lock Feature for more information.</p><p>·         0x00 = Show text “Welcome” “Device is Locked”</p><p>·         0x01 = Show custom image 1</p><p>·         0x02 = Show custom image 2</p><p>·         0x03 = Show custom image 3</p><p>·         0x04 = Show custom image 4</p><p> </p><p>To use this feature, the host must first load an image into the selected slot using Command 0xD812 - Start Send File to Device (Unsecured). Images must be BMP format, 160KB or smaller with no compression, maximum 320px by 240px, with color depth 16 color, 256 color, 16-bit color, 24-bit color. Images smaller than the maximum size are centered on the display. Note images at full screen size must be 16-bit color or lower to meet the size requirement.</p></td></tr><tr><td valign="top">Securing Key</td><td>None</td></tr><tr><td valign="top">Min. Len (b)</td><td>1</td></tr><tr><td valign="top">Max. Len (b)</td><td>1</td></tr><tr><td valign="top">Data Type</td><td>Binary</td></tr><tr><td valign="top">Valid Values</td><td>Any number</td></tr><tr><td valign="top">Default</td><td>0x00</td></tr></tbody></table>

## Table - Get Request Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA00 8104 0155D101 840F D101 8501 01 8704 02030101 8902 C200</td></tr></tbody></table>

## Table - Get Response Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA00 81 04 8255D101 82 04 00000000 84 820010 D101 85 01 01 87 04 02030101 89 03 C2 01 00</td></tr></tbody></table>

## Table - Set Request Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA00 81040155D111 8410 D111 8501 01 8704 02030101 8903 C201 00</td></tr></tbody></table>

## Table - Set Response Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA00 81 04 8255D111 82 04 00000000 84 820010 D111 85 01 01 87 04 02030101 89 03 C2 01 00</td></tr></tbody></table>

## Table - Property 1.2.3.1.2.1 Display Orientation (Display Only)

<table data-header-hidden><thead><tr><th width="208" valign="top"></th><th></th></tr></thead><tbody><tr><td valign="top">Property Description</td><td></td></tr><tr><td valign="top">Property OID</td><td>1.2.3.1.2.1 / 0x010203010201</td></tr><tr><td valign="top">Name</td><td>Display Orientation</td></tr><tr><td valign="top"><p> </p><p> </p><p>Description</p></td><td>The device uses this property to set the orientation of the display. There are four modes: Landscape with magnetic stripe reader (MSR) on the top, Landscape with MSR on the bottom, Portrait with MSR on the right, and Portrait with MSR on the left. This property does not take effect immediately, it takes effect the next time the device transitions to idle (for example, after a transaction or after power cycle / reset).</td></tr><tr><td valign="top">Securing Key</td><td>None</td></tr><tr><td valign="top">Min. Len (b)</td><td>1</td></tr><tr><td valign="top">Max. Len (b)</td><td>1</td></tr><tr><td valign="top">Data Type</td><td>Binary</td></tr><tr><td valign="top"><p> </p><p>Valid Values</p></td><td><p>0x00 = Landscape with MSR on Top 0x01 = Portrait with MSR on Right 0x02 = Portrait with MSR on Left</p><p>0x03 = Landscape with MSR on Bottom</p></td></tr><tr><td valign="top">Default</td><td>0x00</td></tr></tbody></table>

## Table - Get Request Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top"><p>AA 00 81 04 01 5E D1 01 84 1A D1 01 81 07 2B 06 01 04 01 F6 09 85 01 01 89 0A E2 08 E3 06 E1 04</p><p>E2 02 C1 00</p></td></tr></tbody></table>

## Table - Get Response Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top"><p>AA 00 81 04 82 5E D1 01 82 04 00 00 00 00 84 82 00 1B D1 01 81 07 2B 06 01 04 01 F6 09 85 01 01</p><p>89 0B E2 09 E3 07 E1 05 E2 03 C1 01 00</p></td></tr></tbody></table>

## Table - Set Request Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top"><p>AA 00 81 04 01 5D D1 11 84 1B D1 11 81 07 2B 06 01 04 01 F6 09 85 01 01 89 0B E2 09 E3 07 E1 05</p><p>E2 03 C1 01 01</p></td></tr></tbody></table>

## Table - Set Response Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top"><p>AA 00 81 04 82 5D D1 11 82 04 00 00 00 00 84 82 00 1B D1 11 81 07 2B 06 01 04 01 F6 09 85 01 01</p><p>89 0B E2 09 E3 07 E1 05 E2 03 C1 01 01</p></td></tr></tbody></table>

## Table - Property 1.2.3.1.2.3 Send UI Notifications Along with Showing Message on the Display (Display Only)

<table data-header-hidden><thead><tr><th width="178.54547119140625"></th><th></th></tr></thead><tbody><tr><td>Property Description</td><td></td></tr><tr><td>Property OID</td><td>1.2.3.1.2.3 / 0x010203010203</td></tr><tr><td>Name</td><td>Send UI notifications along with showing message on the display</td></tr><tr><td>Description</td><td>This property is used to enable/disable the device to send UI notifications to the Host (similars to non-display device) in addition to showing UI message on the display device.</td></tr><tr><td>Securing Key</td><td>None</td></tr><tr><td>Min. Len (b)</td><td>1</td></tr><tr><td>Max. Len (b)</td><td>1</td></tr><tr><td>Data Type</td><td>Binary</td></tr><tr><td>Valid Values</td><td><p>0x00 – Disable UI notification</p><p>0x01 – Enable UI notification</p></td></tr><tr><td>Default</td><td>0x00</td></tr></tbody></table>

## Table - Get Request Example

```
AA 00 81 04 01 36 D1 01 84 1A D1 01 81 07 2B 06 01 04 01 F6 09 85 01 01 89 0A E2 08 
E3 06 E1 04 E2 02 C3 00
```

## Table - Get Response Example

```
AA 00 81 04 82 36 D1 01 82 04 00 00 00 00 84 82 00 1B D1 01 81 07 2B 06 01 04 01 F6 09 
85 01 01 89 0B E2 09 E3 07 E1 05 E2 03 C3 01 00
```

## Table - Set Request Example

```
AA 00 81 04 01 38 D1 11 84 1B D1 11 81 07 2B 06 01 04 01 F6 09 85 01 01 89 0B E2 09 E3 07 
E1 05 E2 03 C3 01 01
```

## Table - Set Response Example

```
AA 00 81 04 82 38 D1 11 82 04 00 00 00 00 84 82 00 1B D1 11 81 07 2B 06 01 04 01 F6 09 85 01 
01 89 0B E2 09 E3 07 E1 05 E2 03 C3 01 01
```

## Table - Property 1.2.3.1.3.1 Enable Card Logos Page at Startup

<table data-header-hidden><thead><tr><th width="232.66668701171875" valign="top"></th><th></th></tr></thead><tbody><tr><td valign="top">Property Description</td><td></td></tr><tr><td valign="top">Property OID</td><td>1.2.3.1.3.1 / 0x010203010301</td></tr><tr><td valign="top">Name</td><td>Enable Card Logos Page at Startup</td></tr><tr><td valign="top">Description</td><td>Enables a page at startup that displays supported payment type brand logos.</td></tr><tr><td valign="top">Securing Key</td><td>None</td></tr><tr><td valign="top">Min. Len (b)</td><td>1</td></tr><tr><td valign="top">Max. Len (b)</td><td>1</td></tr><tr><td valign="top">Data Type</td><td>Binary</td></tr><tr><td valign="top">Valid Values</td><td>0x00 = Disable Logo Page at Startup 0x01 = Enable Logo Page at Startup</td></tr><tr><td valign="top">Default</td><td>0x00</td></tr></tbody></table>

## Table - Get Request Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top"><p>AA 00 81 04 01 5E D1 01 84 1A D1 01 81 07 2B 06 01 04 01 F6 09 85 01 01 89 0A E2 08 E3 06 E1 04</p><p>E3 02 C1 00</p></td></tr></tbody></table>

## Table - Get Response Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top"><p>AA 00 81 04 82 5E D1 01 82 04 00 00 00 00 84 82 00 1B D1 01 81 07 2B 06 01 04 01 F6 09 85 01 01</p><p>89 0B E2 09 E3 07 E1 05 E3 03 C1 01 00</p></td></tr></tbody></table>

## Table - Set Request Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top"><p>AA 00 81 04 01 5D D1 11 84 1B D1 11 81 07 2B 06 01 04 01 F6 09 85 01 01 89 0B E2 09 E3 07 E1 05</p><p>E3 03 C1 01 01</p></td></tr></tbody></table>

## Table - Set Response Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top"><p>AA 00 81 04 82 5D D1 11 82 04 00 00 00 00 84 82 00 1B D1 11 81 07 2B 06 01 04 01 F6 09 85 01 01</p><p>89 0B E2 09 E3 07 E1 05 E3 03 C1 01 01</p></td></tr></tbody></table>

## Table - Property 1.2.3.1.3.2 Display Card Logo While Authorizing

<table data-header-hidden><thead><tr><th width="232" valign="top"></th><th></th></tr></thead><tbody><tr><td valign="top">Property Description</td><td>1.2.3.1.3.2 / 0x010203010302</td></tr><tr><td valign="top">Property OID</td><td></td></tr><tr><td valign="top">Name</td><td>Display Card Logo While Authorizing</td></tr><tr><td valign="top">Description</td><td>Enable display of logo for card brand used in transaction</td></tr><tr><td valign="top">Securing Key</td><td>None</td></tr><tr><td valign="top">Min. Len (b)</td><td>1</td></tr><tr><td valign="top">Max. Len (b)</td><td>1</td></tr><tr><td valign="top">Data Type</td><td>Binary</td></tr><tr><td valign="top">Valid Values</td><td>0x00 = Disable Logo 0x01 = Enable Logo</td></tr><tr><td valign="top">Default</td><td>0x00</td></tr></tbody></table>

## Table - Get Request Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top"><p>AA 00 81 04 01 5E D1 01 84 1A D1 01 81 07 2B 06 01 04 01 F6 09 85 01 01 89 0A E2 08 E3 06 E1 04</p><p>E3 02 C2 00</p></td></tr></tbody></table>

## Table - Get Response Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top"><p>AA 00 81 04 82 5E D1 01 82 04 00 00 00 00 84 82 00 1B D1 01 81 07 2B 06 01 04 01 F6 09 85 01 01</p><p>89 0B E2 09 E3 07 E1 05 E3 03 C2 01 00</p></td></tr></tbody></table>

## Table - Set Request Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top"><p>AA 00 81 04 01 5D D1 11 84 1B D1 11 81 07 2B 06 01 04 01 F6 09 85 01 01 89 0B E2 09 E3 07 E1 05</p><p>E3 03 C2 01 01</p></td></tr></tbody></table>

## Table - Set Response Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top"><p>AA 00 81 04 82 5D D1 11 82 04 00 00 00 00 84 82 00 1B D1 11 81 07 2B 06 01 04 01 F6 09 85 01 01</p><p>89 0B E2 09 E3 07 E1 05 E3 03 C2 01 01</p></td></tr></tbody></table>

## Table - Property 1.2.3.1.2.2 Display Backlight Intensity (Display Only)

<table data-header-hidden><thead><tr><th width="213.33331298828125" valign="top"></th><th></th></tr></thead><tbody><tr><td valign="top">Property Description</td><td></td></tr><tr><td valign="top">Property OID</td><td>1.2.3.1.2.2 / 0x010203010202</td></tr><tr><td valign="top">Name</td><td>Display Backlight Intensity</td></tr><tr><td valign="top"><p> </p><p>Description</p></td><td><p>The device uses this property to set the intensity of the display’s backlight, expressed as a percentage range from 1% to 100%.</p><p>The backlight setting takes effect immediately after the host changes it.</p></td></tr><tr><td valign="top">Securing Key</td><td>None</td></tr><tr><td valign="top">Min. Len (b)</td><td>1</td></tr><tr><td valign="top">Max. Len (b)</td><td>1</td></tr><tr><td valign="top">Data Type</td><td>Binary</td></tr><tr><td valign="top">Valid Values</td><td>0x01..0x64</td></tr><tr><td valign="top">Default</td><td>0x5A (90%)</td></tr></tbody></table>

## Table - Get Request Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA 00 81 04 01 55 D1 01 84 0F D1 01 85 01 01 87 04 02 03 01 02 89 02 C2 00</td></tr></tbody></table>

## Table - Get Response Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top"><p>AA 00 81 04 82 55 D1 01 82 04 00 00 00 00 84 82 00 10 D1 01 85 01 01 87 04 02 03 01 02 89 03 C2</p><p>01 5A</p></td></tr></tbody></table>

## Table - Set Request Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA 00 81 04 01 55 D1 11 84 10 D1 11 85 01 01 87 04 02 03 01 02 89 03 C2 0164</td></tr></tbody></table>

## Table - Set Response Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top"><p>AA 00 81 04 82 55 D1 11 82 04 00 00 00 00 84 82 00 10 D1 11 85 01 01 87 04 02 03 01 02 89 03 C2</p><p>01 64</p></td></tr></tbody></table>

## Table - Property 1.2.3.2.1.1 System Volume Control

<table data-header-hidden><thead><tr><th width="197.33331298828125" valign="top"></th><th></th></tr></thead><tbody><tr><td valign="top">Property Description</td><td></td></tr><tr><td valign="top">Property OID</td><td>1.2.3.2.1.1 / 0x010203020101</td></tr><tr><td valign="top">Name</td><td>System Volume Control</td></tr><tr><td valign="top"><p> </p><p> </p><p>Description</p></td><td><p>This property sets the output volume for all sounds the device produces after startup, expressed as a percentage range from 0% (no sound) to 100%. The volume setting takes effect immediately after the host changes it.</p><p> </p><p>Note that devices with limited volume control hardware allocate ranges of numbers to represent the same physical volume level (for example, 1..49 = Low, 50..100 = High).</p></td></tr><tr><td valign="top">Securing Key</td><td>None</td></tr><tr><td valign="top">Min. Len (b)</td><td>1</td></tr><tr><td valign="top">Max. Len (b)</td><td>1</td></tr><tr><td valign="top">Data Type</td><td>Binary</td></tr><tr><td valign="top">Valid Values</td><td>0x00..0x64</td></tr><tr><td valign="top">Default</td><td>0x32 (50%)</td></tr></tbody></table>

## Table - Get Request Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top"><p>AA 00 81 04 01 5E D1 01 84 1A D1 01 81 07 2B 06 01 04 01 F6 09 85 01 01 89 0A E2 08 E3 06 E2 04</p><p>E1 02 C1 00</p></td></tr></tbody></table>

## Table - Get Response Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top"><p>AA 00 81 04 82 5E D1 01 82 04 00 00 00 00 84 82 00 1B D1 01 81 07 2B 06 01 04 01 F6 09 85 01 01</p><p>89 0B E2 09 E3 07 E2 05 E1 03 C1 01 32</p></td></tr></tbody></table>

## Table - Set Request Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top"><p>AA 00 81 04 01 5D D1 11 84 1B D1 11 81 07 2B 06 01 04 01 F6 09 85 01 01 89 0B E2 09 E3 07 E2 05</p><p>E1 03 C1 01 01</p></td></tr></tbody></table>

## Table - Set Response Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top"><p>AA 00 81 04 82 5D D1 11 82 04 00 00 00 00 84 82 00 1B D1 11 81 07 2B 06 01 04 01 F6 09 85 01 01</p><p>89 0B E2 09 E3 07 E2 05 E1 03 C1 01 01</p></td></tr></tbody></table>

## Table - Property 1.2.3.2.2.1 Touch Keypress Beep Enable

<table data-header-hidden><thead><tr><th width="233.33331298828125" valign="top"></th><th></th></tr></thead><tbody><tr><td valign="top">Property Description</td><td></td></tr><tr><td valign="top">Name</td><td>Touch Keypress Beep Enable</td></tr><tr><td valign="top">Property OID</td><td>1.2.3.2.2.1 / 0x010203020201</td></tr><tr><td valign="top">Description</td><td>Globally enables/disables the beep tone triggered by touchscreen taps.</td></tr><tr><td valign="top">Securing Key</td><td>None</td></tr><tr><td valign="top">Min. Len (b)</td><td>1</td></tr><tr><td valign="top">Max. Len (b)</td><td>1</td></tr><tr><td valign="top">Data Type</td><td>Binary</td></tr><tr><td valign="top">Valid Values</td><td>0x0 - 0x1</td></tr><tr><td valign="top">Default</td><td>0x1</td></tr></tbody></table>

## Table - Get Request Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA 00 81 04 01 55 D1 01 84 0F D1 01 85 01 01 87 04 02 03 02 02 89 02 C1 00</td></tr></tbody></table>

## Table - Get Response Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top"><p>AA 00 81 04 82 55 D1 01 82 04 00 00 00 00 84 82 00 10 D1 01 85 01 01 87 04 02 03 02 02 89 03 C1</p><p>01 01</p></td></tr></tbody></table>

## Table – Set Request Example (enable)

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top"><p> </p><p>Example (Hex)</p></td></tr><tr><td valign="top">AA 00 81 04 01 55 D1 11 84 10 D1 11 85 01 01 87 04 02 03 02 02 89 03 C1 01 01</td></tr></tbody></table>

## Table 946 - Set Response Example (enable)

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top"><p>AA 00 81 04 82 55 D1 11 82 04 00 00 00 00 84 82 00 10 D1 11 85 01 01 87 04 02 03 02 02 89 03 C1</p><p>01 01</p></td></tr></tbody></table>

## Table - Set Request Example (disable)

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA 00 81 04 01 55 D1 11 84 10 D1 11 85 01 01 87 04 02 03 02 02 89 03 C1 01 00</td></tr></tbody></table>

## Table - Set Response Example (disable)

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top"><p>AA 00 81 04 82 55 D1 11 82 04 00 00 00 00 84 82 00 10 D1 11 85 01 01 87 04 02 03 02 02 89 03 C1</p><p>01 00</p></td></tr></tbody></table>

## Table - Property 1.2.3.3.1.1 Phone Number Format

<table data-header-hidden><thead><tr><th width="195.33331298828125" valign="top"></th><th></th></tr></thead><tbody><tr><td valign="top">Property Description</td><td></td></tr><tr><td valign="top">Property OID</td><td>1.2.3.3.1.1 / 0x010203030101</td></tr><tr><td valign="top">Name</td><td>Phone Number Format</td></tr><tr><td valign="top"><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p>Description</p></td><td><p>This property is used to change the displayed format of the phone number entered in the touch screen. It fully supports the International E.164 format that defines the fields allowed for global phone numbers. This property is an array of 7 bytes divided into fields. All values are HEX. <br> <br>Byte 0-1 – Country code (0x0000): 1 – 999 (value range 0x01 – 0x3E7) see NOTE 1 <br>Byte 2 – Number of Area code digits: 0 – 3 (value range 0x00 – 0x03) <br>Byte 3 – Add Area code leading zero: (T/F) 0 – 1 (value range 0x00 – 0x01) NOTE 3 </p><p>Byte 4 – Number of local number digits: l – 12 (value range 0x01 – 0x0C) </p><p>Byte 5 – Local number dash position: 0 – ‘Byte 4’s value minus 1’ </p><p>Byte 6 – Hide digits with ‘*’: (T/F) 0 – 1 (value range 0x00 – 0x01) <br> <br>NOTE 1: If country code is set to zero, then the local number format is automatically enabled. </p><p> </p><p>NOTE 2: The maximum number of digits specified by the E.164 format is 15. The country code digits + area code digits + local number digits cannot exceed 15 total digits. </p><p> </p><p>NOTE 3: Setting Byte 3 to true only takes effect if country code is set to zero. If Byte 3 is set to true, then Byte 2 must be set to 2 or 3. Reason: Adding a leading zero automatically makes the number of area code digits greater than 1. </p></td></tr><tr><td valign="top">Securing Key</td><td>None</td></tr><tr><td valign="top">Min. Len (b)</td><td>7</td></tr><tr><td valign="top">Max. Len (b)</td><td>7</td></tr><tr><td valign="top">Data Type</td><td>Binary</td></tr><tr><td valign="top">Valid Values</td><td><p>Example valid HEX value for the USA</p><p>0001 03 00 07 03 00</p></td></tr><tr><td valign="top"><p> </p><p>Default</p></td><td><p>OID Default</p><p>0x0001 = country code (+1) USA 0x03 = num area code digits</p><p>0x00 = add area code leading zero (T/F)</p><p>0x07 = num local number Digits</p><p>0x03 = local number dash position 0x00 = hide digits (T/F)</p></td></tr></tbody></table>

## Table - Get Request Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA00 81040155D101 840F D101 850101 870402030301 8902 C100</td></tr></tbody></table>

## Table - Get Response Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA0081048255D11182040000000084820016D1118501018704020303018909C107 00010300070300</td></tr></tbody></table>

## Table – Set Request Example

United States +1 (321) 689-1234, international number, with 1-digit country code, 3-digit area code

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA00 81040155D111 8416 D111 850101 870402030301 8909 C107 0001 03 00 07 03 00</td></tr></tbody></table>

## Table - Set Response Example (enable)

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA0081048255D10182040000000084820016D1018501018704020303018909C107 00010300070300</td></tr></tbody></table>

## Table – Set Request Example

United States (321) 689-2213, local number, with 3-digit area code, dash in position 3

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA00 81040155D111 8416 D111 850101 870402030301 8909C107 0000 03 00 07 03 00</td></tr></tbody></table>

## Table – Set Request Example

Australia +61 (5) 1234-5678, international number, with 2-digit country code, 1-digit area code

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA00 81040155D111 8416 D111 850101 870402030301 8909C107 003D 01 00 08 04 00</td></tr></tbody></table>

## Table – Set Request Example

Australia (05) 1234-5678, local number, with leading zero, 1-digit area code, dash in position 4

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA00 81040155D111 8416 D111 850101 870402030301 8909C107 0000 02 01 08 04 00</td></tr></tbody></table>

## Table – Set Request Example

Hong Kong +852 12345678, international number, with 3-digit country code, no area code

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA00 81040155D111 8416 D111 850101 870402030301 8909C107 0354 00 00 08 00 00</td></tr></tbody></table>

## Table – Set Request Example

Hong Kong 1234-5678, local number, with no area code, dash in position 4

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA00 81040155D111 8416 D111 850101 870402030301 8909C107 0000 00 00 08 04 00</td></tr></tbody></table>

## Table - Property 1.2.3.3.2.1 Social Security Number Format

<table data-header-hidden><thead><tr><th width="186" valign="top"></th><th></th></tr></thead><tbody><tr><td valign="top">Property Description</td><td></td></tr><tr><td valign="top">Property OID</td><td>1.2.3.3.2.1 / 0x010203030201</td></tr><tr><td valign="top">Name</td><td>Social Security Number Format</td></tr><tr><td valign="top"><p> </p><p> </p><p> </p><p>Description</p></td><td><p>This property is used to change the displayed format of the social security number entered</p><p>in the touch screen. The default obfuscated character is ‘*’.</p><p> </p><p>Byte 0 – Number of digits</p><p>Valid values are 4 or 9 (0x04 or 0x09) 4 = Last 4 social security number digits 9 = All 9 social security number digits</p><p>Byte 1 – Hide digits with ‘*’ (T/F) 0 – 1 (0x00 – 0x01)</p></td></tr><tr><td valign="top">Securing Key</td><td>None</td></tr><tr><td valign="top">Min. Len (b)</td><td>2</td></tr><tr><td valign="top">Max. Len (b)</td><td>2</td></tr><tr><td valign="top">Data Type</td><td>Binary</td></tr><tr><td valign="top"><p> </p><p>Valid Values</p></td><td><p>Example valid value for the USA</p><p>04 00 – (04 capture 4 digits, 00 show digits)</p><p>09 00 – (09 capture 9 digits, 00 show digits)</p><p>04 01 – (04 capture 4 digits, 01 hide)</p><p>09 01 – (09 capture 9 digits, 01 hide)</p></td></tr><tr><td valign="top">Default</td><td>09 01 = 9 digits, hide</td></tr></tbody></table>

## Table - Get Request Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA00 81040155D101 840F D101 850101 870402030302 8902 C100</td></tr></tbody></table>

## Table - Get Response Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA0081048255D10182040000000084820011D1018501018704020303028904C1020901</td></tr></tbody></table>

## Table – Set Request Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA00 81040155D111 8411 D111 850101 870402030302 8904 C102 04 01</td></tr></tbody></table>

## Table - Set Response Exampl*e*

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA0081048255D11182040000000084820011D1118501018704020303028904C1020401</td></tr></tbody></table>

## Table - Property 1.2.3.3.3.1 Zip Code Format

<table data-header-hidden><thead><tr><th width="212" valign="top"></th><th></th></tr></thead><tbody><tr><td valign="top">Property Description</td><td></td></tr><tr><td valign="top">Property OID</td><td>1.2.3.3.3.1 / 0x010203030301</td></tr><tr><td valign="top">Name</td><td>Zip Code Format</td></tr><tr><td valign="top"><p> </p><p> </p><p> </p><p> </p><p>Description</p></td><td><p>This property is used to format the zip code. Byte 2 is used to control the input type, For example, a numeric zip code 23452 (United states) or an alphanumeric zip code M5V 2T6 (Canada). </p><p> </p><p>Byte 0 – Number of digits: 1 – 9 (value range 0x01 – 0x09) </p><p>Byte 1 – Dash position: 0 – ‘Byte 0’s value minus 1’ </p><p>               When set to 0, no dash will appear </p><p>Byte 2 – Zip code type: Numeric or Alphanumeric 0 - 1 (value 0x00 – 0x01) </p><p>Byte 3 – Hide digits with ‘*’ (T/F) 0 – 1 (value range 0x00 – 0x01) </p></td></tr><tr><td valign="top">Securing Key</td><td>None</td></tr><tr><td valign="top">Min. Len (b)</td><td>4</td></tr><tr><td valign="top">Max. Len (b)</td><td>4</td></tr><tr><td valign="top">Data Type</td><td>Binary</td></tr><tr><td valign="top">Valid Values</td><td><p>Example valid HEX value for the USA 09 05 00 00</p><p>(capture 9 digits, add dash after digit 5, Numeric Zip code, show digits)</p></td></tr><tr><td valign="top">Default</td><td>05 00 00 00</td></tr></tbody></table>

## Table - Get Request Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA00 81040155D101 840F D101 850101 870402030303 8902 C100</td></tr></tbody></table>

## Table - Get Response Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA0081048255D10182040000000084820012D1018501018704020303038905C10309050000</td></tr></tbody></table>

## Table – Set Request Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA00 81040155D111 8413 D111 850101 870402030303 8906 C104 09 05 00 00</td></tr></tbody></table>

## Table - Set Response Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA0081048255D11182040000000084820012D1118501018704020303038905C10309050000</td></tr></tbody></table>

## Table - Property 1.2.3.3.4.1 Birth Date Format

<table data-header-hidden><thead><tr><th width="212.6666259765625" valign="top"></th><th></th></tr></thead><tbody><tr><td valign="top">Property Description</td><td></td></tr><tr><td valign="top">Property OID</td><td>1.2.3.3.4.1 / 0x010203030401</td></tr><tr><td valign="top">Name</td><td>Birth Date Format</td></tr><tr><td valign="top"><p> </p><p> </p><p> </p><p>Description</p></td><td><p>This property is used to determine if the birth date should be displayed on the screen or hidden. The default hidden character is ‘*’.</p><p>Byte 0 – Hide digits with ‘*’ (T/F) 0 – 1 (value range 0x00 – 0x01) Byte 1 – Birth date format</p><p>0x00 = MM-DD-YYYY</p><p>0x01 = DD-MM-YYYY</p></td></tr><tr><td valign="top">Securing Key</td><td>None</td></tr><tr><td valign="top">Min. Len (b)</td><td>2</td></tr><tr><td valign="top">Max. Len (b)</td><td>2</td></tr><tr><td valign="top">Data Type</td><td>Binary</td></tr><tr><td valign="top">Valid Values</td><td><p>Example valid HEX value for the USA</p><p>00 Show Digits, 01 Hide Digits</p></td></tr><tr><td valign="top">Default</td><td>00 00</td></tr></tbody></table>

## Table - Get Request Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA00 81040155D101 840F D101 850101 870402030304 8902 C100</td></tr></tbody></table>

## Table - Get Response Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA0081048255D10182040000000084820010D1018501018704020303048903C10100</td></tr></tbody></table>

## Table – Set Request Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA00 81040155D111 8411 D111 850101 870402030304 8904 C102 00 00</td></tr></tbody></table>

## Table - Set Response Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA0081048255D11182040000000084820011D1118501018704020303048904C1020000</td></tr></tbody></table>

## Table - Property 1.2.3.3.5.1 Personal ID Format

<table data-header-hidden><thead><tr><th width="199.33331298828125" valign="top">Property Description</th><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Property OID</td><td valign="top">1.2.3.3.5.1 / 0x010203030501</td></tr><tr><td valign="top">Name</td><td valign="top">Personal ID Format</td></tr><tr><td valign="top"><p> </p><p>Description</p></td><td valign="top"><p>This property is used to determine if the Employee ID should be displayed on the screen or hidden. The default hidden character is ‘*’.</p><p>Byte 0 – Hide characters with ‘*’ (T/F) 0 – 1 (value range 0x00 – 0x01)</p></td></tr><tr><td valign="top">Securing Key</td><td valign="top">None</td></tr><tr><td valign="top">Min. Len (b)</td><td valign="top">1</td></tr><tr><td valign="top">Max. Len (b)</td><td valign="top">1</td></tr><tr><td valign="top">Data Type</td><td valign="top">Binary</td></tr><tr><td valign="top">Valid Values</td><td valign="top"><p>Example valid HEX value for the USA</p><p>00 Show Characters, 01 Hide Characters</p></td></tr><tr><td valign="top">Default</td><td valign="top">00</td></tr></tbody></table>

## Table - Get Request Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA00 81040155D101 840F D101 850101 870402030305 8902 C100</td></tr></tbody></table>

## Table - Get Response Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA0081048255D10182040000000084820010D1018501018704020303058903C10100</td></tr></tbody></table>

## Table – Set Request Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA00 81040155D111 8410 D111 850101 870402030305 8903 C101 01</td></tr></tbody></table>

## Table - Set Response Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA0081048255D11182040000000084820010D1118501018704020303058903C10101</td></tr></tbody></table>

##

## Table - Property 1.2.3.3.6.1 Email Format

<table data-header-hidden><thead><tr><th width="248"></th><th></th></tr></thead><tbody><tr><td>Property Description </td><td></td></tr><tr><td>Property OID </td><td>1.2.3.3.6.1 / 0x010203030601 </td></tr><tr><td>Name </td><td>Email Format </td></tr><tr><td>Description </td><td><p>This property is used to determine if the Email should be displayed on the screen or hidden. The default hidden character is ‘*’. The maximum number of characters for Email is 29 </p><p> </p><p>Byte 0 – Hide digits with ‘*’ (T/F) 0 – 1 (value range 0x00 – 0x01) </p></td></tr><tr><td>Securing Key </td><td>None </td></tr><tr><td>Min. Len (b) </td><td>1 </td></tr><tr><td>Max. Len (b) </td><td>1 </td></tr><tr><td>Data Type </td><td>Binary </td></tr><tr><td>Valid Values </td><td>Example valid HEX value for the USA <br>00 Show Digits, 01 Hide Digits </td></tr><tr><td>Default </td><td>00 </td></tr></tbody></table>

## Table - Get Request Example&#x20;

| Example (Hex)                                             |
| --------------------------------------------------------- |
| AA00 81040155D101 840F D101 850101 870402030306 8902 C100 |

&#x20;

## Table - Get Response Example&#x20;

| Example (Hex)                                                        |
| -------------------------------------------------------------------- |
| AA0081048255D10182040000000084820010D1018501018704020303068903C10100 |

&#x20;

## Table – Set Request Example&#x20;

| Example (Hex)                                                        |
| -------------------------------------------------------------------- |
| AA0081048255D11182040000000084820010D1118501018704020303068903C10101 |

## Table - Property 1.2.3.3.7.1 General Information Format

<table data-header-hidden><thead><tr><th width="220.66668701171875"></th><th></th></tr></thead><tbody><tr><td>Property Description </td><td>111111111111111111111111111111111111111111111111111111111111111</td></tr><tr><td>Property OID </td><td>1.2.3.3.7.1 / 0x010203030701 </td></tr><tr><td>Name </td><td>General Information Format </td></tr><tr><td>Description </td><td><p>This property is used to determine if the General Information should be displayed on the screen or hidden. The default hidden character is ‘*’. The maximum number of characters for General Information is 18. </p><p> </p><p>Byte 0 – Hide digits with ‘*’ (T/F) 0 – 1 (value range 0x00 – 0x01) </p></td></tr><tr><td>Securing Key </td><td>None </td></tr><tr><td>Min. Len (b) </td><td>1 </td></tr><tr><td>Max. Len (b) </td><td>1 </td></tr><tr><td>Data Type </td><td>Binary </td></tr><tr><td>Valid Values </td><td>Example valid HEX value for the USA <br>00 Show Digits, 01 Hide Digits </td></tr><tr><td>Default </td><td>00 </td></tr></tbody></table>

## Table - Get Request Example&#x20;

| Example (Hex)                                             |
| --------------------------------------------------------- |
| AA00 81040155D101 840F D101 850101 870402030307 8902 C100 |

&#x20;

## Table - Get Response Example&#x20;

| Example (Hex)                                                        |
| -------------------------------------------------------------------- |
| AA0081048255D10182040000000084820010D1018501018704020303078903C10100 |

&#x20;

## Table – Set Request Example&#x20;

| Example (Hex)                                                |
| ------------------------------------------------------------ |
| AA00 81040155D111 8410 D111 850101 870402030307 8903 C101 01 |

## Table - Set Response Example (enable)&#x20;

| Example (Hex)                                                        |
| -------------------------------------------------------------------- |
| AA0081048255D11182040000000084820010D1118501018704020303078903C10101 |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developer.magtek.com/api-and-command-reference/scra-dynafamily-programmers-manual/configuration/device-settings-property-group-1.2.nnnn/user-interface-settings-property-subgroup-1.2.3.nnn-a.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
