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

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.

Parameters: None

Return Value: String containing the device part number.

4.44 getCardStatus

Retrieves the Card Status

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.

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.

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.

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.

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.

Parameters: Protocol String

Return Value: None

4.50 getResponseType

This function gets the response type.

Parameters: None

Return Value: Response Type

Last updated