Magtek Dynamag Programmer's Reference Manual
  1. Manuals
  2. Brands
  3. Magtek Manuals
  4. Card Reader
  5. DYNAMAG
  6. Programmer's reference manual

Magtek Dynamag Programmer's Reference Manual

Wcf, secure card reader authenticator
Hide thumbs Also See for Dynamag:
Table of Contents

Advertisement

Quick Links

Dynamag, DynaMAX, and eDynamo
Secure Card Reader Authenticator
Programmer's Reference (WCF)
November 2015
Manual Part Number:
D9982000105-10
REGISTERED TO ISO 9001:2008
MagTek I 1710 Apollo Court I Seal Beach, CA 90740 I Phone: (562) 546-6400 I Technical Support: (888) 624-8350
www.magtek.com

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the Dynamag and is the answer not in the manual?

Questions and answers

Related Manuals for Magtek Dynamag

Summary of Contents for Magtek Dynamag

  • Page 1 Dynamag, DynaMAX, and eDynamo Secure Card Reader Authenticator Programmer’s Reference (WCF) November 2015 Manual Part Number: D9982000105-10 REGISTERED TO ISO 9001:2008 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 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.

  • Page 3: Software License Agreement

    ATTENTION: CUSTOMER SUPPORT. TERMS, CONDITIONS, AND RESTRICTIONS MagTek, Incorporated (the "Licensor") owns and has the right to distribute the described software and documentation, collectively referred to as the "Software." LICENSE: Licensor grants you (the "Licensee") the right to use the Software in conjunction with MagTek products.
  • Page 4 Agreement and will not affect the enforceability of any of the remaining provisions. This Agreement shall be governed by the laws of the State of California and shall inure to the benefit of MagTek, Incorporated, its successors or assigns.

  • Page 5: Table Of Contents

    3.14 setAcquirerResponse (eDynamo Only) ..............21 3.15 getTransactionProgress ....................21 MTSCRA Library Data Type and Structures ................22 Device Connection State ....................22 CardData ..........................22 Dynamag, DynaMAX, and eDynamo| Secure Card Reader Authenticator | Programmer’s Reference (WCF) Page 5...
  • Page 6 Appendix B Cryptography ......................28 Appendix C Sample Code ......................29 Query devices, openDevice and closeDevice..............29 SendCommand to device and get response..............29 Dynamag, DynaMAX, and eDynamo| Secure Card Reader Authenticator | Programmer’s Reference (WCF) Page 6...

  • Page 7: 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: ...

  • Page 8: System Requirements

    Windows 7, Windows 8, 8.1 & Windows 10 Windows 8, 8.1 & 10 eDynamo Windows 7, Windows 8, 8.1 & Windows 10 Windows 8, 8.1 & 10 Dynamag, DynaMAX, and eDynamo| Secure Card Reader Authenticator | Programmer’s Reference (WCF) Page 8...

  • Page 9: How To Set Up The Magtek Scra Libraries

    1) Download the Dynamag, DynaMAX, and eDynamo Secure Card Reader Authenticator Windows API Install, available from MagTek.com (Support > Software > Programming Tools > Dynamag, DynaMAX, and eDynamo Secure Card Reader Authenticator Windows API> Dynamag, DynaMAX, and eDynamo SCRA Windows API)
  • Page 10 2 - How to Set Up the MagTek SCRA Libraries 3) Input the base address to reference the WCF service, then click OK. Dynamag, DynaMAX, and eDynamo| Secure Card Reader Authenticator | Programmer’s Reference (WCF) Page 10...

  • Page 11: Connect Ajax Service In Web

    How to Connect DynaMAX or eDynamo to a Windows Host via BLE To connect DynaMAX or eDynamo to a host with Windows 8.1 or higher and Bluetooth 4.0 hardware that supports BLE, follow these steps: Dynamag, DynaMAX, and eDynamo| Secure Card Reader Authenticator | Programmer’s Reference (WCF) Page 11...
  • Page 12 Enter desktop mode by swiping in from the left side of the touchscreen. b) Touch the Bluetooth icon in the system tray and select (see Figure Add a Bluetooth Device 2-1). Dynamag, DynaMAX, and eDynamo| Secure Card Reader Authenticator | Programmer’s Reference (WCF) Page 12...
  • Page 13 11) Select the device and press the Pair button. If the device is configured to run in KB mode, Windows will prompt you Enter the passcode for your keyboard Dynamag, DynaMAX, and eDynamo| Secure Card Reader Authenticator | Programmer’s Reference (WCF) Page 13...
  • Page 14 After a short period of time, you will see the text below the device you are pairing with. Connected After a few seconds the device will disconnect, which is normal power-saving behavior. Dynamag, DynaMAX, and eDynamo| Secure Card Reader Authenticator | Programmer’s Reference (WCF) Page 14...
  • Page 15 15) Remember to change the default password. See the DynaMAX Programmer’s Reference documents for details. To unpair from the device: 1) Locate the device in the window. Manage Bluetooth devices Press the Remove device button. Dynamag, DynaMAX, and eDynamo| Secure Card Reader Authenticator | Programmer’s Reference (WCF) Page 15...

  • Page 16: Mtscra Library Functions

    3 - MTSCRA Library Functions MTSCRA Library Functions MagTek SCRA WCF Library can be hosted by service, IIS or any other application and it also can be referenced just like a normal .Net dll. getDeviceList This function enumerate devices and return device URIs.

  • Page 17: Isdeviceconnected

    Reference to V5 command for detail. Return Value: Hex string of device raw response for this command. getCardData Retrieves last swipe card data. string getCardData(); Return Value: Dynamag, DynaMAX, and eDynamo| Secure Card Reader Authenticator | Programmer’s Reference (WCF) Page 17...

  • Page 18: Getresultcode

    (causes “decline” to be generated internally if ARQC is generated) amount Amount Authorized (EMV Tag 9F02, format n12, 6 bytes) For example: [0,0,0,0,0x10,0], means 10.00 dollars. Dynamag, DynaMAX, and eDynamo| Secure Card Reader Authenticator | Programmer’s Reference (WCF) Page 18...

  • Page 19: Canceltransaction (Edynamo Only)

    This function sets the user selection result. It should be called after receiving the OnUserSelect event which is triggered after the user makes a choice. byte[] setUserSelectionResult( byte status, byte selection Dynamag, DynaMAX, and eDynamo| Secure Card Reader Authenticator | Programmer’s Reference (WCF) Page 19...
  • Page 20 Indicates the menu item selected by the user. This is a single byte zero based binary value. Return Value: This function will always returns null. To get the result code of this command, use getResultCode() function. Dynamag, DynaMAX, and eDynamo| Secure Card Reader Authenticator | Programmer’s Reference (WCF) Page 20...

  • Page 21: Setacquirerresponse (Edynamo Only)

    JSON string for progress. It contains two properties – type (integer) which references the event type and data (data attach to this event type). Reference Data Type and Structure for detail. Dynamag, DynaMAX, and eDynamo| Secure Card Reader Authenticator | Programmer’s Reference (WCF) Page 21...

  • Page 22: Mtscra Library Data Type And Structures

    4124540bab017a6ce65dcfeada5774f8|100"} Transaction Status getTransactionProgress will return the transaction status after device has status changed. type : 768 (0x300) data : Hex string for 5 bytes Dynamag, DynaMAX, and eDynamo| Secure Card Reader Authenticator | Programmer’s Reference (WCF) Page 22...
  • Page 23 0x10 – waiting online processing response  0x11 – transaction completion  0x12 – transaction error  0x13 – transaction approved  0x14 – transaction declined Final Status Example : Dynamag, DynaMAX, and eDynamo| Secure Card Reader Authenticator | Programmer’s Reference (WCF) Page 23...

  • Page 24: Display Message Request

    The minimum value of the Selection Result should be 1 (the first item, #0, was a title line only). The maximum value of the Selection Result is based on the number of items displayed. {"type":770,"data":"011E53656C656374206C616E67756167653A00656E00646500 "} Select language: Dynamag, DynaMAX, and eDynamo| Secure Card Reader Authenticator | Programmer’s Reference (WCF) Page 24...

  • Page 25: Arqc

    Length ARQC message that follows. Batch Data See Appendix C. It is expected that the host will save this data as a record of the transaction. Dynamag, DynaMAX, and eDynamo| Secure Card Reader Authenticator | Programmer’s Reference (WCF) Page 25...
  • Page 26 4 - MTSCRA Library Data Type and Structures {"type":772,"data":"010214FE820210DFDF250F4233303646393630393238313541 41FA8201F9F08201F5F182000FDFDF1A0100DFDF1B0100DFDF520105F28200E39A0300 00009F02060000000009999F10120110600001220000000000000000000000FF9F1607 303030303030309F4E0730303030303030820258008E10000000000000000042015E03 42031F035F24031401315F25031201019F0607A00000000410109F0702FF009F0D05F0 500408009F0E0500008800009F0F05F0700498009F2608C4751D62AEA184A59F270140 9F360200C59C01009F33032028C89F34035E03009F37049FA41BDA9F3901059F400572 0000B001950542200080009B02E8009F1E0842333036463936209F1A0208405F2A0208 409F01060000000000018A023030F782007B5F25031201015F24031401315F2A020840 9F02060000000009999F03060000000000009F0607A00000000410109F1C0831313232 333334349F3901059C01009F34035E03005F2009544553542F43415244DFDF4D263B35 3431333030303034303030313531333D30313134303030303030303030303030303030 3FF8820078DFDF560A9010010B306F9600001BDFDF570100FA820061DF31182E6ECDA6 0D8CB9D382EE13942C18B6DF82EE13942C18B6DFDF321040A47A243903C9DA71DBF069 963D1D64DF3B30E5B2E54BF31D8DC0BA5C217F756F0CC3D24553AE6B25BD4FFA7C8D98 243DC66D8C43FEA072300044F6278B858108B825"} Dynamag, DynaMAX, and eDynamo| Secure Card Reader Authenticator | Programmer’s Reference (WCF) Page 26...

  • Page 27: Appendix Atlv Data Format

    This section gives the format of the data the device uses to do completion processing FE<len> /* container for generic data */ DFDF25(IFD Serial Number)<len><val> FA<len>/* container for generic data */ F0<len> /* Transaction Results */ Dynamag, DynaMAX, and eDynamo| Secure Card Reader Authenticator | Programmer’s Reference (WCF) Page 27...

  • Page 28: Appendix B Cryptography

    DF38(Encrypted Tag 9F62 TLV, T1,PCVC3)<len><val> DF39(Encrypted Tag DF812A TLV, T1 DD)<len><val> DF3A(Encrypted Tag DF812B TLV), T2 DD<len><val> DF3B(Encrypted Tag DFDF4A TLV, T2 ISO Format)<len><val> Appendix B Cryptography Dynamag, DynaMAX, and eDynamo| Secure Card Reader Authenticator | Programmer’s Reference (WCF) Page 28...

  • Page 29: Appendix C Sample Code

    This example shows how to use the SendCommand function to send command to device and get device response. var response = wcf.sendCommand("0001"); Console.WriteLine(response); Output in Console : Dynamag, DynaMAX, and eDynamo| Secure Card Reader Authenticator | Programmer’s Reference (WCF) Page 29...

This manual is also suitable for:

DynamaxEdynamo

Table of Contents