Magtek DynaPro Go Owner's manual

MagTek I 1710 Apollo Court I Seal Beach, CA 90740 I Phone: (562) 546-6400 I Technical Support: (888) 624-8350

www.magtek.com

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

DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS)

Page 2 of 247 (D998200136-31)

Printed in the United States of America

INFORMATION IN THIS PUBLICATION IS SUBJECT TO CHANGE WITHOUT NOTICE AND

MAY CONTAIN TECHNICAL INACCURACIES OR GRAPHICAL DISCREPANCIES. CHANGES

OR IMPROVEMENTS MADE TO THIS PRODUCT WILL BE UPDATED IN THE NEXT

PUBLICATION RELEASE. NO PART OF THIS DOCUMENT MAY BE REPRODUCED OR

TRANSMITTED IN ANY FORM OR BY ANY MEANS, ELECTRONIC OR MECHANICAL, FOR

ANY PURPOSE, WITHOUT THE EXPRESS WRITTEN PERMISSION OF MAGTEK, INC.

MagTek® is a registered trademark of MagTek, Inc.

MagnePrint® is a registered trademark of MagTek, Inc.

MagneSafe® is a registered trademark of MagTek, Inc.

Magensa™ is a trademark of MagTek, Inc.

DynaPro™ and DynaPro Mini™ are trademarks of MagTek, Inc.

IPAD® is a registered 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.

Apple Pay® is a registered trademark to Apple Inc.

D-PAYMENT APPLICATION SPECIFICATION® is a registered trademark to Discover Financial

Services CORPORATION

Google Wallet™ payment service is a trademark of Google Inc.

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.

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.

UL™ and the UL logo are trademarks of UL 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 and Android™ platform are trademarks of Google Inc. Google Wallet™ payment

service is a trademark of Google Inc.

iPhone®, iPod®, and Mac® are registered trademarks of Apple Inc., registered in the U.S. and other

countries. App Store

SM

is a service mark of Apple Inc., registered in the U.S. and other countries. iPad™

is a trademark of Apple, Inc. 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® and Windows® are registered trademarks of Microsoft Corporation.

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 3 of 247 (D998200136-31)

Table 1-1 - Revisions

Rev Number

Date

Notes

10

Oct 28, 2016

Engineering Prototype for BOM purposes (no attachments)

20

Aug 29, 2018

Initial release from master Rev 150 plus minor corrections

30

Mar 19, 2019

Derived from PCI submaster rev 51 plus minor corrections

from master rev 152 (update default value of Bluetooth LE

Property 0x08 - Desired Minimum Connection Interval,

default value of Bluetooth LE Property 0x09 - Desired

Maximum Connection Interval); Section 3.3.1, section 4.6.3

rewrite Caution text to reflect devices will not ship with TLS

disabled; Add Extended Device Certificate Status to Report

0x20 - Device State Report; Update default value of 9F66 in

section H.4.1 payWave Terminal Settings (payWave 2.2

Support Only); Correct PIN Block Format option in 4.3.4

Command 0x04 - Request PIN Entry; Update error codes

section F.6; Remove Command 0xE8 - Set 802.11 Wireless

TLS Root CA Certificate; Modify Command 0xE4/0x00 Set

802.11 Wireless Access Point Connection for enterprise

connection types; Add guidance to Command 0xE4/0x02 Set

802.11 Wireless Access Point Security Key/Password;

Update About Device Features to show Interoperability Test

Support and add Quick Chip capability to DynaPro Mini-

Bluetooth LE; Add TLS interface debugging guidance to How

to Use 802.11 Wireless Connections (802.11 Wireless Only);

Clarify detailed Quick Chip behavior for Command 0xA2 -

Start EMV Transaction; Update About Device Features to

add payWave checksum feature and changes in the contactless

kernels specification supported; Correct Byte 4 of Table 4-77;

Remove device-specific information from How to Use

Bluetooth LE Connections (Bluetooth LE Only | PCI

Bluetooth LE Only); Clarify response sequences for

Command 0xA1 - Access EMV Tags; Add Suppress Signature

Capture to feature table; Add PCI Bluetooth LE to feature table

and add related information about PCI Bluetooth LE devices

throughout; Misc. clarifications and corrections

31

Apr 15, 2021

Derived from master Rev 153:

Throughout, clarify RSA-OAEP is RSA-OAEP V2.0; Fix

cross-references missing from Table 1-1 - Revisions; Section

2.4 add features Host-Supplied-Non-Session-PAN and

Expresspay 4.0.2; Section 4.2, correct CBC-MAC calculation

method to include message length; Add Command 0x40 -

Request PIN Entry with Host Supplied Account Data (Host-

Supplied-Non-Session-PAN Only) and modify Report 0x24 -

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 4 of 247 (D998200136-31)

LIMITED WARRANTY

MagTek warrants that the products sold pursuant to this Agreement will perform in accordance with

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

