All pages
Powered by GitBook
1 of 14

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Message Format & Structure

Every exchange with the DynaFlex II Go— the commands you send and the responses and notifications it returns — uses the standard Multi-Interface Card Reader Platform (MMS) message format. This section defines how requests, responses, notifications, and file messages are framed and parsed. The format is the same across DynaFamily readers and is documented once in the shared reference.

Applies to: DynaFlex II Go

Settings & Information - Group 0xD1nn

Reference Section

Information Available

The host and the device communicate with each other by exchanging blocks of data called Messages, which are standardized wrappers containing a payload that is either a command Request, a command Response, an unsolicited Notification, or a File.

Appendices

These sections detail a variety of information on OIDs, codes, tips & taxes and more.

This section will help erase already existing EMV configurations.

DynaFlex II SCR features a single physical button. Pressing and holding this button can activate additional functions on the device.

Reference Section

Information Available

A: Object IDs and ITU-T x660

For modular management of device functions, information, and settings, this standard makes extensive use of Object Identifiers (also known as Object IDs or OIDs) as defined in ITU-T X.660 | ISO/IEC 9834-1.

B: Barcode Reader Symbologies

Applies to: DynaFlex II Go

System Status Information - Property Group 2.3.1.nnn

Barcode symbology refers to the way in which data is encoded in a barcode. It uses either spaced lines, dots or squares.

For More Help

Need Help?

For additional support, please contact MagTek Support:

Technical Support:

  • 📧 Email:

Message Format

All messages exchanged between the host and the device are formatted using the tag-length-value Distinguished Encoding Rules (DER).

Message Structure

Each message type follows a specific structure described on this page.

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!

About Messages

DynaFlex II Go

The DynaFlex II Go is a portable secure card reader authenticator (SCRA) that reads contact chip, contactless (NFC), and magnetic-stripe cards in a compact, handheld device. It encrypts cardholder data at the point of read (SRED) and connects over USB or Bluetooth LE — suited to both mobile and countertop acceptance. It uses the shared Dyna-family MMS command set, so everything you build against it is documented in the API & Command Reference and linked below.

Key Capabilities

  • Contact, contactless (NFC), and magnetic stripe card reading in one device

  • SRED point-to-point encryption at the moment of read (TDES / AES DUKPT)

  • NFC/MIFARE pass-through and NFC card emulation (DynaCast)

  • Optional barcode reader (BCR) for scanning outside a transaction

  • Portable and battery-powered, with status LEDs and a buzzer for prompts

  • PCI PTS POI–approved SCRA (no PIN entry — see the DynaFlex II PED for PIN)

Notifications

MMS notifications are the asynchronous messages the DynaFlex II Go reader sends while a transaction is running, reporting progress, state changes, and completion. Find the Notification Group you are looking for below and follow the links in the table to jump to a specific notification.

NFC/MIFARE

Working with contactless cards and tags on the DynaFlex II Go, the supported card technologies (NTag, MIFARE Ultralight, Classic, DESFire, Plus), how pass-through works, and NFC card emulation (DynaCast). This is shared DynaFamily content, documented once in the guide.

