Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.
Page cover
Export as PDF

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.

Parameters: None

Return Value: String containing the device part number.

getCardStatus

Retrieves the Card Status

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.

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.

Parameters: None

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

getOperationStatus

This function gets the status of the current operation.

Parameters: None

Return Value: Operation Status

getTLVVersion

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

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.

Parameters: Protocol String

Return Value: None

getResponseType

This function gets the response type.

Parameters: None

Return Value: Response Type