After creating an instance of the MTSCRA class in your custom software project, use the methods described in this section to communicate with SCRA device.
This method sets the connection type of the device.
public void setConnectionType(MTConnectionType connectionType)Parameters:
Parameter
Description
connectionType
The following table shows the connection types supported by the various SCRA devices:
Return Value: None
This function when set to True instructs the SDK to automatically retry to connect to the Bluetooth LE reader upon pairing. If set to False, the Bluetooth LE reader will be disconnected after pairing. This function is set to False by default in the SDK, but MagTek highly recommends to set this flag to True in your application in order to make sure that you'll have a successful secure connection between Android OS and Bluetooth LE reader after the paring.
Parameters:
Return Value: None
This method sets the address of the device.
Parameters:
Return Value: None
This method sets the configuration parameters for the device.
Parameters:
Return Value: None
This method opens connection to the device.
Parameters: None
Return Value: None
This method closes the connection to the device.
Parameters: None
Return Value: None
This method returns whether the device is connected or not.
Parameters: None
Return Value:
Return true if the device is connected. Otherwise, return false.
This method returns whether the device supports EMV or not.
Parameters: None
Return Value:
Return true if EMV is supported by the device. Otherwise, return false.
Get stored masked tracks data. If decodable track data exists for a given track, it is located in the Masked Track Data field that corresponds to the track number. The length of each Masked Track Data field is fixed at 112 bytes, but the length of valid data in each field is determined by the Masked Track Data
Length field that corresponds to the track number. Masked Track Data located in positions greater than indicated in the Masked Track Data Length field are undefined and should be ignored.
The Masked Track Data is decoded and converted to ASCII and then it is masked. The Masked Track Data includes all data starting with the start sentinel and ending with the end sentinel. Much of the data is masked; a specified mask character is sent instead of the actual character read from the track. Which characters are masked depends on the format of the card. Only ISO/ABA (Financial Cards with Format Code B) and AAMVA cards are selectively masked; all other card types are either entirely masked or sent totally in the clear. There is a separate masking property for ISO/ABA cards and AAMVA cards. See D99875475 for the ISO Track Masking property and the AAMVA Track Masking property for more information. See D99875475 for a description on how ISO/ABA and AAMVA cards are identified.
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 correction should be applied to make the Mod 10 9 (Luhn algorithm) digit at the end of the number be correct.
Parameters: None
Return Value:
Return stored masked tracks data string.
Get stored track1 data. This field contains the encrypted track data for track 1.
public String getTrack1()
Parameters: None
Return Value:
Return stored track1 data string.
Bluetooth LE EMV
eDynamo
Android 4.4.2 and above
Bluetooth LE EMVT
tDynamo
Android 4.4.2 and above
Bluetooth
BulleT
Card swipe only
USB
BulletT DynaMag DynaMAX eDynamo tDynamo DynaWave iDynamo 6
iDynamo 5 (Gen III)
Host must support USB On- The-Go.
Serial
DynaGlass
Android 7.1.2
Serial
DynaWave
Android 4.4.2 and above
AIDL
DynaGlass
Android 7.1.2
INPUT_AUDIO_SOURE
VRECOG
MIC, VRECOG
INPUT_SAMPLE_RATE_IN_HZ
44100
32000, 44100, 48000
MTConnectionType value: MTConnectionType.Unknown, MTConnectionType.Audio, MTConnectionType.BLE, MTConnectionType.BLEEMV, MTConnectionType.Bluetooth, MTConnectionType.USB, MTConnectionType.Serial, MTConnectionType.Net, MTConnectionType.Net_TLS12, MTConnectionType.Net_TLS12_Trust_All, MTConnectionType.BLEEMVT, MTConnectionType.AIDL
Connection Type
SCRA Device
Note
Audio
aDynamo uDynamo
Bluetooth LE
DynaMAX
Parameter
Description
connectionRetry
Connection retry value:
True = SDK will retry the conection after pairing.
False = SDK will not retry the connection after pairing.
Parameter
Description
deviceAddress
String value of the address.
Parameter
Description
configuration
String value of the configuration parameters to be used for the device.
Audio Reader Device Configuration
Parameter
Default Value
Configurable Values
PAN_MOD10_CHECKDIGIT
TRUE
Android 4.4.2 and above
FALSE, TRUE
public void setConnectionRetry(boolean connectionRetry)public void setAddress(String deviceAddress)public void setDeviceConfiguration(String configuration)public void openDevice()public void closeDevice()public boolean isDeviceConnected()public boolean isDeviceEMV()public String getMaskedTracks()