Parameters

For the definitions of the return_code, reason_code, exit_data_length, and exit_data parameters, see Parameters common to all verbs.

rule_array_count

Direction:	Input
Type:	Integer

A pointer to an integer variable containing the number of elements in the rule_array variable. This value must be 1 or 2.

rule_array

Direction:	Input
Type:	String array

Keywords that provide control information to the verb. The keywords are left-aligned in an 8-byte field and padded on the right with blanks. The keywords must be in contiguous storage. The rule_array keywords are described in Table 1.

Table 1. Keywords for Transaction Validation control information

Keywords for Transaction Validation control information

Keyword	Description
Card security code algorithm (One, optional)
CSC-V1	Specifies use of CSC version 1.0 algorithm for generating or verifying the validation values.
CSC-V2	Specifies use of CSC version 2.0 algorithm for generating or verifying the validation values.
American Express® card security codes (One, required)
CSC-3	3-digit card security code (CSC) located on the signature panel. VERIFY implied. This is the default.
CSC-4	4-digit card security code (CSC) located on the signature panel. VERIFY implied.
CSC-5	5-digit card security code (CSC) located on the signature panel. VERIFY implied.
CSC-345	Generate 5-byte, 4-byte, or 3-byte values when given an account number and an expiration date. GENERATE implied.
Operation (One, optional)
VERIFY	Specifies verification of the value presented in the validation values variable.
GENERATE	Specifies generation of the value presented in the validation values variable.

transaction_key_length

Direction:	Input
Type:	Integer

The length of the transaction_key parameter.

transaction_key

Direction:	Input
Type:	String

The label name or internal token of a MAC or MACVER class key. The key can be single or double length.

For a TR-31 key, the token must have the following attributes:

• TR-31 key usage: C0
• Algorithm: D or T
• TR-31 mode of key use: C, G, or V

The mode of key use must match the rule array Operation rule. For VERIFY use C or V, and for GENERATE use C or G.

transaction_info_length

Direction:	Input
Type:	Integer

The length of the transaction_info parameter. For the American Express CSC codes, the length must be 19.

transaction_info

Direction:	Input
Type:	String

For American Express, this is a 19-byte field containing the concatenation of the 4-byte expiration data (in the format YYMM) and the 15-byte American Express account number. Provide the information in character format.

validation_values_length

Direction:	Input/Output
Type:	Integer

The length of the validation_values parameter. Maximum value for this field is 64.

validation_values

Direction:	Input
Type:	String

This variable contains American Express CSC values. The data is output for GENERATE and input for VERIFY. See Table 2.

Table 2. Values for Transaction Validation validation_values parameter

Values for Transaction Validation validation_values parameter

Operation	Element description
GENERATE and CSC-345	5555544444333 where: 55555 = CSC 5 value 4444  = CSC 4 value 333   = CSC 3 value
VERIFY and CSC-3	333 = CSC 3 value
VERIFY and CSC-4	4444 = CSC 4 value
VERIFY and CSC-5	55555 = CSC 5 value