MTSCRA Function - 4.41 - 4.50

4.41 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.

4.42 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

4.43 getDevicePartNumber

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

(NSString *) getDevicePartNumber

Parameters: None

Return Value: String containing the device part number.

4.44 getCardStatus

Retrieves the Card Status

(NSString *) getCardStatus

Parameters: None

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

4.45 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.

4.46 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.

4.47 getOperationStatus

This function gets the status of the current operation.

(NSString *) getOperationStatus

Parameters: None

Return Value: Operation Status

4.48 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.

4.49 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

4.50 getResponseType

This function gets the response type.

(NSString *) getResponseType

Parameters: None

Return Value: Response Type