During the Warranty Period, should this product fail to conform to MagTek’s specifications, MagTek

will, at its option, repair or replace this product at no additional charge except as set forth below. Repair

parts and replacement products will be furnished on an exchange basis and will be either reconditioned or

new. All replaced parts and products become the property of MagTek. This limited warranty does not

include service to repair damage to the product resulting from accident, disaster, unreasonable use,

misuse, abuse, negligence, or modification of the product not authorized by MagTek. MagTek reserves

the right to examine the alleged defective goods to determine whether the warranty is applicable.

Without limiting the generality of the foregoing, MagTek specifically disclaims any liability or warranty

for goods resold in other than MagTek’s original packages, and for goods modified, altered, or treated

without authorization by MagTek.

Service may be obtained by delivering the product during the warranty period to MagTek (1710 Apollo

Court, Seal Beach, CA 90740). If this product is delivered by mail or by an equivalent shipping carrier,

the customer agrees to insure the product or assume the risk of loss or damage in transit, to prepay

shipping charges to the warranty service location, and to use the original shipping container or equivalent.

MagTek will return the product, prepaid, via a three (3) day shipping service. A Return Material

Authorization (“RMA”) number must accompany all returns. Buyers may obtain an RMA number by

contacting Technical Support at (888) 624-8350.

EACH BUYER UNDERSTANDS THAT THIS MAGTEK PRODUCT IS

OFFERED AS IS. MAGTEK MAKES NO OTHER WARRANTY, EXPRESS OR

IMPLIED, AND MAGTEK DISCLAIMS ANY WARRANTY OF ANY OTHER

KIND, INCLUDING ANY WARRANTY OF MERCHANTABILITY OR FITNESS

FOR A PARTICULAR PURPOSE.

IF THIS PRODUCT DOES NOT CONFORM TO MAGTEK’S

SPECIFICATIONS, THE SOLE REMEDY SHALL BE REPAIR OR

REPLACEMENT AS PROVIDED ABOVE. MAGTEK’S LIABILITY, IF ANY,

SHALL IN NO EVENT EXCEED THE TOTAL AMOUNT PAID TO MAGTEK

UNDER THIS AGREEMENT. IN NO EVENT WILL MAGTEK BE LIABLE TO

THE BUYER FOR ANY DAMAGES, INCLUDING ANY LOST PROFITS, LOST

SAVINGS, OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES

ARISING OUT OF THE USE OF, OR INABILITY TO USE, SUCH PRODUCT,

EVEN IF MAGTEK HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH

DAMAGES, OR FOR ANY CLAIM BY ANY OTHER PARTY.

DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS)

Page 5 of 247 (D998200136-31)

LIMITATION ON LIABILITY

EXCEPT AS PROVIDED IN THE SECTIONS RELATING TO MAGTEK’S LIMITED WARRANTY,

MAGTEK’S LIABILITY UNDER THIS AGREEMENT IS LIMITED TO THE CONTRACT PRICE OF

THIS PRODUCT.

MAGTEK MAKES NO OTHER WARRANTIES WITH RESPECT TO THE PRODUCT, EXPRESSED

OR IMPLIED, EXCEPT AS MAY BE STATED IN THIS AGREEMENT, AND MAGTEK

DISCLAIMS ANY IMPLIED WARRANTY, INCLUDING WITHOUT LIMITATION ANY IMPLIED

WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

MAGTEK SHALL NOT BE LIABLE FOR CONTINGENT, INCIDENTAL, OR CONSEQUENTIAL

DAMAGES TO PERSONS OR PROPERTY. MAGTEK FURTHER LIMITS ITS LIABILITY OF ANY

KIND WITH RESPECT TO THE PRODUCT, INCLUDING ANY NEGLIGENCE ON ITS PART, TO

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 6 of 247 (D998200136-31)

FCC INFORMATION

This device complies with Part 15 of the FCC Rules. Operation is subject to the following two

conditions: (1) This device may not cause harmful interference, and (2) This device must accept any

interference received, including interference that may cause undesired operation.

Note: This equipment has been tested and found to comply with the limits for a Class B digital device,

pursuant to part 15 of the FCC Rules. These limits are designed to provide reasonable protection against

harmful interference in a residential installation. This equipment generates, uses and can radiate radio

frequency energy and, if not installed and used in accordance with the instructions, may cause harmful

interference to radio communications. However, there is no guarantee that interference will not occur in a

particular installation. If this equipment does cause harmful interference to radio or television reception,

which can be determined by turning the equipment off and on, the user is encouraged to try to correct the

interference by one or more of the following measures:

 Reorient or relocate the receiving antenna.

 Increase the separation between the equipment and receiver.

 Connect the equipment into an outlet on a circuit different from that to which the receiver is

connected.

 Consult the dealer or an experienced radio/TV technician for help.

