Magtek Audio Reader for Android Devices Manual do Utilizador

i Audio Reader PROGRAMMING REFERENCE MANUAL for Android Devices PART NUMBER 99875583-1 SEPTEMBER 2012 Confidential This document contai

4 getMaskedTracks Get stored masked tracks data. If decodable track data exists for a given track, it is located in the Masked Track Data field that

5 - public String getTrack2() Parameters Return Value Return stored track2 data string. getTrack3 Get stored track3 data. This field contains t

6 Return Value Return stored masked track2 data string. For an ISO/ABA card, the PAN is masked as follows: • The specified number of initial cha

7 For an AAMVA card, the specified mask character is substituted for each of the characters read from the card. getMagnePrint Supported on uDynamo

8 This four-byte field contains the MagnePrint status. The MagnePrint status is in little endian byte order. Byte 1 is the least significant byte.

9 getSessionID Not suported on Audio Reader. This 8-byte Binary field contains the encrypted version of the current Session ID. Its primary purpose

10 MagTekSCRA.DEVICE_TYPE_NONE MagTekSCRA.DEVICE_TYPE_AUDIO MagTekSCRA.DEVICE_TYPE_BLUETOOTH Return Value setDeviceID Set device identifier for the

11 String representing MagnePrint capabilities 0 = No MagnePrint, 1 = Short MagnePrint, 2 = Long MagnePrint getCapMagnePrintEncryption Retrieves

12 getCapMSR Retrieves MSR Capabilities - public String getCapMSR() Parameters Return Value String representing MSR Capabilities 0 = No MSR, 1 =

13 Note: The data returned is dependent on the partial information provided by the reader. If the reader supports emitting partial data for the field

ii Copyright© 2001-2012 MagTek®, Inc. Printed in the United States of America Information in this document is subject to change without notice. No

14 Note: The data returned is dependent on the partial information provided by the reader. If the reader supports emitting partial data for the field

15 Card Encode Type This one-byte value indicates the type of encoding that was found on the card. The following table defines the possible values.

16 Return Value String representing device configuration getDeviceType Retrieves device type - public int getDeviceType() Parameters Return Val

17 getFirmware Retrieves firmware version - public String getFirmware() Parameters Return Value String representing firmware version getMagTekD

18 Parameters Return Value String representing response data getResponseType Retrieves response type - public String getResponseType() Parameter

19 track data length value for the track that has the error will be set to zero and no valid track data will be supplied. - public String getTrackDec

20 SDK Version setConfigurationParams Sets configuration parameters - public void setConfigurationParams(String lpstrParams) Parameters lpstrP

21 -public void setConfigurationXML(String lpstrXML)throws MTSCRAException Parameters lpstrXML XML data received from the configuration serv

22 Parameters lpiReaderType Type of reader. The type of reader is assigned an integer value starting at 1. lpDeviceInfo SCRAConfigura

23 SECTION 2. CODE EXAMPLES Open Device: if (! mMTSCRA.isDeviceConnected()) { mMTSCRA.setDeviceType(mMTSCRA.DEVICE_TYPE_BLUETOOTH); mMTSCR

iii SOFTWARE LICENSE AGREEMENT IMPORTANT: YOU SHOULD CAREFULLY READ ALL THE TERMS, CONDITIONS AND RESTRICTIONS OF THIS LICENSE AGREEMENT BEFORE INSTAL

24 Get Tracks Data From Reader: private class SCRAHandlerCallback implements Callback { public boolean handleMessage(Message msg) { switch (msg.what)

iv Table of Contents Section 1. MagTekSCRA Class ... 1 Meth

v getPANHashSHA1 ... 17 getPANHashSHA256 ...

vi

1 SECTION 1. MagTekSCRA CLASS Methods: openDevice: Open device closeDevice: Close device isDeviceConnected Check the connection status of reader ge

2 getTagValue Retrieves the value of the specified tag getTLVVersion Retrieves TTLV version getTrackDecodeStatus Retrieves track decode status listen

3 Methods openDevice: This function opens the reader. - public void openDevice() Parameters None Return Value None closeDevice This function c