# Programmer's Manuals (Commands)


April 2025 Document Number: D998200597-113 REGISTERED TO ISO 9001:2015

April 2025

Document Number: D998200597-113

REGISTERED TO ISO 9001:2015

INFORMATION IN THIS PUBLICATION IS SUBJECT TO CHANGE WITHOUT NOTICE. MAGTEK CANNOT BE HELD LIABLE FOR ANY USE OF THE CONTENTS OF THIS DOCUMENT. ANY CHANGES OR IMPROVEMENTS MADE TO THIS PRODUCT WILL BE INCLUDED IN THE NEXT PUBLICATION RELEASE. IF YOU HAVE QUESTIONS ABOUT SPECIFIC FEATURES AND FUNCTIONS OR WHEN THEY WILL BECOME AVAILABLE, PLEASE CONTACT YOUR MAGTEK REPRESENTATIVE. MagTek®, MagnePrint®, and MagneSafe® are registered trademarks of MagTek, Inc. Magensa™ is a trademark of MagTek, Inc. AAMVA™ is a trademark of AAMVA. American Express® and EXPRESSPAY FROM AMERICAN EXPRESS® are registered trademarks of American Express Marketing & Development Corp. D-PAYMENT APPLICATION SPECIFICATION® is a registered trademark of Discover Financial Services CORPORATION MasterCard® is a registered trademark and PayPass™ and Tap & Go™ are trademarks of MasterCard International Incorporated. Visa® and Visa payWave® are registered trademarks of Visa International Service Association. ANSI®, the ANSI logo, and numerous other identifiers containing "ANSI" are registered trademarks, service marks, and accreditation marks of the American National Standards Institute (ANSI). ISO® is a registered trademark of the International Organization for Standardization. UL™ and the UL logo are trademarks of UL LLC. PCI Security Standards Council® is a registered trademark of the PCI Security Standards Council, LLC. EMV® is a registered trademark in the U.S. and other countries and an unregistered trademark elsewhere. The EMV trademark is owned by EMVCo, LLC. The Contactless Indicator mark, consisting of four graduating arcs, is a trademark owned by and used with permission of EMVCo, LLC. The *Bluetooth*® word mark and logos are registered trademarks owned by Bluetooth® SIG, Inc. and any use of such marks by MagTek is under license. Google Play™ store, Google Wallet™ payment service, and Android™ platform are trademarks of Google LLC. Apple Pay®, iPhone®, iPod®, Mac®, and OS X® are registered trademarks of Apple Inc., registered in the U.S. and other countries. iPad™ is a trademark of Apple. Inc. App Store^SM is a service mark of Apple Inc., registered in the U.S. and other countries. IOS is a trademark or registered trademark of Cisco in the U.S. and other countries and is used by Apple Inc. under license. Microsoft®, Windows®, and .NET® are registered trademarks of Microsoft Corporation. MIFARE, the MIFARE logo, MIFARE Ultralight, MIFARE Plus, MIFARE Classic, MIFARE MINI®, MIFARE FleX, DESFire, and MIFARE4Mobile are registered trademarks of NXP B.V. All other system names and product names are the property of their respective owners. ## Revisions


