> 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/properties.md).

# Properties

## Properties

These sections of the DynaFamily Programmer's Manual details two mechanisms - properties - for the host to retrieve information about the device and to configure / customize device behavior:

{% hint style="success" %}
Applies to: All Dyna Family products
{% endhint %}

### Subsections

| **Setting**                                                                                                                                                                                                                      | **Information**                                                                                                                        |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| [<mark style="color:red;">**About Configuration**</mark>](/api-and-command-reference/scra-dynafamily-programmers-manual/properties/about-configuration-mechanisms.md)                                                            | This section details two mechanisms for the host to retrieve information about the device and to configure / customize device behavior |
| [<mark style="color:red;">**1.1.nnnn - Financial Settings**</mark>](https://developer.magtek.com/api-and-command-reference/scra-dynafamily-programmers-manual/properties#id-1.1.nnnn-financial-settings)                         | This section details EMV settings                                                                                                      |
| [<mark style="color:red;">**1.1.2.nnn - SRED Settings**</mark>](https://developer.magtek.com/api-and-command-reference/scra-dynafamily-programmers-manual/properties#id-1.1.2.nnn-sred-settings)                                 | This section details the settings involving masked data.                                                                               |
| [<mark style="color:red;">**1.2.nnnn - Device Settings**</mark>](https://developer.magtek.com/api-and-command-reference/scra-dynafamily-programmers-manual/properties#id-1.2.nnnn-device-settings)                               | This section details the settings involving payment brands.                                                                            |
| [<mark style="color:red;">**2.1.2.nnn - Firmware Identification**</mark>](https://developer.magtek.com/api-and-command-reference/scra-dynafamily-programmers-manual/properties#id-2.1.2.nnn-firmware-identification-information) | This section details the settings involved with firmware numbers.                                                                      |
| [<mark style="color:red;">**2.2.1.nnn - Hardware Information**</mark>](https://developer.magtek.com/api-and-command-reference/scra-dynafamily-programmers-manual/properties#id-2.2.1.nnn-hardware-settings)                      | This section involves the settings involved with hardware serial numbers.                                                              |
| [<mark style="color:red;">**2.3.1.nnn - System Status Information**</mark>](https://developer.magtek.com/api-and-command-reference/scra-dynafamily-programmers-manual/properties#id-2.3.1.nnn-system-status)                     | This sections involves the settings involving systems status.                                                                          |

### 1.1.nnnn - Financial Settings

| **Setting**                                                                                                                                                                                        | **Information**                     |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- |
| [<mark style="color:red;">**1.1.1.nnn - EMV Settings A**</mark>](/api-and-command-reference/scra-dynafamily-programmers-manual/properties/1.1.nnnn-financial-settings/1.1.1.nnn-emv-settings-a.md) | Part A of EMV Terminal ID settings. |
| [<mark style="color:red;">**1.1.1.nnn - EMV Settings B**</mark>](/api-and-command-reference/scra-dynafamily-programmers-manual/properties/1.1.nnnn-financial-settings/1.1.1.nnn-emv-settings-b.md) | Part B of EMV Terminal ID settings. |
| [<mark style="color:red;">**1.1.1.nnn - EMV Settings C**</mark>](/api-and-command-reference/scra-dynafamily-programmers-manual/properties/1.1.nnnn-financial-settings/1.1.1.nnn-emv-settings-c.md) | Part C of EMV Terminal ID settings. |

### 1.1.2.nnn - SRED Settings

| **Setting**                                                                                                                                                                                        | **Information**                                                                                                 |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| [<mark style="color:red;">**1.1.2.nnn - SRED Settings - A**</mark>](/api-and-command-reference/scra-dynafamily-programmers-manual/properties/1.1.2.nnn-sred-settings/1.1.2.nnn-sred-settings-a.md) | The device uses this property to determine what character it should use when sending masked ISO/ABA track data. |
| [<mark style="color:red;">**1.1.2.nnn - SRED Settings - B**</mark>](/api-and-command-reference/scra-dynafamily-programmers-manual/properties/1.1.2.nnn-sred-settings/1.1.2.nnn-sred-settings-b.md) | The device uses these properties to determine which DUKPT Key Set and Usage shall be used                       |

### 1.2.nnnn - Device Settings

| **Setting**                                                                                                                                                                                                                 | **Information**                                                                                                                                                                                                              |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [<mark style="color:red;">**1.2.nnnn - Transaction Settings A**</mark>](/api-and-command-reference/scra-dynafamily-programmers-manual/properties/1.2.nnnn-device-settings/1.2.1.nnn-transaction-settings-a.md)              | Configure how the device runs financial transactions — EMV terminal and kernel parameters, supported entry methods, and amount, currency, and timeout handling.                                                              |
| [<mark style="color:red;">**1.2.1.nnn - Transaction Settings B**</mark>](/api-and-command-reference/scra-dynafamily-programmers-manual/properties/1.2.nnnn-device-settings/1.2.1.nnn-transaction-settings-b.md)             | Continues the transaction group with the remaining financial/EMV properties, such as contactless and additional processing options.                                                                                          |
| [<mark style="color:red;">**1.2.2.1.nn - Basic Properties**</mark>](/api-and-command-reference/scra-dynafamily-programmers-manual/properties/1.2.nnnn-device-settings/1.2.2.1.nn-basic-properties.md)                       | Read the device's core identity and status: model name, serial number, firmware and boot versions, real-time clock, and operational state. These are mostly read-only values for identifying and health-checking the reader. |
| [<mark style="color:red;">**1.2.2.1.nn - WLAN Settings (WLAN Only) - A**</mark>](/api-and-command-reference/scra-dynafamily-programmers-manual/properties/1.2.nnnn-device-settings/1.2.2.1.nn-wlan-settings-wlan-only-a.md) | Configure Wi-Fi connectivity on WLAN-equipped models, including network SSID, security mode, and credentials. Applies only to devices with a WLAN radio.                                                                     |
| [<mark style="color:red;">**1.2.2.1.nn - WLAN Settings (WLAN Only) - B**</mark>](/api-and-command-reference/scra-dynafamily-programmers-manual/properties/1.2.nnnn-device-settings/1.2.2.1.nn-wlan-settings-wlan-only-b.md) | Continues WLAN configuration with the remaining network properties, such as IP addressing and connection behavior.                                                                                                           |
| [<mark style="color:red;">**1.2.2.2.nn - USB Settings (USB Only)**</mark>](/api-and-command-reference/scra-dynafamily-programmers-manual/properties/1.2.nnnn-device-settings/1.2.2.2.nn-usb-settings-usb-only.md)           | Configure the USB interface on USB-connected devices, including communication mode and power behavior during USB suspend. Applies only when connected over USB.                                                              |
| [<mark style="color:red;">**1.2.3.nnn - User Interface Settings - A**</mark>](/api-and-command-reference/scra-dynafamily-programmers-manual/properties/1.2.nnnn-device-settings/1.2.3.nnn-user-interface-settings-a.md)     | Configure the device's cardholder-facing interface — display behavior, LEDs, buzzer, and prompts — including the UI configuration file.                                                                                      |
| [<mark style="color:red;">**1.2.3.nnn - User Interface Settings - B**</mark>](/api-and-command-reference/scra-dynafamily-programmers-manual/properties/1.2.nnnn-device-settings/1.2.3.nnn-user-interface-settings-b.md)     | Continues UI configuration with the remaining interface properties, such as the card-logos page and related on-screen elements.                                                                                              |
| [<mark style="color:red;">**1.2.2.3.1.1 - Bluetooth LE Device Name**</mark>](/api-and-command-reference/scra-dynafamily-programmers-manual/properties/1.2.nnnn-device-settings/1.2.2.3.1.1-bluetooth-le-device-name.md)     | Set or read the name the device advertises over Bluetooth LE, used to identify the reader when pairing and connecting.                                                                                                       |
| [<mark style="color:red;">**1.2.5.nnn - Security Settings**</mark> ](/api-and-command-reference/scra-dynafamily-programmers-manual/properties/1.2.nnnn-device-settings/1.2.5.nnn-security-settings-a.md)                    | Configure the device's security posture, including SRED/encryption behavior and key status.                                                                                                                                  |
| [<mark style="color:red;">**1.2.7.nnn - System Settings**</mark> ](/api-and-command-reference/scra-dynafamily-programmers-manual/properties/1.2.nnnn-device-settings/1.2.5.nnn-security-settings-a.md)                      | Configure the device's system settings                                                                                                                                                                                       |

### 2.1.2.nnn - Firmware Identification Information

| **Notification**                                                                                                                                                                                                                                                                                     | **Information**                                                                                                                                         |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [<mark style="color:red;">**2.1.2.1.nn - Firmware Identification Information**</mark>](/api-and-command-reference/scra-dynafamily-programmers-manual/properties/2.1.2.nnn-firmware-identification-information/2.1.2.1.nn-firmware-identification-information.md)                                     | The device's top-level firmware identifier — the composite firmware ID that ties together the individual component versions and checksums listed below. |
| [<mark style="color:red;">**2.1.2.2.nn - Core Firmware Information**</mark>](/api-and-command-reference/scra-dynafamily-programmers-manual/properties/2.1.2.nnn-firmware-identification-information/2.1.2.2.nn-core-firmware-information.md)                                                         | Part number, version, and build details for the device's core application firmware — the main firmware that runs the reader.                            |
| [<mark style="color:red;">**2.1.2.3.4.3. - EMV Firmware Information**</mark>](/api-and-command-reference/scra-dynafamily-programmers-manual/properties/2.1.2.nnn-firmware-identification-information/2.1.2.3.nn-emv-firmware-information.md)                                                         | Part number and version for the EMV firmware component that handles Level 2 EMV processing for contact and contactless transactions.                    |
| [<mark style="color:red;">**2.1.2.3.4.3 - EMV Contactless L1 Kernel Checksum (Contactless Only)**</mark>](/api-and-command-reference/scra-dynafamily-programmers-manual/properties/2.1.2.nnn-firmware-identification-information/2.1.2.3.4.3-emv-contactless-l1-kernel-checksum-contactless-only.md) | A checksum identifying the contactless Level 1 kernel firmware, used to confirm which L1 kernel build is installed.                                     |
| [<mark style="color:red;">**2.1.2.3.7.3 - Discover D-PAS Kernel Checksum (Contactless Only)**</mark>](/api-and-command-reference/scra-dynafamily-programmers-manual/properties/2.1.2.nnn-firmware-identification-information/2.1.2.3.7.3-discover-d-pas-kernel-checksum-contactless-only.md)         | A checksum identifying the Discover D-PAS contactless kernel firmware installed on the device.                                                          |
| [<mark style="color:red;">**2.1.2.3.B.3 - China Union Pay Kernel ID (Contactless Only)**</mark>](/api-and-command-reference/scra-dynafamily-programmers-manual/properties/2.1.2.nnn-firmware-identification-information/2.1.2.3.b.1-china-union-pay-kernel-id-contactless-only-common-kernel.md)     | The identifier and version of the China UnionPay contactless kernel firmware.                                                                           |
| [<mark style="color:red;">**2.1.2.5.nn - WLAN Information (WLAN Only)**</mark>](/api-and-command-reference/scra-dynafamily-programmers-manual/properties/2.1.2.nnn-firmware-identification-information/2.1.2.5.nn-wlan-information-wlan-only.md)                                                     | Firmware and version information for the device's Wi-Fi (WLAN) module, on models equipped with a WLAN radio.                                            |
| [<mark style="color:red;">**2.1.2.8.nn - Custom UI**</mark>](/api-and-command-reference/scra-dynafamily-programmers-manual/properties/2.1.2.nnn-firmware-identification-information/2.1.2.8.nn-custom-ui.md)                                                                                         | Identifies the custom user-interface package loaded on the device — which custom UI build (if any) is installed, and its version.                       |
| [<mark style="color:red;">**2.1.2.9.nn - NFC**</mark>](/api-and-command-reference/scra-dynafamily-programmers-manual/properties/2.1.2.nnn-firmware-identification-information/2.1.2.9.nn-nfc.md)                                                                                                     | Firmware and version information for the device's NFC contactless module and controller.                                                                |

### 2.2.1.nnn - Hardware Settings

| **Notification**                                                                                                                                                                                        | **Information**                                            |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| [<mark style="color:red;">**2.2.1.1.1.n - Device Common Configuration Information**</mark>](/api-and-command-reference/scra-dynafamily-programmers-manual/properties/2.2.1.nnn-hardware-information.md) | The device uses this property to report its serial number. |

### 2.3.1.nnn - System Status

| **Notification**                                                                                                                                                                                                                                                             | **Information**                                                                                   |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| [<mark style="color:red;">**2.3.1.1.1.n - System Status Injected Key Information**</mark>](/api-and-command-reference/scra-dynafamily-programmers-manual/properties/2.3.1.nnn-system-status-information/2.3.1.1.1.n-system-status-injected-key-information.md)               | This OID contains a 32-bit bitmap. Each bit indicates the status of a transaction key,            |
| [<mark style="color:red;">**2.3.1.1.2.n - System Status Security Protection Information**</mark>](/api-and-command-reference/scra-dynafamily-programmers-manual/properties/2.3.1.nnn-system-status-information/2.3.1.1.2.n-system-status-security-protection-information.md) | The device maps this property to its internal register that enables its internal real-time clock. |
| [<mark style="color:red;">**2.3.1.2.1.n - System Status Device State Information**</mark>](/api-and-command-reference/scra-dynafamily-programmers-manual/properties/2.3.1.nnn-system-status-information/2.3.1.2.1.n-system-status-device-state-information.md)               | The device uses this property to report its operational status.                                   |

### Appendices

| **Notification**                                                                                                                                                                          | **Information**                                                                                                                                                                                                |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [<mark style="color:red;">**A: Object IDs and ITU-T x660**</mark>](/api-and-command-reference/scra-dynafamily-programmers-manual/appendices/appendix-a-object-ids-oids-and-itu-t-x660.md) | For modular management of device functions, information, and settings, this standard makes extensive use of Object Identifiers (also known as Object IDs or OIDs) as defined in ITU-T X.660 \| ISO/IEC 9834-1. |
| [<mark style="color:red;">**B: Barcode Reader Symbologies**</mark>](/api-and-command-reference/scra-dynafamily-programmers-manual/appendices/appendix-b-barcode-reader-symbologies.md)    | Barcode symbology refers to the way in which data is encoded in a barcode. It uses either spaced lines, dots or squares.                                                                                       |
| [<mark style="color:red;">**C: Erasing EMV Configurations**</mark>](/api-and-command-reference/scra-dynafamily-programmers-manual/appendices/appendix-c-erasing-emv-configurations.md)    | This section will help erase already existing EMV configurations.                                                                                                                                              |
| [<mark style="color:red;">**D: Tip & Tax DIsplay**</mark>](/api-and-command-reference/scra-dynafamily-programmers-manual/appendices/appendix-d-tip-and-tax-display-limits-touch-only.md)  | All of the space limitations on the device.                                                                                                                                                                    |
| [<mark style="color:red;">**E: Physical Button**</mark>](/api-and-command-reference/scra-dynafamily-programmers-manual/appendices/appendix-e-physical-button-dynaflex-only.md)            | Every DynaFlex device features a single physical button.  Pressing and holding this button can activate additional functions on the device.                                                                    |

### Need More Help

{% hint style="info" %}
**Need Help?**

For additional support, please contact MagTek Support:

**Technical Support:**

* 📧 **Email:** [support@magtek.com](mailto:support@magtek.com?subject=Support%20Request)
* 📞 **Phone:** 1-562-546-6800 (US)
* 🕐 **Hours:** Monday-Friday, 5:30 AM - 5:00 PM PST

**Online Resources:**

* 🌐 **Support Portal:** developer.magtek.com

**Documentation Feedback:**

Help us improve this documentation! [feedback@magtek.com](mailto:feedback@magtek.com?subject=Feedback)
{% endhint %}


---

# 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/properties.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.