feedback@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! feedback@magtek.com

    C: Erasing EMV Configurations
    E: Physical Button
    support@magtek.com

    DUKPT (3DES→AES), MAC, KSNs, encryption/decryption, and PCI requirements.

    working with contactless cards and tags (NTag, Classic, DESFire, Plus).

    Reference Section

    Information Available

    Quickstart

    The Go connects to a host over USB or Bluetooth LE. For wiring, pairing, and a first end-to-end transaction, start with the Quickstart.

    Reference Section

    Information Available

    Programmer's Manual

    The MMS command set scoped to the Go: message format, commands, notifications, configuration, and status codes.

    Commands

    The commands the Go supports, each linking into the shared reference.

    Command Support Across Products

    The full device Command matrix, if you're building for more than one Dyna reader.

    Reference Section

    Information Available

    Firmware & Downloads

    The MMS command set scoped to the Go: message format, commands, notifications, configuration, and status codes.

    Compliance

    Compliance documentation for the Go, including inspection documents.

    How it Connects

    Build with the DynaFlex II Go

    Downloads & Compliance

    For 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!

    This notification reports the final result of a transaction the host initiated using Command 0x1001 - Start Transaction.

    Reference Section

    Information Available

    This notification reports the successful completion of firmware update operations the host initiated

    This notification reports the failure of a Firmware Update command the host initiated.

    This notification reports Firmware is up to date for host initiated update.

    Reference Section

    Information Available

    This notification reports information about general state changes that occur within the device, outside the context of specific operations like transactions

    The device sends this notification when the battery charge reaches 15 percent.

    The device sends this notification one minute before it automatically powers down the device.

    Reference Section

    Information Available

    This notification requests that the host take action during operations involving the device’s User Interface modules.

    This notification shows that a UI operations involving the device’s User Interface modules is complete.

    Reference Section

    Information Available

    This notification reports information about progress and state changes that occur during a Pass-Through Mode.

    Reference Section

    Information Available

    Transaction Information Update - Notification 0x0101

    This notification reports information about progress and state changes that occur during a transaction.

    Transaction Operation Complete - Notification 0x0105

    Applies to: DynaFlex II Go

    From Transactions - Source 0x01nn

    Firmware Updates - Source 0x09nn

    From Device - Source 0x10nn

    User Interface - Source 0x18nn

    From Generic Pass-Through Mode - Source 0x03nn

    For more help

    Need Help?

    For additional support, please contact MagTek Support:

    Technical Support:

    • 📧 Email:

    Send commands to and receive responses from a MIFARE DESFire (Type 4) tag.

    Send commands to and receive responses from a MIFARE Plus (Type 2) tag.

    Exchange raw ISO 14443-4 APDUs with any card that supports the protocol.

    Enter or leave contactless pass-through mode.

    Start or stop the reader polling for a contactless card.

    The device will prepare card emulation with the parameters provided in the command and start card emulation.

    Reference Section

    Information Available

    The NFC/MIFARE Guide section give you a selection of how-to guides on working with NFC/MIFARE.

    Reference Section

    Information Available

    NTag / MIFARE Ultralight — 0x1100

    Send commands to and receive responses from an NTag or MIFARE Ultralight (Type 2) tag.

    MIFARE Classic / MINI / Plus SL1 — 0x1101

    Applies to: DynaFlex II Go

    Pass-through Commands

    After the tag is activated, send commands to and receive responses from a MIFARE Classic, MINI, or Plus SL1 (Type 2) tag.

    NFC/MIFARE Guide

    For More Help

    Need Help?

    For additional support, please contact MagTek Support:

    Technical Support:

    • 📧 Email:

    Data Types & Shared TLV Objects

    Data Types and Shared TLV Data Objects

    This section defines the primitive and composed data types, TLV (Tag-Length-Value) data objects, file structures, and cryptographic key formats used throughout the device command set, including track data, display strings, EMV configuration file types (ARQC, ARPC, Batch, CA Public Keys), security parameters, TR‑31 key blocks, certificate and CSR file structures, and card emulation.

    Applies to: DynaFlex II PED

    Information in this group

    Section

    Information available

    A list of primitive data types used by TLV data objects.

    feedback@magtek.com
    Security & Keys
    NFC/MIFARE

    📞 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! feedback@magtek.com

    Battery Charged - Notification 0x1001

    The device sends this notification when the battery charger detects that the battery is fully charged.

    Firmware Update Successful - Notification 0x0905
    Firmware Update Failed - Notification 0x0906
    Firmware is Up to Date - Notification 0x0907
    Device Information Update - Notification 0x1001
    Low Battery Warning - Notification 0x1001
    Low Battery Shutdown - Notification 0x1001
    User Interface Host Action Request - Notification 0x1803
    User Interface Operation Complete - Notification 0x1805
    Pass-Through Mode Information Update - Notification 0x0301
    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! feedback@magtek.com

    MIFARE DESFire — 0x1102
    MIFARE Plus — 0x1103
    ISO 14443-4 APDU Pass-Through — 0x3003
    Pass-Through Mode Start/Stop — 0x3001
    Start/Stop Polling — 0x3002
    Card Emulation - 0x1840
    NFC / MIFARE Guide
    support@magtek.com

    About Track Data

    Information about parsing EMV ARQC Type or Merchant Data Container data for each track into individual values embedded in the tracks.

    Display Strings

    A pre-defined set of messages by string ID that the host and device use for various user interface features.

    Encryption Type

    Information on the key type, variant, and other information the host can use to decrypt encrypted data included in various payloads.

    EMV ARQC Type

    Information on how the device formats ARQC messages.

    EMV ARPC Type

    Information on how the device formats ARPC messages

    EMV Batch Data Type

    Information on the device formats EMV batch data, such as merchant data and pre-defined EMV batch data tags.

    EMV Terminal Configuration Type

    Information on loading this file type to control the behavior of the device’s EMV contact kernel.

    EMV Processing Configuration File Type

    Information on loading this file type to control the behavior of the device’s EMV kernel.

    EMV Entry Point Configuration File Type

    Information on loading this file type to control the behavior of the device’s EMV kernels.

    EMV Configuration CA Public Keys File Type

    Information on loading this file type to control the behavior of the device’s EMV contact and contactless kernels when the device should support Offline Data Authentication (ODA).

    EMV American Express DRL Configuration Type

    Information on loading this file type to control the behavior of the device’s American Express contactless kernel when the card sends tag 9F70 and one or more DRL is defined. (Not supported on Expresspay 4.x)

    Signature Capture File Type

    The signature capture file type produced when the host invokes Request Cardholder Signature - Command 0x1801 (Touch Only)

    Security Operation Type

    This non-TLV data structure consists of four or five bytes that describes a security operation, including the algorithms and methods to be used in that operation.

    Security Parameters Type

    Information on tags used with security parameters.

    Key Information Type

    Information on tags used to identify key types.

    NFC UID Type

    Information on tags used with NFC UID Types. (EMV Contactless Only)

    TR-31 Key Block Type

    Information on tags used with TR-31 Key Blocks.

    DUKPT Key Mapping

    Information on tags used with DUKPT Keys.

    Common File Structure

    Information on file types that conform to the common file structure format.

    Certificate File Type

    These file types conform to the Common File Structure format. The File Payload of these files contain a certificate in PEM format.

    Certificate Signing Request (CSR) Files Types

    Information on CSR File Types.

    Card Emulation

    Card emulation enables a DynaFlex/DynaProx device to simulate a Type 4 smart card.

    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!

    Primitive Data Types

    Quick Installation Guide

    Overview

    DynaFlex II Go and DynaFlex II Go BCR deliver the next generation of mobile payment solutions, both models are PCI PTS 6.x. These secure card reader authenticator devices accept magnetic stripe cards; EMV chip cards (contact and contactless); NFC enabled mobile wallets including Apple® Pay, Samsung™ Pay, Google Pay™, with support for Google Smart Tap and Apple VAS protocols, and MIFARE® Classic,

    MIFARE® DESFire, and NTag. DynaFlex II Go BCR additionally has an integrated barcode reader. Ideal for cafés, restaurants, boutiques, airlines, retail banks, and other developers looking to build a secure payment solution that accepts swipe, tap, and dip technology.

    Major Components

    DynaFlex II Go Major Components

    Top Face

    Environmental Notice

    DynaFlex II Go products are designed to provide flexible mounting options. The device can be mounted to the host via an external clip or the embedded lanyard. When designing an enclosure or mounting bracket, ensure there is adequate clearance for cardholders to tap, swipe, dip, and for users to present a bar code. Proximity to metal can reduce the device’s reading range. DynaFlex II Go offers an optional OtterBox uniVERSE clip adapter and a countertop stand.

    DynaFlex II Go is available with USB-C or USB-C and Bluetooth LE connection. Check you model number for connection configuration.

    For best results, use the cable that is included with the device. Connect the cable to the device. Connect the other end to the HOST USB port. Device will automatically power on. Windows will start an installation of the driver on initial connection. Windows will report DEVICE IS READY and device shows in Windows Device Manager under HUMAN INTERFACE DEVICES as two devices HID-COMPLIANT VENDOR-DEFINED (VID 0801, PID 2024) and USB INPUT DEVICES.

    See D998200386 MagTek Universal SDK

    Disconnect any active connections to the device. Install Android HOST software. Press and hold the POWER BUTTON for 4 beeps until LED 4 starts flashing indicating Bluetooth LE pairing is in process. LED flashes once per second for up to 3 minutes. On the Android HOST, launch SETTINGS >BLUETOOTH> SEARCH FOR DEVICES > locate

    the 7-digit serial number on the device label (DF II GO_xxxxxxx). Select device. When HOST shows BLUETOOTH PAIRING REQUEST and asks for configuration key, enter [000000]. The device appears in PAIRED DEVICES. Change the default passkey.

    To UNPAIR, locate the device in BLUETOOTH configuration page on HOST, press the settings (gear) icon, press FORGET.

    Ensure HOST Bluetooth LE is turned on and working. Disconnect any other connections to the device. On the HOST, install and configure the software. Ensure HOST software is configured to look for the device. The device transmits in GATT format. In START on HOST type BLUETOOTH and select BLUETOOTH AND OTHER DEVICE

    SETTINGS. Locate the 7-digit serial number on device label. Press and hold the POWER BUTTON on device for 4 beeps until LED 4 starts flashing indicating Bluetooth pairing is in process. LED flashes once per second for up to 3 minutes. Press the ADD BLUETOOTH OR OTHER DEVICE button and launch ADD A DEVICE window. Under CHOOSE THE KIND OF DEVICE YOU WANT TO ADD select BLUETOOTH.

    Locate the device called DF II GO-xxxxxxx. Enter configured passkey (999999) press the CONNECT button. After a short period CONNECTED appears. Press DONE. Change the default passkey.

    To UNPAIR, select the device in BLUETOOTH AND OTHER DEVICE SETTINGS window and press the REMOVE DEVICE button.

    DynaFlex II Go receives power from the USB-C port. The battery must be periodically recharged by connecting the device to a USB port or stand-alone USB charger. The device requires a USB power supply that can provide at least 500mA @ 5V.

    • Powered Off Mode is the shipping and storage mode of the device. No external power is applied to the device through the USB cable or from the internal rechargeable battery.

    • Active Mode is the device’s normal “awake” state when it is in use. In this mode, the device LED indicators are powered on, and the device is ready to receive commands from the host.

    • To set the device from Active mode to Powered Off mode: remove power, and press and hold the power button for two beeps.

    DynaFlex II Go has 4 LEDs that provide responses to the user for Power, Connection, Device Status, and Card Status. The Installation and Operation Manual has a more complete list of light signals.

    The device does not have an on-screen configuration interface. However, it does have settings the HOST can change using commands.

    Operator presses the Start transaction button on the HOST device. LED 1 and 2 will remain on. When a card is swiped, all four LEDs will turn on in sequence (1, 2, 3 then 4), followed by a long beep, indicating a successful transaction. Swipe the card with the magnetic stripe facing away from the face of the device. After a successful transaction, the device will return to the ready state.

    Locate the insertion slot on the face of the device. Orient the chip card so the chip faces the face of the device. Insert the chip card into the slot, then push gently on the card until it stops. The operator presses the Start transaction button on the HOST device.

    LED 1 and 2 will remain on. When a card is inserted, LEDs 1, 2 and 4 will turn on in sequence, followed by a long beep, indicating a successful transaction.

    Hold QR Code or barcode approximately 6 inches away from barcode reader. The operator presses the Start button on the HOST device. LED 1,2, and the BCR status light will be illuminated see. When a barcode is detected, only LED 1 will remain illuminated, the BCR status LED will be off, and a long beep will sound.

    The operator presses the Start transaction button on the host device. LED 1 will remain on. When a card is presented within range of the contactless reader, LEDs 1,2,3, and 4 will turn on in sequence, followed by a long beep, indicating a successful transaction. Tap the card or electronic payment device on the contactless landing zone, indicated by the EMVCo Contactless Indicator on the device’s face. The card or device’s antenna* must be centered over the contactless landing zone. Remove the card or electronic payment device from the contactless landing zone.

    Users can take advantage of the OtterBox® uniVERSE® adaptor for easy sliding and connection to a wide range of mobile devices, including phones and tablets

    FCC INFORMATION

    This device complies with Part 15 of the FCC Rules. Operation is subject to the following two conditions: (1) This device may not cause harmful interference, and (2) This device must accept any interference received, including interference that may cause undesired operation.

    Note: This equipment has been tested and found to comply with the limits for a Class B digital device, pursuant to part 15 of the FCC Rules. These limits are designed to provide reasonable protection against harmful interference in a residential installation. This equipment generates, uses and can radiate radio frequency energy and, if not installed and used in accordance with the instructions, may cause harmful interference to radio communications. However, there is no guarantee that interference will not occur in a particular installation. If this equipment does cause harmful interference to radio or television reception, which can be determined by turning the equipment off and on, the user is encouraged to try to correct the interference by one or more of the following measures:

    Reorient or relocate the receiving antenna.

    Increase the separation between the equipment and receiver.

    Connect the equipment into an outlet on a circuit different from that to which the receiver is connected. Consult the dealer or an experienced radio/TV technician for help.

    CAUTION

    Changes or modifications not expressly approved by MagTek could void the user’s authority to operate this equipment.

    CANADIAN DECLARATION OF CONFORMITY

    This digital apparatus does not exceed the Class B limits for radio noise from digital apparatus set out in the Radio Interference Regulations of the Canadian Department of Communications.

    Le présent appareil numérique n’émet pas de bruits radioélectriques dépassant les limites applicables aux appareils numériques de la classe B prescrites dans le Réglement sur le brouillage radioélectrique édicté par le ministère des Communications du Canada.

    This Class B digital apparatus complies with Canadian ICES-003.

    Cet appareil numérique de la classe B est conformé à la norme NMB-003 du Canada.

    INDUSTRY CANADA (IC) RSS

    This device complies with Industry Canada licence-exempt RSS standard(s). Operation is subject to the following two conditions: (1) This device may not cause interference, and (2) This device must accept any interference, including interference that may cause undesired operation of the device.

    Le présent appareil est conforme aux CNR d’Industrie Canada applicables aux appareils radio exempts de licence. L’exploitation est autorisée aux deux conditions suivantes: (1) L’appareil ne doit pas produire de brouillage, et (2) L’utilisateur de l’appareil doit accepter tout brouillage radioélectrique subi, même si le brouillage est susceptible d’en compromettre le fonctionnement.

    CUR/UR

    This product is recognized per Underwriter Laboratories and Canadian Underwriter Laboratories 1950.

    CE STANDARDS

    Testing for compliance with CE requirements was performed by an independent laboratory. The unit under test was found compliant with standards established for Class B devices.

    EU STATEMENT

    Hereby, MagTek Inc. declares that the radio equipment types Wideband Transmission System (802.11 wireless and Bluetooth® Low Energy), and Non-Specific Short Range Device (contactless) are in compliance with Directive 2014/53/EU. The full text of the EU declarations of conformity is available at the following Internet addresses:

    UL/CSA

    This product is recognized per UL 60950 1, 2nd Edition, 2011 12 19 (Information Technology Equipment - Safety - Part 1: General Requirements), CSA C22.2 No. 60950 1 07, 2nd Edition, 2011 12 (Information Technology Equipment - Safety - Part 1: General Requirements).

    ROHS STATEMENT

    When ordered as RoHS compliant, this product meets the Electrical and Electronic Equipment (EEE) Reduction of Hazardous Substances (RoHS) Directive (EU) 2015/863 amending Annex II to Directive 2011/65/EU. The marking is clearly recognizable, either as written words like “Pb-free,” “lead-free,” or as another clear symbol ( Pb ).

    PCI STATEMENT

    PCI Security Standards Council, LLC (“PCI SSC”) has approved this PIN Transaction Security Device to be in compliance with PCI SSC’s PIN Security Requirements.

    When granted, PCI SSC approval is provided by PCI SSC to ensure certain security and operational characteristics important to the achievement of PCI SSC’s goals, but PCI SSC approval does not under any circumstances include any endorsement or warranty regarding the functionality, quality or performance of any particular product or service. PCI SSC does not warrant any products or services provided by third parties. PCI SSC approval does not under any circumstances include or imply any product warranties from PCI SSC, including, without limitation, any implied warranties of merchantability, fitness for purpose, or non-infringement, all of which are expressly disclaimed by PCI SSC. All rights and remedies regarding products and services which have received PCI SSC approval shall be provided by the party providing such products or services, and not by PCI SSC.

    UKCA STATEMENT

    Hereby, MagTek Inc. declares that the radio equipment types Wideband Transmission System (Wireless LAN and Bluetooth Low Energy), and Non-Specific Short Range Device (contactless) are in compliance with Radio Equipment Regulations 2017 Directive S.I.2017:1206. The full text of the UKCA declarations of conformity is available at the following Internet addresses:

    feedback@magtek.com

    Storage temperature

    -4°F to 113°F (-20°C to 45°C)

    Operating temperature

    32°F to 95°F (0°C to 35°C)

    Mounting / Stability

    Connection

    How to Connect to a Host Computer via USB-C

    How to Connect to iOS Host via Bluetooth® LE

    How to Connect to Android Host via Bluetooth LE

    How to Connect to Windows 10 Host via Bluetooth LE

    Power

    LEDs

    Commands

    Accepting Payments

    SWIPE: How to Swipe Magnetic Stripe Cards

    DIP: How to Insert EMV Contact Chip Cards

    SCAN: How to Read with Barcode Reader

    TAP: How to Tap Contactless Cards / Devices

    *NOTE ON ELECTRONIC DEVICES: If the cardholder is using an electronic payment device, such as a smartphone, ensure the payment device has NFC turned ON and has a payment app configured to process transactions. Because each smartphone model may have its NFC antenna placed differently, the ideal tap position may vary by make and model. For example, Samsung users may need to center the phone on the contactless landing zone, while Apple users may need to tap the top of the phone on the contactless landing zone.

    Accessories

    OtterBox Adapater

    COMPLIANCE

    https://www.magtek.com/content/documentationfiles/d998200650.pdf
    https://www.magtek.com/content/documentationfiles/d998200651.pdf

    Configurations

    This section focuses on properties, which the host can either read from the device to retrieve device information (such as its PCI hardware ID, serial number, firmware revision numbers, etc.), or write to the device to change device behavior, or to store values for future reference.

    Applies to: DynaFlex II Go

    About Configuration

    Reference Section

    Information Available

    Detail on configuring the DynaFlex II Go device.

    Financial Settings - Property Group 1.1.nnnn

    Configure Wi-Fi connectivity on WLAN-equipped models, including network SSID, security mode, and credentials. Applies only to devices with a WLAN radio.

    Continues WLAN configuration with the remaining network properties, such as IP addressing and connection behavior.

    Configure the USB interface on USB-connected devices, including communication mode and power behavior during USB suspend. Applies only when connected over USB.

    Configure the device's cardholder-facing interface — display behavior, LEDs, buzzer, and prompts — including the UI configuration file.

    Continues UI configuration with the remaining interface properties, such as the card-logos page and related on-screen elements.

    Set or read the name the device advertises over Bluetooth LE, used to identify the reader when pairing and connecting.

    Configure the device's security posture, including SRED/encryption behavior and key status.

    Configure the device's system settings

    A checksum identifying the contactless Level 1 kernel firmware, used to confirm which L1 kernel build is installed.

    A checksum identifying the Discover D-PAS contactless kernel firmware installed on the device.

    The identifier and version of the China UnionPay contactless kernel firmware.

    Firmware and version information for the device's Wi-Fi (WLAN) module, on models equipped with a WLAN radio.

    Identifies the custom user-interface package loaded on the device — which custom UI build (if any) is installed, and its version.

    Firmware and version information for the device's NFC contactless module and controller.

    Reference Section

    Information Available

    EMV Settings A

    Part A of EMV Terminal ID settings.

    EMV Settings B

    Part B of EMV Terminal ID settings.

    EMV Settings C

    Part C of EMV Terminal ID settings.

    Reference Section

    Information Available

    SRED Settings - Property Subgroup 1.1.2.nnn - A

    The device uses this property to determine what character it should use when sending masked ISO/ABA track data.

    SRED Settings - Property Subgroup 1.1.2.nnn - B

    The device sends this notification when the battery charge reaches 15 percent.

    Reference Section

    Information Available

    Transaction Settings - A

    Configure how the device runs financial transactions — EMV terminal and kernel parameters, supported entry methods, and amount, currency, and timeout handling.`

    Transaction Settings - B

    Continues the transaction group with the remaining financial/EMV properties, such as contactless and additional processing options.

    Basic Properties

    Read the device's core identity and status: model name, serial number, firmware and boot versions, real-time clock, and operational state. These are mostly read-only values for identifying and health-checking the reader.

    Reference Section

    Information Available

    Firmware Identification Information

    The device's top-level firmware identifier — the composite firmware ID that ties together the individual component versions and checksums listed below.

    Core Firmware Information

    Part number, version, and build details for the device's core application firmware — the main firmware that runs the reader.

    EMV Firmware Information

    Part number and version for the EMV firmware component that handles Level 2 EMV processing for contact and contactless transactions.

    Reference Section

    Information Available

    Device Common Configuration Information

    Read-only hardware information reported by the device, such as model, part number, and hardware revision.

    Reference Section

    Information Available

    System Status Injected Key Information

    This OID contains a 32-bit bitmap. Each bit indicates the status of a transaction key,

    System Status Security Protection Information

    The device uses this property to report its security status.

    SRED Settings - Property Subgroup 1.1.2.nnn

    Device Settings - Property Group 1.2.nnnn

    Firmware Identification Information - Property Group 2.1.2.nnn

    Hardware Information - Property Group 2.2.1.nnn Device

    System Status Information - Property Group 2.3.1.nnn

    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!

    About
    feedback@magtek.com
    WLAN Settings (WLAN Only) - A
    WLAN Settings (WLAN Only) - B
    USB Settings (USB Only)
    User Interface Settings - A
    User Interface Settings - B
    Bluetooth LE Device Name
    Security Settings
    System Settings
    EMC Contactless L1 Kernel Checksum (Contactless Only)
    Discover D-PAS Kernel Checksum (Contactless Only)
    China Union Pay Kernel ID (Contactless Only) (Common Kernel)
    WLAN Information (WLAN Only)
    Custom UI
    NFC

    Commands

    The DynaFlex II Go accepts the Multi-Interface Card Reader Platform (MMS) command set — the messages you send to run transactions, read cards, manage keys and files, and query or configure the reader. Full syntax, parameters, responses, and examples are documented once in the shared reference; the families below are the commands the Go supports, each linking into that reference.

    Applies to: DynaFlex II Go

    Transaction - Group 0x10nn

    Reference Section

    Information Available

    The host uses this command to start a payment transaction.

    The Host uses this command to send commands and receive responses to and from a MIFARE Plus tag.

    The host uses this command to direct the device to arm or disarm the barcode reader for reading a barcode outside the scope of a transaction.

    The host uses this command to start a buzzer for playing a sequence of tones. Each sequence can have a minimum of 1 to maximum of 10 tones.

    The host uses this command to prompt a cardholder for customer information.

    The host uses this command to trigger the device to immediately show a pre-loaded image on the display.

    The host uses this command to direct the device to immediately show a QR code on the display.

    The host uses this command to trigger the device to immediately show a bitmap file the host includes as a parameter.

    This command allows the host to bring up standalone pages.

    The host uses this command to control the 4 LEDs of the device when the device is not in non-User Control LED states.

    Card emulation is initiated by receiving a 0x1840 command from the host.

    The host uses this command to send application-level APDUs to a PICC that supports ISO 14443-4 Protocol

    The host uses this command to start sending unsecured files to the device for storage or processing

    The host uses this command to request a file stored on the device.

    The host uses this command to request the file information of a file stored on the device.

    The host uses this command to request the deletion of a file stored on the device.

    The host can use this command to change the device’s lock passcode.

    The host uses this command to retrieve information about a key slot, including details about the key stored in that slot.

    Resume Transaction - Command 0x1004

    The host uses this command to provide the device with additional/modified data to resume a transaction that is currently paused.

    Cancel Transaction - Command 0x1008

    The host uses this command to cancel a transaction that is currently in progress.

    Reference Section

    Information Available

    Pass Through Command For NTag/MIFARE Ultralight, Type 2 - Command 0x1100

    The host uses this command to send commands and receive responses to and from a NTag/MIFARE Ultralight.

    Pass Through Command for MIFARE Classic/MINI®/Plus SL1 (Security Level 1), Type 2 - Command 0x1101

    After a MIFARE Tag is activated, the host uses this command to send commands and receive responses to and from a MIFARE tag.

    Pass Through Command for MIFARE DESFire, Type 4 - Command 0x1102

    The host uses this command to send commands and receive responses to and from a MIFARE DESFire Tag.

    Reference Section

    Information Available

    Request Cardholder Signature - Command 0x1801

    The host uses this command to prompt a cardholder for a signature.

    Report Cardholder Selection - Command 0x1802

    The host uses this command to provide a cardholder selection to the device when the device itself does not have a display or inputs to prompt the cardholder for a selection.

    Display Message

    Reference Section

    Information Available

    About

    Basic details about generic pass-through commands.

    Pass-Through Mode Start/Stop - Command 0x3001

    The host uses this command to enter or exit Pass-Through Mode.

    Start/Stop Polling - Command 0x3002

    After entering the Pass-Through Mode, the host use this command to request the device to start polling for a Type A and Type B PICC until it detects a PICC or times out.

    Reference Section

    Information Available

    Reset Device - Command 0x1F01

    The host uses this command to reset the device.

    Set Notification Subscriptions - Command 0x1F02

    The host uses this command to specify which notifications the device should send on each of its available interfaces

    Extend Session - Command 0x1F03

    The host can use this command to erase all Bluetooth® LE bonds.

    Reference Section

    Information Available

    Request PIN with Host Supplied Account Data - 0x2001

    This command directs the device to prompt the cardholder to enter a PIN when a card is not present or is not presented.

    Request PIN with Card Supplied Account Data 0x2002

    This command directs the device to prompt the cardholder to present their card by swiping, dipping or tapping, and to enter a PIN.

    Reference Section

    Information Available

    Get Property - Command 0xD101

    The host uses this command to get information about the device or its configuration / settings.

    Set Property (Unsecured) - Command 0xD111

    The host uses this command to set device configuration / settings that do not require security.

    Set Property (Secured) - Command 0xD112

    The host uses this command to set device configuration / settings securely.

    Reference Section

    Information Available

    About Files

    Large blobs of data uploaded to / downloaded from the device are referred to as “files” and share a common set of commands documented here, and special message type Data File Message.

    Load Firmware File - Command 0xD801

    The host uses this command to send a firmware image file, signed by MagTek, to the device as the first step in updating firmware.

    Start Send File to Device (Secured) - Command 0xD811

    The host uses this command to start sending secured files to the device for storage or processing.

    Reference Section

    Information Available

    Commit Firmware from File - Command 0xD901

    The host uses this command to commit a file previously uploaded using Command 0xD801 - Load (Firmware File) into the device’s permanent memory after the device has authenticated the file.

    Reference Section

    Information Available

    Echo - Command 0xDF01

    The host uses this command to prompt the device for a response that contains the same payload it sent.

    Reference Section

    Information Available

    Get Challenge - Command 0xE001

    Requests a random challenge from the device, used to construct a secured command.

    Send Secured Command to Device - Command 0xEEEE

    The host uses this command to request a random challenge from the device, used to construct a subsequent secured command.

    Load Key Using TR-31 - Command 0xEF01

    The host uses this command to load a key into one of several available slots in the device’s secure memory.

    Reference Section

    Information Available

    Establish Ephemeral KBPK - Command 0xF017

    The host uses this command to complete the ECDHE-ECDSA Key Exchange protocol, which enables the host and the device to generate the same TEMP KBPK key to use with Command 0xEF01 - Load Key Using TR-31 to load the Master Transport Key (MTK).

    NFC/MIFARE Pass-Through - Group 0x11nn

    User Interface - Group 0x18nn

    Generic Pass-Through - Group 0x30nn

    Device Control - Group 0x1Fnn

    Banking Functions - Group 0x20nn

    Settings & Information - Group 0xD1nn

    File Operation - Group 0xD8nn

    Process Files - Group 0xD9nn

    Diagnostics & Utilities - Group 0xDFnn

    Security - Grouo 0xEnnn

    Manufacturing - Group 0xFnnn

    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!

    Start Transaction - Command 0x1001
    feedback@magtek.com
    Pass Through Command for MIFARE Plus, Type 2 - Command 0x1103
    Read Barcode (BCR Only) - Command 0x1804
    Buzzer - Command 0x1805
    Personal Info Entry - Command 0x1806
    Show Image - Command 0x1821
    Show QR Code - Command 0x1822
    Show Bitmap Image - Command 0x1823
    Display Flexible UI Pages - Command 0x1830
    LED Control - Command 0x1807
    Card Emulation - Command 0x1840
    ISO 14443-4 APDU Pass-Through Commands - Command 0x3003
    Start Send File to Device (Unsecured) - Command 0xD812
    Start Get File from Device - Command 0xD821
    Get File Info from Device - Command 0xD825
    Delete File from Device - Command 0xD831
    Change Device Lock Passcode - Command 0xEF07
    Get Key Info - Command 0xEF11

    Programmer's Manual

    The DynaFlex II Go uses the shared Dyna-family Multi-Interface Card Reader Platform (MMS) command set. This manual is a device-scoped map into the API & Command Reference with the sections this device relies on linked below.

    Applies to: DynaFlex II Go

    In this manual

    Reference Section

    Information Available

    The full device Command matrix, if you're building for more than one Dyna reader.

    • Security & Keys --> How the Go protects data and manages keys: DUKPT (3DES→AES), MAC, KSNs, encryption/decryption, and the PCI requirements like the 24-hour reset and device lock.

    • Compliance--> The Go's PCI PTS POI security policy, certifications, and the regulatory documentation for deployment.

    • NFC/MIFARE -->Working with contactless cards and tags — NFC/MIFARE pass-through and the supported card technologies (NTag, Classic, DESFire, Plus).

    Message Format & Structure

    How MMS requests, responses, and notifications are framed and parsed.

    Data Types & Shared TLV Objects

    The shared TLV and EMV objects the commands carry.

    Commands

    The MMS command set, scoped to the Go, with a supported-commands view.

    Notifications

    Asynchronous messages the Go sends during transactions, device events, and firmware updates.

    Configurations

    Configurable properties and parameters.

    Status Codes & Responses

    Result and error codes the device returns.

    See Also

    Need Help?

    For additional support, please contact MagTek Support:

    Technical Support:

    • 📧 Email: support@magtek.com

    • 📞 Phone: 1-800-788-6835 (US) | +1-562-546-6616 (International)

    • 🕐 Hours: Monday-Friday, 6:00 AM - 5:00 PM PST

    Online Resources:

    • 🌐 Official Site:

    • 💬 Developer Forum:

    Documentation Feedback:

    Help us improve this documentation!

    Command Support Across Products
    https://www.magtek.com
    https://forum.magtek.com

    Security & Keys

    How the DynaFlex II Goprotects cardholder data and manages keys. These are shared DynaFamily concepts, documented in the Guides Section:

    Applies to: DynaFlex II Go

    Security & Key Guides

    Reference Section

    Information Available

    DUKPT: 3DES/TDEA --> AES Migration

    How DUKPT derives a unique key per transaction, and the path (and reasons) for moving from legacy 3DES/TDEA DUKPT to AES DUKPT on your devices and host.

    Key Serial Numbers (KSN)

    What a KSN is, how it's structured, and how it identifies the unique key used to encrypt a given transaction under DUKPT.

    Message Authentication Codes (MAC)

    How a MAC lets the host and device confirm a message hasn't been altered in transit, and when one is required.

    Encryption & Decryption

    How the reader encrypts data at the point of read (SRED), how to determine which key was used, and how to decrypt the output on your host.

    TR-31 Key Blocks

    The ANSI TR-31 key-block format used to transport and load keys securely into the device.

    PCI requirements (24-hour Reset, device lock)

    The operational requirements the device enforces for PCI compliance: the 24-hour automatic reset and the device lock feature.

    Reference Section

    Information Available

    Security & Key Guides

    This section covers how DynaFamily readers protect cardholder data and manage keys.

    Full Security & Key Guides Section

    For more help

    Need Help?

    For additional support, please contact MagTek Support:

    Technical Support:

    • 📧 Email: support@magtek.com

    • 📞 Phone: 1-800-788-6835 (US) | +1-562-546-6616 (International)

    • 🕐 Hours: Monday-Friday, 6:00 AM - 5:00 PM PST

    Online Resources:

    • 🌐 Official Site:

    • 💬 Developer Forum:

    Documentation Feedback:

    Help us improve this documentation!

    https://www.magtek.com
    https://forum.magtek.com

    Compliance

    This compliance documentation page provides the essential security and inspection guides required to maintain PCI PTS POS approval and ensure the physical integrity of DynaFlex II Go secure card readers before and after deployment.

    Applies to: DynaFlex II Go

    Documents

    Reference Section

    Information Available

    This document details the device's PCI PTS POI security features, including its support for encryption algorithms (AES, TDEA) and DUKPT key management to ensure secure payment transactions.

    A manual that outlines the step-by-step procedures for visually inspecting the DynaFlex II Go's hardware label, physical appearance, and tamper indicators to verify its authenticity and security before use.

    Package Inspection Document

    A guide that details how to examine the device's secure packaging for signs of tampering during storage or transit, helping to ensure the reader has not been compromised before deployment.

    For more help

    Need Help?

    For additional support, please contact MagTek Support:

    Technical Support:

    • 📧 Email: support@magtek.com

    • 📞 Phone: 1-800-788-6835 (US) | +1-562-546-6616 (International)

    • 🕐 Hours: Monday-Friday, 6:00 AM - 5:00 PM PST

    Online Resources:

    • 🌐 Official Site:

    • 💬 Developer Forum:

    Documentation Feedback:

    Help us improve this documentation!

    Security Policy (PCI PTS POI)
    Device Inspection Document
    https://www.magtek.com
    https://forum.magtek.com
    Submit feedback
    Submit feedback
    Submit feedback

    Firmware & Downloads

    This page provides access to the essential software resources for developing with and managing the DynaFlex II Go secure card reader. Here you will find Software Development Kits (SDKs) for integrating the device into applications across Android, iOS, and Windows platforms. Additionally, you can download utility programs for device demonstration and configuration, as well as specialized browser applications and the Reader Management System (RMS) for remote, large-scale device management.

    DynaFlex II Go Documentation

    Firmware

    Reference Section

    Information Available

    Latest Firmware

    The MagneFlex Browser is a full function browser this free development tool can be white-labelled and provides a turnkey integration solution for web applications, working with MagTek hardware and services. Sites developed in HTML 5 with device responsive views will work seamlessly in this browser allowing an app to respond to devices whether they are tablets or phones.

    MagneFlex Browser - Web API Reference

    EMVConfiguration Console Manual (Linux)

    Firmware Update Utility Manual (Windows)

    RMS Application Encryption Onboarding (iOS)

    A Windows SDK that provides sample code, documentation, and a demo application to help developers integrate MagTek MMS devices into Windows-based host applications.

    An iOS SDK that provides the necessary tools, sample application, sample code, and documentation for developers building iOS solutions for MagTek MMS devices.

    A sample iOS application that works with the MTUSDK to demonstrate communication with MagTek card readers and provide a user experience that simulates a transaction.

    How to Update

    Description

    Summary

    Installation & Operation Manual

    OID Converter Console Manual

    This document provides instructions to use the OID Converter Console.

    Web HID-MQTT-WSS Demo App User Guide

    Description

    Summary

    Reader Management System, Linux, Sample Code

    A sample console application for Linux that demonstrates how to update DynaFlex II Go device firmware, update production firmware via RS2 web service, and update EMV configurations (tags and CAPK) from an XML file.

    MagTek Universal SDK for MMS Devices, (Android)

    An Android Software Development Kit that provides tools, a sample application, sample code, and documentation for developers creating solutions for MagTek MMS devices on Android hosts.

    MagTek Universal SDK for MMS Devices - (Linux)

    A Linux-based SDK that includes sample applications, code, and documentation for building software solutions for MagTek MMS devices on Linux hosts.

    Description

    Summary

    MagneFlex Sky, Browser App, Android

    A full-featured Android browser designed for app development, enabling web apps to communicate with hardware without needing plugins, available on Google Play and the Amazon app store.

    MagTek Reader Management System, iOS

    An iOS app that is part of a suite of tools for remotely configuring and updating a large number of geographically dispersed MagTek readers across an enterprise, including the DynaFlex II Go and other Dyna devices.

    MagTek Reader Management System, Windows App

    A Windows application that automates the configuration and firmware updates for a wide range of MagTek readers, including all DynaFlex II models, across an enterprise deployment.

    Description

    Summary

    EMV Updates Utility - (Web)

    A configuration utility for a variety of DynaFlex and DynaProx devices used to change or update EMV configurations, run demo EMV transactions, upload bitmap images, and parse TLV data.

    MagneFlex Prism – Navy/Blue/Sky – Demo

    A demo web page designed to illustrate the functionality of the MagneFlex Browser, which can be launched on Android, iOS, and Windows versions of the browser.

    MTUSDK Omni, Android

    A sample Android application provided with the MTUSDK that demonstrates communication with MagTek card readers (including the DynaFlex II Go) and simulates a transaction process.

    Description

    Summary

    MagneFlex Navy, Browser, MFX 2.0 for Windows x64

    A full-function HTML browser application for Windows x64, featuring a developer mode for debugging JavaScript, improved HTML/framework rendering, and tabbed browsing.

    MagneFlex Navy, Browser, MFX 2.0 for Windows x86

    A full-function HTML browser application for Windows x86, featuring the same developer tools and modern rendering capabilities as the x64 version.

    Description

    Summary

    MagneFlex Powder Middleware

    A lightweight middleware application that manages communications between a POS application and the hardware for DynaFlex and DynaProx products, streamlining data processing.

    Manuals

    API/SDK

    Apps

    Demo Programs

    Magneflex Browser

    MagneFlex Middleware

    Need Help?

    For additional support, please contact MagTek Support:

    Technical Support:

    • 📧 Email: support@magtek.com

    • 📞 Phone: 1-800-788-6835 (US) | +1-562-546-6616 (International)

    • 🕐 Hours: Monday-Friday, 6:00 AM - 5:00 PM PST

    Online Resources:

    • 🌐 Official Site:

    • 💬 Developer Forum:

    Documentation Feedback:

    Help us improve this documentation!

    https://www.magtek.com
    https://forum.magtek.com
    MagTek Universal SDK for MMS Devices - (Windows)
    MagTek Universal SDK for MMS Devices (iOS)
    MTUSDK Omni, iOS
    Submit feedback

    Quickstart

    This Quickstart takes you from an unopened DynaFlex II Go to a completed test transaction.

    Applies to: DynaFlex II Go

    Before You Start

    • Your DynaFlex II Go unit

    • USB Cable (or a Bluetooth LE-capable host)

    • Your platform's SDK or the Web demo for sending commands

      • See SDKs & Tools

    • Test keys injected, if you intend to decrypt output

      • See Security & Key Management

    Reference Section

    Information Available

    Quick Installation Guide

    Basic mounting, setup, and connection guide.

    Build with the DynaFlex II Go

    For more help

    Need Help?

    For additional support, please contact MagTek Support:

    Technical Support:

    • 📧 Email: support@magtek.com

    • 📞 Phone: 1-800-788-6835 (US) | +1-562-546-6616 (International)

    • 🕐 Hours: Monday-Friday, 6:00 AM - 5:00 PM PST

    Online Resources:

    • 🌐 Official Site:

    • 💬 Developer Forum:

    Documentation Feedback:

    Help us improve this documentation!

    https://www.magtek.com
    https://forum.magtek.com
    Submit feedback