All pages
Powered by GitBook
1 of 51

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Compliance

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

Applies to: DynaFlex II PED

Documents

Reference Section

Information Available

Security Policy (PCI PTS POI)

Device Inspection Document

Data Types & Shared TLV 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.

Appendices

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

Appendices

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

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

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

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

Information on how the device formats ARQC messages.

Information on how the device formats ARPC messages

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

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

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

E

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

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).

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)

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

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.

Information on tags used with security parameters.

Information on tags used to identify key types.

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

Information on tags used with GPORT-1 Types. (EMV Contactless Only)

Information on tags used with TR-31 Key Blocks.

Information on tags used with DUKPT Keys.

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

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

Information on CSR File Types.

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

Section

Information available

Primitive Data Types

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

Data Types and Shared TLV Data Objects

Applies to: DynaFlex II SCR

Information in this group

Need Help?

For additional support, please contact MagTek Support:

Technical Support:

  • 📧 Email:

This section will help erase already existing EMV configurations.

)

These are the display limits that are supported.

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 SCR

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:

This section will help erase already existing EMV configurations.

)

These are the display limits that are supported.

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 SCR

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:

Package Inspection Document

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!

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.

Pass-through Commands

Reference Section

Information Available

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

NFC/MIFARE

Working with contactless cards and tags on the DynaFlex II SCR, 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.

Pass-through Commands

Reference Section

Information Available

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

Appendices

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

Applies to: DynaFlex II Go

System Status Information - Property Group 2.3.1.nnn

Reference Section

Information Available

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.

Notifications

MMS notifications are the asynchronous messages the DynaFlex II PED 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.

Firmware & Downloads

This page provides access to the essential software resources for developing with and managing the DynaFlex II SCR 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.

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.

Message Format & Structure

