Magtek DYNAPRO, Programmer'S Manual

Page 1: ...Beach CA 90740 I Phone 562 546 6400 I Technical Support 888 624 8350 www magtek com SDK MagneFlex Powder MIddleware PIN PEDs Programmer s Manual MagneFlex API February 2021 Manual Part Number D9982001...

Page 2: ...Microsoft Corporation All other system names and product names are the property of their respective owners Table 0 1 Revisions Rev Number Date Notes 10 03 02 2016 Initial Release 20 03 22 2016 Renamed...

Page 3: ...t are automatically terminated COPYRIGHT The Software is copyrighted Licensee may not copy the Software except for archival purposes or to load for execution purposes All other copies of the Software...

Page 4: ...ure to the benefit of MagTek Incorporated its successors or assigns ACKNOWLEDGMENT LICENSEE ACKNOWLEDGES THAT HE HAS READ THIS AGREEMENT UNDERSTANDS ALL OF ITS TERMS CONDITIONS AND RESTRICTIONS AND AG...

Page 5: ...ect DynaPro Mini to a Windows Host via BLE 10 3 MagneFlex Powder Resources 14 3 1 CheckHealth 14 3 2 RequestCardSwipe 14 3 3 RequestEMVTags 15 3 4 RequestManualSwipe 17 3 5 RequestPIN 19 3 6 RequestSi...

Page 6: ...neFlex Powder MIddleware PIN PEDs Programmer s Manual MagneFlex API Page 6 Appendix A TLV Data Format 37 A 1 ARQC Message Format 37 A 2 ARQC Response from online processing 37 A 3 Transaction Result M...

Page 7: ...fers to the piece of general purpose electronic computing equipment the device is connected or paired to which can send data to and receive data from the device It also hosts the MagneFlex Powder The...

Page 8: ...I HostService exe MagTek WEBAPI Windows service configuration files DLLs File Description MTDevice DLL MagTek PPSCRA Device constance library MTLIB DLL MagTek PPSCRA interface library MTPPSCRANET DLL...

Page 9: ...environments Windows 8 1 with Microsoft Visual Studio 2013 1 5 Interfaces for Operating Systems The following table matches the device interface to operating system Device Interface Operating System D...

Page 10: ...uired drivers and connect it to the host 2 On the host install and configure the software you intend to use with DynaPro Mini a Make sure the host software is configured to look for the device on the...

Page 11: ...ate the serial number on the label on the bottom of the device Note the final four digits 10 Read through the list of pairable devices and locate the device called DynaProMini nnnn where nnnn is the l...

Page 12: ...a few seconds the device will disconnect which is normal power saving behavior 13 Use the host software to test swiping a card If you do not yet have host software and the device is configured to run...

Page 13: ...PEDs Programmer s Manual MagneFlex API Page 13 15 Remember to change the default password See the DynaPro Mini Programmer s Reference documents for details To unpair from the device 1 Locate the devi...

Page 14: ...T api mtppscrahost RequestCardSwipe string DeviceID int WaitTime int DisplayMessage int Tones string FieldSeparator boolean CloseDevice boolean EndSession Parameter Description DeviceID URI of the dev...

Page 15: ...losed after the request is processed Default value is false false Do no close the device true Close device EndSession Flag which determines whether an EndSession command is sent to the device after th...

Page 16: ...TLS99261829170E0810 For BLE devices use the form BLEEMV DEVICENAME Example BLEEMV DPG123456789A DEVICENAME is listed in the operating system Bluetooth settings WaitTime Time in seconds the device wil...

Page 17: ...g an EMV tag GET for getting an EMV tag CloseDevice Flag which determines whether the connection to the device will be closed after the request is processed Default value is false false Do no close th...

Page 18: ...R Example TLS12 TLS99261829170E0810 TLS12TRUST TLS99261829170E0810 For BLE devices use the form BLEEMV DEVICENAME Example BLEEMV DPG123456789A DEVICENAME is listed in the operating system Bluetooth se...

Page 19: ...e request is processed Default value is false When set to false this flag may facilitate the display of a custom message after a request is processed false Do no end the session true End the session R...

Page 20: ...1829170E0810 For BLE devices use the form BLEEMV DEVICENAME Example BLEEMV DPG123456789A DEVICENAME is listed in the operating system Bluetooth settings WaitTime Time in seconds the device will wait f...

Page 21: ...ag which determines whether an EndSession command is sent to the device after the request is processed Default value is false When set to false this flag may facilitate the display of a custom message...

