Page 1 DynaPro Go Handheld PIN Pad Device with MSR/Contact/Contactless Programmer’s Manual (COMMANDS) April 2021 Document Number: D998200136-31 REGISTERED TO ISO 9001:2015 MagTek I 1710 Apollo Court I Seal Beach, CA 90740 I Phone: (562) 546-6400 I Technical Support: (888) 624-8350 www.magtek.com...
Page 2 Some device icons courtesy of https://icons8.com/, used under the Creative Commons Attribution- NoDerivs 3.0 license. All other system names and product names are the property of their respective owners. DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 2 of 247 (D998200136-31)
Page 3 PIN Response Report and Command 0x04 - Request PIN Entry accordingly; Section H.2, remove statement about common tags; Section H.5, add Expresspay 4.0.1 information; Misc. clarifications and corrections. DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 3 of 247 (D998200136-31)
Page 4: Limited Warranty
MagTek’s published specifications. This warranty shall be provided only for a period of one year from the date of the shipment of the product from MagTek (the “Warranty Period”). This warranty shall apply only to the “Buyer” (the original purchaser, unless that entity resells the product as authorized by MagTek, in which event this warranty shall apply only to the first repurchaser).
Page 5 THE CONTRACT PRICE FOR THE GOODS. MAGTEK’S SOLE LIABILITY AND BUYER’S EXCLUSIVE REMEDIES ARE STATED IN THIS SECTION AND IN THE SECTION RELATING TO MAGTEK’S LIMITED WARRANTY. DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 5 of 247 (D998200136-31)
Page 6: Fcc Information
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). DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 6 of 247 (D998200136-31)
Page 7: Rohs Statement
Reduction of Hazardous Substances (RoHS) European Directive 2002/95/EC. The marking is clearly recognizable, either as written words like “Pb-free,” “lead-free,” or as another clear symbol ( DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 7 of 247 (D998200136-31)
Page 8: Table Of Contents
Command 0x05 - Cancel Command ................... 47 4.3.6 Command 0x06 - Request Cardholder Selection ............. 48 4.3.7 Command 0x07 - Display Message ..................50 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 8 of 247 (D998200136-31)
Page 9 Report 0x27 - Display Message Done Report ..............101 4.4.9 Report 0x28 - Signature Capture State Report (SC-S Only | SC-F Only)...... 102 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 9 of 247 (D998200136-31)
Page 10 Command 0xE4/0x04 Set 802.11 Wireless Network Host ID ......149 4.6.5 Command 0xE5 - Get 802.11 Wireless Network Info (802.11 Wireless Only) ..150 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 10 of 247 (D998200136-31)
Page 11 D-PAS Application Settings ....................227 Appendix I Language and Country Codes .................... 229 Terminal Country Codes ......................229 Terminal Language Codes ......................229 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 11 of 247 (D998200136-31)
Page 12 Bluetooth LE Property 0x0D - Minimum Advertising Interval (PCI Bluetooth LE Only) J.2.13 Bluetooth LE Property 0x0E - Maximum Advertising Interval (PCI Bluetooth LE Only) DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 12 of 247 (D998200136-31)
Page 13: Introduction
About Connection Types DynaPro, DynaPro Mini, DynaPro Go, and related products use a common communication protocol across a variety of physical connection layers, which can include universal serial bus (USB), Ethernet, Apple 30-pin dock connector, and Bluetooth Low Energy (Bluetooth LE).
Page 14 Financial Format Whitelisting Max Financial Card PAN Length MagneSafe 2.0 (MS2.0) Token Reversal Handheld Operation Quick Chip Beeper Control Connections and Connection Features USB Connection DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 14 of 247 (D998200136-31)
Page 15 EMV 4.3H Kernel Chip Card Contactless MasterCard PayPass MasterCard MCL 3.1.x payWave 2.1.3 payWave 2.2 payWave Checksum Expresspay 3.0 Expresspay 3.1 Expresspay 4.0.2 D-PAS DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 15 of 247 (D998200136-31)
Page 16 9) Available on DynaPro v3 firmware version C4 or newer. 10) Available on DynaPro v3 firmware version E or newer. 11) Available on DynaPro Go firmware version D or newer. DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 16 of 247 (D998200136-31)
Page 17: About Sdks
To download the SDKs and documentation, search www.magtek.com documentation for the programming languages and platforms you need, or contact MagTek Support Services for assistance. Table 2-2 provides an example list of SDKs and related documentation available for this family of devices:...
Page 18: Connection Types
USB bus. They identify themselves with vendor ID 0x0801 and product ID 0x3004 (DynaPro) or product ID 0x3009 (DynaPro Mini or DynaPro Go). The device enters and wakes up from Suspend mode when directed to do so by the USB host. It does not support remote wakeup.
Page 19: About Reports
For information about receiving unsolicited data from the device via Input Reports, see section 3.1.4 How to Receive Data On the USB Connection. DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 19 of 247 (D998200136-31)
Page 20: About The Report Descriptor
85 05 Usage (Cancel Command) 09 05 Report Count (1) 95 01 Feature (Data,Var,Abs,NWrp,Lin,Pref,Nnul,Nvol,Buf) B2 02 01 Report ID (0x06) - Set 85 06 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 20 of 247 (D998200136-31)
Page 21 09 0D Report Count (21) 95 15 Feature (Data,Var,Abs,NWrp,Lin,Pref,Nnul,Nvol,Buf) B2 02 01 Report ID (0x0E) - Get 85 0E Usage (Get Information) 09 0E DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 21 of 247 (D998200136-31)
Page 22 95 08 Feature (Data,Var,Abs,NWrp,Lin,Pref,Nnul,Nvol,Buf) B2 02 01 Report ID (0x018) - Set 85 18 Usage (Perform Test) 09 18 Report Count (63) 95 3F DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 22 of 247 (D998200136-31)
Page 23 82 02 01 Report ID (0x22) - Input 85 22 Usage (Card Status) 09 22 Report Count (16) 95 10 Input (Data,Var,Abs,NWrp,Lin,Pref,Nnul,Buf) 82 02 01 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 23 of 247 (D998200136-31)
Page 24 Report ID (0x2B) - Input 85 2B Reserved Report ID (0x2C) - Input 85 2C Usage (EMV Cardholder Interaction Status) 09 2C Report Count (127) 95 7F DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 24 of 247 (D998200136-31)
Page 25 Report ID (0xA2) - Set 85 A2 Usage (Request Start EMV Transaction) 09 A2 Report Count (48) 95 30 Feature (Data,Var,Abs,NWrp,Lin,Pref,Nnul,Buf) B2 02 01 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 25 of 247 (D998200136-31)
Page 26 Usage (Confirm Session Key) 09 AA Report Count (17) 95 11 Feature (Data,Var,Abs,NWrp,Lin,Pref,Nnul,Buf) B2 02 01 Report ID (0xAB) - Set 85 AB DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 26 of 247 (D998200136-31)
Page 27 Report ID (0xFF) - Set 85 FF Usage (Device Reset) 09 1E Report Count (02) 95 02 Input (Data,Var,Abs,NWrp,Lin,Pref,Nnul,Buf) B2 02 01 End Collection DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 27 of 247 (D998200136-31)
Page 28: How To Send Commands On The Usb Connection
4) If the documentation specifies the command should be called in Get mode, simply construct and send a Get Feature Report, and interpret the device’s response using the Usage / Response table in the command documentation. DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 28 of 247 (D998200136-31)
Page 29: How To Receive Data On The Usb Connection
Usage for that report, and interpret the incoming data according to that. 4) Respond accordingly (for example, by sending followup commands). DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 29 of 247 (D998200136-31)
Page 30: How To Use Bluetooth Le Connections (Bluetooth Le Only | Pci Bluetooth Le Only)
UUID In LSB (Little Endian) Order Characteristic Max. Size Some frameworks use MSB order DynaPro Mini GATT service 01:01:B6:0C:41:E3:43:F8:8F:89:82:AD:F8:E6:08:05 Application Data From Host Length 1 byte 20:02:B6:0C:41:E3:43:F8:8F:89:82:AD:F8:E6:08:05 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 30 of 247 (D998200136-31)
Page 31 Byte 1..2 (Response ACK Report) Input report format: Byte 0 Report ID Byte 1 - n Report Maximum report size is 127 bytes. DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 31 of 247 (D998200136-31)
Page 32: How To Use Network Connections (Ethernet Only | 802.11 Wireless Only)
To show the current IP address of the device, press keypad buttons Left function key 4 7 2 Right function key DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 32 of 247 (D998200136-31)
Page 33: How To Use 802.11 Wireless Connections (802.11 Wireless Only)
3.3.1 How to Use 802.11 Wireless Connections (802.11 Wireless Only) DynaPro Go ships from the manufacturer with TLS Enabled. This setting can be set to Disabled by the customer, which may be useful for initial network setup and testing. MagTek strongly recommends that TLS always be Enabled when it is deployed in the field.
Page 34 See section 3.3.2 How to Send Commands Using Network Connections. 7) Make sure all pending operations have completed, then close the TLS connection and TCP socket. DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 34 of 247 (D998200136-31)
Page 35: How To Send Commands Using Network Connections
Response as defined in section 4 Command Set. See SLIP specification for requirements Byte n about decoding DB xx byte sequences. Byte n+1 0xC0 = SLIP frame delimiter DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 35 of 247 (D998200136-31)
Page 36: How To Receive Data On The 802.11 Wireless Connection
4) Parse the data in the message according to the report’s documentation. 5) Respond accordingly (for example, by establishing a mutually authenticated TLS connection with the device and sending followup commands). DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 36 of 247 (D998200136-31)
Page 37: Command Set
F9, which is designed specifically for transmitting MACed messages, the message being sent as big block data follows this general format (interpret hexadecimal as binary values, ignore whitespace and /*comments*/, replace <angle bracketed values> with actual values): DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 37 of 247 (D998200136-31)
Page 38 F9 will always include nested TLV data object DFDF25 containing the device’s unique IFD Serial Number, which the host can read from the device. See Appendix D MagTek Custom EMV Tags (EMV Only) for details about retrieving tags.
Page 39: General Commands
0x00; if the host included bad parameters in the command, the ACKSTS would be Bad Parameter (0x82), as specified in the documentation of Command 0x03 - Request Swipe Card. DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 39 of 247 (D998200136-31)
Page 40 CBC-MAC ACKSTS, wrong serial number, or a bad key. 0x83 = Length Error or OID error. The data size is 0 or is larger than the available buffer size, or a data packet is incomplete, or MagTek device OID of the certificate doesn’t match the predefined OID 0x84 = PAN Exists 0x85 = No Key or Key is incorrect.
Page 41: Command 0X02 - End Session
(Bitmaps Only): Byte 1 0x01 = Bitmap Slot 1 0x02 = Bitmap Slot 2 0x03 = Bitmap Slot 3 0x04 = Bitmap Slot 4 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 41 of 247 (D998200136-31)
Page 42: Command 0X03 - Request Swipe Card
Table 4-4 - Usage Table for Command 0x03 Byte 0 0x03 Byte 1 Wait time in seconds, (0x01..0xFF; 0x00 = Infinite wait time) DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 42 of 247 (D998200136-31)
Page 43 Beeper Behavior (Only changes device behavior if Beeper Mode = Enabled in Command Byte 3 0x09 - Set / Get Device Configuration). See Table 4-101 - Beeper Behavior Codes on page 163 for possible values. DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 43 of 247 (D998200136-31)
Page 44: Command 0X04 - Request Pin Entry
ENTER PIN The English on-screen prompts look like this: DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 44 of 247 (D998200136-31)
Page 45 4 - Command Set Figure 4-3 - DynaPro Go PIN Prompts DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 45 of 247 (D998200136-31)
Page 46 0 = ISO Format 0 0b01 = English or French Only Options 1 = ISO Format 3 0b10 = All Languages as defined by DFDF2D DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 46 of 247 (D998200136-31)
Page 47: Command 0X05 - Cancel Command
4.3.5 Command 0x05 - Cancel Command This command cancels the current command. Table 4-6 - Usage Table for Command 0x05 Byte 0 0x05 Byte 1 0x00 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 47 of 247 (D998200136-31)
Page 48: Command 0X06 - Request Cardholder Selection
1) Clear the display 2) Return to the idle state 3) Send Report 0x25 - Cardholder Selection Response Report to the host DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 48 of 247 (D998200136-31)
Page 49 0x64 = No start beep, no timeout beep 0x65 = One start beep, no timeout beep 0x66 = Two start beep, no timeout beep DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 49 of 247 (D998200136-31)
Page 50: Command 0X07 - Display Message
This command directs the device to display a predefined message for a specified time. Examples are shown below. For information about setting custom status messages, see Appendix G Custom Messages. Figure 4-5 - DynaPro Go Messages DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 50 of 247 (D998200136-31)
Page 51 0x80..0x83 = Bitmap in slots 1..4 0xFF = Custom Bitmap Message (requires first sending data via Command 0x10 - Send Big Block Data to Device) DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 51 of 247 (D998200136-31)
Page 52: Command 0X08 - Request Device Status
Following this command, the device sends the host Report 0x20 - Device State Report. Table 4-9 - Usage Table for Command 0x08 Byte 0 0x08 Byte 1 0x00 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 52 of 247 (D998200136-31)
Page 53: Command 0X09 - Set / Get Device Configuration
Contactless Alternate GUI Control (Chip card contactless only) All other settings, including the Configuration Lock bit, can only be changed by the supplier or manufacturer. DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 53 of 247 (D998200136-31)
Page 54 1 = Locked Bit 7 Configuration Lock (NOTE: After locking, unlocking can only be performed by the manufacturer): 0 = Unlocked 1 = Locked DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 54 of 247 (D998200136-31)
Page 55 SRED, maximum length = 4. EMV L2 ICS Configuration (Default = 0x01) Byte 7 Note: This setting is ignored when EMV Mode is disabled. DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 55 of 247 (D998200136-31)
Page 56 Alternate mode prevents both the MSR and Contactless interfaces from being enabled at the same time. 0 = Standard 1 = Alternate Bit 6 Reserved Bit 7 Reserved DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 56 of 247 (D998200136-31)
Page 57: Command 0X0A - Request Msr Data
MSR data is available, the device sends a single Report 0x23 - Card Data Report containing a Data Length of 0. Table 4-11 - Usage Table for Command 0x0A Byte 0 0x0A Byte 1 0x00 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 57 of 247 (D998200136-31)
Page 58: Command 0X0B - Get Challenge
If Sub Operation = 0x63 and a valid Mutual Authentication Key is available: Byte 2..13 Bytes 2..9 contain the encrypted partial device serial number and random token Bytes 10..13 contain the partial device serial number DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 58 of 247 (D998200136-31)
Page 59: Command 0X0C - Set Bitmap (Bitmaps Only)
0x01 = Save 0x02 = Invert (i.e. reverse black / white) and Save Figure 4-6 - DynaPro Go Welcome Screen With Custom Bitmap DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 59 of 247 (D998200136-31)
Page 60: Command 0X0E - Get Information
Key Status, if Info ID = 0x80: 0x00..0x05 = KCV type (see Table 4-17) Byte 3 Data length (see Table 4-17); default value is 0 Byte 4..63 Block data DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 60 of 247 (D998200136-31)
Page 61 Device Authentication token signed 0x80 kcv_type=4 Hash value by PIN Key Loader Certificate Device Authentication token signed 0x80 kcv_type=5 Hash value by MSR Key Loader Certificate DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 61 of 247 (D998200136-31)
Page 62 SN and DN length; max length is 59. *** its corresponding CA certificate **** KCV = Key Check Value, where the lowest 6 digits are valid DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 62 of 247 (D998200136-31)
Page 63: Command 0X0F - Login/Authenticate Or Logout
0x01 = Login / Authenticate If logging in, encrypted transformed token (8 bytes). See Command 0x0B - Get Challenge. Bytes 2..9 If logging out, Reserved. DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 63 of 247 (D998200136-31)
Page 64: Command 0X10 - Send Big Block Data To Device
Data Length high byte (if Byte 7 indicates Extended) Extended Type: Byte 7 0x00 = Legacy, data length less than 64K 0x01 = Extended, data length > 64K Byte 8..63 Reserved DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 64 of 247 (D998200136-31)
Page 65 If sending 0xAE, use the format defined in Command 0xAE - MCL Send DET Command (MCL 3.1 Support Only). (MasterCard MCL 3.1.x support only) DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 65 of 247 (D998200136-31)
Page 66: Command 0X11 - Request Manual Card Entry
Report. Table 4-21 - Usage Table for Command 0x11 Byte 0 0x11 Byte 1 Wait Time in seconds, (0x01..0xFF, 0x00 = 256 seconds) DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 66 of 247 (D998200136-31)
Page 67 (?); the CVC ending position in Track 2 is the byte before the 3 digits which precede the end sentinel (?). DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 67 of 247 (D998200136-31)
Page 68: Command 0X12 - Request Cardholder Signature (Sc-S Only | Sc-F Only)
Byte 3 Command 0x09 - Set / Get Device Configuration). See Table 4-101 - Beeper Behavior Codes on page 163 for possible values. DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 68 of 247 (D998200136-31)
Page 69: Command 0X13 - Get Cardholder Signature (Sc-S Only | Sc-F Only)
For example, if the cardholder signed with an “X,” the device could transmit it as 05 0A 0A 05 00 FF 0A 0A 05 05 00 FF. Table 4-23 - Usage Table for Command 0x13 Byte 0 0x13 Byte 1 Reserved DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 69 of 247 (D998200136-31)
Page 70: Command 0X14 - Request Cardholder Data Entry
Code (Activation Codes Only)(firmware revision C12 and newer), (Handheld Transactions Only) Server/Waiter Number or Ticket Number, by displaying one of the available predetermined messages, examples of which are shown below: DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 70 of 247 (D998200136-31)
Page 71 Beeper Behavior (Only changes device behavior if Beeper Mode = Enabled in Command Byte 3 0x09 - Set / Get Device Configuration). See Table 4-101 - Beeper Behavior Codes on page 163 for possible values. DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 71 of 247 (D998200136-31)
Page 72: Command 0X16 - Get Selected Menu Item Command (Handheld Operation Only)
Beeper Behavior (Only changes device behavior if Beeper Mode = Enabled in Command Byte 3 0x09 - Set / Get Device Configuration). See Table 4-101 - Beeper Behavior Codes on page 163 for possible values. DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 72 of 247 (D998200136-31)
Page 73: Command 0X17 - Update Device
N/A N/A N/A N/A N/A N/A 1 Return Response ACK, wait 100ms, N/A N/A N/A N/A N/A N/A 1 Reset Now (only valid after successful update) N/A N/A DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 73 of 247 (D998200136-31)
Page 74: Command 0X1A - Request Device Information
Table 4-30 - Usage Table for Command 0x1A - Maximum Device Message Size Byte 0 0x1A Byte 1 0x01 “64” (null terminated string) Bytes 2..63 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 74 of 247 (D998200136-31)
Page 75 “DynaPro SC” if the device is signature capture capable, or Bytes 2..63 “DynaPro Mini” or “DynaPro Go” Table 4-34 - Usage Table for Command 0x1A - Serial Number Byte 0 0x1A DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 75 of 247 (D998200136-31)
Page 76 Table 4-39 - Usage Table for Command 0x1A - Boot1 Firmware Version Byte 0 0x1A Byte 1 0x0A “30050858B01-DEMO” (null terminated string) Bytes 2..63 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 76 of 247 (D998200136-31)
Page 77 0x01 = Modified 0x01 = Modified 0x01 = Modified 0x11 = Corrupted 0x11 = Corrupted 0x11 = Corrupted 0x11 = Corrupted Bytes 2..63 Reserved DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 77 of 247 (D998200136-31)
Page 78: Command 0X1C - Set/Get Bluetooth Le Power Configuration
Because it takes some time for the device to be capable of full communication after powering it on, the host can read the Ready bit to determine whether the device is ready for full communication. DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 78 of 247 (D998200136-31)
Page 79: Command 0X1D - Set Bluetooth Le Module Control Data (Bluetooth Le Only | Pci Bluetooth Le Only)
(2+control Control data (defined in Appendix J) data length-1) Bytes (2 + control data Padding. Set all bytes to zero. length) to 63 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 79 of 247 (D998200136-31)
Page 80: Command 0X1F - Request Clear Text Cardholder Data Entry (Clear Text User Data Only)
Code (Activation Codes Only) (firmware revision C12 and newer), (Handheld Transactions Only) Server/Waiter Number or Ticket Number, by displaying one of the available predetermined messages, examples of which are shown below: DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 80 of 247 (D998200136-31)
Page 81 If an error occurs, the device terminates the command and reports the error in ACKSTS of Command 0x01 - Response ACK. For a full list of error codes, see Command 0x01 - Response ACK. DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 81 of 247 (D998200136-31)
Page 82 Beeper Behavior (Only changes device behavior if Beeper Mode = Enabled in Command Byte 3 0x09 - Set / Get Device Configuration). See Table 4-101 - Beeper Behavior Codes on page 163 for possible values. DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 82 of 247 (D998200136-31)
Page 83: Command 0X32 - Get Bin Whitelist Table - Non Financial Format
If an error occurs, the device terminates the command and reports the error in ACKSTS of Command 0x01 - Response ACK. For a full list of error codes, see Command 0x01 - Response ACK. DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 83 of 247 (D998200136-31)
Page 84: Command 0X33 - Get Bin Whitelist Table - Financial Format
If an error occurs, the device terminates the command and reports the error in ACKSTS of Command 0x01 - Response ACK. For a full list of error codes, see Command 0x01 - Response ACK. DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 84 of 247 (D998200136-31)
Page 85: Command 0X40 - Request Pin Entry With Host Supplied Account Data (Host-Supplied-Non-Session-Pan Only)
PIN Block Format the host specified in the command. b) If the host did not provide the Account Number in the command, the device creates the EPB using ISO format 1. DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 85 of 247 (D998200136-31)
Page 86 Byte 8 Byte 9 Byte 10 A9 Byte 11 A11 The English on-screen prompts look like this: Figure 4-12 - DynaPro Go PIN Prompts DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 86 of 247 (D998200136-31)
Page 87: Command 0X58 - Request Device Certificate
Table 4-48 - Usage Table for Command 0x58 (Request Device Certificate) Byte 0 0x58 Byte 1 0x02 = Read Device Byte 2 Reserved Reserved Reserved Reserved Reserved Reserved Reserved Certificate DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 87 of 247 (D998200136-31)
Page 88: Command 0Xff - Device Reset
This command directs the device to perform a restart. Table 4-49 - Usage Table for Command 0xFF Byte 0 0xFF Byte 1 0x00 = Soft Reset Byte 2 Reserved DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 88 of 247 (D998200136-31)
Page 89: General Input Reports
Byte 4 Device Certificate Status (see Table 4-53 - Device Certificate Status Codes). Byte 5 Hardware Status (see Table 4-55 - Hardware Status Codes). DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 89 of 247 (D998200136-31)
Page 90 1 = Card Data Available Session State MSR PAN: 1 = PAN Parsed from Card EXPAN: 1 = External PAN Sent Amt: 1 = Amount sent DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 90 of 247 (D998200136-31)
Page 91 Status/Msg Value 0 = Certificate does not exist in the device Device 1 = Certificate exists in the device Certificate Status Bit 7 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 91 of 247 (D998200136-31)
Page 92 Table 4-55 - Hardware Status Codes Status/Msg Value 0 = False 1 = True Hardware Bit 7 Status Tamper .IE3 SRED Reserved Reserved Reserved Reserved Sensors only Active DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 92 of 247 (D998200136-31)
Page 93: Report 0X21 - Cardholder Data Entry Response Report
(R); if the Birth Date data length is 8 (MMDDYYYY format), those positions contain the rightmost two characters of the birth year (P). Table 4-57 - Report 0x21 Cardholder Data Block Format Bits Zip Code DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 93 of 247 (D998200136-31)
Page 94 Codes Only) Server/Waiter code (Handheld P/R P/R P/R P/R P/R R Operation Only) Ticket Number (Handheld P/R P/R P/R P/R P/R R Operation Only) DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 94 of 247 (D998200136-31)
Page 95: Report 0X22 - Card Status Report
Otherwise, for each track, the possible values are listed below: Value 0 = No error Card Status Value 1 = Error detected Bit 7 Track 3 Track 2 Track 1 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 95 of 247 (D998200136-31)
Page 96: Report 0X23 - Card Data Report (Mac-Msr)
0x64 = CBC-MAC Track Status: 0x00 = OK Byte 2 0x01 = Empty 0x02 = Error 0x03 = Disabled Byte 3 Data Length DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 96 of 247 (D998200136-31)
Page 97 If Data ID = 0x40, data block is the encrypted PAN and Expiration date in the following Byte 4..n format:  Start Sentinel(‘;’)   Separator (‘=’)  YYMM  (‘?’) DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 97 of 247 (D998200136-31)
Page 98: Report 0X24 - Pin Response Report
ISO Format 1.  If there is a PAN, the device creates the EPB using the PIN Option the host specified in the command. DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 98 of 247 (D998200136-31)
Page 99: Report 0X25 - Cardholder Selection Response Report
Code of key pressed: 0x71 = Left function key Byte 2 0x72 = Middle function key 0x74 = Right function key 0x78 = Enter key DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 99 of 247 (D998200136-31)
Page 100: Report 0X26 - Send Selected Menu Item (Handheld Operation Only)
Menu Selection Mode Byte 2 0x00 = Select Table 0x01 = Select Bill Byte 3 Index of Selected Menu Item Byte 4 0x00 (Reserved) DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 100 of 247 (D998200136-31)
Page 101: Report 0X27 - Display Message Done Report
Table 4-64 - Usage Table for Report 0x27 Byte 0 0x27 Byte 1 Operation Status (see Table 4-99 - Operation Status Codes on page 163) DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 101 of 247 (D998200136-31)
Page 102: Report 0X28 - Signature Capture State Report (Sc-S Only | Sc-F Only)
Operation Status (see Table 4-99 - Operation Status Codes on page 163) Byte 2 0x00 (Reserved) Byte 3 Signature length (low byte) Byte 4 Signature length (high byte) DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 102 of 247 (D998200136-31)
Page 103: Report 0X29 - Send Big Block Data To Host
Data length high byte Table 4-67 - Big Block Data Sending Format (Blocks 1 thru n) Byte 0 0x29 Byte 1 Not defined DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 103 of 247 (D998200136-31)
Page 104: Big Block Data For Authorization Request (Arqc)
Transaction Currency Code Device Local Date transaction was authorized Device Transaction Type Device 9F37 Unpredictable Number Device 9F10 Issuer EMV Application Data Card 0..32 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 104 of 247 (D998200136-31)
Page 105 4 - Command Set Description Source Format Length DFDF53 Fallback Indicator Device Container For Encrypted PIN Device Container For Encrypted MSR Device DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 105 of 247 (D998200136-31)
Page 106: Report 0X2A - Delayed Response Ack
Table 4-70 - Usage Table for Report 0x2A Byte 0 0x2A Status of Command (“ACKSTS”) Byte 1 Byte 2 ID for Command reporting status Bytes 3..n Reserved DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 106 of 247 (D998200136-31)
Page 107: Report 0X2D - Bluetooth Le Module Control Data (Bluetooth Le Only | Pci Bluetooth Le Only)
Control data (defined in Appendix J) length - 1) Bytes (2 + control data Padding. All bytes are zeros. length) to 63 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 107 of 247 (D998200136-31)
Page 108: Report 0X2E - Clear Text Cardholder Data Entry Response Report (Clear Text User Data Only)
Length of data Clear Text Cardholder Data block - only the indicated number of bytes is meaningful, Bytes 4..12 other bytes should be ignored. DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 108 of 247 (D998200136-31)
Page 109: Report 0X2F - Request Host Connection (Handheld Operation Only, 802.11 Wireless Only)
Byte 0 0x2F Bytes 1..2 Device Listening Port TLS Enabled Byte 3 0x00 = Disabled 0x01=Enabled Byte 4 Device TLS Certificate Common Name length DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 109 of 247 (D998200136-31)
Page 110 4 - Command Set Byte Description Byte 5..63 Device TLS Certificate Common Name (up to 59 characters, padded to fill) DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 110 of 247 (D998200136-31)
Page 111: Emv-Related Commands And Reports (Emv Only)
A number of tags can be configured on the device using the Set form of Command 0xA1 - Access EMV Tags, such as EMV terminal floor limit, terminal ID, and transaction currency code. DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 111 of 247 (D998200136-31)
Page 112: Report 0X2C - Emv Cardholder Interaction Status Report
If EMV Cardholder Interaction Status ID from Byte 1 = 0x20, bytes 4 and 5 indicate the length of data starting at byte 6, which is in TLV format. Otherwise, no data. DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 112 of 247 (D998200136-31)
Page 113: Report 0X30 - Tip Or Cashback Report (Handheld Operation Only)
Bytes 15..17 Cashback (Handheld Operation Only) Bytes 18..23 Tip or Cashback amount depending on Mode specified in Byte 2 (n12 format) Byte 24 Reserved DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 113 of 247 (D998200136-31)
Page 114: Command 0Xa0 - Request Tip Or Cashback (Handheld Operation Only)
Not applicable when using Cashback mode Percent or Fixed Amount for right button (format n2) Byte 22 Not applicable when using Cashback mode Bytes 23..48 Reserved DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 114 of 247 (D998200136-31)
Page 115 4 - Command Set Figure 4-13 - DynaPro Go Request Tip or Cashback - Cashback Mode Figure 4-14 - DynaPro Go Request Tip or Cashback - Tip Mode, Percent DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS)
Page 116 4 - Command Set Figure 4-15 - DynaPro Go Request Tip or Cashback - Tip Mode, Amount DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 116 of 247 (D998200136-31)
Page 117: Command 0Xa1 - Access Emv Tags
Appendix H.4 payWave Settings (payWave 2.1.3 Support Only | payWave 2.2 Support Only). DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 117 of 247 (D998200136-31)
Page 118: Reading All Emv Tags
The Response Type parameter allows the host to specify how it prefers the device to compose its response. MagTek recommends using Quick Initial ACK response, unless the host software needs to use Single ACK response for backward compatibility reasons. Quick Initial ACK response is specifically designed to help avoid connection timeout problems the developer can not control;...
Page 119 The FA TLV data object contains nested TLV data objects representing the tags the host requested. The device calculates the CBC-MAC using the AMK key XOR 0x000000000000FF00000000000000FF00. DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 119 of 247 (D998200136-31)
Page 120: Command 0Xa2 - Start Emv Transaction
0x04 = Acquirer not available (Note: prevents long timeout on waiting for host approval) Bytes 7..12 Amount Authorized (EMV Tag 9F02, n12 format) Transaction Type: DynaPro (Firmware Rev E and newer) and DynaPro Go and DynaPro Mini (Firmware Rev D and newer) 0x00 = Purchase 0x01 = Cash Advance...
Page 121 If an error occurs, the device terminates the command and reports the error in ACKSTS of Command 0x01 - Response ACK. For a full list of error codes, see Command 0x01 - Response ACK. DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 121 of 247 (D998200136-31)
Page 122: Standard Emv Transaction
Swipe Insert/Tap , and Cancel Figure 4-16 - DynaPro Go Handheld Operation Present Payment Pages DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 122 of 247 (D998200136-31)
Page 123 Figure 4-18 – DynaPro Go Request Start EMV Transaction Insert Card - Contactless Only Figure 4-19 – DynaPro Go Request Start EMV Transaction Insert Card - Contactless and MSR DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS)
Page 124 4 - Command Set Figure 4-20 – DynaPro Go Request Start EMV Transaction Insert Card - Contact and Contactless Figure 4-21 – DynaPro Go Request Start EMV Transaction Insert Card - Contact and MSR DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS)
Page 125 4 - Command Set Figure 4-22 – DynaPro Go Request Start EMV Transaction Insert Card - Contact, Contactless, and MSR 7) If the cardholder swipes a magnetic stripe card, the device meets EMV 4.x requirements by checking the service code from the magnetic stripe data to see if it begins with a 2 or a 6 to determine if the...
Page 126 Command 0xA2 Completion. b) For online transactions, the device does the following: i) If the host started the transaction with Quick Chip Mode in effect: DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 126 of 247 (D998200136-31)
Page 127 (6) Depending on the transaction outcome, the device displays APPROVED DECLINED ERROR (similar to the screenshots in Command 0x07 - Display Message), and performs Command 0xA2 Completion. DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 127 of 247 (D998200136-31)
Page 128: Arqc Request (Emv Only)
DFDF58 to report how many bytes of tag DFDF59 are padding. DFDF59 contains the following after the host decrypts it: FC<len>/* container for encrypted generic data */ DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 128 of 247 (D998200136-31)
Page 129: Command 0Xa2 Completion
5) The host should send the device Command 0x02 - End Session to clear from the THANK YOU display and make the device ready for the next transaction. DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 129 of 247 (D998200136-31)
Page 130: Command 0Xa4 - Acquirer Response Arpc (Mac-Msr)
Big Block Data to Device. After sending the contents of the message, the host should send the following command to trigger the device to process it: Table 4-79 - Usage Table for Command 0xA4 Byte 0 0xA4 Bytes 1..12 Reserved DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 130 of 247 (D998200136-31)
Page 131: Command 0Xa8 - Get Kernel Info
Version - CL2 D-PAS Kernel (Chip Card Contactless Only, otherwise Reserved) 0x10 Checksum/Signature - L1 Kernel 0x11 Checksum/Signature - L2 Kernel LIB 0x12 Checksum/Signature - L2 Kernel Configuration 0x13 Checksum/Signature - L2 HAL DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 131 of 247 (D998200136-31)
Page 132 Checksum/Signature - CL2 Expresspay Kernel (Chip Card Contactless Only, otherwise 0x25 Reserved) Checksum/Signature - CL2 D-PAS Kernel (Chip Card Contactless Only, otherwise 0x26 Reserved) 0x30 Reserved DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 132 of 247 (D998200136-31)
Page 133: Command 0Xab - Request Emv Transaction Data (Mac-Msr)
… /* Status Data tags */ F8<len> /* container tag for encryption */ DFDF59(Encrypted Data Primative)<len><Encrypted Data val (Decrypt data to read tags)> DFDF56(Encrypted Transaction Data KSN)<len><val> DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 133 of 247 (D998200136-31)
Page 134 The following tables provide details about the data format. For an explanation of the “Format” columns, see the definitions in EMV 4.3 Book 3. DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 134 of 247 (D998200136-31)
Page 135 0x39 = Aid parse error 0x3A = Code table index not found 0x3B = Error no more record 0x3C = EMV e overflow [sic.] DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 135 of 247 (D998200136-31)
Page 136 DFDF70 TAC-default (Terminal Action Codes) Device DFDF71 TAC-Offline (Terminal Action Codes) Device DFDF72 TAC-Online (Terminal Action Codes) Device 9F5B Issuer Script Results Device 0..128 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 136 of 247 (D998200136-31)
Page 137 Track2 Equivalent Data Card 0..19 9F02 Amount Authorized Device 5F2A Transaction Currency Code Device Transaction Date Device 9F21 Transaction Time Device Transaction Type Device DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 137 of 247 (D998200136-31)
Page 138 Account Type Device 5F34 PAN Sequence Number Card 5F20 Cardholder Name Card Var 2..26 DFDF4D Masked ICC Track 2 Data Card Var 30..38 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 138 of 247 (D998200136-31)
Page 139: Command 0Xac - Merchant Bypass Pin Command
This command allows the host to bypass the PIN entry requirement during an EMV transaction (Command 0xA2 - Start EMV Transaction). Table 4-88 - Usage Table for Command 0xAC Byte 0 0xAC Byte 1 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 139 of 247 (D998200136-31)
Page 140: Command 0Xae - Mcl Send Det Command (Mcl 3.1 Support Only)
If an error occurs, the device terminates the command and reports the error in ACKSTS of Command 0x01 - Response ACK. For a full list of error codes, see Command 0x01 - Response ACK. DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 140 of 247 (D998200136-31)
Page 141: Wireless Connection Commands And Reports (802.11 Wireless Only | Pci Bluetooth Le Only)
Command 0xE1 - Unlock Wireless Network Configuration (802.11 Wireless Only). The host can then configure the device’s network settings by using the other commands in this section. DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 141 of 247 (D998200136-31)
Page 142: Command 0Xe1 - Unlock Wireless Network Configuration (802.11 Wireless Only)
Table 4-90 - Usage Table for Command 0xE3 - Restart Network (Set Mode) Byte 0 0xE1 Byte 1 Wait Time for operator passcode entry in seconds (0x01..0xFF; 0x00 = 256 seconds) DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 142 of 247 (D998200136-31)
Page 143: Command 0Xe2 - Set / Get Wireless Timeouts (802.11 Wireless Only | Pci Bluetooth Le Only)
Table 4-92 - Usage Table for Command 0xE2 (Get Limit Time Values in minutes) Byte 0 0xE2 Byte 1 Inactive Connection Timeout (802.11 Wireless Only, otherwise Reserved) Byte 2 Sleep Timeout DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 143 of 247 (D998200136-31)
Page 144: Command 0Xe3 - Enable / Disable Tls Mutual Authentication (802.11 Wireless Only)
4.6.3 Command 0xE3 - Enable / Disable TLS Mutual Authentication (802.11 Wireless Only) DynaPro Go ships from the manufacturer with TLS Enabled. This setting can be set to Disabled by the customer, which may be useful for initial network setup and testing. MagTek strongly recommends that TLS always be Enabled when it is deployed in the field.
Page 145: Command 0Xe4 - Set 802.11 Wireless Network Configuration (802.11 Wireless Only)
Usage of the command is slightly different depending on which setting the host is changing. The following subsections provide distinct usage tables for calling the command to change each of the available settings. DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 145 of 247 (D998200136-31)
Page 146: Command 0Xe4/0X00 Set 802.11 Wireless Access Point Connection
0x02 = WPA2 (PCI Requires WPA2 Security) Byte 4 SSID Name length Bytes 5..36 SSID Name (up to 32 characters) Bytes 37..63 Reserved DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 146 of 247 (D998200136-31)
Page 147: Command 0Xe4/0X02 Set 802.11 Wireless Access Point Security Key/Password
Byte 1 0x02 = Access Point Security Key / Password Byte 2 Security Key length Bytes 3..63 Security Key (up to 61 characters) DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 147 of 247 (D998200136-31)
Page 148: Command 0Xe4/0X03 Set 802.11 Wireless Tcp/Ip Settings
Static IPv4 address (4 bytes), ignored if IP Configuration is set to use dynamic IP Bytes 5..8 address Bytes 9..12 Gateway address (4 bytes) Bytes 13..16 Subnet Mask (4 bytes) Bytes 17..63 Reserved DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 148 of 247 (D998200136-31)
Page 149: Command 0Xe4/0X04 Set 802.11 Wireless Network Host Id
Host name length (if using IP address, set to 0x00) Host IPv4 address (4 bytes) OR Bytes 6..n Host name (up to 32 characters) Bytes n..63 Reserved DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 149 of 247 (D998200136-31)
Page 150: Command 0Xe5 - Get 802.11 Wireless Network Info (802.11 Wireless Only)
0x00 = Access Point Connection 0x01 = Reserved Byte 1 0x02 = Reserved 0x03 = Device 802.11 Wireless TCP/IP Settings 0x04 = Host ID Configuration DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 150 of 247 (D998200136-31)
Page 151: Appendix A Examples
3) The device prompts the cardholder to swipe his or her card, and sends Report 0x20 - Device State Report to the host, which expands to the following bytes: DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 151 of 247 (D998200136-31)
Page 152 802.11 wireless and Ethernet format of command 0A 00 iOS format of command (Note MSB order) 6) The device sends back Command 0x01 - Response ACK to the host. DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 152 of 247 (D998200136-31)
Page 153 11) The device sends the host Report 0x24 - PIN Response Report if PIN entry is successful. 12) The device sends the host another Report 0x20 - Device State Report. DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 153 of 247 (D998200136-31)
Page 154: How To Parse Encrypted Big Block Emv Data From An Sred Device
01C7 is the expected data length not including padding and CBC-MAC. Per Appendix D MagTek Custom EMV Tags and section 4.5.8, the next byte, F9, is a tag that indicates the beginning of a data object containing Message Authentication (MAC) structure and generic data.
Page 155 AF626E5A14F19C025B7CD1EF1456A31DDFDF560A9500030000000120039DDFDF570180 DFDF580106F782007FDFDF4001015F25031201015F24031401315F2A0208269F020600 00000002009F0607A00000000410109F1C0831313232333334349F3901059C01009F34 035E03005F5701305F3401005F2009544553542F43415244DFDF4D263B353431333030 303034303030313531333D303131343030303030303030303030303030303F The value of data object FA begins with tag F0, which Appendix D MagTek Custom EMV Tags and section 4.5.8 indicate is transaction results. Its length 0x82019C gives a 412 byte value: F105DFDF1A0100F882010EDFDF598200F08569A27E2A2A9D7E67A96624D10DBE3F366E C3F31C4072676FEF43213AF3C76ABE06A6E90F10E1650BE4ECE9CF64E9143129F66B44 E8C4A697CA5A0E319D933BF9BBC52B2DAF8FCC663354E2B0E545A5002F4A0C976E65DD...
Page 156 Appendix A - Examples The value of data object F0 (transaction results) begins with tag F1, which Appendix D MagTek Custom EMV Tags and section 4.5.8 indicate is status data. Its length is a single byte 0x05, giving the value DFDF1A0100.
Page 157 0012 5413339000001513D0114201000000000000 82 (EMV Application Interchange Profile) 0002 5800 The value if data block F0 (transaction results) continues with: F782007FDFDF4001015F25031201015F24031401315F2A0208269F0206000000000200 9F0607A00000000410109F1C0831313232333334349F3901059C01009F34035E03005F 5701305F3401005F2009544553542F43415244DFDF4D263B3534313330303030343030 30313531333D303131343030303030303030303030303030303F DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 157 of 247 (D998200136-31)
Page 158 3F (“TEST/CARD”) And the remaining data in the whole big block is: 00000000000000C568ACEB …which consists of padding zeroes and the 4-byte CBC-MAC C568ACEB. DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 158 of 247 (D998200136-31)
Page 159: Appendix B Terminology
IBM Corporation, since adopted by the US government and ANSI (the American National Standards Institute) as the encryption standard for financial institutions. DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 159 of 247 (D998200136-31)
Page 160 MagneSafe 2.0, MagTek’s proprietary method of encrypting data while preserving the essential MS2.0 format of the unencrypted data, such as length and character set. DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 160 of 247 (D998200136-31)
Page 161 TDES Triple Data Encryption Standard TRSM Tamper-Resistant Security Module Transaction Status Information Transaction Verification Results UART Universal Asynchronous Receive Transmit Universal Serial Bus DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 161 of 247 (D998200136-31)
Page 162 Appendix B - Terminology Term Definition USIP Universal Secure Integrated Platform DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 162 of 247 (D998200136-31)
Page 163: Appendix C Status And Message Codes
0x06 = Contactless ICC - EMV 0x07 = Financial MSR + ICC (Byte 2 bit 2 of device configuration must be set) 0x08 = Contactless ICC - MSD DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 163 of 247 (D998200136-31)
Page 164: Appendix D Magtek Custom Emv Tags (Emv Only)
In addition to the standard EMV tags documented in EMV 4.3, Book 3, Annex A and in Appendix H EMV Settings (EMV Only), MagTek provides additional custom tags with the device. These are used with Command 0xA1 - Access EMV Tags, Command 0xA2 - Start EMV Transaction, Command 0xA4 - Acquirer Response ARPC (MAC-MSR), and Command 0xAB - Request EMV Transaction Data (MAC-MSR).
Page 165 Masked T1 Status DFDF31 Masked T1 DFDF32 Masked T2 Status DFDF33 Masked T2 DFDF34 Masked T3 Status DFDF35 Masked T3 DFDF36 Encrypted T1 Status DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 165 of 247 (D998200136-31)
Page 166 DFDF53 0x81 = MSR Fallback used 0x01 = Technical Fallback used DFDF54 MAC KSN MAC Encryption Type (see DFDF42 for bit DFDF55 definitions) DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 166 of 247 (D998200136-31)
Page 167 00 00 00 00 00 00 b DFDF66 BIN Table Slot 6 00 00 00 00 00 00 b * Value is based on the ongoing transaction DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 167 of 247 (D998200136-31)
Page 168: Appendix Eemv Configurations (Emv Only)
MagTek, Inc. working with. 6) Click the attachment icon at the end of the row to open the Letter of Approval for that device. DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 168 of 247 (D998200136-31)
Page 169: Appendix F Error Codes
Battery Charge Measurement Failure Battery Charge Measurement Circuit bad ADC Failure USIP bad Error in 802.11 Wireless device (802.11 802.11 Wireless Failure Wireless Only) DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 169 of 247 (D998200136-31)
Page 170: S Codes
Cn where n = sum of the Description following Manufacturer Unbind/Rebind Certificate not loaded Device CA Certificate not loaded PIN Key Loader CA Certificate not loaded DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 170 of 247 (D998200136-31)
Page 171: Device Offline K Codes
No PIN Key Loader Certificate or PIN Key installed No PIN Key installed (or exhausted) Device Offline A Codes Table 4-109 - "A" Error Codes Code Displayed Description Device awaiting authentication DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 171 of 247 (D998200136-31)
Page 172: Device Offline W Codes (802.11 Wireless Only)
TLS connection. NET_STATUS_SYS_NOK System error. Reset the device. The device’s 802.11 wireless firmware is NET_STATUS_SELFTEST_NOK corrupted: Update the wireless firmware. DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 172 of 247 (D998200136-31)
Page 173: Appendix G Custom Messages (Custom Messages Only)
This code snippet provides an example of how to write a custom message to the device: void addCustomMessageString(MemoryStream m, byte x, byte y, byte p1, byte p2,string s) m.WriteByte((byte)(s.Length+5)); m.WriteByte(x); m.WriteByte(y); m.WriteByte(p1); m.WriteByte(p2); System.Text.ASCIIEncoding encoding = new System.Text.ASCIIEncoding(); DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 173 of 247 (D998200136-31)
Page 174 64, 30, 0x15, 0, "Select Cashback"); pp.SendMultiData(6, ms.ToArray()); //6 for getsel, 7 for disp pp.GetResponse(30, ResponseMsg.CustomMsg, KeyMask.Left | KeyMask.Right | KeyMask.Middle, 0); DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 174 of 247 (D998200136-31)
Page 175: Appendix Hemv Settings (Emv Only)
ICS Configuration C2:22 Additional Terminal Device Config ICS Configuration C1:70 00 A0 B0 01 9F40 Capabilities Manufacturer ICS Configuration C2:70 00 A0 B0 01 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 175 of 247 (D998200136-31)
Page 176 Config - Fallback Acquirer Terminal DFDF68 MagTek Config - PIN Bypass Terminal/Payment Brand 00 00 00 …00 [16 bytes fixed] DFDF26 MagTek Label DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 176 of 247 (D998200136-31)
Page 177: Emv Contact Application Settings (Emv 4.3E/F/G Kernel Only)
Type Terminal Threshold Value DFDF10 MagTek 00 00 00 00 40 00 Terminal Target DFDF11 MagTek Percentage Terminal Max Target DFDF12 MagTek Percentage DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 177 of 247 (D998200136-31)
Page 178 Type Terminal Threshold Value DFDF10 MagTek 00 00 00 00 40 00 Terminal Target DFDF11 MagTek Percentage Terminal Max Target DFDF12 MagTek Percentage DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 178 of 247 (D998200136-31)
Page 179 Type Terminal Threshold Value DFDF10 MagTek 00 00 00 00 40 00 Terminal Target DFDF11 MagTek Percentage Terminal Max Target DFDF12 MagTek Percentage DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 179 of 247 (D998200136-31)
Page 180 Type Terminal Threshold Value DFDF10 MagTek 00 00 00 00 40 00 Terminal Target DFDF11 MagTek Percentage Terminal Max Target DFDF12 MagTek Percentage DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 180 of 247 (D998200136-31)
Page 181 Type Terminal Threshold Value DFDF10 MagTek 00 00 00 00 40 00 Terminal Target DFDF11 MagTek Percentage Terminal Max Target DFDF12 MagTek Percentage DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 181 of 247 (D998200136-31)
Page 182 Type Terminal Threshold Value DFDF10 MagTek 00 00 00 00 40 00 Terminal Target DFDF11 MagTek Percentage Terminal Max Target DFDF12 MagTek Percentage DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 182 of 247 (D998200136-31)
Page 183 Type Terminal Threshold Value DFDF10 MagTek 00 00 00 00 40 00 Terminal Target DFDF11 MagTek Percentage Terminal Max Target DFDF12 MagTek Percentage DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 183 of 247 (D998200136-31)
Page 184 Type Terminal Threshold Value DFDF10 MagTek 00 00 00 00 40 00 Terminal Target DFDF11 MagTek Percentage Terminal Max Target DFDF12 MagTek Percentage DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 184 of 247 (D998200136-31)
Page 185 Type Terminal Threshold Value DFDF10 MagTek 00 00 00 00 40 00 Terminal Target DFDF11 MagTek Percentage Terminal Max Target DFDF12 MagTek Percentage DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 185 of 247 (D998200136-31)
Page 186 Type Terminal Threshold Value DFDF10 MagTek 00 00 00 00 40 00 Terminal Target DFDF11 MagTek Percentage Terminal Max Target DFDF12 MagTek Percentage DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 186 of 247 (D998200136-31)
Page 187: Paypass/Mcl Settings (Paypass Support Only | Mastercard Mcl 3.1.X Support Only)
4D 61 67 54 65 6B 00 00 00 00 00 00 00 00 Data Card Data Input DF8117 MagTek Capability Default UDOL DF811A MagTek 9F6A04 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 187 of 247 (D998200136-31)
Page 188 MagTek 509F12849F119F6D9F24569F6B Exception List DFDF0E MagTek 700E5A08373737345678904F5F340100 Socket Timeout DFDF14 MagTek 00 0 3A 98 Socket Retries DFDF15 MagTek 00 00 00 01 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 188 of 247 (D998200136-31)
Page 189 DF8109 MagTek DS ODS Info for Reader DF810A DSVN Term DF810D MagTek Reader Application DFDF27 Read Only Calculated - 20 bytes Database Checksum DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 189 of 247 (D998200136-31)
Page 190: Mcl Application Settings (Mcl 3.1.X Support Only)
Terminal Action Code - DF8122 MagTek 0000000000 Online Reader Contactless Floor DF8123 MagTek 000000010000 Limit Reader Contactless Transaction Limit (No DF8124 MagTek 000000030000 On-Device CVM) DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 190 of 247 (D998200136-31)
Page 191 DF811E MagTek Required Security Capability DF811F MagTek Terminal Action Code - DF8120 MagTek 0000000000 Default Terminal Action Code - DF8121 MagTek 0000000000 Denial DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 191 of 247 (D998200136-31)
Page 192 Kernel Configuration DF811B MagTek Max Lifetime of Torn DF811C MagTek 0000 Transaction Log Record Max Number of Torn DF811D MagTek Transaction Log Records DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 192 of 247 (D998200136-31)
Page 193 Management Data Terminal Type 9F35 MagTek Additional Terminal 9F40 MagTek 0000000000 Capabilities Kernel ID DF810C MagTek CVM Capability - CVM DF8118 MagTek Required DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 193 of 247 (D998200136-31)
Page 194 Configurable Default Value (Hex) Application DF Name MagTek A0000000041010 Transaction Type MagTek Application Version 9F09 MagTek 0002 Terminal Risk 9F1D MagTek Management Data DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 194 of 247 (D998200136-31)
Page 195 Transaction Limit (On- DF8125 MagTek 000000050000 Device CVM) Reader CVM Required DF8126 MagTek 000000020000 Limit Mag-Stripe CVM Capability - No CVM DF812C MagTek Required DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 195 of 247 (D998200136-31)
Page 196 Transaction Limit (No DF8124 MagTek 000000030000 On-Device CVM) Reader Contactless Transaction Limit (On- DF8125 MagTek 000000050000 Device CVM) Reader CVM Required DF8126 MagTek 000000020000 Limit DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 196 of 247 (D998200136-31)
Page 197 Terminal Action Code - DF8121 MagTek 0000000000 Denial Terminal Action Code - DF8122 MagTek 0000000000 Online Reader Contactless Floor DF8123 MagTek 000000010000 Limit DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 197 of 247 (D998200136-31)
Page 198 Transaction Log Records Mag-Stripe CVM Capability - CVM DF811E MagTek Required Security Capability DF811F MagTek Terminal Action Code - DF8120 MagTek 0000000000 Default DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 198 of 247 (D998200136-31)
Page 199 Kernel Configuration DF811B MagTek Max Lifetime of Torn DF811C MagTek 0000 Transaction Log Record Max Number of Torn DF811D MagTek Transaction Log Records DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 199 of 247 (D998200136-31)
Page 200 Management Data Terminal Type 9F35 MagTek Additional Terminal 9F40 MagTek 0000000000 Capabilities Kernel ID DF810C MagTek CVM Capability - CVM DF8118 MagTek Required DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 200 of 247 (D998200136-31)
Page 201 Default Value (Hex) Application DF Name MagTek A0000000043060 Transaction Type MagTek Application Version 9F09 MagTek 0002 Terminal Risk 9F1D MagTek 44FF800000000000 Management Data DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 201 of 247 (D998200136-31)
Page 202 Transaction Limit (On- DF8125 MagTek 000000050000 Device CVM) Reader CVM Required DF8126 MagTek 000000030000 Limit Mag-Stripe CVM Capability - No CVM DF812C MagTek Required DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 202 of 247 (D998200136-31)
Page 203 Transaction Limit (No DF8124 MagTek 000000030000 On-Device CVM) Reader Contactless Transaction Limit (On- DF8125 MagTek 000000050000 Device CVM) Reader CVM Required DF8126 MagTek 000000030000 Limit DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 203 of 247 (D998200136-31)
Page 204 Terminal Action Code - DF8121 MagTek 0000000000 Denial Terminal Action Code - DF8122 MagTek 0000000000 Online Reader Contactless Floor DF8123 MagTek 000000010000 Limit DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 204 of 247 (D998200136-31)
Page 205 Transaction Log Records Mag-Stripe CVM Capability - CVM DF811E MagTek Required Security Capability DF811F MagTek Terminal Action Code - DF8120 MagTek 0000000000 Default DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 205 of 247 (D998200136-31)
Page 206 Kernel Configuration DF811B MagTek Max Lifetime of Torn DF811C MagTek 0000 Transaction Log Record Max Number of Torn DF811D MagTek Transaction Log Records DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 206 of 247 (D998200136-31)
Page 207 Management Data Terminal Type 9F35 MagTek Additional Terminal 9F40 MagTek 0000000000 Capabilities Kernel ID DF810C MagTek CVM Capability - CVM DF8118 MagTek Required DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 207 of 247 (D998200136-31)
Page 208 Configurable Default Value (Hex) Application DF Name MagTek B012345678 Transaction Type MagTek Application Version 9F09 MagTek 0002 Terminal Risk 9F1D MagTek Management Data DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 208 of 247 (D998200136-31)
Page 209 Transaction Limit (On- DF8125 MagTek 000000050000 Device CVM) Reader CVM Required DF8126 MagTek 000000010000 Limit Mag-Stripe CVM Capability - No CVM DF812C MagTek Required DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 209 of 247 (D998200136-31)
Page 210: Paywave Settings (Paywave 2.1.3 Support Only | Paywave 2.2 Support Only)
Tags (EMV and DFDF02 MagTek 29F039F109F1A9F249F269F279F369F379 CVN17) F399F5B9F5D9F669F6ECF 575A8295999A9C5F205F245F2A5F349F0 Clearing Tags for EMV DFDF17 MagTek 29F039F109F1A9F249F269F279F369F379 and CVN17 F399F5B9F5D9F669F6EDFDF2C Socket Timeout DFDF14 MagTek 00000BB8 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 210 of 247 (D998200136-31)
Page 211 Tag Description Configurable Default Value (Hex) Socket Retries DFDF15 MagTek 00000003 Issuer Script Max Size DFDF16 MagTek 00000080 Default Terminal DFDF19 MagTek 656E Language DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 211 of 247 (D998200136-31)
Page 212 VOQOS compliant. If the device is only VCPS compliant, it reports this byte as 0x00. Bits 0..3 Reserved Bit 4 SDA Online activated DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 212 of 247 (D998200136-31)
Page 213 Bit 6 Decline transaction when SDA fails 0 = Disabled 1 = Enabled Bit 7 Forward transaction online when SDA fails 0 = Disabled 1 = Enabled DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 213 of 247 (D998200136-31)
Page 214 Bit 6 Cash Back Transaction support 0 = Disabled 1 = Enabled Bit 7 Manual Cash Transaction support 0 = Disabled 1 = Enabled DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 214 of 247 (D998200136-31)
Page 215 000000005000 Contactless CVM Limit PW Default Reader DF02 MagTek 000000008000 Contactless Floor Limit Reader Application DFDF27 MagTek 20 Bytes - calculated Database Checksum DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 215 of 247 (D998200136-31)
Page 216: Paywave Application Settings (Paywave 2.2 Support Only)
Table 4-148 - payWave Application Settings Slot 5 Tag Description Configurable Default Value (Hex) Application DF Name MagTek A0000000090807060504 Application AID 9F06 MagTek A0000000090807060504 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 216 of 247 (D998200136-31)
Page 217: Paywave Dynamic Reader Limit Settings (Paywave 2.2 Support Only)
Contactless Transaction DF00 MagTek 000000002000 Limit PW Default Reader DF01 MagTek 000000000500 Contactless CVM Limit PW Default Reader DF02 MagTek 000000001000 Contactless Floor Limit DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 217 of 247 (D998200136-31)
Page 218 Contactless Transaction DF00 MagTek 000000030000 Limit PW Default Reader DF01 MagTek 000000035000 Contactless CVM Limit PW Default Reader DF02 MagTek 000000040000 Contactless Floor Limit DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 218 of 247 (D998200136-31)
Page 219: Expresspay Settings (Expresspay 3.0 Support Only | Expresspay 3.1 Support Only)
E000F0A001 Capabilities Merchant Name and 9F4E MagTek 5261696C776179204F70657261746F72 Location MagStripe Application 9F6D MagTek Version Number Form Factor Indicator/Third Party 9F6E MagTek D8F00000 Data DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 219 of 247 (D998200136-31)
Page 220 Reader Application DFDF26 MagTek 45787072657373706179332E31204442 Database Label Reader Application DFDF27 MagTek 20 Bytes - calculated Database Checksum Number of DRL DFDF2A Compile Only DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 220 of 247 (D998200136-31)
Page 221 Tag Description Configurable Default Value (Hex) Supported Terminal DFDF2D MagTek 656E6672697464656573 Languages AMEX Unpredictable DFDF2E MagTek Number 45787072657373706179332E310D0000000 Kernel Version DFDF2F MagTek 0000000000000000000000000 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 221 of 247 (D998200136-31)
Page 222: Expresspay Application Settings (Expresspay 4.0 2 Support Only)
DF8121 MagTek 0000000000 Denial Terminal Action Code - DF8122 MagTek 0000000000 Online ASI (Application Select DFDF23 MagTek Indicator) Kernel Version DFDF2F MagTek 0001 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 222 of 247 (D998200136-31)
Page 223 DF8121 MagTek 0000000000 Denial Terminal Action Code - DF8122 MagTek 0000000000 Online ASI (Application Select DFDF23 MagTek Indicator) Kernel Version DFDF2F MagTek 0001 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 223 of 247 (D998200136-31)
Page 224: Expresspay Dynamic Reader Limit Settings (Expresspay 3.1 Only | Expresspay 4.0.2 Support Only)
H.5.3 Expresspay Dynamic Reader Limit Settings (Expresspay 3.1 Only | Expresspay 4.0.2 Support Only) There are 2 Dynamic Reader Limit Slots available that are set to empty as the factory default. DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 224 of 247 (D998200136-31)
Page 225: D-Pas Settings (D-Pas Support Only)
Merchant Category Code DF15 MagTek 0001 Loyalty Program ID DF70 MagTek Hold Time Value DF8130 MagTek 9A9F025A899F109F169F4E828E5F245F25 Authorization Request 9F069F079F0D9F0E9F0F9F269F279F369C DFDF02 MagTek Tags EMV 9F339F349F379F399F40959B9F5BF59F1E 9F1A5F2A9F019F21 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 225 of 247 (D998200136-31)
Page 226 MagTek Cashback Transaction Terminal Capabilities for Cash Advance DFDF5D MagTek Transaction Terminal Capabilities for DFDF5E MagTek Refund Transaction Terminal Features DFDF5F MagTek FC00 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 226 of 247 (D998200136-31)
Page 227: D-Pas Application Settings
MagTek 00003A98 Reader Contactless DF00 MagTek 000000030000 Transaction Limit Reader Contactless CVM DF01 MagTek 000000002000 Limit Reader Contactless Floor DF02 MagTek 000000015000 Limit DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 227 of 247 (D998200136-31)
Page 228 Default Terminal Action Code - DF8121 MagTek 0000000000 Denial Terminal Action Code - DF8122 MagTek 0000000000 Online ASI (Application Select DFDF23 MagTek Indicator) DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 228 of 247 (D998200136-31)
Page 229: Appendix I Language And Country Codes
Terminal Language Codes Table 4-161 - Terminal Language Codes 656E English (en) 6672 French (fr) 6974 Italian (it) 6465 German (de) 6573 Spanish (es) DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 229 of 247 (D998200136-31)
Page 230 Section J.1 Bluetooth LE Module Commands provides a list of available Bluetooth LE module commands, and section J.2 Bluetooth LE Module Configuration Properties provides a list of Bluetooth LE module configuration settings. DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 230 of 247 (D998200136-31)
Page 231: Bluetooth Le Module Commands
0x00 (success) 0x01 (failure) 0x02 (bad parameters) Bytes 2..n Command response data Notification message format Byte 1 Notification identifier Byte 2..n Notification data DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 231 of 247 (D998200136-31)
Page 232: Bluetooth Le Command 0X00 - Get Property
Data to echo from request message Example Echo command: Request message (hex): 00 02 01 02 03 Response message (hex): 01 00 01 02 03 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 232 of 247 (D998200136-31)
Page 233: Bluetooth Le Command 0X03 - Reset
Byte 0 0x01 (Response message type) Byte 1 Response code Example command: Request message (hex): 00 04 55 AA Response message (hex): 01 00 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 233 of 247 (D998200136-31)
Page 234: Bluetooth Le Command 0X05 - Erase All Bonds
Byte 0 0x01 (Response message type) Byte 1 Response code Example command: Request message (hex): 00 05 55 AA Response message (hex): 01 00 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 234 of 247 (D998200136-31)
Page 235: Bluetooth Le Command 0X0C - Terminate Bluetooth Le Connection (Pci Bluetooth Le Only)
Response message Byte 0 0x01 (Response message type) Byte 1 Response code Example command: Request message (hex): 00 0C Response message (hex): 01 00 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 235 of 247 (D998200136-31)
Page 236: Bluetooth Le Module Configuration Properties
Example Get Bluetooth Device Address property: Request message (hex): 00 00 01 Response message (hex): 01 00 EC 11 A0 E5 C5 78 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 236 of 247 (D998200136-31)
Page 237: Bluetooth Le Property 0X02 - Bluetooth Device Name
Modifying this property too many times wears out flash memory. Default value: A string composed of the device name (such as “DynaProMini” or “DynaPro Go”) plus “-XXYY” where XX is the second to least significant byte of the Bluetooth device address converted to ASCII hex, and YY is the least significant byte.
Page 238: Bluetooth Le Property 0X03 - Configuration Revision
Response message (hex): 01 00 01 (configuration revision 1) Example Set Configuration Revision property: Request message (hex): 00 01 03 01 (configuration revision 1) Response message (hex): 01 00 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 238 of 247 (D998200136-31)
Page 239: Bluetooth Le Property 0X05 - Power Control
Example Set Power Control property: Request message (hex): 00 01 05 03 (button controlled and Bluetooth Connection controlled) Response message (hex): 01 00 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 239 of 247 (D998200136-31)
Page 240: Bluetooth Le Property 0X06 - Advertising Control
Response message (hex): 01 00 00 Example Set Advertise Control property: Request message (hex): 00 01 06 00 Response message (hex): 01 00 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 240 of 247 (D998200136-31)
Page 241: Bluetooth Le Property 0X08 - Desired Minimum Connection Interval
Response message (hex): 01 00 0A 00 (10 (0x0A) (12.5 milliseconds)) Example Set Property: Request message (hex): 00 01 08 0A 00 (10 (0x0A) (12.5 milliseconds)) Response message (hex): 01 00 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 241 of 247 (D998200136-31)
Page 242: Bluetooth Le Property 0X09 - Desired Maximum Connection Interval
Response message (hex): 01 00 0A 00 (10 (0x0A) (12.5 milliseconds)) Example Set Property: Request message (hex): 00 01 09 0A 00 (10 (0x0A) (12.5 milliseconds)) Response message (hex): 01 00 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 242 of 247 (D998200136-31)
Page 243: Bluetooth Le Property 0X0A - Desired Slave Latency
Response message (hex): 01 00 04 00 (4) Example Set Property: Request message (hex): 00 01 0A 04 00 (4) Response message (hex): 01 00 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 243 of 247 (D998200136-31)
Page 244: Bluetooth Le Property 0X0B - Desired Supervision Timeout
Response message (hex): 01 00 F4 01 (500 (0x1F4) (5000 milliseconds)) Example Set Property: Request message (hex): 00 01 0B F4 01 (500 (0x1F4) (5000 milliseconds)) Response message (hex): 01 00 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 244 of 247 (D998200136-31)
Page 245: Bluetooth Le Property 0X0C - Connection Parameter Update Request Control
Response message (hex): 01 00 01 (send connection parameter update bit is set) Example Set property: Request message (hex): 00 01 0C 01 (send connection parameter update bit is set) Response message (hex): 01 00 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 245 of 247 (D998200136-31)
Page 246: Bluetooth Le Property 0X0D - Minimum Advertising Interval (Pci Bluetooth Le Only)
Response message (hex): 01 00 06 40 (1000ms / .625ms) = 1600 (0x0640) Example Set property: Request message (hex): 00 01 0D 06 40 (1000ms / .625ms) = 1600 (0x0640) Response message (hex): 01 00 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 246 of 247 (D998200136-31)
Page 247: Bluetooth Le Property 0X0E - Maximum Advertising Interval (Pci Bluetooth Le Only)
Response message (hex): 01 00 06 40 (1000ms / .625ms) = 1600 (0x0640) Example Set property: Request message (hex): 00 01 0E 06 40 (1000ms / .625ms) = 1600 (0x0640) Response message (hex): 01 00 DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS) Page 247 of 247 (D998200136-31)

Magtek DynaPro Go Programmer's Manual

Quick Links

Need help?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for Magtek DynaPro Go

Summary of Contents for Magtek DynaPro Go

Table of Contents