# ThreeDSecureAuthentication

Object · GraphQL API

Information about the 3D Secure authentication for a payment method.

## Fields

- `cavv` (`String`): The cardholder authentication verification value. This value should be appended to the authorization message signifying that the transaction has been successfully authenticated with 3D Secure. This value will be encoded according to the merchant's configuration with CardinalCommerce, with either Base64 or Hex encoding. The decoded value will be of different length and format per card scheme.
- `directoryServerTransactionId` (`String`): A unique identifier for the 3D Secure interaction with the card brand directory server.
- `eciFlag` (`ECommerceIndicator`): The electronic commerce indicator.
- `liabilityShifted` (`Boolean`): A boolean indicating if the card has received liability shift.
- `liabilityShiftPossible` (`Boolean`): A boolean indicating if the card is eligible for liability shift.
- `cardEnrolled` (`ThreeDSecureCardEnrolled`): Indicates whether the card is enrolled in a 3D Secure program.
- `authenticationStatus` (`ThreeDSecureAuthenticationStatus`): The 3D Secure authentication status of the card.
- `version` (`String`): The version of the 3D Secure protocol used during authentication.
- `xId` (`String`): A unique identifier for the 3D Secure interaction with the provider.
- `threeDSecureServerTransactionId` (`String`): A unique identifier for the 3D Secure interaction with the 3D Secure server.
- `acsTransactionId` (`String`): A unique identifier for the 3D Secure interaction with the access control server.
- `paresStatus` (`ThreeDSecureAuthenticationStatusIndicator`): Indicates the current status of the 3D Secure authentication from the 3D Secure server for 3D Secure 1.0 authentications.
- `transactionStatus` (`ThreeDSecureAuthenticationStatusIndicator`): Indicates the current status of the 3D Secure authentication from the 3D Secure server for 3D Secure 2.0 authentications.
- `transactionStatusReason` (`String`): Indicates the reason for the transaction status. This will be null if status is `SUCCESSFUL_AUTHENTICATION`.

## Used by

- [ThreeDSecureDetails](/braintree/graphql/reference/types/three-d-secure-details) — Object; authentication

## GraphQL definition

```graphql
type ThreeDSecureAuthentication {
  cavv: String
  directoryServerTransactionId: String
  eciFlag: ECommerceIndicator
  liabilityShifted: Boolean
  liabilityShiftPossible: Boolean
  cardEnrolled: ThreeDSecureCardEnrolled
  authenticationStatus: ThreeDSecureAuthenticationStatus
  version: String
  xId: String
  threeDSecureServerTransactionId: String
  acsTransactionId: String
  paresStatus: ThreeDSecureAuthenticationStatusIndicator
  transactionStatus: ThreeDSecureAuthenticationStatusIndicator
  transactionStatusReason: String
}
```

---

[View the complete GraphQL schema on GitHub](https://raw.githubusercontent.com/braintree/graphql-api/refs/heads/master/schema.graphql)