Every exchange with the DynaProx — 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.

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

    About Track Data
    Display Strings
    Encryption Type
    EMV ARQC Type
    EMV ARPC Type
    EMV Batch Data Type
    EMV Terminal Configuration Type
    EMV Processing Configuration File Type
    MV Entry Point Configuration File Type
    EMV Configuration CA Public Keys File Type
    EMV American Express DRL Configuration Type
    Signature Capture File Type
    Security Operation Type
    Security Parameters Type
    Key Information Type
    NFC UID Type
    GPO Response Type
    TR-31 Key Block Type
    DUKPT Key Mapping
    Common File Structure
    Certificate File Type
    Certificate Signing Request (CSR) Files Types
    Card Emulation
    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

    C: Erasing EMV Configurations
    D: Tip & Tax Display Limits (Touch Only
    E: Physical Button
    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

    C: Erasing EMV Configurations
    D: Tip & Tax Display Limits (Touch Only
    E: Physical Button
    support@magtek.com

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

    Reference Section

    Information Available

    This notification reports information about progress and state changes involving the device’s Banking Functions modules

    This notification reports information about progress and state changes that occur during interaction with the Banking Functions modules.

    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

    Transaction Information Update - Notification 0x0101

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

    Applies to: DynaFlex II PED

    From Transactions - Source 0x01nn

    Notifications from Banking Functions (Banking Functions Only) - Source 0x02nn

    Firmware Updates - Source 0x09nn

    From Device - Source 0x10nn

    User Interface - Source 0x18nn

    For more help

    Need Help?

    For additional support, please contact MagTek Support:

    Technical Support:

    • 📧 Email:

    Reference Section

    Information Available

    Installation & Operation Manual

    Quick Installation Guide

    Reference Section

    Information Available

    Universal SDK - .NET

    Universal SDK - Java

    Universal SDK - iOS

    Reference Section

    Information Available

    Latest Firmware

    Applies to: DynaFlex II SCR

    Firmware

    How to Update

    Manuals

    SDKs & Tools

    Need Help?

    For additional support, please contact MagTek Support:

    Technical Support:

    • 📧 Email:

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

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

    Reference Section

    Information Available

    About Messages

    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.

    Applies to: DynaFlex II Go

    Settings & Information - Group 0xD1nn

    Need Help?

    For additional support, please contact MagTek Support:

    Technical Support:

    • 📧 Email:

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

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

    Reference Section

    Information Available

    About Messages

    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.

    Applies to: DynaProx

    Settings & Information - Group 0xD1nn

    For More help

    Need Help?

    For additional support, please contact MagTek Support:

    Technical Support:

    • 📧 Email:

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

    MIFARE DESFire — 0x1102

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

    MIFARE Plus — 0x1103

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

    ISO 14443-4 APDU Pass-Through — 0x3003

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

    Pass-Through Mode Start/Stop — 0x3001

    Enter or leave contactless pass-through mode.

    Start/Stop Polling — 0x3002

    Start or stop the reader polling for a contactless card.

    Card Emulation - 0x1840

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

    Reference Section

    Information Available

    NFC / MIFARE Guide

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

    NFC/MIFARE Guide

    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!

    Applies to: DynaFlex II Go

    NTag / MIFARE Ultralight — 0x1100
    MIFARE Classic / MINI / Plus SL1 — 0x1101

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

    MIFARE DESFire — 0x1102

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

    MIFARE Plus — 0x1103

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

    ISO 14443-4 APDU Pass-Through — 0x3003

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

    Pass-Through Mode Start/Stop — 0x3001

    Enter or leave contactless pass-through mode.

    Start/Stop Polling — 0x3002

    Start or stop the reader polling for a contactless card.

    Card Emulation - 0x1840

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

    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!

    Applies to: DynaFlex II SCR

    NTag / MIFARE Ultralight — 0x1100
    MIFARE Classic / MINI / Plus SL1 — 0x1101

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

    C: Erasing EMV Configurations

    This section will help erase already existing EMV configurations.

    E: Physical Button

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

    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!

    A: Object IDs and ITU-T x660
    B: Barcode Reader Symbologies

    Notifications

    MMS notifications are the asynchronous messages the DynaFlex II SCR 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.

    Applies to: DynaFlex II SCR

    From Transactions - Source 0x01nn

    Reference Section

    Information Available

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

    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)

    Appendices

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

    Applies to: DynaFlex II SCR

    System Status Information - Property Group 2.3.1.nnn

    Reference Section

    Information Available

    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.

    DynaFlex Pro/SCR (Gen I)

    The DynaFlex Family resource hub provides documentation, software, and developer tools for a line of PCI PTS POI certified Secure Card Reader Authenticators (SCRAs) designed for modern, omni‑channel payment environments. The family includes the base DynaFlex, the DynaFlex Pro with a color touchscreen display, and the DynaFlex BCR with barcode scanning, all of which accept magnetic stripe, EMV® contact chip, EMV contactless, and NFC contactless payments (Apple Pay®, Google Pay™, Samsung Pay®) along with 1D/2D barcode scanning. Connectivity options include USB, Bluetooth® LE, and 802.11 wireless networking, all backed by MagTek’s MagneSafe® Security Architecture with AES‑256 encryption and DUKPT key management.

    DynaFlex Pro/SCR (Gen I) Support Page

    Need Help?

    For additional support, please contact MagTek Support:

    Technical Support:

    • 📧 Email:

    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.

    DynaProx

    The DynaProx is a next-generation, EMV Contactless, and NFC Contactless reader from MagTek, designed for original equipment manufacturers (OEMs) and developers building secure payment, access control, and identification solutions. It combines the controller and antenna in a small form-factor, and is available in two models: the standard DynaProx for EMV Contactless, and NFC transactions, and the DynaProx BCR which includes a camera for reading 1D/2D barcodes. The device is engineered with the MagneSafe® Security Architecture, meeting requirements for contactless EMV 3.0 and PCI PTS POI 6.x, and supports triple DEA and AES-256 encryption with DUKPT key management to safeguard sensitive payment data.

    • Contactless (NFC) card and mobile wallet acceptance — tap-to-pay, no contact slot or magnetic stripe

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

    NFC/MIFARE

    Working with contactless cards and tags on the DynaProx, 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
    feedback@magtek.com
    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

    Battery Charged - Notification 0x1001

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

    Transaction Operation Complete - Notification 0x0105
    Banking Functions Information Update - 0x0201
    Banking Functions Operations Complete - 0x0206
    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
    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

    Universal SDK - Linux

    MagneFlex Browser Web API

    OID Converter

    EMVConfiguration Console

    Firmware Update Utility

    BCR Utility

    Demos & Sample Code

    Reader Management System (RMS)

    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

    Message Format
    Message Structure
    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

    Message Format
    Message Structure
    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

    DynaFlex Pro/SCR (Gen I) >

    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.

    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:

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

  • Compact contactless reader for attended checkout, transit, and access control

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

  • Reference Section

    Information Available

    Programmer's Manual

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

    Commands

    The commands DynaProx 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 DynaProx: message format, commands, notifications, configuration, and status codes.

    Compliance

    Compliance documentation for the DynaProx, including inspection documents.

    Applies to: DynaProx

    Key capabilities

    Build with the DynaProx

    Downloads & Compliance

    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: DynaProx

    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:

    Transaction Operation Complete - Notification 0x0105

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

    Reference Section

    Information Available

    Firmware Update Successful - Notification 0x0905

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

    Firmware Update Failed - Notification 0x0906

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

    Firmware is Up to Date - Notification 0x0907

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

    Reference Section

    Information Available

    Device Information Update - Notification 0x1001

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

    Reference Section

    Information Available

    User Interface Host Action Request - Notification 0x1803

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

    User Interface Operation Complete - Notification 0x1805

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

    Firmware Updates - Source 0x09nn

    From Device - Source 0x10nn

    User Interface - Source 0x18nn

    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!

    Transaction Information Update - Notification 0x0101

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

    C: Erasing EMV Configurations

    This section will help erase already existing EMV configurations.

    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!

    A: Object IDs and ITU-T x660
    B: Barcode Reader Symbologies

    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 SCR

    About Configuration

    Reference Section

    Information Available

    Detail on configuring the DynaFlex II SCR device.

    Financial Settings - Property Group 1.1.nnnn

    Notifications

    MMS notifications are the asynchronous messages the DynaProx 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.

    Applies to: DynaProx

    From Transactions - Source 0x01nn

    Reference Section

    Information Available

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

    Firmware & Downloads

    This page provides access to the essential software resources for developing with and managing the DynaFlex II PED 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.

    Applies to: DynaFlex II PED

    Firmware

    Reference Section

    Information Available

    Latest Firmware

    DynaFamily (MMS Dyna Devices)

    This page provides resources for MagTek's MMS (MagTek Messaging Schema) Dyna device family, which includes secure card readers and PIN pads that communicate using the MMS command set. These devices support reading magnetic stripe, EMV® Contact Chip, EMV Contactless, NFC Mobile Wallets, Non-payment NFC technologies, and 1D/2D barcodes. Here you will find documentation covering device communication protocols, developer tools, and configuration guides for various Dyna device models.

    DynaFamily (MMS Dyna Devices)

    Product

    Description

    Programmer’s manuals, technical reference guides, software/SDKs, FAQs, and instructional videos for the DynaFlex II Secure Card Reader.

    Message Format & Structure

    Every exchange with the DynaFlex II SCR — 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 Dyna-family readers and is documented once in the shared reference.

    Applies to: DynaFlex II SCR

    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.

    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.

    Data Types & Shared TLV 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.

    NFC/MIFARE

    Working with contactless cards and tags on the DynaFlex II PED, 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.

    Compliance

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

    DynaFlex II SCR

    The DynaFlex II SCR is a compact, countertop secure card reader authenticator (SCRA) that reads contact chip, contactless (NFC), and magnetic-stripe cards and encrypts cardholder data at the point of read (SRED). It connects over USB and uses the shared DynaFamily MMS command set, so everything you build against it is documented in the API & Command Reference and linked below.

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

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

    Programmer's Manual

    The DynaFlex II SCR uses the shared DynaFamily Multi-Interface Card Reader Platform (MMS) command set. This manual is a device-scoped map into the with the sections this device relies on linked below.

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

    Transaction Operation Complete - Notification 0x0105
    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

    Security & Keys

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

    NFC/MIFARE

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

    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

    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.

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

    Configure the device's system settings

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

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

    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.

    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.

    USB Settings (USB Only)

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

    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.

    System Status Device State Information

    The device uses this property to report its operational 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

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

    Transaction Operation Complete - Notification 0x0105

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

    Reference Section

    Information Available

    Firmware Update Successful - Notification 0x0905

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

    Firmware Update Failed - Notification 0x0906

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

    Firmware is Up to Date - Notification 0x0907

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

    Reference Section

    Information Available

    Device Information Update - Notification 0x1001

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

    Low Battery Warning - Notification 0x1001

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

    Low Battery Shutdown - Notification 0x1001

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

    Reference Section

    Information Available

    User Interface Host Action Request - Notification 0x1803

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

    User Interface Operation Complete - Notification 0x1805

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

    Firmware Updates - Source 0x09nn

    From Device - Source 0x10nn

    User Interface - Source 0x18nn

    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!

    Transaction Information Update - Notification 0x0101

    Universal SDK - Linux

    MagneFlex Browser Web API

    OID Converter

    EMVConfiguration Console

    Firmware Update Utility

    BCR Utility

    Demos & Sample Code

    Reader Management System (RMS)

    How to Update

    Reference Section

    Information Available

    Installation & Operation Manual

    Quick Installation Guide

    Reference Section

    Information Available

    Universal SDK - .NET

    Universal SDK - Java

    Universal SDK - iOS

    Manuals

    SDKs & Tools

    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!

    Reference Section

    Information Available

    Part A of EMV Terminal ID settings.

    Part B of EMV Terminal ID settings.

    Part C of EMV Terminal ID settings.

    Reference Section

    Information Available

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

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

    Reference Section

    Information Available

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

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

    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

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

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

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

    Reference Section

    Information Available

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

    Reference Section

    Information Available

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

    The device uses this property to report its security status.

    The device uses this property to report its operational status.

    Reference Section

    Information Available

    About

    Detail on configuring the DynaFlex II PED device.

    Applies to: DynaFlex II PED

    About Configuration

    Financial Settings - Property Group 1.1.nnnn

    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:

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

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

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

    Information on how the device formats ARQC messages.

    Information on how the device formats ARPC messages

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

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

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

    E

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

    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).

    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)

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

    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.

    Information on tags used with security parameters.

    Information on tags used to identify key types.

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

    Information on tags used with TR-31 Key Blocks.

    Information on tags used with DUKPT Keys.

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

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

    Information on CSR File Types.

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

    Section

    Information available

    Primitive Data Types

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

    Data Types and Shared TLV Data Objects

    Applies to: DynaFlex II PED

    Information in this group

    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

    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 PED

    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.

    For More Help

    Need Help?

    For additional support, please contact MagTek Support:

    Technical Support:

    • 📧 Email:

    Package Inspection Document

    Reference Section

    Information Available

    Security Policy (PCI PTS POI)

    Device Inspection Document

    Applies to: DynaFlex II SCR

    Documents

    For more help

    Need Help?

    For additional support, please contact MagTek Support:

    Technical Support:

    • 📧 Email:

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

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

  • Compact countertop secure card reader authenticator (SCRA)

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

  • Section

    Description

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

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

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

    Section

    Description

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

    Compliance documentation for the SCR, including inspection documents.

    Applies to: DynaFlex II SCR

    Key capabilities

    Build with the DynaFlex II SCR

    Downloads & Compliance

    For more help

    Need Help?

    For additional support, please contact MagTek Support:

    Technical Support:

    • 📧 Email:

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

    The shared TLV and EMV objects the commands carry.

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

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

    Configurable properties and parameters.

    Result and error codes the device returns.

    • Security & Keys --> How the SCR 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 SCR'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).

    Reference Section

    Information Available

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

    Applies to: DynaFlex II SCR

    In this manual

    API & Command Reference

    See Also

    Need Help?

    For additional support, please contact MagTek Support:

    Technical Support:

    • 📧 Email:

    ​​DynaFlex II PED

    Brochures, programmer’s manuals, compliance documents, and software tools for the DynaFlex II PED, a PIN Entry Device.

    DynaFlex II Go

    Programmer's manuals, documentation, software, and FAQ videos for the portable DynaFlex II Go SCR, a Secure Card Reader.

    DynaProx

    Programmer’s manuals, and compliance documents for the DynaProx EMV Contactless, and NFC Contactless reader.

    DynaFlex Pro/SCR (Gen I)

    Programmer’s manuals, compliance documents, and software tools for the DynaFlex Pro/SCR (Gen I) PCI PTS POI certified Secure Card Reader Authenticators reader.

    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!

    DynaFlex II SCR​​

    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

    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

    Firmware & Downloads

    This page provides access to the essential software resources for developing with and managing the DynaProx 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.

    Applies to: DynaProx

    Firmware

    Reference Section

    Information Available

    Latest Firmware

    Compliance

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

    Applies to: DynaFlex II PED

    Documents

    Reference Section

    Information Available

    Security Policy (PCI PTS POI)

    Device Inspection Document

    Message Format & Structure

    Every exchange with the DynaFlex II PED — 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 Dyna-family readers and is documented once in the shared reference.

    Applies to: DynaFlex II PED

    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.

    Quick Installation Guide

    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.

    DynaFlex II Go Major Components

    Top Face

    Data Types & Shared TLV 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.

    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.

    feedback@magtek.com
    feedback@magtek.com
    feedback@magtek.com
    feedback@magtek.com
    User Interface Settings - A
    User Interface Settings - B
    Security Settings
    System Settings
    China Union Pay Kernel ID (Contactless Only) (Common Kernel)
    Custom UI
    feedback@magtek.com
    Battery Charged - Notification 0x1001

    📞 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

    WLAN Settings (WLAN Only) - A

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

    WLAN Settings (WLAN Only) - B

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

    USB Settings (USB Only)

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

    User Interface Settings - A

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

    User Interface Settings - B

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

    Bluetooth LE Device Name

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

    Security Settings

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

    System Settings

    Configure the device's system settings

    China Union Pay Kernel ID (Contactless Only) (Common Kernel)

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

    WLAN Information (WLAN Only)

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

    Custom UI

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

    NFC

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

    EMV Settings A
    EMV Settings B
    EMV Settings C
    SRED Settings - Property Subgroup 1.1.2.nnn - A
    SRED Settings - Property Subgroup 1.1.2.nnn - B
    Transaction Settings - A
    Transaction Settings - B
    Basic Properties
    Firmware Identification Information
    Core Firmware Information
    EMV Firmware Information
    Device Common Configuration Information
    System Status Injected Key Information
    System Status Security Protection Information
    System Status Device State Information
    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

    About Track Data
    Display Strings
    Encryption Type
    EMV ARQC Type
    EMV ARPC Type
    EMV Batch Data Type
    EMV Terminal Configuration Type
    EMV Processing Configuration File Type
    MV Entry Point Configuration File Type
    EMV Configuration CA Public Keys File Type
    EMV American Express DRL Configuration Type
    Signature Capture File Type
    Security Operation Type
    Security Parameters Type
    Key Information Type
    NFC UID Type
    TR-31 Key Block Type
    DUKPT Key Mapping
    Common File Structure
    Certificate File Type
    Certificate Signing Request (CSR) Files Types
    Card Emulation
    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
    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

    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

    Security & Keys

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

    NFC/MIFARE

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

    Programmer's Manual
    Commands
    Command Support Across Products
    Firmware & Downloads
    Compliance
    support@magtek.com

    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

    Universal SDK - Linux

    MagneFlex Browser Web API

    OID Converter

    EMVConfiguration Console

    Firmware Update Utility

    BCR Utility

    Demos & Sample Code

    Reader Management System (RMS)

    How to Update

    Reference Section

    Information Available

    Installation & Operation Manual

    Quick Installation Guide

    Reference Section

    Information Available

    Universal SDK - .NET

    Universal SDK - Java

    Universal SDK - iOS

    Manuals

    SDKs & Tools

    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!

    📞 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

    Message Format & Structure
    Data Types & Shared TLV Objects
    Commands
    Notifications
    Configurations
    Status Codes & Responses
    support@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)

    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: https://www.magtek.com/content/documentationfiles/d998200650.pdf

    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: https://www.magtek.com/content/documentationfiles/d998200651.pdf

    Overview

    Major Components

    Environmental Notice

    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

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

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

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

    Information on how the device formats ARQC messages.

    Information on how the device formats ARPC messages

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

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

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

    E

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

    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).

    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)

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

    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.

    Information on tags used with security parameters.

    Information on tags used to identify key types.

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

    Information on tags used with GPORT-1 Types. (EMV Contactless Only)

    Information on tags used with TR-31 Key Blocks.

    Information on tags used with DUKPT Keys.

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

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

    Information on CSR File Types.

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

    Section

    Information available

    Primitive Data Types

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

    Data Types and Shared TLV Data Objects

    Applies to: DynaFlex II PED

    Information in this group

    Need Help?

    For additional support, please contact MagTek Support:

    Technical Support:

    • 📧 Email:

    Reference Section

    Information Available

    Part A of EMV Terminal ID settings.

    Part B of EMV Terminal ID settings.

    Part C of EMV Terminal ID settings.

    Reference Section

    Information Available

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

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

    Reference Section

    Information Available

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

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

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

    Reference Section

    Information Available

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

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

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

    Reference Section

    Information Available

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

    Reference Section

    Information Available

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

    The device uses this property to report its security status.

    The device uses this property to report its operational status.

    Reference Section

    Information Available

    About

    Detail on configuring the DynaProx device.

    Applies to: DynaProx

    About Configuration

    Financial Settings - Property Group 1.1.nnnn

    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:

    Package Inspection Document

    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!

    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

    Security & Keys

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

    Applies to: DynaFlex II SCR

    Security & Key Guides

    Reference Section

    Information Available

    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.

    DynaFlex II PED

    The DynaFlex II PED is a PCI PTS v6.x PED, a certified PIN Entry Device from MagTek, designed to meet the security demands of modern payment, banking, and point-of-sale applications. It supports a wide range of payment methods, including magnetic stripe, EMV® Contact Chip, EMV Contactless, and NFC Contactless payments, as well as 1D/2D barcode scanning. The device features a touchscreen for PIN entry, manual card data entry, and signature capture, and connects to Windows and Android host devices via USB and Windows, iOS, Linux, and Android via WebSocket or MQTT. The official MagTek DynaFlex II PED support page is a central hub containing all the resources you'll need. There you can find detailed product brochures, compliance documentation, software development kits (SDKs) such as the MagneFlex Powder API, comprehensive programmer’s manuals, and helpful resources including FAQs and instructional videos.

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

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

    📞 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

    About Track Data
    Display Strings
    Encryption Type
    EMV ARQC Type
    EMV ARPC Type
    EMV Batch Data Type
    EMV Terminal Configuration Type
    EMV Processing Configuration File Type
    MV Entry Point Configuration File Type
    EMV Configuration CA Public Keys File Type
    EMV American Express DRL Configuration Type
    Signature Capture File Type
    Security Operation Type
    Security Parameters Type
    Key Information Type
    NFC UID Type
    GPO Response Type
    TR-31 Key Block Type
    DUKPT Key Mapping
    Common File Structure
    Certificate File Type
    Certificate Signing Request (CSR) Files Types
    Card Emulation
    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

    User Interface Settings - A

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

    User Interface Settings - B

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

    Bluetooth LE Device Name

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

    Security Settings

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

    System Settings

    Configure the device's system settings

    China Union Pay Kernel ID (Contactless Only) (Common Kernel)

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

    Custom UI

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

    EMV Settings A
    EMV Settings B
    EMV Settings C
    SRED Settings - Property Subgroup 1.1.2.nnn - A
    SRED Settings - Property Subgroup 1.1.2.nnn - B
    Transaction Settings - A
    Transaction Settings - B
    USB Settings (USB Only)
    Firmware Identification Information
    Core Firmware Information
    EMV Firmware Information
    Device Common Configuration Information
    System Status Injected Key Information
    System Status Security Protection Information
    System Status Device State Information
    support@magtek.com
    SRED point-to-point encryption at the moment of read (TDES / AES DUKPT)
  • PIN entry on a secure PIN pad for PIN debit and cardholder verification

  • Full color touch display for on-screen prompts, cardholder selection, and signature capture

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

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

  • PCI PTS POI–approved SCRA for attended, countertop acceptance

  • Reference Section

    Information Available

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

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

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

    Reference Section

    Information Available

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

    Compliance documentation for the PED, including inspection documents.

    Applies to: DynaFlex II PED

    Key capabilities

    Build with the DynaFlex II PED

    Downloads & Compliance

    For more help

    Need Help?

    For additional support, please contact MagTek Support:

    Technical Support:

    • 📧 Email:

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

    DUKPT: 3DES/TDEA --> AES Migration
    Key Serial Numbers (KSN)

    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.

    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

    Security & Keys

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

    NFC/MIFARE

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

    Programmer's Manual
    Commands
    Command Support Across Products
    Firmware & Downloads
    Compliance
    support@magtek.com

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

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

    Reference Section

    Information Available

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

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

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

    Reference Section

    Information Available

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

    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

    Basic details about generic pass-through commands.

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

    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

    The host uses this command to reset the device.

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

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

    Reference Section

    Information Available

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

    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

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

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

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

    Reference Section

    Information Available

    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.

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

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

    Reference Section

    Information Available

    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

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

    Reference Section

    Information Available

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

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

    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

    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).

    Reference Section

    Information Available

    Start Transaction - Command 0x1001

    The host uses this command to start a payment transaction.

    Applies to: DynaFlex II Go

    Transaction - Group 0x10nn

    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:

    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.

    📞 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

    Pass Through Command for MIFARE Plus, Type 2 - Command 0x1103

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

    Read Barcode (BCR Only) - Command 0x1804

    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.

    Buzzer - Command 0x1805

    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.

    Personal Info Entry - Command 0x1806

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

    Show Image - Command 0x1821

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

    Show QR Code - Command 0x1822

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

    Show Bitmap Image - Command 0x1823

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

    Display Flexible UI Pages - Command 0x1830

    This command allows the host to bring up standalone pages.

    LED Control - Command 0x1807

    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 - Command 0x1840

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

    ISO 14443-4 APDU Pass-Through Commands - Command 0x3003

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

    Start Send File to Device (Unsecured) - Command 0xD812

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

    Start Get File from Device - Command 0xD821

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

    Get File Info from Device - Command 0xD825

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

    Delete File from Device - Command 0xD831

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

    Change Device Lock Passcode - Command 0xEF07

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

    Get Key Info - Command 0xEF11

    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
    Cancel Transaction - Command 0x1008
    Pass Through Command For NTag/MIFARE Ultralight, Type 2 - Command 0x1100
    Pass Through Command for MIFARE Classic/MINI®/Plus SL1 (Security Level 1), Type 2 - Command 0x1101
    Pass Through Command for MIFARE DESFire, Type 4 - Command 0x1102
    Request Cardholder Signature - Command 0x1801
    Report Cardholder Selection - Command 0x1802
    About
    Pass-Through Mode Start/Stop - Command 0x3001
    Start/Stop Polling - Command 0x3002
    Reset Device - Command 0x1F01
    Set Notification Subscriptions - Command 0x1F02
    Extend Session - Command 0x1F03
    Request PIN with Host Supplied Account Data - 0x2001
    Request PIN with Card Supplied Account Data 0x2002
    Get Property - Command 0xD101
    Set Property (Unsecured) - Command 0xD111
    Set Property (Secured) - Command 0xD112
    About Files
    Load Firmware File - Command 0xD801
    Start Send File to Device (Secured) - Command 0xD811
    Commit Firmware from File - Command 0xD901
    Echo - Command 0xDF01
    Get Challenge - Command 0xE001
    Send Secured Command to Device - Command 0xEEEE
    Load Key Using TR-31 - Command 0xEF01
    Establish Ephemeral KBPK - Command 0xF017
    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)

    GPO Response Type

    Information on tags used with GPORT-1 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

    Commands

    The DynaFlex II SCR 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 SCR supports, each linking into that reference.

    feedback@magtek.com

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

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

    Reference Section

    Information Available

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

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

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

    Reference Section

    Information Available

    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.

    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.

    Reference Section

    Information Available

    The host uses this command to reset the device.

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

    Reference Section

    Information Available

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

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

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

    Reference Section

    Information Available

    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.

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

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

    Reference Section

    Information Available

    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

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

    Reference Section

    Information Available

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

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

    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

    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).

    Reference Section

    Information Available

    Start Transaction - Command 0x1001

    The host uses this command to start a payment transaction.

    Applies to: DynaFlex II SCR

    Transaction - Group 0x10nn

    NFC/MIFARE Pass-Through - Group 0x11nn

    User Interface - Group 0x18nn

    Device Control - Group 0x1Fnn

    Setting & 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:

    Security & Keys

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

    Security & Keys

    How the DynaProx protects cardholder data and manages keys. These are shared DynaFamily concepts, documented in the Guides Section:

    📞 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

    Pass Through Command for MIFARE Plus, Type 2 - Command 0x1103

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

    Personal Info Entry - Command 0x1806

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

    Card Emulation - Command 0x1840

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

    Start Send File to Device (Unsecured) - Command 0xD812

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

    Start Get File from Device - Command 0xD821

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

    Get File Info from Device - Command 0xD825

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

    Delete File from Device - Command 0xD831

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

    Change Device Lock State - Command 0xEF06

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

    Change Device Lock Passcode - Command 0xEF07

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

    Encrypt User Data - Command 0xEF09

    The host uses this command to request that the device encrypt a block of user data embedded in the command string.

    Get Key Info - Command 0xEF11

    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
    Cancel Transaction - Command 0x1008
    Pass Through Command For NTag/MIFARE Ultralight, Type 2 - Command 0x1100
    Pass Through Command for MIFARE Classic/MINI®/Plus SL1 (Security Level 1), Type 2 - Command 0x1101
    Pass Through Command for MIFARE DESFire, Type 4 - Command 0x1102
    Report Cardholder Selection - Command 0x1802
    Read Barcode (BCR Only) - Command 0x1804
    Buzzer - Command 0x1805
    Reset Device - Command 0x1F01
    Set Notification Subscriptions - Command 0x1F02
    Get Property - Command 0xD101
    Set Property (Unsecured) - Command 0xD111
    Set Property (Secured) - Command 0xD112
    About Files
    Load Firmware File - Command 0xD801
    Start Send File to Device (Secured) - Command 0xD811
    Commit Firmware from File - Command 0xD901
    Echo - Command 0xDF01
    Get Challenge - Command 0xE001
    Send Secured Command to Device - Command 0xEEEE
    Load Key Using TR-31 - Command 0xEF01
    Establish Ephemeral KBPK - Command 0xF017
    support@magtek.com

    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

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

    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)

    Applies to: DynaFlex II Go

    Security & Key Guides

    Guides Section:

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

    Full Security & Key Guides Section

    For more help

    Need Help?

    For additional support, please contact MagTek Support:

    Technical Support:

    • 📧 Email: support@magtek.com

    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

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

    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)

    Applies to: DynaProx

    Security & Key Guides

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

    Full Security & Key Guides Section

    For more help

    Need Help?

    For additional support, please contact MagTek Support:

    Technical Support:

    • 📧 Email: support@magtek.com

    Programmer's Manual

    The DynaFlex II PED uses the shared DynaFamily 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 PED

    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 PED 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 PED'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).

    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

    Commands

    The DynaFlex II PED 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 PED supports, each linking into that reference.

    📞 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: https://www.magtek.com

    • 💬 Developer Forum: https://forum.magtek.com

    Documentation Feedback:

    Help us improve this documentation!

    Security & Key Guides

    📞 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: https://www.magtek.com

    • 💬 Developer Forum: https://forum.magtek.com

    Documentation Feedback:

    Help us improve this documentation!

    Security & Key Guides

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

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

    Reference Section

    Information Available

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

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

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

    Reference Section

    Information Available

    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.

    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.

    Reference Section

    Information Available

    Basic details about generic pass-through commands.

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

    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

    The host uses this command to reset the device.

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

    The host can use this command to terminate a Bluetooth LE connection.

    Reference Section

    Information Available

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

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

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

    Reference Section

    Information Available

    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.

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

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

    Reference Section

    Information Available

    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

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

    Reference Section

    Information Available

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

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

    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

    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).

    Reference Section

    Information Available

    Start Transaction - Command 0x1001

    The host uses this command to start a payment transaction.

    Applies to: DynaFlex II PED

    Transaction - Group 0x10nn

    NFC/MIFARE Pass-Through - Group 0x11nn

    User Interface - Group 0x18nn

    Generic Pass-Through - Group 0x30nn

    Device Control - Group 0x1Fnn

    Setting & 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:

    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 PED 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

    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!

    Command Support Across Products

    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!

    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).

    📞 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

    Pass Through Command for MIFARE Plus, Type 2 - Command 0x1103

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

    Personal Info Entry - Command 0x1806

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

    LED Control - Command 0x1807

    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 - Command 0x1840

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

    ISO 14443-4 APDU Pass-Through Commands - Command 0x3003

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

    Erase All Bluetooth LE Bonds (Bluetooth LE Only) - Command 0x1F05

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

    Start Send File to Device (Unsecured) - Command 0xD812

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

    Start Get File from Device - Command 0xD821

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

    Get File Info from Device - Command 0xD825

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

    Delete File from Device - Command 0xD831

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

    Change Device Lock State - Command 0xEF06

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

    Change Device Lock Passcode - Command 0xEF07

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

    Get Key Info - Command 0xEF11

    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
    Cancel Transaction - Command 0x1008
    Pass Through Command For NTag/MIFARE Ultralight, Type 2 - Command 0x1100
    Pass Through Command for MIFARE Classic/MINI®/Plus SL1 (Security Level 1), Type 2 - Command 0x1101
    Pass Through Command for MIFARE DESFire, Type 4 - Command 0x1102
    Report Cardholder Selection - Command 0x1802
    Read Barcode (BCR Only) - Command 0x1804
    Buzzer - Command 0x1805
    About
    Pass-Through Mode Start/Stop - Command 0x3001
    Start/Stop Polling - Command 0x3002
    Reset Device - Command 0x1F01
    Set Notification Subscriptions - Command 0x1F02
    Terminate Bluetooth LE Connection (Bluetooth LE Only) - Command 0x1F04
    Get Property - Command 0xD101
    Set Property (Unsecured) - Command 0xD111
    Set Property (Secured) - Command 0xD112
    About Files
    Load Firmware File - Command 0xD801
    Start Send File to Device (Secured) - Command 0xD811
    Commit Firmware from File - Command 0xD901
    Echo - Command 0xDF01
    Get Challenge - Command 0xE001
    Send Secured Command to Device - Command 0xEEEE
    Load Key Using TR-31 - Command 0xEF01
    Establish Ephemeral KBPK - Command 0xF017
    support@magtek.com

    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
    https://www.magtek.com
    https://forum.magtek.com
    https://www.magtek.com
    https://forum.magtek.com

    Programmer's Manual

    The DynaProx uses the shared DynaFamily 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: DynaProx

    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 DynaProx 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 DynaProx'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 DynaProx 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

    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.

    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

    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.

    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.

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

    Description

    Summary

    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.

    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.

    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

    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.

    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.

    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.

    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.

    Description

    Summary

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

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

    Description

    Summary

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

    Reference Section

    Information Available

    Latest Firmware

    DynaFlex II Go Documentation

    Firmware

    How to Update

    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

    https://www.magtek.com
    https://forum.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!

    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.

    Reader Management System, Linux, Sample Code
    MagTek Universal SDK for MMS Devices, (Android)
    MagTek Universal SDK for MMS Devices - (Linux)
    MagneFlex Sky, Browser App, Android
    MagTek Reader Management System, iOS
    MagTek Reader Management System, Windows App
    EMV Updates Utility - (Web)
    MagneFlex Prism – Navy/Blue/Sky – Demo
    MTUSDK Omni, Android
    MagneFlex Navy, Browser, MFX 2.0 for Windows x64
    MagneFlex Navy, Browser, MFX 2.0 for Windows x86
    MagneFlex Powder Middleware
    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

    Security & Keys

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

    Applies to: DynaFlex II PED

    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
    Command Support Across Products
    Submit feedback
    Submit feedback
    Submit feedback
    Submit feedback
    Submit feedback
    Submit feedback
    Submit feedback
    Submit feedback
    Submit feedback