background image

1 - Introduction  

Dynamag, DynaMAX, and eDynamo| Secure Card Reader Authenticator | Programmer’s Reference (WCF) 

 
Page 7 

1

 

Introduction 

This document provides instructions for software developers who want to create software solutions that 
include a Dynamag, DynaMAX, or eDynamo connected to a Windows-based host via USB or BLE.  It is 
part of a larger library of documents designed to assist Dynamag, DynaMAX, and eDynamo 
implementers, which includes the following documents available from MagTek: 

 

D99875724 Dynamag, DynaMAX, and eDynamo Programmer's Reference (Java and Java 
Applet) 

 

D99875725 Dynamag, DynaMAX, and eDynamo Programmer's Reference (C++) 

 

D99875475 MagneSafe V5 Communication Reference Manual 

1.1

 

About the MagTek SCRA WCF Demo 

The MTSCRA WCF Demo, available from MagTek, provides demonstration source code and reusable 
MTSCRAWCF DLLs that provide developers of custom software solutions with an easy-to-use interface 
for Dynamag, DynaMAX, and eDynamo.  Developers can include the MTSCRAWCF DLLs in custom 
branded software which can be distributed to customers or distributed internally as part of an enterprise 
solution. 

1.2

 

Nomenclature 

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 it does in the context of networked financial transaction processing.  In this 
document, “device” and “host” are used strictly as follows: 
 

 

Device

 refers to the MSR device (eg. DynaMAX) that receives and responds to the command set 

specified in this document. 

 

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 “USB host.” 

 
The word “user” is also often used in different ways in different contexts.  In this document, user 
generally refers to the cardholder. 

1.3

 

SDK Contents 

File 

Description 

WCF\MTDevice.DLL 

MagTek SCRA Device constance library 

WCF\MTLIB.DLL 

MagTek SCRA interface library 

WCF\MTSCRANET.DLL 

MagTek SCRA library for .Net 

WCF\MTSCRAWCF.DLL 

MagTek SCRA library for WCF 

WCF\MTServiceNet.DLL 

MagTek SCRA connection service library for .Net 

 
 

 

Содержание DYNAMAG

Страница 1: ...A 90740 I Phone 562 546 6400 I Technical Support 888 624 8350 www magtek com Dynamag DynaMAX and eDynamo Secure Card Reader Authenticator Programmer s Reference WCF November 2015 Manual Part Number D9...

Страница 2: ...e 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 per...

Страница 3: ...reement 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 Sof...

Страница 4: ...all inure 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...

Страница 5: ...Demo 9 2 2 1 Connect web service in C Project 9 2 2 2 Connect ajax service in web page javascript 11 2 3 How to Connect DynaMAX or eDynamo to a Windows Host via BLE 11 3 MTSCRA Library Functions 16 3...

Страница 6: ...4 4 5 User Selection Request 24 4 6 ARQC 25 4 7 Transaction Result 25 Appendix A TLV Data Format 27 A 1 ARQC Message Format 27 A 2 ARQC Response from online processing 27 A 3 Transaction Result Messag...

Страница 7: ...l 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 tha...

Страница 8: ...ework 4 5 installed Tested development environments Windows 8 1 with Microsoft Visual Studio 2013 1 5 Interfaces for Operating Systems The following table matches the device interface to operating sys...

Страница 9: ...bit machine launch Visual Studio 2013 and open C Program Files x86 MagTek SCRA Windows SDK Sample Code CPP Source VCDemo vcxproj 2 For 32 bit machine launch Visual Studio 2013 and open C Program File...

Страница 10: ...ow to Set Up the MagTek SCRA Libraries Dynamag DynaMAX and eDynamo Secure Card Reader Authenticator Programmer s Reference WCF Page 10 3 Input the base address to reference the WCF service then click...

Страница 11: ...sert ScriptManager object asp ScriptManager ID ScriptManager1 runat server asp ScriptManager This step will enable the microsoftajax js module 4 Insert javascript referent to WCF script src http local...

