QwantiFi Cloud Dashboard (Guide)

The QwantiFi Cloud Dashboard is the fleet console for QwantiFi. It's a browser portal in the Magensa Reseller Portal that lets resellers and administrators see and manage every deployed reader across their merchant network from one place. From the dashboard you can check fleet health at a glance, search and filter your devices, view them on a map, inspect any single reader and send it a command, run actions across many readers at once, watch live device activity, and register new readers.

It's the companion to the QwantiFi Cloud Device Management tool the dashboard is the fleet-wide view, while the Cloud Device Management tool is the per-device setup step. Registering a reader in the dashboard hands off to that tool — see Registering a Device, below. For how the dashboard fits into the wider QwantiFi service, see the QwantiFi Overview.

A Note on "QwantiFi," vs "MQTT": QwantiFi is built on MQTT, a lightweight, standard messaging protocol for secure device-to-cloud communication. Throughout this documentation we call it "QwantiFi" rather than "MQTT," so you have one consistent name for the service and don't need any prior MQTT knowledge to get started. The underlying protocol is named only where you actually need it, such as in the API reference.

Fleet Health at a Glance

Three cards across the top summarize your fleet:

Total Devices: The total number of registered readers in your account.
Online: Readers with a live QwantiFi connection right now (an active connection heartbeat).
Policy Blocked: Readers an administrator has disabled by security policy; these can't be commanded until they're unblocked.

Connected Devices Directory

The directory lists every reader deployed across your merchant network. Each row shows the reader's status (Online / Offline / Blocked), serial number, credential state, company or branch, customer code, location, and the date it was first seen.

Omni-search: Filter the list by serial number, customer code, model, city, state, or company.
Status filters: Narrow the list to All, Online, Offline, or Blocked.
Select a reader: Click a serial number to open the device inspector (see Inspecting a device). Use the row checkboxes to select one or more readers for bulk actions (see Bulk actions and the Script Runner).

List and Map views

Toggle between two views using the List and Map buttons at the top of the directory:

List view (default): The full table described above.
Map view: Plots your readers geographically with a status pin at each location, for a quick regional or national overview.

Inspecting a Device

Click any serial number to open the inspection drawer on the right. It shows the reader's connection details and lets you send it a command:

Command and response addresses — the drawer displays the reader's QwantiFi command and response addresses. For what these are and how the addressing works, see the topic model in the POS Integration Guide.
Send a command — enter a Hex or ASCII payload and send it directly to the reader; the response appears below. For the command set and payload format, see the DynaFamily Programmer's Manual.

Hardware and Profile drawers

Below the command panel, four expandable drawers hold the selected reader's full profile:

Identity & Location: Nickname, company, full street address, and customer code (editable via Edit Device Profile).
Hardware Specs: The security KSN prefix.
Firmware Versions: The Boot1, Main, and Wi-Fi firmware levels.
Logs & Activity: First-seen and last-activity timestamps.

Bulk Actions and the Script Runner

For managing many readers at once:

Fleet action bar: When you select one or more readers with the checkboxes, the Block / Unblock controls activate so you can change access across the whole selection.
Script Runner: Upload a command payload to broadcast an operation, such as a configuration or diagnostic sweep, across your connected readers.

Note: Bulk actions and broadcast scripts apply to many terminals at once. Confirm your selection and your payload before you run them — for the command and payload format, see the DynaFamily Programmer's Manual.

Live Activity Stream

The console at the bottom of the dashboard streams live events across your fleet — connection status, heartbeats, and lifecycle messages — as they happen. Use it to confirm a reader has come online, or to watch activity during a deployment. Clear it at any time with Clear Console Stream.

Registering a Device

Registering a reader starts in the dashboard and finishes in the Cloud Device Management tool:

Start registration
1. In the Magensa Reseller Portal, open the Devices section to display the dashboard
2. Scroll to the bottom of the device list
3. Click Register Device.
Choose the merchant
1. In the Select a merchant dialog, pick the merchant to onboard to
2. Click Proceed. This opens the QwantiFi Cloud Device Management tool in a new tab.
Finish in the Cloud Device Management tool
Connect the reader over USB
Set Wi-Fi and location and push the configuration to the reader; it reboots and comes online in QwantiFi. The full step-by-step is in the QwantiFi Cloud Device Management (Tool Guide).