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

Introduction

This document provides instructions on how to interact with the MagneFlex Browser.

1.1 About the MagneFlex Browser WEB API

The MagneFlex Browser, available from MagTek, is a full-function HTML browser application that is integrated with driver applications that allow the control of a set of MagTek payment card readers.

1.2 Nomenclature

In this document, the following nomenclature are used strictly as follows:

  • Device refers to the MagTek device (eg. Dynamag, DynaPro, MICRSafe) that receives and responds to the command set specified in this document.

  • Host refers to the piece of general-purpose electronic equipment the device is connected. Host types include PC and Mac computers/laptops, tablets, and smartphones.

  • User refers to the cardholder.

  • Web App refers to the application provided by the integrator of MagneFlex Browser. The web app will communicate with the MagneFlex browser via query strings. MagneFlex then controls and obtains data from the MagTek device.

  • Query string refers to the web app’s interface to MagneFlex WEB API sent as an HTTP request. The query string is added to the base URL. This string contains field-value pairs referred to as parameters and begins after the question mark character “?” at the end of the base URL. Each parameter is defined in the parameter table for each resource of the MagneFlex WEB API. In the following example, the place holder for field will be listed in the parameter column of the table and value will be explained in the description column.

Example query:

https://192.168.10.100/magneflexdemo/default.aspx?field=value

Postback refers to the response from a request or command from the device. The web app shall consume the postback. MagneFlex sends the postback in two forms.

  • HTTP GET - returns the response data in the form of a query string.

  • HTTP POST - returns the response data in the form of a body message. POST is recommended for EVM related transactions or commands of lengthy response to accommodate limits on query string lengths.

1.3 System Requirements

Tested operating systems:

  • iOS 8 to iOS 10

  • Windows 7, 8.1, 10

1.4 Interfaces for Operating Systems

The following table matches the device interface to operating system.

Device

Interface

Operating System

DynaPro Mini

Bluetooth LE

iOS 8 – 10

Windows 8.1, 10

USB

iOS 8 – 10

Windows 7, 8.1, 10

DynaPro

Ethernet

iOS 8 – 10

Windows 7, 8.1, 10

USB

iOS 8 – 10

Windows 7, 8.1, 10

DynaMAX

Bluetooth LE

iOS 8 – 10

Windows 8.1, 10

USB

iOS 8 – 10

Windows 7, 8.1, 10

eDynamo

Bluetooth LE

iOS 8 – 10

Windows 8.1, 10

USB

iOS 8 – 10

Windows 7, 8.1, 10

iDynamo

Lightning

iOS 8 – 10

uDynamo

Audio

iOS 8 – 10

Windows 7, 8.1, 10

MICRSafe

USB

Windows 7, 8.1, 10

Last updated