Rev Number	Date	Notes
100	August 2, 2023	Initial release
101	October 10, 2023	Added definition of 00 03 00 00 in 7.3.1 Notification 0x1001 - Device Information Update ; Added NFC UID support in 4.16 NFC UID Type (EMV Contactless Only) , Table 7.1-1 - Notification Detail Codes , Table 7.1-2 - Notification Payload for Data Update, ARQC Update (Quick Chip), Data Attached , Table 7.1-7 - Notification Detail Codes; add detection and removal user event notification in 7.3.1 Notification 0x1001 - Device Information Update ; Add Property 2.3.1.2.1.5 Battery Charger Status Update tables for FW Update, Table 6.6-2 - Request Data for Command 0xD801 - Load Firmware File. Table 6.7-1 - Request Data for Command 0xD901 - Commit Firmware from File; Updated Message Length from 60 to 61 in Table 2.1-3 - Multi-Packet Middle Format ; Clarified Message size in Table 2.1-2 - Multi-Packet Head Format ; Add DynaFlex II Go USB PID and Get/Set Property command, Device Family ID, Product ID; Updated notification code for Battery Charge complete to 00 02 02 00 in Table 7.3-1 - Notification Detail Codes ; updated Table 7.3-1 - Notification Detail Codes to distinguish 1K or 4K Mifare Classic cards; Add DynaFlex II Go on page 1; Add NFC pass through flow description in Command 0x1001 - Start Transaction; Add BCR encryption bit to 8.3.6.4 Property 1.2.7.1.2.1 User Event Notification Controls Enable; Updated NFC Removal Code from -x50 to 0x05 in Table 7.1-7 - Notification Detail Codes ; Updated Table 6.2-1 - Request Data for , Table 6.2-7 - Request Example (Get Version), Table 6.2-8 - Response Example (Get Version), Table 7.3-1 - Notification Detail Codes, Add Table 7.3-7 - Notification Payload for UID, Table 7.3-8 – Notification Payload for UID Example; Update Table 6.2-1 - Request Data for ; Add tags 82 and 9F6E in the clear text portion of the ARQC Message - EMV ARQC (DynaPro Format) Type ; Removed Tag 84 on these payloads message to match firmware Table 7.4-2, Table 7.4-3; Add 24 Hour Automatic Reset PCI Requirement and Property 1.2.7.1.1.4 Auto Reset Configuration; Add Extended AID Selection Feature - 7.4.1 Notification 0x1803 - User Interface Host Action Request and 8.3.1.2 Property 1.2.1.1.1.2 Application Selection Behavior; Add support for Mifare Classic 1K and 4K - 6.2.2 Command 0x1101 – Pass Through Command for MIFARE Classic; Update Key Injection Sequence in Command 0xEF01 - Load Key Using TR-31 added Table 6.9-7 - Device Key ID / Slot;, Misc. clarifications and corrections.
102	April 30, 2024	Add Section 8.4.1.4 Property 2.1.2.1.2.4 Boot0 Firmware Part Number; Update section 4.3 Display Strings to include missing strings. Add reference to Command 0xE001 - Get Challenge to Command 0xEF01 - Load Key Using TR-31, Update Table 4.18-6 - Key Slot IDs, change ID from 200x to 0x2000 to 0x201F , Update 0 DUKPT Slot IDs with TR31 Module support from 16 to 32 and Slot IDs to 0x2000 to 0x201F, Update Table 8.6-4 - Property 2.3.1.1.1.2 Transaction Key Status with updated Valid Values, Add Property 2.3.1.2.1.6 Device Temperature. Add Property

Rev Number

Date

Notes

1.2.7.1.4.1 Device Low Temperature Notification Level. Add Property 1.2.7.1.4.2 Device High Temperature Notification Level. Add Property 1.2.7.1.4.3 Device Temperature Notification Repeat Interval. Add Section 6.2.3 Command 0x1102 – Pass Through Command for MIFARE DESFire, Type 4, Update section 7.1.1 Notification 0x0101 - Transaction Information Update to include Mifare DESfire info, Update section

7.3.1 Notification 0x1001 - Device Information Update to include Mifare DESFire info, Add Property 1.1.1.1.1.10 Google Smart Tap Collector ID Slot 1 through Property 1.1.1.1.1.15 Google Smart Tap Collector ID Slot 6. Add Property 1.1.1.1.1.1A Google Smart Tap POS Capabilities.Add Google Smart Tap to Notification 0x0101 – Transaction Information Update. Add Google Smart Tap data to EMV ARQC Type and EMV Batch Data Type. Add Property 1.2.2.2.1.2 USB Configuration Type; Changed Property 1.2.2.3.1.1 Bluetooth® LE Device Name default value; Add Property 1.1.1.1.1.D Apple iAP2 AppBundleID; Add Property 1.2.2.3.1.D Bluetooth® LE Debug Mode Enabled ; Revised 5.1.1 MACs for EMV Data to add AES method and simplified TDES MACing spec by referencing ANSI x9.24; Add Command 0x1805 - Buzzer and update Notification 0x1805 - User Interface Operation Complete to include Buzzer result info, add Property 1.2.1.1.3.1 Contactless Low Power Card Detect (Contactless Only), Clarified max number of leading unmasked characters Property 1.1.2.2.1.3 PAN Number of Leading Unmasked Characters ; Added Appendix G - Physical Button (DynaFlex Only); Added low battery error to Table 3.2-4 in Response Message; Added event notifications are disabled when battery is 5% or less in Property 1.2.7.1.2.1 User Event Notification Controls Enable; Changed Property 1.2.2.3.1.C Bluetooth® LE Sleep Enabled default to enabled, made it customer facing and added more related documentation; Added note that firmware can not be updated when the batter charge is less than or equal to 5 percent in Command 0xD801 - Load Firmware File; Add definition of Tag DF29 in Table 4.5-2 - EMV ARQC (DynaPro Format) DFDF59 Decrypted Contents and Table 4.7-2 – EMV Batch Data (DynaPro Format) DFDF59 Decrypted Contents ; Misc. clarifications and corrections;

