All pages
Powered by GitBook
1 of 1

Loading...

Commands

These are the MagTek Messaging Schema (MMS) commands supported by the DynaProx contactless reader, grouped by function — payment transactions, NFC/MIFARE pass-through, user-interface control (barcode, buzzer, card emulation), device control and settings, file operations, security, and diagnostics. Each entry links to the command's full definition — request and response layout, parameters, and examples — in the shared DynaFamily (MMS) Programmer's Manual. Use this page as your index when integrating the DynaProx into a host application.

Applies to: DynaProx

Transaction - Group 0x10nn

Reference Section

Information Available

The host uses this command to start a payment transaction.

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

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

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

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

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

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

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

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

Resume Transaction - Command 0x1004

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

Cancel Transaction - Command 0x1008

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

Reference Section

Information Available

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

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

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

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

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

Reference Section

Information Available

Report Cardholder Selection - Command 0x1802

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

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

Reference Section

Information Available

Reset Device - Command 0x1F01

The host uses this command to reset the device.

Set Notification Subscriptions - Command 0x1F02

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

Reference Section

Information Available

Get Property - Command 0xD101

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

Set Property (Unsecured) - Command 0xD111

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

Set Property (Secured) - Command 0xD112

Reference Section

Information Available

About Files

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

Load Firmware File - Command 0xD801

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

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

Reference Section

Information Available

Commit Firmware from File - Command 0xD901

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

Reference Section

Information Available

Echo - Command 0xDF01

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

Reference Section

Information Available

Get Challenge - Command 0xE001

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

Send Secured Command to Device - Command 0xEEEE

The host uses this command to transmit another command securely

Load Key Using TR-31 - Command 0xEF01

Reference Section

Information Available

Establish Ephemeral KBPK - Command 0xF017

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

NFC/MIFARE Pass-Through - Group 0x11nn

User Interface - Group 0x18nn

Device Control - Group 0x1Fnn

Settings & Information - Group 0xD1nn

File Operation - Group 0xD8nn

Process Files - Group 0xD9nn

Diagnostics & Utilities - Group 0xDFnn

Security - Group 0xEnnn

Manufacturing - Group 0xFnnn

Need Help?

For additional support, please contact MagTek Support:

Technical Support:

  • 📧 Email: support@magtek.com

  • 📞 Phone: 1-562-546-6800 (US)

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

Online Resources:

  • 🌐 Support Portal: developer.magtek.com

Documentation Feedback:

Help us improve this documentation!

Start Transaction - Command 0x1001

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

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

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

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

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

feedback@magtek.com
Pass Through Command for MIFARE Plus, Type 2 - Command 0x1103
Card Emulation - Command 0x1840
Start Send File to Device (Unsecured) - Command 0xD812
Start Get File from Device - Command 0xD821
Get File Info from Device - Command 0xD825
Delete File from Device - Command 0xD831
Change Device Lock Passcode - Command 0xEF07
Get Key Info - Command 0xEF11