Magtek DynaPro Go, Руководство программиста

Страница: 93 / 247

4 - Command Set
DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS)
Page 93 of 247 ( D998200136-31 )
4.4.2 Report 0x21 - Cardholder Data Entry Response Report
This event supports Command 0x14 - Request Cardholder Data Entry . After the cardholder has
successfully entered data, the device uses this report to send cardholder data to the host.
Table 4-56 - Usage Table for Report 0x21
Bit 7 6 5 4 3 2 1 0
Byte 0 0x21
Byte 1 Operation Status (see Table 4-99 - Operation Status Codes on page 163 )
Bytes 2..11 MSR KSN
Bytes 12..19 Cardholder Data Block
If the device is configured to send this data encrypted (see the
Clear Text Cardholder Data bit in
Command 0x09 - Set / Get Device Configuration ), it encrypts the Cardholder Data Block using the
current MSR DUKPT working key. It will either use the data variant or the PIN variant (see the MSR
Encryption Variant bit in Command 0x09 - Set / Get Device Configuration ).
The Cardholder Data Block format is a proprietary variation of a standard PIN ISO Format 1 data block,
but contains the information the host requested with
Command 0x14 - Request Cardholder Data Entry
(for example, if the host requested the cardholder’s zip code, this block would return just the zip code
data). After decryption, the 8-byte Cardholder Data Block is divided into 16 four-bit nybbles, as specified
in the tables below. Each nybble contains one of the following:

C: Control field
o
0100=SSN
o
0101=Zip Code
o
0110=Birth Date
o
0111=Activation Code [firmware revision C12 and newer] (Activation Codes Only)
o
1000= Server/Waiter code (Handheld Operation Only)
o
1001=Ticket Number (Handheld Operation Only)

N: Data length

P: Cardholder data digit from 0000 (decimal 0) to 1001 (decimal 9)

R: Filled random number

P/R: If the Birth Date data length is 6 (MMDDYY format), the positions marked P/R are filled with
random numbers (R); if the Birth Date data length is 8 (MMDDYYYY format), those positions
contain the rightmost two characters of the birth year (P).
Table 4-57 - Report 0x21 Cardholder Data Block Format
Bits
0
..3
4
..7
8
..11
1
2
..15
1
6
..19
2
0
..23
2
4
..27
2
8
..31
3
2
..35
3
6
..39
4
0
..43
4
4
..47
4
8
..51
5
2
..55
5
6
..59
6
0
..63
SSN
C N P P P P P P P P P R R R R R
Zip Code C N P P P P P R R R R R R R R R