All pages
Powered by GitBook
1 of 1

Loading...

QwantiFi Cloud Device Management (Tool Guide)

Introduction

QwantiFi Cloud Device Management is a browser tool for MagTek MMS / DynaFlex readers. Operators use WebHID over USB to open a device session, inspect identity and firmware, configure Wi-Fi on the reader, enter deployment Location details, and update QwantiFi (MQTT) configuration from Magensa RMS.

What You Can Do

  • Pair and open a USB WebHID session (including a multi-device picker by serial number)

  • View device model, serial number, and firmware versions

  • Enter Location / site address details used by Update Config

  • Read and write Wi-Fi settings (SSID, security, DHCP/static, protocol)

  • Read QwantiFi / MQTT settings from the device (Get Config)

  • Update QwantiFi configuration from RMS and report success/failure back to RMS

  • Send manual or batch commands and review the Output Console

  • A supported MagTek DynaFlex / MMS reader connected by USB

Control
Behavior
  1. Attach the reader by USB.

  2. Click Open.

  3. If the browser shows a device chooser, select the MagTek reader and allow access.

  4. If more than one granted device is available, pick by serial number in the Select Device modal.

Click Close to end the WebHID session. Fields may retain last-known values until cleared or refreshed.

After Open: Model, Serial Number, and MainApp / BLE / WLAN FW Version (when available). Use the copy icon on the section title to copy fields as text.

Field
Required?
Notes
  • Values persist in browser storage and are included in Update Config AdditionalParameters.

  • Clear (header, left of copy) empties all fields and resets Country to US.

  • Copy copies the Location fields as text.

Field
Editable
Notes

Save Config writes Wi-Fi values to the device and shows inline success/failure. Get Config (in QwantiFi) can refresh values from the reader.

Control
Behavior

Status under Update Config advances one step at a time (Connecting β†’ Sending request β†’ Getting response β†’ Updating β†’ success/fail). Location fields and ResellerID / CustomerID are sent in AdditionalParameters. The endpoints behind this panel are documented in the .

(Example values shown.)

  • RMS may return Commands (SENDCOMMAND, SENDFILE, WAIT, RESETDEVICE, DISPLAYMESSAGE).

  • The app executes those commands on the device when enabled.

Control
Purpose
  • First-time pairing: Serve over HTTPS or localhost; attach a supported MMS reader by USB; click Open and grant the device (or pick by serial when multiple are attached); confirm Device Info fills in.

  • Enter Location: Fill Device Friendly Name and address fields as needed (Street 2 and ZIP+4 are optional); Country defaults to US; use Clear in the Location header to reset; values are saved locally and sent on the next Update Config.

  • Configure Wi-Fi: Open the device; optionally click Get Config to load current values; edit SSID / password and More info as needed; click Save Config and confirm the inline status.

On tablets and phones the page stacks for scrolling. Controls remain the same; touch targets are sized for smaller screens.

Symptom
What to try

Chrome or Microsoft Edge (WebHID enabled)

  • App served from localhost or HTTPS

  • Network access to the RMS gateway for Update Config

  • Valid ResellerID / CustomerID for RMS AdditionalParameters

  • ResellerID / CustomerID

    Sent as RMS AdditionalParameters (defaults 13204 / 2026213)

    Confirm status shows Opened and Device Info populates.

    Street 2

    No (optional)

    Suite / unit

    City

    No

    City name

    State

    No

    US state dropdown (2-letter code)

    ZIP

    No

    5 digits

    ZIP+4

    No (optional)

    4 digits

    Country

    Defaults to US

    Editable; defaults to US

    There is no address geocode validation; empty fields are allowed.

    Address Mode

    Yes

    DHCP or Static IP

    IP Address

    No

    Reported by the device

    WLAN Protocol

    Yes

    MQTT or WebSocket Server

    Success or failure is reported to RMS via UpdateDeviceStatus.
  • If RESETDEVICE is included, the app waits and reopens the USB session when possible.

  • Send Command

    Runs one command or the batch file

    Output Console

    Dark terminal-style log

    View Details / Clear

    Full detail modal / clear history

    Provision QwantiFi from RMS: Open the device; confirm ResellerID / CustomerID and Location fields; optionally Get Config to see what is on the reader; click Update Config and watch the step status; expand Tools & Support / Output Console for the full log; RMS receives success or failure via UpdateDeviceStatus.

  • Debug with a command or batch file β€” Expand Tools & Support; enter a hex / SENDCOMMAND / SENDFILE line, or check Batch and choose a file; Send Command; expand the Output Console / View Details for responses.

  • Update Config fails at Sending

    Check RMS BaseUrl / network; confirm API key on server

    Update Config fails during Updating

    Inspect Commands in the log; retry after device reconnect

    Multi-device picker hangs

    Wait for serial probe timeout, or unplug unused readers

    Status

    Dot + short text (Disconnected, Connected, Opened, Reconnecting…)

    Open

    WebHID picker / in-app multi-device list; loads Device Info and configs

    Close

    Device Friendly Name

    No

    Stored as DeviceNickname in Update Config

    Street 1

    No

    SSID Name / Password

    Yes

    Primary credentials

    Security Mode

    Yes

    Get Config

    Reads Wi-Fi and MQTT properties from the device (local HID)

    Update Config

    POST api/V2/Configs β†’ apply Commands on device β†’ POST UpdateDeviceStatus

    Broker / Client ID / …

    {
      "ProductName": "DYNAFLEX",
      "ProfileName": "MagTek_MQTT",
      "ConfigurationName": "DynaFlexMqttAll",
      "Version": null,
      "FirmwareID": "1000009711-AC2-PCI",
      "DeviceSerialNumber": "B563215",
      "BillingLabel": "Test",
      "InterfaceType": "USB",
      "DownloadPayload": true,
      "RawCommands": true,
      "Authentication": null,
      "AdditionalParameters": {
        "KSN": "",
        "Boot1FirmwareID": "",
        "WifiFirmwareID": "",
        "ResellerID": "13204",
        "CustomerID": "2026213",
        "DeviceNickname": "Store 101 Front Counter",
        "Street1": "3674 Tyler Ave",
        "Street2": "Suite 200",
        "City": "El Monte",
        "State": "CA",
        "ZipCode": "91731",
        "ZipPlus4": "2506",
        "Country": "US"
      }
    }

    + / βˆ’ Tools & Support

    Shows or hides the command / console strip

    Command

    Hex, SENDCOMMAND,…, or SENDFILE,…

    Batch

    Open does nothing / no devices

    Use Chrome/Edge; serve localhost or HTTPS; check USB cable

    Device Info stays empty

    Confirm status is Opened; Close and Open again

    Save Config fails

    Prerequisites

    Main Layout

    Device connection

    Open a Device

    Close a Device

    Device Info and Location

    Device Info

    Location

    Wi-Fi

    QwantiFi Configuration (MQTT)

    Sample Update Config request body

    After Update Config

    Tools & Support and Output Console

    Typical workflows

    Mobile layout

    Troubleshooting

    Need More Help

    Need Help?

    For additional support, please contact MagTek Support:

    Technical Support:

    • πŸ“§ Email: support@magtek.com

    • πŸ“ž 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!

    DynaFlex II SCR
    DynaFlex II PED
    DynaFlex II Go
    RMS MQTT Configuration API Reference

    Ends the HID session

    Primary street line

    PSK or EAP-PEAP (More info)

    Read-only in UI; provisioned from RMS

    Load a commands file (JSON Commands array or script lines)

    Verify SSID/password; expand Output Console for command errors

    feedback@magtek.com