# MTSCRA Class Methods - 51 - 61 #### getTLVVersion Retrieves TLV version. public string getTLVVersion() Parameters: None Return Value: String representing TLV version as a two-byte hex string. #### getTrackDecodeStatus Retrieves track decode status. This is a one-byte value, which indicates the status of decoding track 1. Bit position zero indicates if there was an error decoding track 1 if the bit is set to one. If it is zero, then no error occurred. If a track has data on it that is not noise, and it is not decodable, then a decode error is indicated. If a decode error is indicated, the corresponding track data length value for the track that has the error will be set to zero and no valid track data will be supplied. public string getTrackDecodeStatus() Parameters: None Return Value: Track Decode Status. Consists of three 2-byte hex values representing the decode status for tracks 1, 2, and 3 (respectively from left to right). Values are: * 00 = Track OK * 01 = Track read Error * 02 = Track is Blank #### getSDKVersion Retrieves SDK version. public string getSDKVersion() Parameters: None Return Value: The version information of the SDK. #### sendCommandToDevice Send command to device. public int sendCommandToDevice(string command) Parameters:
ParameterDescription
commandCommand string to send to the device.
Return Value: * 0 = Success * 9 = Error * 15 = Busy #### 1.5 startTransaction (EMV Device Only) This function starts an EMV L2 transaction for smart card. * public int startTransaction( * byte timeLimit, * byte cardType, * byte option, * byte\[] amount, * byte transactionType, * byte\[] cashBack, * byte\[] currentCode, * byte reportingOption) Parameters:
ParameterDescription

Card Type to Read:

0x01 = Magnetic Stripe (as alternative to EMV L2, card swipe causes abort of EMV L2)

0x02 = Contact chip card

0x03 = Magnetic Stripe and Contact chip Card. 0x04 = Contactless chip card

0x05 = Magnetic Stripe and Contactless chip card. 0x06 = Contact chip card and Contactless chip card.

0x07 = Magnetic Stripe, Contact chip card, Contactless chip card.

Refer to Supported Device Features for supported devices.


ParameterDescription
timeLimitSpecifies the maximum time, in seconds, allowed to complete the total transaction. This includes time for the user to insert the card, choose a language, choose an application, and online processing. If this time is exceeded, the transaction will be aborted, and an appropriate Transaction Status will be available. Value 0 is not allowed.
cardType

Card Type to Read:

0x01 = Magnetic Stripe (as alternative to EMV L2, card swipe causes abort of EMV L2)

0x02 = Contact chip card

0x03 = Magnetic Stripe and Contact chip Card. 0x04 = Contactless chip card

0x05 = Magnetic Stripe and Contactless chip card. 0x06 = Contact chip card and Contactless chip card.

0x07 = Magnetic Stripe, Contact chip card, Contactless chip card.

Refer to Supported Device Features for supported devices.

option

0x00 = Normal 0x01 = Bypass PIN 0x02 = Force Online

0x04 = Acquirer not available (Note: prevents long timeout on waiting for host approval) (causes “decline” to be generated internally if ARQC is generated)

To use Quick Chip mode, set the most significant bit to ‘1’.

0x80 = Quick Chip, Normal 0x81 = Quick Chip, Bypass PIN 0x82 = Quick Chip, Force Online

Refer to Supported Device Features for supported devices.

amount

Amount Authorized (EMV Tag 9F02, format n12, 6 bytes) in hex string.

For example: “000000000999”, means 9.99 dollars.

transactionType

Valid values:

0x00 = Purchase (listed as “Payment” on ICS)

0x01 = Cash Advance (not supported for this reader)

0x02 or 0x09 = Cash back (0x09 only supported when using contactless) 0x04 = Goods (Purchase)

0x08 = Services (Purchase)

0x10 = International Goods (Purchase) 0x20 = Refund

0x40 = International Cash Advance or Cash Back 0x80 = Domestic Cash Advance or Cash Back

cashBack

Cash back Amount (if non-zero, EMV Tag 9F03, format n12, 6 bytes) in hex string.

For example: “000000001000”, means 10.00 dollars.

currencyCode

Transaction Currency Code (EMV Tag 5F2A, format n4, 2 bytes) Sample Valid values:

0x0840 – US Dollar 0x0978 – Euro 0x0826 – UK Pound

reportingOption

This single byte field indicates the level of Transaction Status notifications the host desires to receive during the course of this transaction.

0x00 = Termination Status only

(normal termination, card error, timeout, host cancel)

0x01 = Major Status changes

(terminations plus card insertions and waiting on user)

0x02 = All Status changes

(documents the entire transaction flow)

Return Value: * 0 = Success * 9 = Error1 * 15 = Busy #### setUserSelectionResult (EMV Device Only) This function sets the user selection result. It should be called after receiving the OnUserSelectRequest event which is triggered after the user makes a selection. public int setUserSelectionResult(byte status, byte selection) Parameters:
ParameterDescription

Status

Indicates the status of User Selection:

0x00 – User Selection Request completed, see Selection Result 0x01 – User Selection Request aborted, cancelled by user

0x02 – User Selection Request aborted, timeout

selectionIndicates the menu item selected by the user. This is a single byte zero based binary value.
Return Value: * 0 = Success * 9 = Error * 15 = Busy #### setAcquirerResponse (EMV Device Only) This function sends to the device the transaction decision from acquirer. public int setAcquirerResponse(byte\[] response) Parameters:
ParameterDescription

response

The first two bytes (most significant byte first) indicate the total length of the following byte array. The byte array contains the ARQC Response message. See Appendix C for ARQC Response Message Format.
Return Value: * 0 = Success * 9 = Error * 15 = Busy #### cancelTransaction (EMV Device Only) This function cancels a transaction while waiting for the user to insert a card. public int cancelTransaction () Parameters: None Return Value: * 0 = Success * 9 = Error * 15 = Busy #### sendExtendedCommand (EMV Device Only) Send extended command to device. public int sendExtendedCommand(string command) Parameters:
ParameterDescription

command

Hexadecimal string of the byte array for the extended command.

The first two bytes represent the value of the extended command.

The next two bytes (most significant byte first) indicate the total length of the following data in bytes.

Return Value: * 0 = Success * 9 = Error * 15 = Busy #### getDeviceFeatures() Retrieves features for the device. public MTDeviceFeatures getDeviceFeatures() Parameters: None Return Value: ``` public class MTDeviceFeatures { bool MSR; bool Contact; bool Contactless; bool PINPad; bool MSRPowerSaver; bool BatteryBackedClock; bool SRED; bool SignatureCapture; bool ManualEntry; } ``` #### getPowerManagementValue() Retrieves power management value for the device. public String getPowerManagementValue() Parameters: None Return Value: Returns the PM value associated with the device.
Parameter

Power Management

BulleT KB BulleT SPPPM1
cDynamo
Dynamag, Dynamag Duo, USB Enc IntelliHead V5
DynastyPM3
DynaMAXPM2
DynaPAD
DynaWave
eDynamoPM3
FlashPM1
iDynamo
iDynamo 5
IDynamo 5 Gen III
Home Banking (Dynamo LCD)
kDynamoPM5
mDynamo
P-series and I-65 w/V5
pDynamoPM6
sDynamo
SPI Encrypting IntelliHead V5
tDynamoPM5
UART Enc IntelliHead V5
uDynamoPM4
U-FinityPM1
--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://developer.magtek.com/hardware/card-readers/magnetic-stripe-readers/idynamo-5-gen-iii/documentation/developers-manuals/programmers-manual-.net-pcl/mtscra-class-methods/mtscra-class-methods-51-61.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.