AuthenticationStatus Property

Indicates whether a transaction qualifies as an authenticated transaction.

Syntax

 mpi.getAuthenticationStatus([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 getAuthenticationStatus([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 setAuthenticationStatus([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 indicates whether the transaction has been authenticated or not. Valid status codes and their explanations are listed below:


Y	The customer was successfully authenticated. All data needed for clearing is included in the AuthenticationCAVV, AuthenticationECI, AuthenticationTime, and AuthenticationCAVVAlgorithm properties.
N	The customer failed authentication, and the transaction is denied.
U	Authentication could not be performed due to technical or other problems.
A	Authentication was not available, but functionality was available (through the issuer, Visa, or a third party) to generate a proof of authentication attempt.

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

Data Type