Get stored track2 data. This field contains the encrypted track data for track 2.
public String getTrack2()Parameters: None
Return Value:
Return stored track2 data string.
Get stored track3 data. This field contains the encrypted track data for track 3.
public String getTrack3()Parameters: None
Return Value:
Return stored track3 data string.
Get stored masked track1 data.
Parameters: None Return Value:
Return stored masked track1 data string.
For an ISO/ABA card, the PAN is masked as follows:
The specified number of initial characters is sent unmasked. The specified number of trailing characters is sent unmasked. If Mod 10 correction is specified, all but one of the intermediate characters of the PAN are set to zero; one of them will be set such that last digit of the PAN calculates an accurate Mod 10 check of the rest of the PAN as transmitted. If the Mod 10 correction is not specified, all of the intermediate characters of the PAN are set to the specified mask character.
The Card Holder’s name and the Expiration Date are transmitted unmasked.
All Field Separators are sent unmasked.
For an AAMVA card, the specified mask character is substituted for each of the characters read from the card.
Get stored masked track2 data.
Parameters: None
Return Value:
Return stored masked track2 data string.
For an ISO/ABA card, the PAN is masked as follows:
The specified number of initial characters are sent unmasked. The specified number of trailing characters are sent unmasked. If Mod 10 correction is specified, all but one of the intermediate characters of the PAN are set to zero; one of them will be set such that last digit of the PAN calculates an accurate Mod 10 check of the rest of the PAN as transmitted. If the Mod 10 correction is not specified, all of the intermediate characters of the PAN are set to the specified mask character.
The Expiration Date is transmitted unmasked.
All Field Separators are sent unmasked.
For an AAMVA card, the DL/ID# is masked as follows:
The specified number of initial characters are sent unmasked. The specified number of trailing characters are sent unmasked. If Mod 10 correction is specified, all but one of the intermediate characters of the DL/ID#PAN are set to zero; one of them will be set such that last digit of the DL/ID# calculates an accurate Mod 10 check of the rest of the DL/ID# as transmitted. If the Mod 10 correction is not specified, all of the intermediate characters of the DL/ID# are set to the specified mask character.
The Expiration Date and Birth Date are transmitted unmasked.
All other characters are set to the specified mask character.
Get stored masked track3 data.
Parameters: None
Return Value:
Return stored masked track3 data string.
For an ISO/ABA card, the PAN is masked as follows:
The specified number of initial characters are sent unmasked. The specified number of trailing characters are sent unmasked. If Mod 10 correction is specified, all but one of the intermediate characters of the PAN are set to zero; one of them will be set such that last digit of the PAN calculates an accurate Mod 10 check of the rest of the PAN as transmitted. If the Mod 10 correction is not specified, all of the intermediate characters of the PAN are set to the specified mask character.
All Field Separators are sent unmasked.
All other characters are set to the specified mask character.
For an AAMVA card, the specified mask character is substituted for each of the characters read from the card.
Not supported on aDynamo. This 128 byte Binary field contains the MagnePrint data. Only the number of bytes specified in the MagnePrint data length field are valid. The least significant bit of the first byte of data in this field corresponds to the first bit of MagnePrint data. If the Enable/Disable MagnePrint property is set to disable MagnePrint, this field will not be sent.
Parameters: None
Return Value:
String containing the MagnePrint data.
Not supported on aDynamo. Get the card MagnePrint status. For more information, see D9875475
Parameters: None
Return Value:
String containing the MagnePrint status.
This Binary field represents 32 bits of MagnePrint status information. Each character represents 4 bits (hexadecimal notation). For example, suppose the characters are: “A1050000”:
Usage Legend:
D = Direction
F = Too Fast
L = Too Slow
M = MagnePrint capable
This four-byte field contains the MagnePrint status. The MagnePrint status is in little endian byte order. Byte 1 is the least significant byte. Byte 1 LSB is status bit 0. Byte 4 MSB is status bit 31. MagnePrint status is defined as follows:
Bit 0 = MagnePrint-capable product (usage M)
Bits 1-15 = Product revision & mode (usage R)
Bit 16 = STATUS-only state (usage S)
If the Enable/Disable MagnePrint property is set to disable MagnePrint, this field will not be sent.
Get stored device serial number. This 16-byte ASCII field contains the device serial number. The device serial number is a NUL (zero) terminated string. So the maximum length of the device serial number, not including the null terminator, is 15 bytes. This device serial number can also be retrieved and set with the device serial number property explained in the property section of this document. This field is stored in non-volatile memory, so it will persist when the unit is power cycled.
Parameters: None
Return Value:
Return stored device serial number.
Not suported on aDynamo. This 8-byte Binary field contains the encrypted version of the current Session ID. Its primary purpose is to prevent replays. After a card is read, this property will be encrypted, along with the card data, and supplied as part of the transaction message. The clear text version of this will never be transmitted. To avoid replay, the application sets the Session ID property before a transaction and verifies that the Encrypted Session ID returned with card data decrypts to the value set.
public String getSessionID()
Parameters: None
Return Value:
Returns a string containing the session id.
Get stored key serial number. This 10-byte Binary field contains the DUKPT Key Serial Number used to encrypt the encrypted fields in this message. This 80-bit field includes the Initial Key Serial Number in the leftmost 59 bits and a value for the Encryption Counter in the rightmost 21 bits. If no keys are loaded, all bytes will have the value 0x00.
public String getKSN()
Parameters: None
Return Value:
Return stored key serial number.
All other characters are set to the specified mask character.
All other characters are set to the specified mask character.
Value
A
1
0
5
0
0
0
0
Bit
7
6
5
4
3
2
1
0
1
5
1
4
1
3
Value
1
0
1
0
0
0
0
1
0
0
0
Usage*
R
R
R
R
R
R
R
M
R
R
R
N = Too Noisy
R =Revision
Bit 18 = Swipe too slow (usage L)
Bit 19 = Swipe too fast (usage F)
Bit 20 = Unassigned (always set to Zero)
Bit 21 = Actual Card Swipe Direction (0 = Forward, 1 = Reverse) (usage D)
Bits 22-31 = Unassigned (always set to Zero)
public String getTrack1Masked()public String getTrack2Masked()public String getTrack3Masked()public String getMagnePrint()public String getMagnePrintStatus()Nibble
1
2
3
4
5
6
7
8
public String getDeviceSerial()1
2
1
1
1
0
9
8
2
3
2
2
2
1
2
0
1
9
1
8
1
7
1
6
3
1
3
0
2
9
2
8
2
7
2
6
2
5
2
4
0
0
1
0
1
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
R
R
R
R
R
0
0
D
0
F
L
N
S
0
0
0
0
0
0
0
0