Encrypted magneprint data, Device serial number, Encrypted session id – MagTek Bluetooth MagneSafe V5 Swipe Reader User Manual

Page 27: Dukpt key serial number, Encryption counter

Advertising
background image

Section 5. Communications

19

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

=

This is a MagnePrint-capable product (usage M)

Bits 1-15

=

Product revision & mode (usage R)

Bit 16

=

STATUS-only state (usage S)

Bit 17

=

Noise too high or “move me” away from the noise source (used
only in STATUS) (usage N)

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)

If the Enable/Disable MagnePrint property is set to disable MagnePrint, this field will not be
sent.

Encrypted MagnePrint Data

This 56-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.

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.

Encrypted Session ID

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.

DUKPT 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.

Encryption Counter

This 3-byte field contains the value of the Encryption Counter at the end of this transaction. See
the Get Encryption Counter command for more information.

Advertising