All pages
Powered by GitBook
1 of 1

Loading...

QwantiFi Cloud Overview

QwantiFi is MagTek's MQTT-driven cloud platform for Dyna family hardware, hosted on Magensa to provide complete remote device control across diverse operating systems, browsers, and networks. Connect a DynaFlex II PED WLAN to a merchant's Wi-Fi network, bring it online through QwantiFi, and your point-of-sale integrated application can accept transactions through the cloud β€” cloud-managed and platform-neutral, with no device-side drivers or OS-specific integration. This is the place to start: it explains what QwantiFi is, how the pieces fit together, and the concrete steps to get your first device online and taking transactions.

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.

How QwantiFi Works

At a high level, QwantiFi has three parts:

  • Your reader connects to QwantiFi Cloud over a local Wi-Fi network, where it receives commands and sends back responses without a physical, wired connection to the integrated application. (see QwantiFi Device Configuration Commands).

  • Provisioning equips a reader with its QwantiFi connection settings and credentials. You do this from the or through the to automate a whole fleet..

  • Your Application connects to QwantiFi Cloud with credentials generated by your Merchant or Reseller account and uses them to run transactions. See and .

Everything flows from your Magensa Reseller Account β€” start with Before You Begin, below.

Everything in QwantiFi β€” devices, merchant accounts, and provisioning β€” flows from a Magensa Reseller Account at the top of your hierarchy.

  • New to Magensa: Your first step is account setup. Before you can onboard a device or access QwantiFi, you need an active Magensa Reseller or Merchant Account.

  • Existing Magensa Customer: Your reseller hierarchy and any previously registered devices already appear in the onboarding tool. Confirm you have reseller-level access and that the target merchant account exists, then continue with the prerequisites below.

Confirm you have all of the following before you start.

There are two ways to start registering a reader β€” from the QwantiFi Cloud Dashboard, or directly in the QwantiFi Cloud Device Management tool. Both open the same tool, where you'll set the reader's Wi-Fi and location. To start from the dashboard:

  1. Sign in to the Magensa Reseller Portal and select Devices in the left menu to open the QwantiFi Cloud Dashboard.

  2. Scroll to the bottom of the device list and click Register Device.

  3. In the Select a merchant dialog, choose the merchant to assign the reader to, then click Proceed β€” the QwantiFi Cloud Device Management tool opens in a new tab, ready for the next step.

Wi-Fi is configured entirely through the onboarding tool β€” there's no need to set up the network from the device screen. Launch the tool and follow its onboarding screens to enter the SSID and password; it pushes the settings to the reader and confirms the connection before you continue.

Use the same onboarding tool to register the reader and assign it to the correct merchant account under your reseller hierarchy. This is the browser-based path for single-device or manual deployments.

For resellers managing multiple readers or building automated deployment workflows, the RMS API registers and configures devices programmatically β€” no browser required. Skip this for a single manual deployment and come back when you're ready to automate at scale.

With the reader onboarded, your application connects to QwantiFi Cloud to perform transactions. The same cloud API works on Windows, Linux, Android, or any other environment β€” no device-side drivers or OS-specific integration required.

  • Authentication:

  • Transactions:

Everything used in this integration, in one place.

Once your first reader is connected and your applicattion integration works end-to-end:

  • Deploy additional readers β€” repeat the connect and onboard steps for each unit. For large fleets, use the to automate bulk registration.

  • Monitor device health β€” track connectivity and transaction activity across all your registered readers from the QwantiFi Cloud Dashboard.

Reference the on-device connection settings applied during provisioning.

Automate reader registration and configuration at scale.

Magensa Reseller Account

Active account with reseller-level access. New customers must contact Magensa Sales to set this up.

DynaFlex II PED - WLAN

The physical reader to be deployed and powered on.

Merchant Wi-Fi credentials

The SSID and password for the network at the location where the reader will operate.

Merchant account in QwantiFi

QwantiFi Credential Model

Understand how your application authenticates and keeps its access alive.

Integration Guide

Connect your application and perform card-present transactions through the cloud.

API Reference

Look up the exact endpoints your application calls at runtime.

QwantiFi Cloud Device Management (Tool Guide)

Before You Begin

Contact a Magensa Sales Associate to set up your reseller or merchant account β€” visit magensa.net or ask your MagTek Sales Associate. Once your account is active, return here and continue with the prerequisites below.

Credentials are issued for you. There is no self-service onboarding endpoint β€” initial device provisioning and integrated application credentials are set up server-to-server by MagTek or your reseller's portal. Once you hold your credentials, everything after that (token refresh, device lookups) is self-service. If you haven't been onboarded, or need credentials re-issued, contact your MagTek Sales Associate.

Prerequisites

Get Started

Register the Reader from the Dashboard

Prefer to skip the dashboard? Open the QwantiFi Cloud Device Management tool directly and register the reader there instead β€” the remaining steps are identical.

  • QwantiFi Cloud Dashboard (Guide)

  • QwantiFi Cloud Device Management (Tool Guide)

Connect the Reader to Wi-Fi

Have the merchant's Wi-Fi SSID and passphrase ready before you start, and configure the reader on the exact production network it will use β€” moving it to a different network after onboarding requires reconfiguring the SSID and password.

Onboard the Reader to QwantiFi

Existing Magensa customers: your hierarchy and previously registered devices already appear in the tool. Select the correct merchant before registering to avoid mis-assignment.

Provision Through the RMS API β€” Optional

Integrate Your Application

Resources at a Glance

Next Steps

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!

QwantiFi Cloud Device Management browser tool
RMS Provisioning API
Integration Guide
QwantiFi Credential Model
QwantiFi Cloud Device Management (Tool Guide)
QwantiFi Cloud Device Management (Tool Guide)
RMS Provisioning API
QwantiFi Credential Model
Integration Guide
RMS Provisioning API

The target merchant under your reseller hierarchy. Create it in advance if it does not already exist.

Register readers and assign them to merchant accounts from the browser.

feedback@magtek.com
QwantiFi Device Settings
RMS Provisioning API