Caution: Any changes or modifications not expressly approved by the party responsible for

compliance could void the user’s authority to operate this equipment. RF Exposure: A

distance of 20 cm shall be maintained between the antenna and users, and the transmitter

may not be co-located with any other transmitter or antenna.

CUR/UR

This product is recognized per Underwriter Laboratories and Canadian Underwriter Laboratories 1950.

CANADIAN DOC STATEMENT

This digital apparatus does not exceed the Class B limits for radio noise from digital apparatus set out in

the Radio Interference Regulations of the Canadian Department of Communications.

Le présent appareil numérique n’émet pas de bruits radioélectriques dépassant les limites applicables aux

appareils numériques de la classe B prescrites dans le Réglement sur le brouillage radioélectrique édicté

par le ministère des Communications du Canada.

This Class B digital apparatus complies with Canadian ICES-003.

Cet appareil numérique de la classe B est conformé à la norme NMB-003 du Canada.

CE STANDARDS

Testing for compliance with CE requirements was performed by an independent laboratory. The unit

under test was found compliant with standards established for Class B devices.

UL/CSA

This product is recognized per UL 60950-1, 2nd Edition, 2011-12-19 (Information Technology

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 7 of 247 (D998200136-31)

ROHS STATEMENT

When ordered as RoHS compliant, this product meets the Electrical and Electronic Equipment (EEE)

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

1 - Table of Contents

DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS)

Page 8 of 247 (D998200136-31)

1 Table of Contents

Limited Warranty .............................................................................................................................................. 4

FCC Information ................................................................................................................................................ 6

CUR/UR............................................................................................................................................................... 6

CANADIAN DOC STATEMENT ........................................................................................................................... 6

CE STANDARDS ................................................................................................................................................. 6

UL/CSA ............................................................................................................................................................... 6

RoHS STATEMENT ............................................................................................................................................. 7

1 Table of Contents ...................................................................................................................................... 8

2 Introduction ............................................................................................................................................. 13

2.1 About This Document .................................................................................................................... 13

2.2 About Terminology ......................................................................................................................... 13

2.3 About Connection Types ................................................................................................................ 13

2.4 About Device Features .................................................................................................................. 13

2.5 About SDKs ..................................................................................................................................... 17

3 Connection Types .................................................................................................................................... 18

3.1 How to Use USB Connections (USB Only) ................................................................................... 18

3.1.1 About Reports ......................................................................................................................... 19

3.1.2 About the Report Descriptor ................................................................................................ 20

3.1.3 How to Send Commands On the USB Connection ............................................................ 28

3.1.4 How to Receive Data On the USB Connection ................................................................... 29

3.2 How to Use Bluetooth LE Connections (Bluetooth LE Only | PCI Bluetooth LE Only) .......... 30

3.3 How to Use Network Connections (Ethernet Only | 802.11 Wireless Only) .......................... 32

3.3.1 How to Use 802.11 Wireless Connections (802.11 Wireless Only) ............................... 33

3.3.2 How to Send Commands Using Network Connections .................................................... 35

3.3.3 How to Receive Data On the 802.11 Wireless Connection ............................................. 36

4 Command Set ......................................................................................................................................... 37

4.1 About Big Block Data and TLV Format........................................................................................ 37

4.2 About Message Authentication Codes (“MAC-AMK” or “MAC-MSR”) ..................................... 37

4.3 General Commands ....................................................................................................................... 39

4.3.1 Command 0x01 - Response ACK ........................................................................................ 39

4.3.2 Command 0x02 - End Session ............................................................................................. 41

4.3.3 Command 0x03 - Request Swipe Card .............................................................................. 42

4.3.4 Command 0x04 - Request PIN Entry .................................................................................. 44

4.3.5 Command 0x05 - Cancel Command ................................................................................... 47

4.3.6 Command 0x06 - Request Cardholder Selection ............................................................. 48

4.3.7 Command 0x07 - Display Message .................................................................................... 50

1 - Table of Contents

DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS)

Page 9 of 247 (D998200136-31)

4.3.8 Command 0x08 - Request Device Status .......................................................................... 52

4.3.9 Command 0x09 - Set / Get Device Configuration ............................................................ 53

4.3.10 Command 0x0A - Request MSR Data ................................................................................ 57

4.3.11 Command 0x0B - Get Challenge ......................................................................................... 58

4.3.12 Command 0x0C - Set Bitmap (Bitmaps Only) ................................................................... 59

4.3.13 Command 0x0E - Get Information ...................................................................................... 60

4.3.14 Command 0x0F - Login/Authenticate or Logout .............................................................. 63

4.3.15 Command 0x10 - Send Big Block Data to Device ............................................................ 64

4.3.16 Command 0x11 - Request Manual Card Entry .................................................................. 66

4.3.17 Command 0x12 - Request Cardholder Signature (SC-S Only | SC-F Only) ................... 68