Page 22: ...ng system Bluetooth settings WaitTime Time in seconds the device will wait for the action to be completed 1 255 Options Option to select the timeout behavior 0 Timeout will clear data 1 Timeout with a...

Page 23: ...lRequestData boolean CloseDevice boolean EndSession Parameter Description DeviceID URI of the device For USB devices Use an empty string to open the first device found Otherwise use USB DEVICESERIALNU...

Page 24: ...ction options 0 Normal 1 Bypass PIN 2 Force Online 4 Acquirer not available TransactionType Type of transaction to be used 0x02 Cash back 0x04 Goods 0x08 Services Amount The amount to be used and auth...

Page 25: ...ssage after a request is processed false Do no end the session true End the session Return Value The Transaction output TransactionOutput 3 8 RequestSendAcquirerResponse Sends the ARPC to the device U...

Page 26: ...WaitTime Time in seconds the device will wait for the action to be completed 1 255 WaitTimeBeforeTransactionComplete Time in seconds to wait after receiving the transaction response before the transac...

Page 27: ...Default value is false When set to false this flag may facilitate the display of a custom message after a request is processed false Do no end the session true End the session Return Value The Transa...

Page 28: ...in the operating system Bluetooth settings WaitTime Time in seconds the device will wait for the action to be completed 1 255 Data Hex string for command Reference device manual for details RequestTyp...

Page 29: ...ag may facilitate the display of a custom message after a request is processed false Do no end the session true End the session Return Value The Data output in Hex string format of device raw response...

Page 30: ...E1BF5C3465D21 EncryptedTrack1 C5389DFDB735F9D9EF628E0FDC446FB9CCBEBE959DECD22655737B41CD249D6C67244 6BF77A3738D09FBF8DD55A61906CB50C697994344DDFE657C3F8ED287BD4141788C400 BAEFBA0E52BE1498AE186 Encrypt...

Page 31: ...s 0 EncTrack3Length 112 E ncTrack3 12BA7B8F7386EB4ED1EAD4467E621E26F727B4225A3C8F73351BEF09B1ED7 4971CE9A1B4F84A1440109735A65864FAA2384D29912454DE6B37485C4060D8809AD7A 00C24F2D78A340CEBDD00CE0AF419BAC...

Page 32: ...1Length 57 Track1 M1111000004000001111 MANUAL ENTRY 22220000000000000000 Track2Status 0 Track2Length 39 Track2 11 11000004000001111 22220000000000000 Track3Status 1 Track3Length 0 Tra ck3 EncTrack1Sta...

Page 33: ...DxIO0k6SjhLO Es3TDdMNk01TjROM04yTjNNM0w0SzVKNko3SThIOUg6RztGPEU REBDQUJDQkRARz9JPks 8TjxPO1E6UTlSOVP 0Y1RjZGN0c3RzhHOUc6SDtIPEg9ST5JQElBSkNLRUtGTEhMSk5NT k9QUlBTUldTWFNZVFtVXVZeV19YX1hg 9PTk5OTk1NTUxM...

Page 34: ...AF5FBF21D6E3C65C77233CA7F7C 7A250C2E289597F9FFD224854F0DFDF560A9500030000000120071BDFDF570180DFDF5 801060000F3E97338 BatchData null RawARQCData AaT5ggGg399UCpUAAwAAAAEgBxvf31UBgt fJQiY2QxmDgcPDvqCAX1w...

Page 35: ...D78EFC6A31A92A76AE4AE1405 A5E85EC1C0FBC9112791CCA7CC5C51478E76C4A7FEDC1FE48D406DB44114A780ACB086 259A5F409BCA61CF06419E7AAD9C3DFDF560A9500030000000120071BDFDF570180DFD F580100F78200A7DFDF4001015F25030...

Page 36: ...Data 01000E000000000000000000000000000000000000000000000000000000000000000 00000000000000000000000000000000000000000000000000000000000 AdditionalOutputData null Example of a GET to DynaPro 0E is a Get...

Page 37: ...a val Decrypt data to read tags DFDF56 Encrypted Transaction Data KSN len val DFDF57 Encrypted Transaction Data Encryption Type val DFDF58 of bytes of padding in DFDF59 len val Buffer if any to be a m...

Page 38: ...sal Data if any Reversal Data tags defined in DFDF05 Note Sensitive Data cannot be defined in DFDF05 F7 len container for Merchant Data Merchant Data tags F8 len container tag for encrypted data DFDF5...