Command 0X04 - Request Pin Entry - Magtek DynaPro Go Programmer's Manual

4 - Command Set

4.3.4 Command 0x04 - Request PIN Entry

This command directs the device to prompt the cardholder to enter a PIN during an MSR transaction
session the host initiated using Command 0x03 - Request Swipe Card, in which the device is aware of
the account information. To prompt for a PIN outside the scope of a session, where the host is aware of
the account information but the device is not, use Command 0x40 - Request PIN Entry with Host
Supplied Account Data (Host-Supplied-Non-Session-PAN Only) instead.
The sequence is as follows:
1) The host has already established a session with the device using Command 0x03 - Request Swipe
Card.
2) The host invokes this command using the format in Table 4-5.
3) (PIN Language Select Only) If the command specifies Language Select should be enabled, the
device first prompts the cardholder to select one of the allowed languages. The selected language
remains active until the host sends Command 0x02 - End Session. The device then switches to the
default device language set in the contact database using Command 0xA1 - Access EMV Tags.
4) The device displays one of five predefined messages (see PIN Mode in Table 4-5) and waits for the
cardholder to enter a PIN.
5) If the host specifies PIN Mode Verify PIN:
a) The device prompts the cardholder to enter the PIN a second time, and proceeds only if both
entries match.
6) If an error occurs, the device terminates the command and reports the error in ACKSTS of Command
0x01 - Response ACK. For a full list of error codes, see Command 0x01 - Response ACK.
7) If no error occurs, when the command completes (PIN entry done, cardholder or operator cancelled,
or timeout), the device sends Report 0x24 - PIN Response Report to the host. If PIN entry is
successful, the report also contains the PIN KSN (if using a DUKPT PIN Key, otherwise the PIN
KSN is zero) and the encrypted PIN block (EPB) data. The EPB format depends on the PIN Option
the host specified in the command, and on Session State (see Report 0x20 - Device State Report):
a) If there is a PAN, the device creates the EPB using the PIN Option the host specified in the
command.
b) If there is no PAN (from card swipe or sent via command), the device creates the EPB using ISO
format 1.
The EPB is encrypted under the current PIN DUKPT key as DES or TDES depending on the injected key
type.
("Cap Keypad" Only)
If the host set the Wait Msg bit in the command's PIN Options byte, the device displays a
message during the delay as it checks for keypad tamper, then displays the
The English on-screen prompts look like this:
DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer's Manual (COMMANDS)
Page 44 of 247 (D998200136-31)
Please Wait
message.
ENTER PIN