Added buzz in progress error to Table 3.2-4 in Response Message; Remove default setting: -mt.test from CN (Subject) and DNS (Subject Alternate Names), Add: Request file from MagTek services Set: No

103

Septem ber 4,

2024

Rev Number

Date

Notes

Notificaton detail codes to include Ntag/MIFARE Ultralight in Table 7.1-1 - Notification Detail Codes and Table 7.3-1 - Notification Detail Codes, add Table 6.1-3 - Response Example for Command 0x1001 – Start Transaction Command not executed due to Battery Charge State, Update Table 3.2-3 - Response Message Format with Table 6.6-4 - Response Example for Command 0xD801 Battery Charge State battery Charge Status content, Update Table 3.2-5 - Notification Message Format with battery charge status content; added 4.16 NFC UID Type (EMV Contactless Only) , add notification for GPO Response in 7.1.1Notification 0x0101 - Transaction Information Update, add additional note on Tag 85 regarding GPO Response = 6985 on Table 7.4-2 - Notification Payload for Display Message Request Notifications (No Display Only): Add Table 6.2-4 – MIFARE Ultralight C Commands, Table 6.2-3 – MIFARE Ultralight EV1 Commands, Table 6.2-5 – MIFARE Ultralight AES Commands, Add Property 1.2.1.1.4.2 MIFARE Ultralight AES DataProtKey.Property 1.2.1.1.4.3 MIFARE Ultralight AES UIDRetrKey. Property 1.2.1.1.4.4 MIFARE Ultralight AES OriginalityKey. Add note for random ID. Add 6.6.7 Command 0xD831 – Delete File from Device, Add Command 0xD112 - Set Property (Secured), Add 2.3 How to Use Apple iAP2 Connections (iAP2 Only); update Table 4.5-1 - EMV ARQC (DynaPro Format) Type with encrypted card data content; Add Table 4.5-3 - EMV ARQC (DynaPro Format) DFDFDF37 Decrypted Contents; Update Table 1.4-1 - Device Connection Types / Data Formats to include iAP2; add 2.3 How to Use Apple iAP2 Connections (iAP2 Only)

110

Septemb er 25,

2024

Add Apple VAS and GWST in Table 1.5-1 - Device Features; Add bit definitions to enable Apple / Google VAS in Command 0x1001 - Start Transaction; Add tag /83 to Table 6.1-1 - Request Data for Command 0x1001 - Start Transaction; Add Table 7.4-7 – Default User Interface String IDs and Strings; Add Property 1.1.1.1.4.1 EMV Configuration Filename; Add Property 1.1.1.1.4.2 CA Public Key Configuration Filename; Add Property Subgroup 2.1.2.8.nn Custom UI; Add NFC Tag Support Flow and Audio Transducer Beep Flow to 6.1.1 Command 0x1001 - Start Transaction; Update references for Tag 81 in Table 6.2-1 - Request Data for Command 0x1100 – Pass Through Command For NTag/MIFARE Ultralight, Type 2.; Update table caption to “NTag Commands” in Table 6.2-2 – NTag Commands; Add Table 6.2-3 – MIFARE Ultralight EV1 Commands and Table 6.2-4 – MIFARE Ultralight C Commands, Add 6.2.1.1 Encrypted Data Format and 6.2.2.1 Encrypted Data Format and 6.2.3.1 Encrypted Data Format; Add 8.3.1.5 Property 1.2.1.1.4.1 MIFARE Ultralight C 2keys3DES; Update Notificaton detail codes to include Ntag/MIFARE Ultralight in Table 7.1-1 - Notification Detail Codes and Table 7.3-1 - Notification Detail Codes, add Table 6.1-3 - Response Example for Command 0x1001 – Start Transaction Command not executed due to Battery Charge State, Update Table 3.2-3 - Response Message Format with Table 6.6-4 - Response Example for Command 0xD801 Battery Charge State battery Charge Status content, Update Table 3.2-5 - Notification Message Format with battery charge status content, added 4.16 NFC UID Type (EMV Contactless Only) , add notification for GPO Response in 7.1.1Notification 0x0101 - Transaction Information Update, add additional note on Tag 85 regarding GPO Response = 6985 on Table 7.4-2 - Notification Payload

