VeriFone MX800 series Programmer's Manual page 218

IPP L L
EGACY IBRARY
ipp_getpin()
218
M X 800 S P
ERIES ROGRAMMERS
Return Values
0 Successful
-1 PIN Entry Occurring
-2 Too many PIN entry requests in a short period - Retry later.
-3 Invalid parameter or IPP communication error.
Prior to issuing this command, the setSecurePINDisplayParameters()
function must be used to register the "PIN feedback" callback function and to load
the hotspot table. See SetSecurePINDisplayParameters().
Once this function is executed, the touch panel data is no longer accessible to the
application and it is routed directly to internal software. As each digit of the PIN is
entered, an event is echoed to the application through the callback function. Illegal
keys are ignored. Pressing [CLEAR] will abort the session
Encryption of the PIN is performed internally by the system hardware immediately
after the PIN is entered and [ENTER] is pressed. Raw PIN data is never made
available to the Application. After issuing this command, the ipp_read()
function must be used to collect the encrypted PIN information.
G
UIDE