> 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/hardware/card-readers/mms-dyna-devices/dynaflex-ii-ped/documentation/user-manuals/web-hid-mqtt-wss-mms-device-user-guide/introduction.md).

# Introduction

This document provides instructions for using the browser-based MagTek [Demo](https://rms.magensa.net/TEST/demo/index.html) Applications to configure and test MagTek devices, including MMS devices, specifically the DynaFlex family (including DynaFlex, DynaFlex Pro, DynaFlex II, DynaFlex II PED, DynaFlex II Go and DynaProx, models).

The Demo Applications enable comprehensive testing of a wide array of capabilities, including core payment functions like EMV chip and NFC transactions, MSR reading, barcode scanning, and PIN entry. Note that feature support is dependent on your specific device model. For instance, the DynaFlex II PED model supports PIN entry, manual card entry, and signature capture functionalities.

{% hint style="warning" %}
CRITICAL REQUIREMENT: For USB connected devices, these demos require a Desktop, Chromium Browser Only!
{% endhint %}

The MagTek Demo Applications rely on Web HID functionality for USB connected devices, which is not supported by mobile browsers (iOS/Android). You must use a desktop-based Chromium browser (like Google Chrome, Microsoft Edge, or Opera) for the demos to function correctly when using a USB connected device.

### Demo Application Home Page <a href="#bookmark2" id="bookmark2"></a>

Upon opening the Web HID Demo home page, the Main Page is displayed. This page serves as the central menu and is organized into the following categories:

* MMS Devices – DynaFlex I/II device types and DynaProx (EMV, NFC, Barcode, PIN and MSR)
* V5 Devices – iDynamo, eDynamo, mDynamo, tDynamo (EMV, NFC and MSR)
* V5 MSR/Manual Entry – MSR swipe devices such as Dynamag and DynaPAD
* V5 (SRED) Devices – iDynamo 5 Gen III (MSR)
* Magensa Services – secure services for transaction testing
* Miscellaneous – configuration and GitHub source access

Each section provides a corresponding demo page with user interface elements for connecting a device, issuing commands, and reviewing results see Figure 1.

<figure><img src="/files/YuPocU5SSPEjT42FSiDM" alt=""><figcaption></figcaption></figure>

<p align="center"><strong>Figure 1 - Demo Application Home Page</strong></p>

### MMS Devices

The MMS product family includes the following devices:

* DynaFlex/DynaFlex Pro
* DynaFlex II/DynaFlex II PED
* DynaFlex II GO
* DynaProx

Devices in this family generally support EMV, NFC, barcode, MSR, and PIN functionality, though specific features vary by model. The Demo Application connects through methods including USB HID, WebSocket (WSS), MQTT, or Bluetooth Low Energy (BLE), depending on the connection method enabled on your device.

### Quick-Start Setup Guide <a href="#bookmark5" id="bookmark5"></a>

This checklist provides a summary of the steps required for configuring and running a demo with your device.

1. Prepare Device: Power on the device (if there is a power button) and connect it via USB, Wi-Fi, MQTT, or BLE.
2. Open Demo Application: Launch the Web HID Demo in a desktop Chromium browser.
3. Configure Host App: Be sure to enter RMS, WebSocket, MQTT, and Contactless parameters prior to using the various demos.
4. Device Provisioning: If using WSS or MQTT, provision the device's network and security settings (as outlined in Section&#x20;
   1. **Note:** For WSS connections, ensure the device's hostname (e.g., df-\[SerialNumber]) is resolvable in your network. Also plan for periodic certificate renewal.
5. Open Session: Select Open and confirm a successful connection.
6. To test your setup and connection, choose a command (e.g., Start EMV ALL), paste command data if necessary, and select Send Command.
7. View Results: Swipe, insert, or tap a card, and observe the transaction log for the response and confirmation

<p align="center"></p>


---

# 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/hardware/card-readers/mms-dyna-devices/dynaflex-ii-ped/documentation/user-manuals/web-hid-mqtt-wss-mms-device-user-guide/introduction.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.
