Errors Returned By Write(); Packet Z63: Accept And Encrypt Pin-Custom Pin Entry Requirements; (Visa Mode) - VeriFone MX800 series Programmer's Manual

Packet Z63: Accept
and Encrypt PIN–
Custom PIN Entry
Requirements

(VISA Mode)

Sample Packet Z63
for MS
Sample Packet Z63
for DUKPT

Errors returned by write()

Some packet format errors are caught when the packet is written to the IPP. In this
case, write() returns –1 and errno set. The packet is not ACKed or NAKed, and
no response packet returns.
Z60 Format Error
No <FS>
PIN entry too fast.
See Restrict the Speed of the PIN Encryption
On receipt of the Z63 packet, Omni 33XX reads the user's PIN from the keyboard,
echoing to the display [echo char] for each digit accepted. The PIN length can be
between [min len] and [max len] digits, inclusive, or 0 if the
[NULL allowed flag] is set. There are two variations of these request
packets: MS and DUKPT.
Request <STX>Z63.[acct num]<FS>[working key][min len][max len]
[NULL allowed flag][echo char]<ETX>{LRC}
Response <STX>71.0[PIN len][PIN block format]
Request <STX>Z63.[acct num]<FS>DUKPT ENCRYPTION[min len][max len]
[NULL allowed flag][echo char]<ETX>{LRC}
Response <STX>73.00000[key serial number][encrypted PIN block]<ETX>{LRC}
Note that [min len] and [max len] are two-character ASCII digits that
represent values between 04 and 12, inclusive. [max len] should not be less
than [min len] that is:
≤ ≤
04 [min len] [max len]
Furthermore, [NULL allowed flag] and [echo char] each are 1-byte
values with the following requirements:
•
[NULL allowed flag] = Y allows a zero-length PIN entry
•
[NULL allowed flag] = N does not allow zero-length PIN entries
•
[echo char] should be displayable and cannot be <STX>, <ETX>, <SI>,
<SO>, or <FS>, even if the currently selected font can display characters 02h,
03h, 0Fh, 0Eh, or 1Ch.
If any of these four fields do not conform to the restrictions, then the packet is
rejected by the driver (return code of -1 with errno set to EINVAL).
Table 48 Packet Z63 Format
Data Elements Characteristics
<STX> 1H
Packet Type 3AN
Packet Delimiter 1A
IPP MS
Operation.
[encrypted PIN block]<ETX>{LRC}
≤
12
Comments
Start of Text, Value: 02h
Value: Z63
Value: (.), 2Eh [aaa...aa] 8-19N Card
account number
DUKPT C
AND OMMUNICATIONS
Common Packets
errno
EINVAL
EACESS
X
M 800 S P
ERIES ROGRAMMERS
P
ACKETS
311
G
UIDE