4.3.18 Command 0x13 - Get Cardholder Signature (SC-S Only | SC-F Only) ............................ 69

4.3.19 Command 0x14 - Request Cardholder Data Entry ........................................................... 70

4.3.20 Command 0x16 - Get Selected Menu Item Command (Handheld Operation Only) ... 72

4.3.21 Command 0x17 - Update Device ......................................................................................... 73

4.3.22 Command 0x1A - Request Device Information ................................................................ 74

4.3.23 Command 0x1C - Set/Get Bluetooth LE Power Configuration (Bluetooth LE Only | PCI

Bluetooth LE Only) .................................................................................................................................. 78

4.3.24 Command 0x1D - Set Bluetooth LE Module Control Data (Bluetooth LE Only | PCI

Bluetooth LE Only) .................................................................................................................................. 79

4.3.25 Command 0x1F - Request Clear Text Cardholder Data Entry (Clear Text User Data

Only) 80

4.3.26 Command 0x32 - Get BIN Whitelist Table - Non Financial Format ................................ 83

4.3.27 Command 0x33 - Get BIN Whitelist Table - Financial Format (Financial Format

Whitelist Only) ......................................................................................................................................... 84

4.3.28 Command 0x40 - Request PIN Entry with Host Supplied Account Data (Host-Supplied-

Non-Session-PAN Only) .......................................................................................................................... 85

4.3.29 Command 0x58 - Request Device Certificate ................................................................... 87

4.3.30 Command 0xFF - Device Reset ............................................................................................ 88

4.4 General Input Reports ................................................................................................................... 89

4.4.1 Report 0x20 - Device State Report ..................................................................................... 89

4.4.2 Report 0x21 - Cardholder Data Entry Response Report .................................................. 93

4.4.3 Report 0x22 - Card Status Report ....................................................................................... 95

4.4.4 Report 0x23 - Card Data Report (MAC-MSR) ..................................................................... 96

4.4.5 Report 0x24 - PIN Response Report ................................................................................... 98

4.4.6 Report 0x25 - Cardholder Selection Response Report .................................................... 99

4.4.7 Report 0x26 - Send Selected Menu Item (Handheld Operation Only) ......................... 100

4.4.8 Report 0x27 - Display Message Done Report ................................................................. 101

4.4.9 Report 0x28 - Signature Capture State Report (SC-S Only | SC-F Only)...................... 102

1 - Table of Contents

DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS)

Page 10 of 247 (D998200136-31)

4.4.10 Report 0x29 - Send Big Block Data to Host ..................................................................... 103

4.4.10.1 Big Block Data for Authorization Request (ARQC) ................................................. 104

4.4.11 Report 0x2A - Delayed Response ACK ............................................................................. 106

4.4.12 Report 0x2D - Bluetooth LE Module Control Data (Bluetooth LE Only | PCI Bluetooth

LE Only) 107

4.4.13 Report 0x2E - Clear Text Cardholder Data Entry Response Report (Clear Text User

Data Only) .............................................................................................................................................. 108

4.4.14 Report 0x2F - Request Host Connection (Handheld Operation Only, 802.11 Wireless

Only) 109

4.5 EMV-Related Commands and Reports (EMV Only) ................................................................. 111

4.5.1 Report 0x2C - EMV Cardholder Interaction Status Report ............................................. 112

4.5.2 Report 0x30 - Tip or Cashback Report (Handheld Operation Only) ............................. 113

4.5.3 Command 0xA0 - Request Tip or Cashback (Handheld Operation Only) .................... 114

4.5.4 Command 0xA1 - Access EMV Tags .................................................................................. 117

4.5.4.1 Reading All EMV Tags ................................................................................................. 118

4.5.5 Command 0xA2 - Start EMV Transaction ......................................................................... 120

4.5.5.1 Standard EMV Transaction ......................................................................................... 122

4.5.5.2 ARQC Request (EMV Only) .......................................................................................... 128

4.5.5.3 Command 0xA2 Completion ..................................................................................... 129

4.5.6 Command 0xA4 - Acquirer Response ARPC (MAC-MSR) .............................................. 130

4.5.7 Command 0xA8 - Get Kernel Info ..................................................................................... 131

4.5.8 Command 0xAB - Request EMV Transaction Data (MAC-MSR) .................................... 133

4.5.9 Command 0xAC - Merchant Bypass PIN Command ....................................................... 139

4.5.10 Command 0xAE - MCL Send DET Command (MCL 3.1 Support Only) ......................... 140

4.6 Wireless Connection Commands and Reports (802.11 Wireless Only | PCI Bluetooth LE

Only) 141

4.6.1 Command 0xE1 - Unlock Wireless Network Configuration (802.11 Wireless Only) . 142

4.6.2 Command 0xE2 - Set / Get Wireless Timeouts (802.11 Wireless Only | PCI Bluetooth

LE Only) 143

