DynaFlex II PED Utility - Help

Welcome to the help guide for the DynaFlex II PED Utility. This application is designed to demonstrate and test the capabilities of the MagTek DynaFlex II PED via WebHID or MQTT connections. Features include screen manipulation, dynamic QR code generation, Personal Identifiable Information (PII) capture, and advanced command execution.

Back to WebHID App Back to MQTT App

Getting Started

Before using any features, you must establish a connection between the browser and the device.

Connecting the Device

The connection process depends on whether you are using the WebHID (USB) or MQTT (Network) version of the utility.

WebHID Connection (USB)

Ensure your DynaFlex II PED is connected to your computer via USB.
Locate the Connection switch at the top center of the page.
Toggle the switch to On. A browser popup will appear requesting access to a HID device.
Select DynaFlex II PED from the list and click Connect.
Once connected, the status badge will turn Green (Connected).

MQTT Connection (Network)

Ensure your DynaFlex II PED is powered on and connected to the network.
Locate the Connection switch at the top center of the page.
Toggle the switch to On. The application will attempt to connect to the configured MQTT broker.
Once connected, the status badge will turn Green (Connected).

Device Info Panel

The Device Info section allows you to verify the identity and health of the connected unit.

Refresh: Click the Refresh button to query the device.
Attributes: The utility will populate the Serial Number, Firmware Version, Battery Level, and Charger Status.

System Settings & Orientation

Control the physical behavior and display orientation of the device.

Display Orientation

The DynaFlex II PED supports dynamic screen rotation (requires a device reset between switching orientation) to accommodate various mounting stands.

MSR Top / Bottom / Left / Right: Click any of these four buttons to instantly rotate the device screen to the desired position.
Query: Checks the current orientation setting stored on the device.

Device Reset

Reset Button: Sends a command to reboot the device or return it to its idle state. Use this if the device becomes unresponsive or to clear a completed transaction state.

Dynamic Content (QR Codes)

This section allows you to send text, URLs, or Calendar events to the device display in the form of a QR Code. This is ideal for "Scan to Pay", "Scan to Schedule", or customer engagement workflows.

Generating Content

QR Text Input: Type any text or URL directly into the text area (e.g., https://magtek.com).
Appointment Generator: Click the Calendar icon () to open the Create Appointment Reminder modal.
- Fill in the Title, Start/End times, Location, and Description.
- Click Generate QR to automatically format this data into a standard vEvent string in the text area.

Display Options

Optional Display Label: Text entered here (e.g., "Scan Me") will appear below the QR code on the device screen.
Timeout: Sets how long (in seconds) the QR code remains on screen. Set to 0 for infinite duration.
Background Color: Choose a specific background color for the QR display screen.

Actions

Render: Previews the QR code on your computer screen (hidden canvas/console) without sending it to the device.
Send: Generates the QR payload and transmits it to the DynaFlex II PED for immediate display.

Personal Info Information (PII)

The DynaFlex II PED can securely capture sensitive user data using an on-screen keypad, enabling encryption option for all PII data collected via Command 0x1806.

Encryption Parameter: When sending the request, the host can set Tag 82 (Encryption for user data) to 0x01 to ensure the data is encrypted immediately upon entry.
Encryption Algorithm: If encryption is enabled, the device uses the working key associated with its current configuration (typically AES-256, AES-128, or TDES) to secure the payload before it is ever sent to the host.
Secure Delivery: The encrypted PII is delivered to the host within the notification payload, requiring the host to use the appropriate Key Serial Number (KSN) and Encryption Type provided by the device to decrypt the data.

Capture Types

Select the format of data you wish to collect using the dropdown menu:

Phone Number (01): Displays a numeric keypad formatted for phone entry.
Social Security Number (02): Captures 9 digits with masking.
Zip Code (03): Captures numeric zip codes.
ID (04): Captures custom ID numbers.
Birth Date (05): Displays a date entry interface.
Email (06): Captures email addresses.
General (07): Captures general text or numeric data.

Security Settings

Request Encryption: If checked, the data entered by the user will be encrypted before being sent back to the host.

Controls

Send Request: Initiates the capture mode on the device. The device screen will change to the keypad interface.
Cancel: Aborts the current input request and returns the device to idle.

Advanced Commands

For developers and integrators, this section provides direct access to low-level commands.

Command List

The Command List dropdown contains a library of pre-formatted hexadecimal commands grouped by function:

EMV Transactions: Start MSR, Contact, or Contactless transactions.
Display Messages: Show standard prompts like "Approved" or "Amount OK?".
PIN Requests: Test PIN entry workflows with Host or Card data.
NFC / NTAG: Configure the device as an NFC reader/writer.
Audio Transducer: Test the onboard beeper with various tone patterns (e.g., Success, Error, Alert).

Manual Command Entry

Command Data: You can manually type or paste a hexadecimal command string into the input field.
Send: Transmits the raw command to the device.

Log View

The Log View at the bottom of the page records all interactions.

It displays system status messages (e.g., "System Initialized").
It captures responses from the device, including Key/Value pairs from PII requests or Command responses.
Use this log to debug integration issues or verify data formats.