Programmer's Manual (Commands)
Document Number: D998200489-102
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 StoreSM 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 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.
Table - Revisions
Rev Number
Date
Notes
10
Oct 11, 2021
Initial DRAFT release from master rev 30v74 plus in-place corrections.
30
Nov 11, 2021
Release derived from master rev 30
50
Sep 8, 2022
Generate Programmers manual from D100005000 rev 50
Release to Rev 50 from rev 31
60
March 6, 2023
Generate Programmers manual from D100005000 rev 60.
61
March 27, 2023
Generate Programmers manual from D100005000 rev 61.
62
April 7, 2023
Updated Table 3.2‑4 Request Operation Failed, Modified value of DFDF1B in Table 4.7‑1 – EMV Batch Data (DynaPro Format) Type ; Update DF1B Example Value in Table 4.10‑2 Updated Table 6.1‑9 - Response Example, Table 6.1‑13 - Response Example, Update Request and Response examples in Command 0xD111 - Set Property, Add note “For additional support, please contact MagTek Support.” To sections 6.6.3, 6.6.4, 6.6.5, 6.6.6, 6.7.1, 6.9.2, 6.9.3, 6.9.4, 6.10.1; Add Appendix C Erasing EMV Configurations, Updated Table 3.2‑4 - Operation Status Detail Codes with 02 Requested Operation Failed; Change examples in Command 0xD101 - Get Property and Command 0xD111 - Set Property Misc. clarifications and corrections
63
May 16, 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
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 ; 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; Misc. clarifications and corrections;
64
September 28, 2023
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.3 Device Reset Will Occur Soon Notification Control; Misc. clarifications and corrections.
65
October 10, 2023
Add Extended AID Selection Feature - 7.4.1 Notification 0x1803 - User Interface Host Action Request and 8.3.1.1 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
66
April 24, 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 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; Add Property 1.1.1.1.1.D Apple iAP2 AppBundleID; 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, 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 buzzen in progress error to Table 3.2-4 in Response Message; Add: Request file from MagTek services Set: No
100
September 3, 2024
Add Apple VAS and GWST in Table 1.6‑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.4 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 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.2 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.5‑1 - Device Connection Types / Data Formats to include iAP2; add 2.2 How to Use Apple iAP2 Connections (iAP2 Only)
101
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
102
April 15, 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.6‑1 - Device Features; Add Card Emulation; add 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.
Last updated