4.6.3 Command 0xE3 - Enable / Disable TLS Mutual Authentication (802.11 Wireless Only)

144

4.6.4 Command 0xE4 - Set 802.11 Wireless Network Configuration (802.11 Wireless Only)

145

4.6.4.1 Command 0xE4/0x00 Set 802.11 Wireless Access Point Connection .............. 146

4.6.4.2 Command 0xE4/0x02 Set 802.11 Wireless Access Point Security Key/Password

147

4.6.4.3 Command 0xE4/0x03 Set 802.11 Wireless TCP/IP Settings ............................. 148

4.6.4.4 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

1 - Table of Contents

DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS)

Page 11 of 247 (D998200136-31)

Appendix A Examples ............................................................................................................................... 151

A.1 How to Get MSR/PIN Data from the Device for a Bank Simulation .................................... 151

A.2 How to Parse Encrypted Big Block EMV Data From An SRED Device .................................. 154

Appendix B Terminology .......................................................................................................................... 159

Appendix C Status and Message Codes ................................................................................................ 163

Appendix D MagTek Custom EMV Tags (EMV Only) ............................................................................. 164

Appendix E EMV Configurations (EMV Only) ......................................................................................... 168

Appendix F Error Codes ............................................................................................................................ 169

F.1 H Codes .......................................................................................................................................... 169

F.2 S Codes .......................................................................................................................................... 170

F.3 C Codes .......................................................................................................................................... 170

F.4 Device Offline K Codes ................................................................................................................ 171

F.5 Device Offline A Codes ................................................................................................................ 171

F.6 Device Offline W Codes (802.11 Wireless Only) ..................................................................... 172

Appendix G Custom Messages (Custom Messages Only) ................................................................... 173

Appendix H EMV Settings (EMV Only) ..................................................................................................... 175

H.1 Certificate Authority Public Keys ............................................................................................... 175

H.2 EMV Contact Settings (EMV Only) .............................................................................................. 175

H.2.1 EMV Contact Terminal Settings (EMV 4.3E/F/G Kernel Only) ...................................... 175

H.2.2 EMV Contact Application Settings (EMV 4.3E/F/G Kernel Only) .................................. 177

H.3 PayPass/MCL Settings (PayPass Support Only | MasterCard MCL 3.1.x Support Only) .. 187

H.3.1 MCL Terminal Settings (MCL 3.1.x Support Only) ........................................................... 187

H.3.2 MCL Application Settings (MCL 3.1.x Support Only) ....................................................... 190

H.4 payWave Settings (payWave 2.1.3 Support Only | payWave 2.2 Support Only) ............... 210

H.4.1 payWave Terminal Settings (payWave 2.2 Support Only) ............................................. 210

H.4.2 payWave Application Settings (payWave 2.2 Support Only) ......................................... 216

H.4.3 payWave Dynamic Reader Limit Settings (payWave 2.2 Support Only) ..................... 217

H.5 Expresspay Settings (Expresspay 3.0 Support Only | Expresspay 3.1 Support Only) ........ 219

H.5.1 Expresspay Terminal Settings (Expresspay 3.1 Support Only | Expresspay 4.0.2

Support Only) ......................................................................................................................................... 219

H.5.2 Expresspay Application Settings (Expresspay 4.0 2 Support Only) .............................. 222

H.5.3 Expresspay Dynamic Reader Limit Settings (Expresspay 3.1 Only | Expresspay 4.0.2

Support Only) ......................................................................................................................................... 224

H.6 D-PAS Settings (D-PAS Support Only) ....................................................................................... 225

H.6.1 D-PAS Terminal Settings ..................................................................................................... 225

H.6.2 D-PAS Application Settings ................................................................................................ 227

Appendix I Language and Country Codes ............................................................................................ 229

I.1 Terminal Country Codes .............................................................................................................. 229

I.2 Terminal Language Codes .......................................................................................................... 229

1 - Table of Contents

DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS)

Page 12 of 247 (D998200136-31)

Appendix J Bluetooth LE Module Control Messages (Bluetooth LE Only | PCI Bluetooth LE Only)

230

J.1 Bluetooth LE Module Commands .............................................................................................. 231

J.1.1 About Bluetooth LE Module Commands .......................................................................... 231

J.1.2 Bluetooth LE Command 0x00 - Get Property .................................................................. 232

J.1.3 Bluetooth LE Command 0x01 - Set Property ................................................................... 232

J.1.4 Bluetooth LE Command 0x02 - Echo ................................................................................ 232

J.1.5 Bluetooth LE Command 0x03 - Reset .............................................................................. 233

J.1.6 Bluetooth LE Command 0x04 - Erase All Non-volatile Memory ................................... 233

J.1.7 Bluetooth LE Command 0x05 - Erase All Bonds ............................................................. 234

