Magtek aDynamo Manual
  1. Manuals
  2. Brands
  3. Magtek Manuals
  4. Card Reader
  5. ADYNAMO
  6. Manual

Magtek aDynamo Manual

Secure card reader authenticator .net/pcl programmer's reference (windows/windows phone)
Hide thumbs Also See for aDynamo:
Table of Contents

Advertisement

Quick Links

Download this manual
aDynamo, uDynamo, Dynamag,
DynaMAX, eDynamo, BulleT,
mDynamo
Secure Card Reader Authenticator
.NET/PCL Programmer's Reference (Windows/Windows Phone)
October 2016
Manual Part Number:
D99875723-50
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 aDynamo and is the answer not in the manual?

Questions and answers

Related Manuals for Magtek aDynamo

Summary of Contents for Magtek aDynamo

  • Page 1 Secure Card Reader Authenticator .NET/PCL Programmer’s Reference (Windows/Windows Phone) October 2016 Manual Part Number: D99875723-50 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

    How to Set Up Headset Interface on Windows Phone ..........12 How to Set Up the MagTek SCRA SDK for .NET Projects ..........12 How to Set Up the MagTek SCRA SDK for Universal App and Windows Store App Projects ............................12 MTSCRA Class Methods ......................
  • Page 6 3.54 startTransaction (EMV Device Only) ................30 3.55 setUserSelectionResult (EMV Device Only) ............... 31 3.56 setAcquirerResponse (EMV Device Only) ..............31 aDynamo, uDynamo, Dynamag, DynaMAX, eDynamo, BulleT, mDynamo| Secure Card Reader Authenticator | .NET/PCL Programmer’s Reference (Windows/Windows Phone) Page 6...
  • Page 7 Appendix C ARQC Response Message Format ..............42 Appendix D Batch Data Format ....................43 DFDF1A Transaction Status Return Codes ..............43 aDynamo, uDynamo, Dynamag, DynaMAX, eDynamo, BulleT, mDynamo| Secure Card Reader Authenticator | .NET/PCL Programmer’s Reference (Windows/Windows Phone) Page 7...

  • Page 8: Introduction

    Windows tablet device or Windows Phone mobile device. About MTSCRA Library Custom Windows software installed on a host PC can communicate with MagTek SCRA devices via the Audio/Headset Interface, Bluetooth, BLE (Bluetooth 4.0 Low Energy), or USB using the MTSCRA library.

  • Page 9: How To Set Up

    How to Set Up How to Set Up Headset Interface on Windows PC on Windows PC To set up the headset interface on Windows PC to communicate with the MagTek SCRA device, follow these steps: 1) Connect the device to the headset jack of the Windows PC.
  • Page 10 2 - How to Set Up Figure 2-1 Device Volume Level Set to 100 Figure 2-2 Microphone Boost Turned Off aDynamo, uDynamo, Dynamag, DynaMAX, eDynamo, BulleT, mDynamo| Secure Card Reader Authenticator | .NET/PCL Programmer’s Reference (Windows/Windows Phone) Page 10...
  • Page 11 2 - How to Set Up Figure 2-3 Enhancements Turned Off Figure 2-4 Effects Turned Off aDynamo, uDynamo, Dynamag, DynaMAX, eDynamo, BulleT, mDynamo| Secure Card Reader Authenticator | .NET/PCL Programmer’s Reference (Windows/Windows Phone) Page 11...

  • Page 12: How To Set Up Headset Interface On Windows Phone

    Phone. How to Set Up the MagTek SCRA SDK for .NET Projects To add the MagTek SCRA libraries to a .NET project in Microsoft Visual Studio, follow these steps: 1) Create or open your .NET project in Visual Studio. 2) Copy the following DLL files from the MTNETDemo folders to the library folder of your software project: ...
  • Page 13 7) Begin using the features provided by the MagTekSCRA library. Details about each methods are provided in section 9 MTSCRA Class Methods. aDynamo, uDynamo, Dynamag, DynaMAX, eDynamo, BulleT, mDynamo| Secure Card Reader Authenticator | .NET/PCL Programmer’s Reference (Windows/Windows Phone) Page 13...

  • Page 14: Mtscra Class Methods

    The following table shows the connection types supported by the various programming interfaces: Connection Type / Audio BLEEMV Bluetooth Programming Interface .NET Framework Portable Class Library (PCL) aDynamo, uDynamo, Dynamag, DynaMAX, eDynamo, BulleT, mDynamo| Secure Card Reader Authenticator | .NET/PCL Programmer’s Reference (Windows/Windows Phone) Page 14...

  • Page 15: Setaddress

    String value of the device ID. Return Value: None openDevice This method opens connection to the device. public void openDevice() aDynamo, uDynamo, Dynamag, DynaMAX, eDynamo, BulleT, mDynamo| Secure Card Reader Authenticator | .NET/PCL Programmer’s Reference (Windows/Windows Phone) Page 15...

  • Page 16: Closedevice

    Each of these properties allows the application to specify masking details for the Primary Account Number and Driver’s License / ID Number (DL/ID#), the masking character to be used, and whether a aDynamo, uDynamo, Dynamag, DynaMAX, eDynamo, BulleT, mDynamo| Secure Card Reader Authenticator | .NET/PCL Programmer’s Reference (Windows/Windows Phone)

  • Page 17: Gettrack1

    Parameters: None Return Value: Return stored masked track1 data string. For an ISO/ABA card, the PAN is masked as follows: aDynamo, uDynamo, Dynamag, DynaMAX, eDynamo, BulleT, mDynamo| Secure Card Reader Authenticator | .NET/PCL Programmer’s Reference (Windows/Windows Phone) Page 17...

  • Page 18: Gettrack2Masked

    All other characters are set to the specified mask character. 3.15 getTrack3Masked Get stored masked track3 data. public string getTrack3Masked() Parameters: None aDynamo, uDynamo, Dynamag, DynaMAX, eDynamo, BulleT, mDynamo| Secure Card Reader Authenticator | .NET/PCL Programmer’s Reference (Windows/Windows Phone) Page 18...

  • Page 19: Getmagneprint

    Return the MagnePrint data. 3.17 getMagnePrintStatus Supported on uDynamo only. public string getMagnePrintStatus() Parameters: None Return Value: Returns the MagnePrint status. aDynamo, uDynamo, Dynamag, DynaMAX, eDynamo, BulleT, mDynamo| Secure Card Reader Authenticator | .NET/PCL Programmer’s Reference (Windows/Windows Phone) Page 19...

  • Page 20: Getdeviceserial

    This field is stored in non-volatile memory, so it will persist when the unit is power cycled. public string getDeviceSerial() Parameters: None aDynamo, uDynamo, Dynamag, DynaMAX, eDynamo, BulleT, mDynamo| Secure Card Reader Authenticator | .NET/PCL Programmer’s Reference (Windows/Windows Phone) Page 20...

  • Page 21: Getsessionid

    Return device model name. 3.22 clearBuffers Clears buffered data retrieved from the reader. public void clearBuffers() Parameters: None Return Value: None aDynamo, uDynamo, Dynamag, DynaMAX, eDynamo, BulleT, mDynamo| Secure Card Reader Authenticator | .NET/PCL Programmer’s Reference (Windows/Windows Phone) Page 21...

  • Page 22: Getbatterylevel

    1 = Same as MagStripe (8122), other values TBD. If absent, default value is 1. 3.27 getCapMagneSafe20Encryption Retrieves MagneSafe 2.0 Encryption Capabilities. aDynamo, uDynamo, Dynamag, DynaMAX, eDynamo, BulleT, mDynamo| Secure Card Reader Authenticator | .NET/PCL Programmer’s Reference (Windows/Windows Phone) Page 22...

  • Page 23: Getcapmagstripeencryption

    Bit 2 = 1 / Track 3 supported,  All other bits = 0. 3.31 getCardDataCRC Retrieves CRC from card data. public long getCardDataCRC() Parameters: None aDynamo, uDynamo, Dynamag, DynaMAX, eDynamo, BulleT, mDynamo| Secure Card Reader Authenticator | .NET/PCL Programmer’s Reference (Windows/Windows Phone) Page 23...

  • Page 24: Getcardexpdate

    Parameters: None Return Value: String representing card name 3.36 getCardPAN Retrieves PAN from card data. public string getCardPAN() Parameters: None aDynamo, uDynamo, Dynamag, DynaMAX, eDynamo, BulleT, mDynamo| Secure Card Reader Authenticator | .NET/PCL Programmer’s Reference (Windows/Windows Phone) Page 24...

  • Page 25: Getcardpanlength

    Retrieves the card encode type. public string getCardEncodeType() Parameters: None Return Value: String representing the card encode type Card Encode Type aDynamo, uDynamo, Dynamag, DynaMAX, eDynamo, BulleT, mDynamo| Secure Card Reader Authenticator | .NET/PCL Programmer’s Reference (Windows/Windows Phone) Page 25...

  • Page 26: Getdatafieldcount

    Parameters: None Return Value: String representing SHA-x hash code 3.43 getDeviceConfig Retrieves device configuration. public string getDeviceConfig(string configType) aDynamo, uDynamo, Dynamag, DynaMAX, eDynamo, BulleT, mDynamo| Secure Card Reader Authenticator | .NET/PCL Programmer’s Reference (Windows/Windows Phone) Page 26...

  • Page 27: Getencryptionstatus

    Bit 11 = DUKPT Key Variant used to encrypt data, 0=PIN Variant, 1=Data Variant/Bidirectional  Bits 12–15 = Unassigned (always set to Zero) 3.45 getFirmware Retrieves firmware version. public string getFirmware() aDynamo, uDynamo, Dynamag, DynaMAX, eDynamo, BulleT, mDynamo| Secure Card Reader Authenticator | .NET/PCL Programmer’s Reference (Windows/Windows Phone) Page 27...

  • Page 28: Getmagtekdeviceserial

    Parameters: None Tag to search for data Data to search from Return Value: String representing tag value 3.50 getTLVVersion Retrieves TLV version. aDynamo, uDynamo, Dynamag, DynaMAX, eDynamo, BulleT, mDynamo| Secure Card Reader Authenticator | .NET/PCL Programmer’s Reference (Windows/Windows Phone) Page 28...

  • Page 29: Gettrackdecodestatus

    Parameters: Parameter Description command Command string to send to the device. Return Value:  0 = Success  9 = Error aDynamo, uDynamo, Dynamag, DynaMAX, eDynamo, BulleT, mDynamo| Secure Card Reader Authenticator | .NET/PCL Programmer’s Reference (Windows/Windows Phone) Page 29...

  • Page 30: Starttransaction (Emv Device Only)

    Cash back Amount (if non-zero, EMV Tag 9F03, format n12, 6 bytes) in hex string. For example: “000000001000”, means 10.00 dollars. aDynamo, uDynamo, Dynamag, DynaMAX, eDynamo, BulleT, mDynamo| Secure Card Reader Authenticator | .NET/PCL Programmer’s Reference (Windows/Windows Phone) Page 30...

  • Page 31: Setuserselectionresult (Emv Device Only)

    3.56 setAcquirerResponse (EMV Device Only) This function informs EMV device to process transaction decision from acquirer. public int setAcquirerResponse(byte[] response) Parameters: aDynamo, uDynamo, Dynamag, DynaMAX, eDynamo, BulleT, mDynamo| Secure Card Reader Authenticator | .NET/PCL Programmer’s Reference (Windows/Windows Phone) Page 31...

  • Page 32: Canceltransaction (Emv Device Only)

    The next two bytes (most significant byte first) indicate the total length of the following data in bytes. Return Value:  0 = Success  9 = Error  15 = Busy aDynamo, uDynamo, Dynamag, DynaMAX, eDynamo, BulleT, mDynamo| Secure Card Reader Authenticator | .NET/PCL Programmer’s Reference (Windows/Windows Phone) Page 32...

  • Page 33: Mtscra Events

    This event occurs when the state of the card information is changed. public event CardDataStateHandler OnCardDataState public delegate void CardDataStateHandler(object sender, MTCardDataState state) aDynamo, uDynamo, Dynamag, DynaMAX, eDynamo, BulleT, mDynamo| Secure Card Reader Authenticator | .NET/PCL Programmer’s Reference (Windows/Windows Phone) Page 33...

  • Page 34: Ondatareceived

    Object representing the publisher of the event data Byte array containing the data received from the device. See table below for descriptions of the data. aDynamo, uDynamo, Dynamag, DynaMAX, eDynamo, BulleT, mDynamo| Secure Card Reader Authenticator | .NET/PCL Programmer’s Reference (Windows/Windows Phone) Page 34...
  • Page 35 0x11 – transaction completion  0x12 – transaction error  0x13 – transaction approved  0x14 – transaction declined Final Status aDynamo, uDynamo, Dynamag, DynaMAX, eDynamo, BulleT, mDynamo| Secure Card Reader Authenticator | .NET/PCL Programmer’s Reference (Windows/Windows Phone) Page 35...

  • Page 36: Ondisplaymessagerequest (Emv Device Only)

    Object representing the publisher of the event data Byte array containing the data received from the device. See table below for descriptions of the data. aDynamo, uDynamo, Dynamag, DynaMAX, eDynamo, BulleT, mDynamo| Secure Card Reader Authenticator | .NET/PCL Programmer’s Reference (Windows/Windows Phone) Page 36...

  • Page 37: Ontransactionresult (Emv Device Only)

    Object representing the publisher of the event data Byte array containing the result code received from the device. See table below for descriptions of the result code. aDynamo, uDynamo, Dynamag, DynaMAX, eDynamo, BulleT, mDynamo| Secure Card Reader Authenticator | .NET/PCL Programmer’s Reference (Windows/Windows Phone) Page 37...

  • Page 38: Ondeviceextendedresponse (Emv Device Only)

    The first two bytes represent the result codes for the extended command. The next two bytes (most significant byte first) indicate the total length of the following data in bytes. aDynamo, uDynamo, Dynamag, DynaMAX, eDynamo, BulleT, mDynamo| Secure Card Reader Authenticator | .NET/PCL Programmer’s Reference (Windows/Windows Phone) Page 38...

  • Page 39: Commands

    Use getCapTracks method to retrieve data. Capability - MagStripe Encryption: 0 = No Encryption, 1 = TripDES DUKPT. Use getCapMagStripeEncryption method to retrieve data. aDynamo, uDynamo, Dynamag, DynaMAX, eDynamo, BulleT, mDynamo| Secure Card Reader Authenticator | .NET/PCL Programmer’s Reference (Windows/Windows Phone) Page 39...

  • Page 40: Appendix A Code Examples

    // Display last 4 digits of the card CardLast4.Text = mMTSCRA.getCardLast4(); Send Command To Device if (mMTSCRA.isDeviceConnected()) // Send discovery command mMTSCRA.sendCommandToDevice(“C10206C20503840900”, 0); aDynamo, uDynamo, Dynamag, DynaMAX, eDynamo, BulleT, mDynamo| Secure Card Reader Authenticator | .NET/PCL Programmer’s Reference (Windows/Windows Phone) Page 40...

  • Page 41: Appendix Barqc Message Format

    The Value inside tag DFDF59 is encrypted and contains the following after decryption: FC<len>/* container for encrypted generic data */ <tags defined by DFDF02 > aDynamo, uDynamo, Dynamag, DynaMAX, eDynamo, BulleT, mDynamo| Secure Card Reader Authenticator | .NET/PCL Programmer’s Reference (Windows/Windows Phone) Page 41...

  • Page 42: Appendix Carqc Response Message Format

    CBC-MAC (4 bytes, use MAC variant of MSR DUKPT key that was used in ARQC request, from message length up to and including ARQC padding, if any aDynamo, uDynamo, Dynamag, DynaMAX, eDynamo, BulleT, mDynamo| Secure Card Reader Authenticator | .NET/PCL Programmer’s Reference (Windows/Windows Phone)

  • Page 43: Appendix D Batch Data Format

    0x21 = Waiting for Card Cancelled by Host 0x22 = Waiting for Card Timeout 0x23 = Cancelled by Card Swipe 0xFF = Unknown aDynamo, uDynamo, Dynamag, DynaMAX, eDynamo, BulleT, mDynamo| Secure Card Reader Authenticator | .NET/PCL Programmer’s Reference (Windows/Windows Phone) Page 43...
  • Page 44 … /* < Merchant Data tags */ (Buffer if any to be a multiple of 8 bytes) CBC-MAC (4 bytes, always set to zeroes) aDynamo, uDynamo, Dynamag, DynaMAX, eDynamo, BulleT, mDynamo| Secure Card Reader Authenticator | .NET/PCL Programmer’s Reference (Windows/Windows Phone) Page 44...

This manual is also suitable for:

UdynamoDynamagDynamaxEdynamoBulletMdynamo

Table of Contents