Rev Number

Date

Notes

for Display Message Request Notifications (No Display Only): Add Table 6.2-4 – MIFARE Ultralight C Commands, Table 6.2-3 – MIFARE Ultralight EV1 Commands, Table 6.2-5 – MIFARE Ultralight AES Commands, Add Property 1.2.1.1.4.2 MIFARE Ultralight AES DataProtKey.Property 1.2.1.1.4.3 MIFARE Ultralight AES UIDRetrKey. Property 1.2.1.1.4.4 MIFARE Ultralight AES OriginalityKey. Add note for random ID. Add 6.6.7 Command 0xD831 – Delete File from Device. Add Command 0xD112 - Set Property (Secured), Add 2.3 How to Use Apple iAP2 Connections (iAP2 Only); update Table 4.5-1 - EMV ARQC (DynaPro Format) Type with encrypted card data content; Add Table 4.5-3 - EMV ARQC (DynaPro Format) DFDFDF37 Decrypted Contents; Update Table 1.4-1 - Device Connection Types / Data Formats to include iAP2; add 2.3 How to Use Apple iAP2 Connections (iAP2 Only); Add MIFARE Mini to 6.2.2 Command 0x1101 – Pass Through Command for MIFARE Classic/MINI®/Plus SL1 (Security Level 1), Type 2

Update Table 4.5-3 - EMV ARQC (DynaPro Format) DFDFDF37 Decrypted Contents Update the MCE description in Command 0x1001 - Start Transaction. Update the MCE description in Table 6.1-1 - Request Data for Command 0x1001 - Start Transaction, Corrected MSR notification code from 128 to 80 in Table 7.1-7 - Notification Detail Codes.

111

January 20,

2025

Updated HW configuration values for USB/iAP2. Add Property 2.1.2.5.6.7 Available Access Points ; Add support for CUP, JCB and Interac in - EMV Processing Configuration File Type and EMV Entry Point Configuration File Type ; Misc. clarifications and corrections; updated Notification 0x0101 - Transaction Information Update and Notification 0x1001 - Device Information Update to support MIFARE Plus. Add tags to ARQC (cleartext):

0xDF2A – Tip Mode Sale Amount Entered 0xDF2B – Tip Mode Total Amount

Add tag to OID property 1.1.1.1.3.4 – Other TLV:

0x9F02 – Default Amount for Quickchip

Add to CA revocation list, exception file list and DPAS data storage to Table 6.6-1 - File Types; Delete Command 0xD112 - Set Property (Secured) request data, response data and example; Add Property 2.1.2.3.6.5 Entry Point Checksum and Property 2.1.2.3.A.5 Entry Point Checksum. Added Table 4.5 9 – Fleet Data Container Payload.; Removed Enhanced ARQC section; Removed Enhanced Batch Data Section; Add “common kernel only” tag to Fleet, JCB, CUP and Interac OIDs; replaced radar mode with updated terminology changed to Proximity Detection Mode

112

April 16,

2025

Make Device Lock Feature customer facing; Add Property 1.1.1.1.2.6 Tip Mode Enable Submit on Amount Button Press; Add response codes to group 2 subgroup 3: Attempt to display Flexible UI page while touchscreen UI notifications enabled and Request is invalid while card emulation is in progress to in Table 3.2-4 - Operation Status Detail Codes; Updated Property 1.2.3.2.1.1 System Volume Control to allow value of 0 (no sound); Added Apollo client cert support; Add Card Emulation to Table 1.5-1 - Device Features; Add Card Emulation; add Command 0x1806 – Personal Info Entry

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


Rev Number	Date	Notes
		The sequence of events is as follows: 6) The host ensures the device is not currently running another command, for example, that it is not running a transaction using Command 0x1001 - Start Transaction. 7) If the host determines it should request a customer information, it composes a command request in the format below. 8) The device presents a keypad interface to the cardholder on the display. 9) The device sends 7.5.3 Notification 0x1805 - User Interface Operation Complete to the host to report data available, or hardware failure. 10) If the device reported data available, the host can retrieve the data as defined in Table 350 – Notification Detail Codes and Table 352 – Notification Payload for Personal Info Entry. Table 6.3-13 - Request Data for Command 0x1806 – Personal Info Entry
