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

MTSCRA Class Methods - 41 - 50

getCardEncodeType

Retrieves the card encode type.

public string getCardEncodeType()

Parameters: None Return Value:

String representing the card encode type.

Card Encode Type

This is a string value which indicates the type of encoding that was found on the card. The following table defines the possible values.

Value

Encode Type

Description

00

ISO/ABA

ISO/ABA encode format. At least one track in ISO/ABA format, Track 3 not AAMVA format.

01

AAMVA

AAMVA encode Track 3 is AAMVA format. Tracks 1 and 2 are ISO/ABA if correctly decoded.

02

Reserved

03

Blank

The card is blank. Only occurs if all tracks decode without error and without data.

04

Other

The card has a non-standard encode format. For example, ISO/ABA track 1 format on track 2.

05

Undetermined

The card encode type could not be determined because no tracks could be decoded. (Combination of Error tracks and Blank Tracks, at least one Error track).

06

None

No decode has occurred. This type occurs if no magnetic stripe data has been acquired since the data has been cleared or since the reader was powered on. This reader only sends an Input report when a card has been swiped so this value will never occur.

getDataFieldCount

Retrieves data field count.

public int getDataFieldCount()

Parameters: None

Return Value:

Data field count

getHashCode

Retrieves SHA-x hash code.

public string getHashCode()

Parameters: None Return Value:

String representing SHA-x hash code.

getDeviceConfig

Retrieves device configuration.

public string getDeviceConfig(string configType)

Parameters:

configType can be one of:

  • 8180: Send TLV Version on Power Up

  • 8181: Send Discovery on Power Up

  • 8280: Send Card name

  • 8281: Send Card IIN

  • 8282: Send Card Last 4 Digits of PAN

  • 8283: Send Card Expiration

  • 8284: Send Card Service Code

  • 8285: Send Card PAN Length

Return Value:

String representing device configuration.

getEncryptionStatus

Retrieves encryption status. This two-byte Binary field contains the Encryption Status. The Reader Encryption Status is sent in big endian byte order. Byte 1 is the least significant byte. Byte 1 LSB is status bit 0. Byte 2 MSB is status bit 15.

public string getEncryptionStatus()

Parameters: None Return Value:

String representing decryption status as a 2-byte binary field.

  • Bit 0 = DUKPT Keys exhausted (1=exhausted, 0=keys available)

  • Bit 1 = Initial DUKPT key Injected, always set to One (Primary DUKPT Key)

  • Bit 2 = Encryption Enabled, always set to One

  • Bit 3 = Reserved (always set to zero)

  • Bit 4 = Reserved (always set to zero)

  • Bit 5 = Reserved (always set to zero)

  • Bit 6 = Reserved (always set to zero)

  • Bit 7 = Reserved (always set to zero)

  • Bit 8 = Reserved (always set to zero)

  • Bit 9 = Initial DUKPT key injected (Secondary DUKPT Key)

  • Bit 10 = DUKPT Key used for encryption, 0=Primary, 1=Secondary

  • Bit 11 = DUKPT Key Variant used to encrypt data, 0=PIN Variant, 1=Data Variant/Bidirectional

  • Bits 12–15 = Unassigned (always set to Zero)

getFirmware

Retrieves firmware version.

public string getFirmware()

Parameters: None

Return Value:

String representing firmware version.

getMagTekDeviceSerial

Retrieves MagTek device serial number.

public string getMagTekDeviceSerial()

Parameters: None

Return Value:

String representing MagTek device serial number.

getResponseData

Retrieves response data.

public string getResponseData()

Parameters: None

Return Value:

String representing response data.

getResponseType

Retrieves response type.

public string getResponseType()

Parameters: None

Return Value:

String representing response type. For Audio Reader, always “C101”.

getTagValue

Retrieves the value of the specified tag.

public string getTagValue(string tag, string data)

  • Parameters: None

    • tag

      • Tag to search for

    • data

      • Data to search from

Return Value: String representing tag value.

Last updated