Magtek DYNAPRO, Programmer'S Manual

Page: 7 / 38

1 - Introduction
SDK - MagneFlex Powder, MIddleware,| PIN PEDs | Programmer’s Manual (MagneFlex API)
Page 7
1 Introduction
This document provides instructions for software developers who want to create software solutions that
include a IPAD, DynaPro, and DynaPro Mini connected to a Windows-based host via USB, BLE, or by
Ethernet. It is part of a larger library of documents designed to assist IPAD, DynaPro, and DynaPro Mini
implementers, which includes the following documents available from MagTek:

D99875585 DYNAPRO PROGRAMMER'S MANUAL ( COMMANDS )

D99875629 DYNAPRO MINI PROGRAMMER'S MANUAL ( COMMANDS )

D99875430 IPAD PROGRAMMER'S MANUAL (COMMANDS)
1.1 Nomenclature
The general terms “device” and “host” are used in different, often incompatible ways in a multitude of
specifications and contexts. For example “host” may have different meanings in the context of USB
communication than it does in the context of networked financial transaction processing. In this
document, “device” and “host” are used strictly as follows:

Device refers to the MSR device (eg. Dynamag) that receives and responds to the command set
specified in this document.

Host refers to the piece of general-purpose electronic computing equipment the device is connected
or paired to, which can send data to and receive data from the device. It also hosts the MagneFlex
Powder.
The word “user” is also often used in different ways in different contexts. In this document, user
generally refers to the cardholder.
1.2 About the MagTek Powder
The MagneFlex Powder provides a convenient HTTP command interface to a device connected to a host.
An HTTP client (such as a web browser) makes JSON calls to the host that are mapped to the device’s
low-level command set, as found in the Programmer’s Reference. The MagneFlex Powder can be
launched on the host as either a Windows Service, or a through a standalone executable. Any HTTP client
that can reach the host via a network can process commands to the device. Commands are processed as
simple request/response pairs, as shown later in the document.
The API also includes a sample SOAPUI project that demonstrates how JSON calls to the MagneFlex
Powder are formed and processed. In addition, source code for the standalone executable is provided, if
the developer wishes to integrate the MagneFlex Powder directly into their own code.
The MagneFlex Powder is single-threaded. If the service is busy processing a command to the device,
other calls will be rejected.