Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.
ChatGPT

Introduction

This document provides instructions for using the browser-based MagTek Demo 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.

CRITICAL REQUIREMENT: For USB connected devices, these demos require a Desktop, Chromium Browser Only!

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

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 1 - Demo Application Home Page

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

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

    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

Last updated