Страница 12: ...ynaMAX s batteries are installed and have adequate charge If using eDynamo make sure the device has an adequate charge 4 Test the batteries by powering on the DynaMAX or eDynamo device Provided the de...

Страница 13: ...ttom of the device Note the final four digits 10 Read through the list of pairable devices and locate the device called DynaMAX nnnn or eDynamo nnnn where nnnn is the last four digits of the device s...

Страница 14: ...asscode 000000 or the device s actual password if it has been configured differently then press the Next button Windows will return you to the Manage Bluetooth devices page After a short period of tim...

Страница 15: ...ext editor 14 The device consumes very little power when not transmitting card data so it is not necessary to power off the device to conserve power If the device appears as Not connected in the Windo...

Страница 16: ...elimited by If input is empty string or null means search all types Return Value A string with Devices URIs delimited by 3 2 getSDKVersion Retrieves SDK version string getSDKVersion Return Value The v...

Страница 17: ...mmand to device and returns the raw response from device string sendCommand string Command Parameter Description Command Hex string for command It does not include the length of command data Reference...

Страница 18: ...ard choose a language choose an application and online processing If this time is exceeded the transaction will be aborted and an appropriate Transaction Status will be available Value 0 is not allowe...

Страница 19: ...ro mode This single byte field indicates the level of Transaction Status notifications the host desires to receive during the course of this transaction 0x00 Termination Status only normal termination...

Страница 20: ...lection 0x00 User Selection Request completed see Selection Result 0x01 User Selection Request aborted cancelled by user 0x02 User Selection Request aborted timeout selection Indicates the menu item s...

Страница 21: ...onse data First two bytes indicate message length following TLV response message Reference to A 2 ARQC Response Return Value This function will always returns null To get the result code of this comma...

Страница 22: ...1d8 33e10070ba62f8d274fe55abee8855971364f716f4fa7d6fae47d078c7c98e7a220b84 4b127cc769344dc76bc14e3cf1638da8c4428daff38163b429037e8f80bc099e123f42 8fc06fb47743f8eeb633ba523a07 B9812000080006827 LAST FI...

Страница 23: ...t complete within this time it will be aborted 2 Current Transaction Progress Indicator This one byte field indicates the current processing stage for the transaction 0x00 No transaction in progress 0...

Страница 24: ...selection request this is 0x00 Application Selection 0x01 Language Selection Others TBD 1 Timeout Specifies the maximum time in seconds allowed to complete the selection process If this time is exceed...

Страница 25: ...5720000B001950542200080009B02E8009F1E0842333036463936209F1A 0208405F2A0208409F01060000000000019F2103183917DFDF4D263B35343133303030 3034303030313531333D303131343030303030303030303030303030303FDFDF52010...

Страница 26: ...700498009F2608C4751D62AEA184A59F270140 9F360200C59C01009F33032028C89F34035E03009F37049FA41BDA9F3901059F400572 0000B001950542200080009B02E8009F1E0842333036463936209F1A0208405F2A0208 409F010600000000000...

Страница 27: ...d Tag 9F1F TLV T1 DD len val DF36 Encrypted Tag 9F20 TLV T2 DD len val DF37 Encrypted Tag 9F61 TLV T2 CVC3 len val DF38 Encrypted Tag 9F62 TLV T1 PCVC3 len val DF39 Encrypted Tag DF812A TLV T1 DD len...

Страница 28: ...chant Data tags F8 len container tag for encrypted data DFDF56 Encrypted Transaction Data KSN len val DFDF57 Encrypted Transaction Data Encryption Type val FA len container for generic data DF30 Encry...

Страница 29: ...List wcf getDeviceList Console WriteLine devList var devs devList Split foreach var dev in devs Console WriteLine dev var open wcf openDevice devs 0 Console WriteLine open devs 0 open if open 0 wcf cl...

Отзывы: