Sun Oracle Crypto Accelerator 6000 Board, User Manual

Page: 160 / 266

138 Sun Crypto Accelerator 6000 Board User’s Guide for Version 1.1 • February 2013
TABLE 5-23
lists the return values for the
fs_
pin_verify
()
function.
PIN Translate Function
fs_pin_translate()
This function translates a PIN from one encryption key to another. This function
occurs during banking transactions. An example is when a cardholder uses their
ATM card at a different bank than the one that issued the card. At the transaction,
the PIN comes in encrypted using a PIN encryption key (PEK) specified by the
point-of-service bank. To route the transaction to the credit card issuing bank, the
PAN
Personal account number
iPIN
Encrypted input PIN
data
PIN algorithm specific data
For Visa PVV,
data
consists of:
• PVKI
• Reference PVV
For IBM-3624
data
consists of:
• Decimalization table
• Validation data
• Check length
• Offset data
TABLE 5-23
fs_pin_verify()
Function Return Values
Return Value Description
fsOK
PIN was verified
fsVerifyFail
PIN failed verification
fsInvalidPEK
PEK invalid
fsInvalidPinType
PIN block format invalid
fsInvalidPVK
PVK invalid
fsInvalidPVKI
PVKI invalid (0 < PVKI || PVKI > 6)
fsInvalidState
Device not in correct state to process command
fsInvalidDectbl
Invalid decimalization table
fsError
Processing error
TABLE 5-22
fs_pin_verify()
Function Parameters (Continued)
Parameter Description