J.1.8 Bluetooth LE Command 0x0C - Terminate Bluetooth LE Connection (PCI Bluetooth LE

Only) 235

J.2 Bluetooth LE Module Configuration Properties ....................................................................... 236

J.2.1 Bluetooth LE Property 0x00 - Software ID ....................................................................... 236

J.2.2 Bluetooth LE Property 0x01 - Bluetooth Device Address .............................................. 236

J.2.3 Bluetooth LE Property 0x02 - Bluetooth Device Name .................................................. 237

J.2.4 Bluetooth LE Property 0x03 - Configuration Revision .................................................... 238

J.2.5 Bluetooth LE Property 0x05 - Power Control ................................................................... 239

J.2.6 Bluetooth LE Property 0x06 - Advertising Control .......................................................... 240

J.2.7 Bluetooth LE Property 0x08 - Desired Minimum Connection Interval ......................... 241

J.2.8 Bluetooth LE Property 0x09 - Desired Maximum Connection Interval ........................ 242

J.2.9 Bluetooth LE Property 0x0A - Desired Slave Latency ..................................................... 243

J.2.10 Bluetooth LE Property 0x0B - Desired Supervision Timeout ......................................... 244

J.2.11 Bluetooth LE Property 0x0C - Connection Parameter Update Request Control ........ 245

J.2.12 Bluetooth LE Property 0x0D - Minimum Advertising Interval (PCI Bluetooth LE Only)

246

J.2.13 Bluetooth LE Property 0x0E - Maximum Advertising Interval (PCI Bluetooth LE Only)

247

2 - Introduction

DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS)

Page 13 of 247 (D998200136-31)

2 Introduction

2.1 About This Document

This document describes the command set available using byte-by-byte direct communication with

devices in the DynaPro family listed on the cover page: DynaPro Go.

2.2 About Terminology

The general terms “device” and “host” are used in different, often incompatible ways in a multitude of

specifications and contexts. For example, “host” may have different meanings in the context of USB

communication than in the context of networked financial transaction processing. In this document,

“device” and “host” are used strictly as follows:

 Device refers to the PIN Encryption Device (PED) that receives and responds to the command set

specified in this document. Devices include DynaPro, DynaPro Go, and so on.

 Host refers to the piece of general-purpose electronic equipment the device is connected or paired to,

which can send data to and receive data from the device. Host types include PC and Mac

computers/laptops, tablets, smartphones, teletype terminals, and even test harnesses. In many cases

the host may have custom software installed on it that communicates with the device. When “host”

must be used differently, it is qualified as something specific, such as “acquirer host” or “USB host.”

Similarly, the word “user” is used in different ways in different contexts. This document separates users

into more descriptive categories:

 The cardholder

 The operator (such as a cashier, bank teller, customer service representative, or server), and

 The developer or the administrator (such as an integrator configuring the device for the first time).

Because some connection types, payment brands, and other vocabulary name spaces (notably Bluetooth

LE, EMV, smart phones, and more recent versions of Windows) use very specific meanings for the term

“Application,” this document favors the term software to refer to software on the host that provides a user

interface for the operator.

The combination of device(s), host(s), software, firmware, configuration settings, physical mounting and

environment, operator and cardholder experiences, and documentation is referred to as the solution.

2.3 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). The set of available

connection layers depends on the device. Details for communicating with devices via each physical

connection type are provided in section 3 Connection Types.

2.4 About Device Features

The information in this document applies to multiple devices. When developing solutions that use a

specific device or set of devices, integrators must be aware of each device’s communication interfaces,

features, and configuration options, which affect the availability and behavior of some commands. Table

2-1 provides a list of device features that may impact command availability and behavior.

2 - Introduction

DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS)

Page 14 of 247 (D998200136-31)

Table 2-1 - Device Features

Feature

IPAD

DynaPro v1

DynaPro v3

DynaPro Plus

L1

DynaPro Mini

30

-pin

DynaPro Mini

Bluetooth LE

DynaPro Go

PIN Function

General Features

Signature Capture Stylus (“SC-S”)

Y

Opt

N

Signature Capture Finger (“SC-F”)

N

Y

Suppress Signature Capture

N

Y

7

N

EMV Message Control

N

Y

9

N

Suppress Debit or Credit

N

Y

9

N

PIN Language Select

N

Y

N

Y

Re-PIN Support

N

Y

Custom Messages

Y

N

Y

Bitmaps

Y

N

Y

Clear Text User Data

N

Y

N

Y

Host-Supplied PAN

Y

N

Host-Supplied-Non-Session-PAN

N

Y

N

Capacitive Keypad (“Cap

Keypad”)

Y

N

Activation Codes

N

Y

N

Y

Fixed PIN Key

Y

N

PCI 4.x Key Block

N

Y

IntelliHead

Y

N

Financial Format Whitelisting

N

Y

N

Y

Max Financial Card PAN Length

