MTSCRA Function - 4.21 - 4.30

4.21 getMagnePrint

This function retrieves the card’s encrypted MagnePrint, for readers that support MagnePrint.

(NSString *) getMagnePrint

Parameters: None

Return Value: String containing the card’s encrypted MagnePrint.

4.22 getMagnePrintStatus [iDynamo Only]

This function retrieves the card MagnePrint status. For more information, see D99875475. Only available on iDynamo; it will return an empty string in audio reader.

(NSString *) getMagnePrintStatus

Parameters: None Return Value:

Return stored MagnePrintStatus string.

4.23 getDeviceSerial

This function retrieves the device serial number.

(NSString *) getDeviceSerial

Parameters: None

Return Value: String containing the device serial number.

4.24 getMagTekDeviceSerial

This function returns the MagTek serial number of the currently opened device.

(NSString *) getMagTekDeviceSerial

Parameters: None

Return Value: Return stored serial number created by MagTek.

4.25 getSessionID [iDynamo/uDynamo Only]

This function retrieves the Session ID from the currently opened device, which the host can use to uniquely identify a transaction to prevent replay. Only supported by iDynamo/uDynamo; on other devices this function will return an empty string. For more information, see D99875475

(NSString *) getSessionID

Parameters: None

Return Value: Stored session ID.

4.26 getKSN

This function retrieves the Key Serial Number (KSN) from the device.

(NSString *) getKSN

Parameters: None

Return Value: String containing the stored key serial number.

4.27 getDeviceName

This function gets the device’s product name.

(NSString *) getDeviceName 

Parameters: None

Return Value: String containing the device product name.

4.28 getDeviceType

This function gets the device type.

(int) getDeviceType 

Parameters: None

Return Value: Device Type

4.29 setDeviceType

This function sets the type of device to open. Call this function before calling openDevice.

(void) setDeviceType:(UInt32 *)deviceType

Parameters:

Device Type:

• MAGTEKAUDIOREADER = Audio readers aDynamo, uDynamo.

• MAGTEKIDYNAMO = iOS 30-pin and Lightning readers iDynamo.

• MAGTEKDYNAMAX = Bluetooth LE reader DynaMAX.

• MAGTEKEDYNAMO = Bluetooth LE reader eDynamo.

• MAGTEKKDYNAMO = Lightning reader kDynamo.

• MAGTEKTDYNAMO = Bluetooth LE reader tDynamo.

Return Value: None

4.30 getDeviceCaps

This function gets the capabilities of the currently opened device.

 (NSString *) getDeviceCaps

Parameters: None

Return Value: Return device capabilities.

• CAP_MASKING = 1,

• CAP_ENCRYPTION=2,

• CAP_CARD_AUTH = 4,

• CAP_DEVICE_AUTH = 8,

• CAP_SESSION_ID = 16,

• CAP_DISCOVERY= 32,