Verify PIN (VFYPIN)
The Verify Personal Identification Number (VFYPIN) command determines if the customer's personal identification number is algorithmically related to the customer's validation data. The result of the test is returned in a 1-byte variable.
| Keyword |
Description |
Choices |
Notes |
| INPINPTCK |
Input protection key name |
Name |
Required, Positional 1 |
| ENCPIN |
Enciphered PIN |
Character value |
Required, Positional 2 |
| PINVLDK |
PIN validation key name |
Name |
Required, Positional 3 |
| DECTBL |
Decimalization table |
Character value |
Required, Positional 4 |
| VLDDTA |
PIN validation data |
Character value |
Required, Positional 5 |
| PINCHKLEN |
PIN check length |
1-16 |
Required, Positional 6 |
| RTNVAR |
Return variable |
Character value |
Required, Positional 7 |
| PINPADCHAR |
PIN pad character |
Character value, *NONE |
Optional, Positional 8 |
| OFFSET |
PIN offset data |
Character value, *NONE |
Optional, Positional 9 |
Input protection key name (INPINPTCK)
Specifies the name, or a variable containing the name, of the input PIN protection key that the personal identification number is enciphered under. This key must exist in the cross-domain key table and be defined with a key use of personal identification number (*PIN specified on the Key use prompt (KUSE parameter) on the Generate Cross-Domain Key (GENCRSDMNK) or Add Cross-Domain Key (ADDCRSDMNK) command). This is a required parameter.
Enciphered PIN (ENCPIN)
Specifies 16 hexadecimal characters, or a character variable containing 16 hexadecimal characters, representing a personal identification number in 3624 format enciphered under the input PIN protection key. This is a required parameter.
PIN validation key name (PINVLDK)
Specifies the name, or a variable containing the name, of a validation key that is to be used to encrypt the validation data. This key must exist in the cross-domain key table and be defined with a key use of personal identification number (*PIN specified on the Key use prompt (KUSE parameter) on the Generate Cross-Domain Key (GENCRSDMNK) or Add Cross-Domain Key (ADDCRSDMNK) command). This is a required parameter.
Decimalization table (DECTBL)
Specifies 16 numeric digits (0-9), or a character variable containing 16 numeric digits, to be used as the table for conversion to decimal when verifying the personal identification number. This is a required parameter.
PIN validation data (VLDDTA)
Specifies 16 hexadecimal characters, or a character variable containing 16 hexadecimal characters, representing the 8 bytes of validation data to be used for verifying the personal identification number. This is a required parameter.
PIN check length (PINCHKLEN)
Specifies the number, or a variable containing the number, of digits of the personal identification number to be verified.
Return variable (RTNVAR)
Specifies a variable to receive the 1-byte verification status. If the personal identification number is valid, the status is set to 0. If the personal identification number is not valid, the status is set to 1.
PIN pad character (PINPADCHAR)
Specifies the hexadecimal character that was used to pad the personal identification number before being encrypted. It is removed from the end of the personal identification number before verification.
The possible values are:
- *NONE
- The personal identification number was not padded before being encrypted.
- PIN-pad-character
- Specify 1 hexadecimal character, or a variable containing 1 hexadecimal character, representing the value that was used to pad the personal identification number before it was encrypted
PIN offset data (OFFSET)
Specifies a numeric value to be added to the intermediate personal identification number obtained from the validation data before comparing it with the supplied personal identification number.
The possible values are:
- *NONE
- No offset value should be added to the intermediate personal identification number before the comparison. Specifying *NONE for this parameter is equivalent to entering a value of zero for the parameter.
- offset-data
- Specify 16 numeric digits (0-9), or a character variable containing 16 numeric digits, representing the value to be added to the intermediate personal identification number before the comparison.