authenticationValue

The authenticationValue element is an optional child of the cardholderAuthentication element with many uses.

This element defines either the Visa CAVV value (fixed length 28 characters), the Mastercard UCAF value (variable length up to 32 characters), or the American Express SafeKey authentication value.

You must include this element for Visa, Mastercard and American Express transactions, when the orderSource element is set to 3dsAuthenticated, as well as Mastercard and American Express transactions if the orderSource element is set to 3dsAttempted.

Mastercard transactions that use both 3DS and DSRP will have two cryptograms. Use the <authenticationValue> element for the 3DS cryptogram and the <tokenAuthenticationValue> element for the DSRP cryptogram. In this case set <orderSource> to either 3DSAuthenticated or 3DSAttempted.

You also use this element to send Worldpay a wallet cryptogram (e.g., Apple Pay, Google Pay, etc.) if you decrypt the encrypted data returned from the wallet host. (see Merchant Decryption of Apple Pay PKPaymentToken, or Merchant Decryption Method).

The Apple Pay cryptogram is already BASE64 encoded. Do not double encode the cryptogram.

Additionally, you use this element to submit any Network Payment Token cryptogram.

Type = Base 64 Encoded String; minLength = N/A; maxLength = 512

Parent Elements:

cardholderAuthentication

Attributes:

None

Child Elements:

None