4 - Command Set
DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS)
Page 44 of 247 (
D998200136-31
)
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)
The sequence is as follows:
1)
The host has already established a session with the device using
2)
The host invokes this command using the format in
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
. 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
) 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
. For a full list of error codes, see
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
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
Please Wait
message during the delay as it checks for keypad tamper, then displays the
ENTER PIN
message.
The English on-screen prompts look like this: