AuthenticationCAVV Property

Cardholder Authentication Verification Value.

Syntax

 mpi.getAuthenticationCAVV([callback])

Default Value

""

Callback

The 'callback' parameter specifies a function which will be called when the operation completes (or an error is encountered). If the 'callback' parameter is not specified, then the method will block and will not return until the operation completes (or an error is encountered).

The callback for the getAuthenticationCAVV([callback]) method is defined as:

function(err, data){ }

'err' is the error that occurred. If there was no error, then 'err' is 'null'.

'data' is the value returned by the method.

The callback for the setAuthenticationCAVV([callback]) method is defined as:

function(err){ }

'err' is the error that occurred. If there was no error, then 'err' is 'null'.

'err' has 2 properties which hold detailed information:

err.code
err.message

Remarks

This property is determined by the Access Control Server (ACS), and is filled after receiving a response to a Payer Authentication Request (PAReq). This property contains a 28-byte Base-64 encoded Cardholder Authentication Verification Value (CAVV). The data contained within this property is only valid if the AuthenticationStatus is "Y", or if a proof of authentication attempt was generated (AuthenticationStatus is "A").

Some regions may require that this value be included in the VIP authorization message.

Note: When using American Express SafeKey, this value may be referred to as the American Express Verification Value (AEVV).

This property is read-only and not available at design time.

Data Type

String