Tag	Len	Value / Description		Typ
Default Beginning of any wrappers, at minimum including Request Message found on
1806 = Command 0x1806 – Personal Info Entry
81	01	Capture Type 0x01 = Phone Number: Capture the phone number 0x02 = Social: Capture the social security number B R 6 - Commands FOR MAGTEK INTERNAL USE ONLY – DO NOT DISTRIBUTE Page 190 of 553 (D100005000-104) 0x03 = Zip code: Capture the zip code 0x04 = Employee ID: Capture Employee ID number 0x05 = Birth Date: Capture birth date in USA format 0xFF = Cancel Capture: Cancel any of the capture commands	B
Beginning of any wrappers, at minimum including Request Message found on page 5
Table 6.3-14 - Response Data for Personal Info Entry
Tag	Len	Value / Description		Typ
Beginning of any wrappers, at minimum including Response Message found on page
1806 = Command 0x1806 – Personal Info Entry
No parameters.
Beginning of any wrappers, at minimum including Response Message found on page
Table 6.3-15 - Request Example
Example (Hex)
AA00 810401031806 8405 1806 8101 01


Rev Numb er	Date	Notes
		Table 6.3-16 - Response Example
Example (Hex)
AA00 810482031806 8204 01000000
Command 0x1840 – Card Emulation, add Module 0x06 Card Emulation to Table 7.4-4 - Notification Detail Codes. Update Command 0x1102 – Pass Through Command for MIFARE DESFire, Type 4 to include MIFARE DESFire EV1/EV2/EV3; Update Command 0x1102 – Pass Through Command for MIFARE DESFire, Type 4 to include MIFARE Plus EV1/EV2/SE/X SL1 (Security Level 1) commands; Update Command 0x1103 – Pass Through Command for MIFARE Plus, Type 2 to include MIFARE Plus EV1/EV2/SE/X SL3 (Security Level 3) commands; Update Notification 0x0101 - Transaction Information Update and Notification 0x1001 - Device Information Update to include MIFARE DESFire EV1/EV2/EV3; Add Property 1.2.1.1.4.5 MIFARE Plus AES_Key1. Property 1.2.1.1.4.6 MIFARE Plus AES_Key2. Property 1.2.1.1.4.7 MIFARE Plus AES_Key3. Property 1.2.1.1.4.8 MIFARE Plus AES_Key4. Property 1.2.1.1.4.9 MIFARE Plus AES_Key5. Property 1.2.1.1.4.A MIFARE Plus AES_Key6. Update Command 0x1100 – Pass Through Command For NTag/MIFARE Ultralight, Type 2 to include an option for READ command to do a fast read.
113	January 27, 2026	Clarified VAS TRANSACTION OPTION parameter in Command 0x1001 - Start Transaction . Updated Table 21 - EMV ARQC (DynaPro Format) DFDFDF37 Decrypted Contents with tag 5A Primary Account Number. Updated Table 573 - Property 1.1.2.6.1.1 Selectable Card Data Encryption Enable with Primary Account Number. Updated Property 1.1.1.1.1.2 EMV ARQC Message Tag List and Property 1.1.1.1.1.3 EMV Batch Data Tag List for CDOL1 and CDOL2 processing ; Updated command 0x1001 to support Apple ECP2.0 and Customer Options. Added Command 0x1806 – Personal Info Entry, Property 1.2.3.3.1.1 Phone Number Format, Property 1.2.3.3.2.1 Social Security Number Format, Property 1.2.3.3.3.1 Zip Code Format, Property 1.2.3.3.4.1 Birth Date Format, Property 1.2.3.3.5.1 Employee ID Format; Updated description of Tag FC in Table 21 - EMV ARQC (DynaPro Format) DFDFDF37 Decrypted Contents; Added Property 1.2.2.2.1.3 Battery Charging Mode, Property 1.2.2.2.1.4 Battery Charging Start Level, Property 1.2.2.2.1.5 Battery Charging Stop Level, Property 1.2.2.2.1.6 Battery Charging Schedule ;

--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://developer.magtek.com/hardware/card-readers/mms-dyna-devices/emv-common-kernel/dynaflex-ii-go/documents/programmers-manuals/programmers-manuals-commands.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.