MTSCRA Functions - 41 - 50

getTrackDecodeStatus

This function retrieves the track decode status after a cardholder swipes a card.

(NSString *) getTrackDecodeStatus

Parameters: None

Return Value:

Hex string, each 2 digits represent one track’s decode status, where the left most 2 digits are for Track 1.

• “00” = Success

• “01” = Error or not decodable

• “02” = No track present

Examples:

“000000” = Track 1, 2, and 3 success.

“000100” = Track 1 and 3 success. Track 2 had error.

“000002” = Track 1 and 2 success. Track 3 not present.

getBatteryLevel

This function retrieves device’s battery level percentage between 0% and 100%, if the device has a battery and supports battery level monitoring. To retrieve the most up to date percentage, call this function after a transaction.

(long) getBatteryLevel

Parameters: None

Return Value: Long value between 0 and 100

getDevicePartNumber

This function returns the currently opened device’s part number.

(NSString *) getDevicePartNumber

Parameters: None

Return Value: String containing the device part number.

getCardStatus

Retrieves the Card Status

(NSString *) getCardStatus 

Parameters: None

Return Value: Card Status, which depends on the device.

getTagValue [aDynamo/uDynamo Only]

This function retrieves individual TLV tag values. Only supported on aDynamo/UDynamo.

(NSString *) getTagValue:(UInt32)tag

Parameters:

Tag = An MTSCRATransactionData type (see section D.5 MTSCRATransactionData).

Return Value: String containing the value of the specified tag.

getDeviceStatus

This function gets the status of the currently connected device.

(NSString *) getDeviceStatus

Parameters: None

Return Value: Return device status of swipe count and battery level.

getOperationStatus

This function gets the status of the current operation.

(NSString *) getOperationStatus

Parameters: None

Return Value: Operation Status

getTLVVersion

This function returns the version of the tag-length-value (TLV) format supported by the device.

(NSString *) getTLVVersion

Parameters: None

Return Value: String containing the firmware TLV version.

setDeviceProtocolString [iDynamo Only]

This function sets the protocol string the SDK will use to communicate with the device. See example in

Open Device code example.

(void) setDeviceProtocolString:(NSString *)pData

Parameters: Protocol String

Return Value: None

getResponseType

This function gets the response type.

(NSString *) getResponseType 

Parameters: None

Return Value: Response Type