Skip to main content

userAccountDetails

These are the user account details from the merchant website.

    addCardAttemptsForLastDay number

    This is the number of Add Card attempts in the last 24 hours.

    changedDate date

    This is the date that the cardholder’s account with the 3DS Requestor was last changed. The ISO 8601 date format is expected, i.e., YYYY-MM-DD.

    changedRange string

    Possible values: [DURING_TRANSACTION, LESS_THAN_THIRTY_DAYS, THIRTY_TO_SIXTY_DAYS, MORE_THAN_SIXTY_DAYS]

    This is the length of time between the most recent change to the cardholder’s account information and the API call of the current transaction.

    createdDate date

    This is the date when the cardholder opened the account with the 3DS Requestor. The ISO 8601 date format is expected, i.e., YYYY-MM-DD.

    createdRange string

    Possible values: [NO_ACCOUNT, DURING_TRANSACTION, LESS_THAN_THIRTY_DAYS, THIRTY_TO_SIXTY_DAYS, MORE_THAN_SIXTY_DAYS]

    This is the length of time between the cardholder opening the account with the 3DS Requestor and the API call of the current transaction.

    passwordChangedDate date

    This is the date when the cardholder’s account was reset or the password was changed. The ISO 8601 date format is expected, i.e., YYYY-MM-DD.

    passwordChangedRange string

    Possible values: [NO_CHANGE, DURING_TRANSACTION, LESS_THAN_THIRTY_DAYS, THIRTY_TO_SIXTY_DAYS, MORE_THAN_SIXTY_DAYS]

    This is the length of time between the most recent password change or cardholder account reset and the API call of the current transaction.

    suspiciousAccountActivity boolean

    This indicates whether the 3DS Requestor has experienced suspicious activity, including previous fraud, on the cardholder account.

    totalPurchasesSixMonthCount number

    Possible values: <= 9999

    This is the total number of purchases from this cardholder account in the previous six months.

    transactionCountForPreviousDay number

    Possible values: <= 999

    This is the number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous 24 hours.

    transactionCountForPreviousYear number

    Possible values: <= 999

    This is the number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous year.

    shippingDetailsUsage

    object

    This is the shipping usage information.

    cardHolderNameMatch boolean

    This indicates whether the cardholder name on the account is identical to the shipping name used for this transaction.

    initialUsageDate date

    This is the date when the shipping address for this transaction was first used with the 3DS Requestor. The ISO 8601 date format is expected, i.e., YYYY-MM-DD.

    initialUsageRange string

    Possible values: [CURRENT_TRANSACTION, LESS_THAN_THIRTY_DAYS, THIRTY_TO_SIXTY_DAYS, MORE_THAN_SIXTY_DAYS]

    userLogin

    object

    This is the cardholder login information.

    authenticationMethod string

    Possible values: [NO_LOGIN, INTERNAL_CREDENTIALS, FEDERATED_ID, ISSUER_CREDENTIALS, THIRD_PARY_AUTHENTICATION, FIDO_AUTHENTICATOR]

    This is the mechanism used by the cardholder to authenticate to the 3DS Requestor.

    data string

    Possible values: <= 2048 characters

    This field is reserved for future iterations of 3D Secure 2.

    time date-time

    This is the date and time of the cardholder authentication. The ISO 8601 date format is expected, i.e., YYYY-MM-DD-THH:MM:SSZ.

    paymentAccountDetails

    object

    These are the details of the current payment account of the cardholder.

    createdRange string

    Possible values: [NO_ACCOUNT, DURING_TRANSACTION, LESS_THAN_THIRTY_DAYS, THIRTY_TO_SIXTY_DAYS, MORE_THAN_SIXTY_DAYS]

    This indicates the length of time that the payment account was enrolled in the cardholder’s account with the 3DS Requestor.

    createdDate date

    This is the date that the cardholder opened the account with the 3DS Requestor. The ISO 8601 date format is expected, i.e., YYYY-MM-DD.e.

    priorThreeDSAuthentication

    object

    This is the previous authentication information used with current merchant, cardholder, and card.

    id string

    Possible values: <= 36 characters

    This is the previous authentication ID for the cardholder.

    Note: For recurring payments, this is the authenticationId of the first authentication.

    data string

    This field is reserved for future iterations of 3D Secure 2.

    method string

    Possible values: [FRICTIONLESS_AUTHENTICATION, ACS_CHALLENGE, AVS_VERIFIED, OTHER_ISSUER_METHOD]

    This is the mechanism used previously by the cardholder to authenticate to the 3DS Requestor.

    time date-time

    This is the date and time of the cardholder authentication. The ISO 8601 date format is expected, i.e., YYYY-MM-DD-THH:MM:SSZ.

    travelDetails

    object

    These are the Amex-specific travel details.

    isAirTravel boolean

    This indicates whether the transaction is an air travel related purchase, e.g., a ticket purchase

    airlineCarrier string

    Possible values: <= 256 characters

    This is the selected airline carrier.

    departureDate date

    This is the date of departure in the time zone of the departure location. The ISO 8601 date format is expected, i.e., YYYY-MM-DD.

    destination string

    Possible values: <= 5 characters

    This is the airport code of the destination airport.

    origin string

    Possible values: <= 5 characters

    This is the airport code of the originating airport.

    passengerFirstName string

    Possible values: <= 99 characters

    This is the first name of the cardholder from the billing details.

    passengerLastName string

    Possible values: <= 99 characters

    This is the last name of the cardholder from the billing details.