All pages
Powered by GitBook
1 of 6

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

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.

Applies to: DynaProx

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.

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 with the sections this device relies on linked below.

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.

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

Reference Section

Information Available

Command Support Across Products

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

Applies to: DynaProx

In this manual

API & Command Reference

Message Format & Structure

See Also

Need Help?

For additional support, please contact MagTek Support:

Technical Support:

  • 📧 Email: support@magtek.com

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.

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!

About Messages

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.

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

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

    Documentation Feedback:

    Help us improve this documentation!

    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:

    📞 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

    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.

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

    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.

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

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

    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
    Battery Charged - Notification 0x1001

    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:

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

    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

    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.

    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
    feedback@magtek.com
    User Interface Settings - A
    User Interface Settings - B
    Bluetooth LE Device Name
    Security Settings
    System Settings
    China Union Pay Kernel ID (Contactless Only) (Common Kernel)
    Custom UI
    Submit feedback