N

18

19

MagneSafe 2.0 (MS2.0)

Y

N

Token Reversal

N

Y

N

Handheld Operation

N

Y

Quick Chip

N

Y

3

Y

3

N

Y

6

Y

Beeper Control

N

Y

Connections and Connection Features

USB Connection

Y

2 - Introduction

DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS)

Page 15 of 247 (D998200136-31)

Feature

IPAD

DynaPro v1

DynaPro v3

DynaPro Plus

L1

DynaPro Mini

30

-pin

DynaPro Mini

Bluetooth LE

DynaPro Go

PIN Function

TCP/IP Over 802.11 Wireless

Connection

N

Y

N

Ethernet Connection

N

Opt

N

Static IP (Ethernet)

N

Y

4

N

Apple 30-Pin Connection

N

Y

N

RS-232 Connection

N

Bluetooth LE Connection

N

Y

N

PCI Bluetooth LE Connection

N

Y

N

SRED Options

SRED

N

Opt

Y

Non-SRED

Y

Opt

N

EMV Features

Chip Card Contact

N

Y

N

Y

Chip Card L1 Mode (“L1”)

N

Y

N

Chip Card L2 Mode (“L2”)

N

Y

N

Y

2

RID CAPK Key Slots

N

8/16

1

8/16

1

N

8

8/16

1

16

Multiple Payment Brand Defaults

N

Y

EMV 4.3E/F/G Kernel

N

Y

N

Y

EMV 4.3H Kernel

N

Y

N

Chip Card Contactless

N

Opt

N

Y

2

MasterCard PayPass

N

Opt

Y

8

N

MasterCard MCL 3.1.x

N

Y

7

N

Y

2

payWave 2.1.3

N

Opt

Y

8

N

payWave 2.2

N

Y

7

N

Y

2

payWave Checksum

N

Y

7

N

Expresspay 3.0

N

Opt

Y

8

N

Expresspay 3.1

N

Y

7

N

Y

2

Expresspay 4.0.2

N

Y

11

N

D-PAS

N

Opt

N

Y

2

2 - Introduction

DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS)

Page 16 of 247 (D998200136-31)

Feature

IPAD

DynaPro v1

DynaPro v3

DynaPro Plus

L1

DynaPro Mini

30

-pin

DynaPro Mini

Bluetooth LE

DynaPro Go

PIN Function

Configurable EMV Support

N

Y

N

Interac Support

N

Y

10

Y

10

N

US Common Debit AID Auto

Select

N

Y

10

Y

10

N

1) The number of CAPK key slots per RID depends on firmware revision number. DynaPro firmware

up to revision D provides 8 key slots; revisions E and newer provide 16. DynaPro v3 provides 16

key slots. DynaPro Mini firmware up to revision C provides 8 key slots; revisions D and newer

provide 16.

2) Feature is not agency-certified.

3) DynaPro v1 firmware revision F and newer; DynaPro v3 firmware revision B and newer.

4) Available with Ethernet module firmware version 30050876-A00 and later.

5) Available on DynaPro v3 with Contactless L1 – EMVCo Ver 2.6

6) Available on DynaPro Mini Bluetooth LE firmware revision E or newer.

7) Available on DynaPro v3 firmware version D or newer.

8) No longer supported on DynaPro v3 firmware version D or newer.

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.

2 - Introduction

DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS)

Page 17 of 247 (D998200136-31)

2.5 About SDKs

MagTek provides convenient SDKs and corresponding documentation for many programming languages

and operating systems. The API libraries included in the SDKs wrap the details of the connection in an

interface that conceptually parallels the device’s internal operation, freeing software developers to focus

on the business logic, without having to deal with the complexities of platform APIs for connecting to the

various available connection types, communicating using the various available protocols, and parsing the

various available data formats.

The SDKs and corresponding documentation include:

 Functions for sending the direct commands described in this manual

 Wrappers for commonly used commands that further simplify development

 Sample source code to demonstrate how to communicate with the device using the direct commands

described in this manual

To download the SDKs and documentation, search www.magtek.com for “SDK” and select the SDK and

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:

Table 2-2 - Available SDKs and Documentation

Platform

SDK

Documentation

Android

99510129

D99875668 IPAD, DynaPro, DynaPro Go, DynaPro Mini Programmer’s

Manual (ANDROID)

Windows

99510127

D99875633 IPAD, DynaPro, DynaPro Go, DynaPro Mini Programmer’s

Manual (JAVA/JAVA APPLETS)

D998200078 IPAD, DynaPro, DynaPro Go, DynaPro Mini Programmer’s

Manual (MICROSOFT .NET)

D998200078 IPAD, DynaPro, DynaPro Go, DynaPro Mini Programmer’s

Manual (C++)

iOS

99510124

D99875654 DynaPro, DynaPro Go, DynaPro Mini Programmer’s Manual

