Filter
Top Products
CCA Release 2.54 Transaction_Validation
Transaction_Validation (CSNBTRV)
Platform/
Product
OS/2 AIX Win NT/
2000
OS/400
IBM 4758-2 X X X X
The Transaction_Validation verb supports the generation and validation of
American Express card security codes (CSC).
The Transaction_Validation verb generates and verifies transaction values based
on information from the transaction and a cryptographic key. You select the
validation method, and either the generate or verify mode, through rule-array
keywords.
For the American Express process, the control vector supplied with the
cryptographic key must indicate a MAC or MACVER class. The control vector bits
zero to three can be B'0000'. Alternatively, you can ensure that a key is used
only for the American Express CSC process by specifying a MAC or a
MACVER-class key with control vector bits zero to three valued to B'0100'. The
control vector generate bit must be on (bit 20) if you request CSC generation and
the verify bit (bit 21) must be on if you request verification. See Figure C-3 on
page C-5 for information about the control vectors.
The verb returns the validation within the return code. A return code of zero
indicates the transaction has been validated, and return code four indicates the
transaction has not been validated.
Restrictions
The transaction_info and validation_values variables cannot exceed 256 bytes in
length. CSC codes must be 19 bytes in length.
Format
CSNBTRV
return_code Output Integer
reason_code Output Integer
exit_data_length In/Output Integer
exit_data In/Output String
rule_array_count Input Integer one or two
rule_array Input String rule_array_count * 8 bytes
transaction_key_identifier_length Input Integer 64
transaction_key_identifier Input String 64 bytes
transaction_info_length Input Integer
transaction_info Input String transaction_info_length bytes
validation_values_length In/Output Integer
validation_values In/Output String validation_values_length
bytes
Parameters
For the definitions of the return_code, reason_code, exit_data_length, and exit_data
parameters, see “Parameters Common to All Verbs” on page 1-11.
rule_array_count
The rule_array_count parameter points to an integer for the number of the
rule-array elements. The value must be one or two for this verb.
Chapter 8. Financial Services Support Verbs 8-75