(IOS)

Software developers also have the option to revert to direct communication with the device using libraries

available in the chosen development framework. This document provides information and support for

developing host software using that method.

3 - Connection Types

DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS)

Page 18 of 247 (D998200136-31)

3 Connection Types

Table 2-1 in section 2.4 includes a list of connection types available for each device. The following

subsections provide details developers need to communicate with the device using each connection type.

3.1 How to Use USB Connections (USB Only)

The device conforms to the USB specification revision 2.0, and is compatible with revision 1.1. It also

conforms to the Human Interface Device (HID) class specification version 1.1, and communicates as a

vendor-defined HID device. This document assumes the reader is familiar with USB HID class

specifications, which are available at www.usb.org. MagTek strongly recommends becoming familiar

with that standard before trying to communicate with the device directly via USB.

Developers can easily create custom software to communicate with the device using any framework that

can make API calls to the standard Windows USB HID driver, such as Visual Basic or Visual C++.

MagTek has developed demonstration software that communicates with the device via this method, and

developers can use it to test the device and to provide a starting point for developing other software. For

more information, see the MagTek web site, or contact your reseller or MagTek Support Services.

The devices documented here are full speed high-powered USB device that, if not designed to use an

external power supply, draw power from the 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.

This device has programmable configuration properties stored in non-volatile memory. The properties

are configured via the USB port and can be configured at the factory, at a key injection facility, or by the

end user. More details can be found in section 4 Command Set in this document, and in a separate

document which provides details about key loading.

There are no specific security settings or actions required to use the device’s USB connection in a manner

that is compliant with agency certification security requirements.

3 - Connection Types

DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS)

Page 19 of 247 (D998200136-31)

3.1.1 About Reports

All USB HID devices send and receive data using Reports. Each report can contain several sections,

called Usages, each of which has its own unique four-byte (32-bit) identifier. The two most significant

bytes of a usage are called the usage page, and the two least significant bytes are called the usage ID.

Vendor-defined HID usages must have a usage page in the range 0xFF00 - 0xFFFF, and it is common

practice for related usage IDs share the same usage page. For these reasons, all usages for these devices

use vendor-defined usage page 0xFF20.

HID reports used by the host can be divided into three types:

 Feature Reports are used by the host to send commands to the device and to receive synchronous

responses from the device. Feature reports can be further subdivided into Get Feature and Set

Feature types.

 Input Reports are used by the device to send asynchronous responses or notifications to the host

when a related feature report completes, or automatically the device’s state changes. This is common

when a command depends on cardholder interaction, or when a command takes more time for the

device to process than is reasonable for the host to wait on a blocking call for the device to

acknowledge completion.

 Output Reports. Output reports are part of the HID standard, but are not used by this device.

For information about determining the device’s available reports, see section 3.1.2 About the Report

Descriptor.

For information about using feature reports to send commands to the device and receive responses from

the device, see section 3.1.3 How to Send Commands On the USB Connection.

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.

3 - Connection Types

DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS)

Page 20 of 247 (D998200136-31)

3.1.2 About the Report Descriptor

The list of the device’s available reports and their structure is sent to the host in a report descriptor,

usually just after the device is connected to the USB port. Generally the details of the report descriptor

are abstracted by the developer’s HID API; however, should it become necessary to examine a report

descriptor byte-by-byte, a full inventory of the report descriptor for these devices is provided in Table

3-1, which also indicates whether each report is a Get type or Set type or both. The reports themselves

are fully documented in the sections that follow.

Table 3-1 - USB HID Report Descriptor

Item

Value (Hex)

Usage Page

06 20 FF

Usage

09 01

Collection

A1 01

Report Size (8)

75 08

Logical Minimum (0)

15 00

Logical Maximum (255)

26 FF 00

Report ID (0x01) - Get

85 01

Usage (Response ACK)

09 01

Report Count (4)

95 04

Feature (Data,Var,Abs,NWrp,Lin,Pref,NNul,Nvol,Buf)

B2 02 01

Report ID (0x02) - Set

85 02

Usage (End Session)

09 02

Report Count (1)

95 01

Feature (Data,Var,Abs,NWrp,Lin,Pref,Nnul,Nvol,Buf)

B2 02 01

Report ID (0x03) - Set

85 03

Usage (Request Swipe Card)

09 03

Report Count (3)

95 03

Feature (Data,Var,Abs,NWrp,Lin,Pref,Nnul,Nvol,Buf)

B2 02 01

Report ID (0x04) - Set

85 04

Usage (Request PIN Entry)

09 04

Report Count (5)

95 05

Feature (Data,Var,Abs,NWrp,Lin,Pref,Nnul,Nvol,Buf)

B2 02 01

Report ID (0x05) - Set

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

Page is loading ...

Magtek DynaPro Go Owner's manual

Magtek DynaPro Go Owner's manual

Related papers

Other documents