lithic 0.1.0.pre.alpha.55 → 0.1.0

data/rbi/lithic/models/three_ds_authentication.rbi

@@ -0,0 +1,2432 @@
+# typed: strong
+
+module Lithic
+  module Models
+    class ThreeDSAuthentication < Lithic::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Lithic::ThreeDSAuthentication, Lithic::Internal::AnyHash)
+        end
+
+      # Globally unique identifier for the 3DS authentication. Permitted values:
+      # 36-digit version 4 UUID (including hyphens).
+      sig { returns(String) }
+      attr_accessor :token
+
+      # Type of account/card that is being used for the transaction. Maps to EMV 3DS
+      # field `acctType`.
+      sig do
+        returns(
+          T.nilable(Lithic::ThreeDSAuthentication::AccountType::TaggedSymbol)
+        )
+      end
+      attr_accessor :account_type
+
+      # Indicates the outcome of the 3DS authentication process.
+      sig do
+        returns(
+          Lithic::ThreeDSAuthentication::AuthenticationResult::TaggedSymbol
+        )
+      end
+      attr_accessor :authentication_result
+
+      # Indicates whether the expiration date provided by the cardholder during checkout
+      # matches Lithic's record of the card's expiration date.
+      sig do
+        returns(Lithic::ThreeDSAuthentication::CardExpiryCheck::TaggedSymbol)
+      end
+      attr_accessor :card_expiry_check
+
+      # Globally unique identifier for the card on which the 3DS authentication has
+      # occurred. Permitted values: 36-digit version 4 UUID (including hyphens).
+      sig { returns(String) }
+      attr_accessor :card_token
+
+      # Object containing data about the cardholder provided during the transaction.
+      sig { returns(Lithic::ThreeDSAuthentication::Cardholder) }
+      attr_reader :cardholder
+
+      sig do
+        params(
+          cardholder: Lithic::ThreeDSAuthentication::Cardholder::OrHash
+        ).void
+      end
+      attr_writer :cardholder
+
+      # Channel in which the authentication occurs. Maps to EMV 3DS field
+      # `deviceChannel`.
+      sig { returns(Lithic::ThreeDSAuthentication::Channel::TaggedSymbol) }
+      attr_accessor :channel
+
+      # Date and time when the authentication was created in Lithic's system. Permitted
+      # values: Date string in the ISO 8601 format yyyy-MM-dd'T'hh:mm:ssZ.
+      sig { returns(Time) }
+      attr_accessor :created
+
+      # Object containing data about the merchant involved in the e-commerce
+      # transaction.
+      sig { returns(Lithic::ThreeDSAuthentication::Merchant) }
+      attr_reader :merchant
+
+      sig do
+        params(merchant: Lithic::ThreeDSAuthentication::Merchant::OrHash).void
+      end
+      attr_writer :merchant
+
+      # Either PAYMENT_AUTHENTICATION or NON_PAYMENT_AUTHENTICATION. For
+      # NON_PAYMENT_AUTHENTICATION, additional_data and transaction fields are not
+      # populated.
+      sig do
+        returns(Lithic::ThreeDSAuthentication::MessageCategory::TaggedSymbol)
+      end
+      attr_accessor :message_category
+
+      # Indicates whether a challenge is requested for this transaction
+      #
+      # - `NO_PREFERENCE` - No Preference
+      # - `NO_CHALLENGE_REQUESTED` - No Challenge Requested
+      # - `CHALLENGE_PREFERENCE` - Challenge requested (3DS Requestor preference)
+      # - `CHALLENGE_MANDATE` - Challenge requested (Mandate)
+      # - `NO_CHALLENGE_RISK_ALREADY_ASSESSED` - No Challenge requested (Transactional
+      #   risk analysis is already performed)
+      # - `DATA_SHARE_ONLY` - No Challenge requested (Data Share Only)
+      # - `OTHER` - Other indicators not captured by above. These are rarely used
+      sig do
+        returns(
+          Lithic::ThreeDSAuthentication::ThreeDSRequestorChallengeIndicator::TaggedSymbol
+        )
+      end
+      attr_accessor :three_ds_requestor_challenge_indicator
+
+      # Object containing additional data about the 3DS request that is beyond the EMV
+      # 3DS standard spec (e.g., specific fields that only certain card networks send
+      # but are not required across all 3DS requests).
+      sig { returns(T.nilable(Lithic::ThreeDSAuthentication::AdditionalData)) }
+      attr_reader :additional_data
+
+      sig do
+        params(
+          additional_data:
+            T.nilable(Lithic::ThreeDSAuthentication::AdditionalData::OrHash)
+        ).void
+      end
+      attr_writer :additional_data
+
+      # Object containing data about the app used in the e-commerce transaction. Present
+      # if the channel is 'APP_BASED'.
+      sig { returns(T.nilable(Lithic::ThreeDSAuthentication::App)) }
+      attr_reader :app
+
+      sig do
+        params(app: T.nilable(Lithic::ThreeDSAuthentication::App::OrHash)).void
+      end
+      attr_writer :app
+
+      # Type of authentication request - i.e., the type of transaction or interaction is
+      # causing the merchant to request an authentication. Maps to EMV 3DS field
+      # `threeDSRequestorAuthenticationInd`.
+      sig do
+        returns(
+          T.nilable(
+            Lithic::ThreeDSAuthentication::AuthenticationRequestType::TaggedSymbol
+          )
+        )
+      end
+      attr_accessor :authentication_request_type
+
+      # Object containing data about the browser used in the e-commerce transaction.
+      # Present if the channel is 'BROWSER'.
+      sig { returns(T.nilable(Lithic::ThreeDSAuthentication::Browser)) }
+      attr_reader :browser
+
+      sig do
+        params(
+          browser: T.nilable(Lithic::ThreeDSAuthentication::Browser::OrHash)
+        ).void
+      end
+      attr_writer :browser
+
+      # Metadata about the challenge method and delivery. Only present when a challenge
+      # is triggered.
+      sig do
+        returns(T.nilable(Lithic::ThreeDSAuthentication::ChallengeMetadata))
+      end
+      attr_reader :challenge_metadata
+
+      sig do
+        params(
+          challenge_metadata:
+            T.nilable(Lithic::ThreeDSAuthentication::ChallengeMetadata::OrHash)
+        ).void
+      end
+      attr_writer :challenge_metadata
+
+      # Entity that orchestrates the challenge. This won't be set for authentications
+      # for which a decision has not yet been made (e.g. in-flight customer decisioning
+      # request).
+      sig do
+        returns(
+          T.nilable(
+            Lithic::ThreeDSAuthentication::ChallengeOrchestratedBy::TaggedSymbol
+          )
+        )
+      end
+      attr_accessor :challenge_orchestrated_by
+
+      # Entity that made the authentication decision. This won't be set for
+      # authentications for which a decision has not yet been made (e.g. in-flight
+      # customer decisioning request).
+      sig do
+        returns(
+          T.nilable(Lithic::ThreeDSAuthentication::DecisionMadeBy::TaggedSymbol)
+        )
+      end
+      attr_accessor :decision_made_by
+
+      # Type of 3DS Requestor Initiated (3RI) request — i.e., a 3DS authentication that
+      # takes place at the initiation of the merchant rather than the cardholder. The
+      # most common example of this is where a merchant is authenticating before billing
+      # for a recurring transaction such as a pay TV subscription or a utility bill.
+      # Maps to EMV 3DS field `threeRIInd`.
+      sig do
+        returns(
+          T.nilable(
+            Lithic::ThreeDSAuthentication::ThreeRiRequestType::TaggedSymbol
+          )
+        )
+      end
+      attr_accessor :three_ri_request_type
+
+      # Object containing data about the e-commerce transaction for which the merchant
+      # is requesting authentication.
+      sig { returns(T.nilable(Lithic::ThreeDSAuthentication::Transaction)) }
+      attr_reader :transaction
+
+      sig do
+        params(
+          transaction:
+            T.nilable(Lithic::ThreeDSAuthentication::Transaction::OrHash)
+        ).void
+      end
+      attr_writer :transaction
+
+      # Represents a 3DS authentication
+      sig do
+        params(
+          token: String,
+          account_type:
+            T.nilable(Lithic::ThreeDSAuthentication::AccountType::OrSymbol),
+          authentication_result:
+            Lithic::ThreeDSAuthentication::AuthenticationResult::OrSymbol,
+          card_expiry_check:
+            Lithic::ThreeDSAuthentication::CardExpiryCheck::OrSymbol,
+          card_token: String,
+          cardholder: Lithic::ThreeDSAuthentication::Cardholder::OrHash,
+          channel: Lithic::ThreeDSAuthentication::Channel::OrSymbol,
+          created: Time,
+          merchant: Lithic::ThreeDSAuthentication::Merchant::OrHash,
+          message_category:
+            Lithic::ThreeDSAuthentication::MessageCategory::OrSymbol,
+          three_ds_requestor_challenge_indicator:
+            Lithic::ThreeDSAuthentication::ThreeDSRequestorChallengeIndicator::OrSymbol,
+          additional_data:
+            T.nilable(Lithic::ThreeDSAuthentication::AdditionalData::OrHash),
+          app: T.nilable(Lithic::ThreeDSAuthentication::App::OrHash),
+          authentication_request_type:
+            T.nilable(
+              Lithic::ThreeDSAuthentication::AuthenticationRequestType::OrSymbol
+            ),
+          browser: T.nilable(Lithic::ThreeDSAuthentication::Browser::OrHash),
+          challenge_metadata:
+            T.nilable(Lithic::ThreeDSAuthentication::ChallengeMetadata::OrHash),
+          challenge_orchestrated_by:
+            T.nilable(
+              Lithic::ThreeDSAuthentication::ChallengeOrchestratedBy::OrSymbol
+            ),
+          decision_made_by:
+            T.nilable(Lithic::ThreeDSAuthentication::DecisionMadeBy::OrSymbol),
+          three_ri_request_type:
+            T.nilable(
+              Lithic::ThreeDSAuthentication::ThreeRiRequestType::OrSymbol
+            ),
+          transaction:
+            T.nilable(Lithic::ThreeDSAuthentication::Transaction::OrHash)
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Globally unique identifier for the 3DS authentication. Permitted values:
+        # 36-digit version 4 UUID (including hyphens).
+        token:,
+        # Type of account/card that is being used for the transaction. Maps to EMV 3DS
+        # field `acctType`.
+        account_type:,
+        # Indicates the outcome of the 3DS authentication process.
+        authentication_result:,
+        # Indicates whether the expiration date provided by the cardholder during checkout
+        # matches Lithic's record of the card's expiration date.
+        card_expiry_check:,
+        # Globally unique identifier for the card on which the 3DS authentication has
+        # occurred. Permitted values: 36-digit version 4 UUID (including hyphens).
+        card_token:,
+        # Object containing data about the cardholder provided during the transaction.
+        cardholder:,
+        # Channel in which the authentication occurs. Maps to EMV 3DS field
+        # `deviceChannel`.
+        channel:,
+        # Date and time when the authentication was created in Lithic's system. Permitted
+        # values: Date string in the ISO 8601 format yyyy-MM-dd'T'hh:mm:ssZ.
+        created:,
+        # Object containing data about the merchant involved in the e-commerce
+        # transaction.
+        merchant:,
+        # Either PAYMENT_AUTHENTICATION or NON_PAYMENT_AUTHENTICATION. For
+        # NON_PAYMENT_AUTHENTICATION, additional_data and transaction fields are not
+        # populated.
+        message_category:,
+        # Indicates whether a challenge is requested for this transaction
+        #
+        # - `NO_PREFERENCE` - No Preference
+        # - `NO_CHALLENGE_REQUESTED` - No Challenge Requested
+        # - `CHALLENGE_PREFERENCE` - Challenge requested (3DS Requestor preference)
+        # - `CHALLENGE_MANDATE` - Challenge requested (Mandate)
+        # - `NO_CHALLENGE_RISK_ALREADY_ASSESSED` - No Challenge requested (Transactional
+        #   risk analysis is already performed)
+        # - `DATA_SHARE_ONLY` - No Challenge requested (Data Share Only)
+        # - `OTHER` - Other indicators not captured by above. These are rarely used
+        three_ds_requestor_challenge_indicator:,
+        # Object containing additional data about the 3DS request that is beyond the EMV
+        # 3DS standard spec (e.g., specific fields that only certain card networks send
+        # but are not required across all 3DS requests).
+        additional_data: nil,
+        # Object containing data about the app used in the e-commerce transaction. Present
+        # if the channel is 'APP_BASED'.
+        app: nil,
+        # Type of authentication request - i.e., the type of transaction or interaction is
+        # causing the merchant to request an authentication. Maps to EMV 3DS field
+        # `threeDSRequestorAuthenticationInd`.
+        authentication_request_type: nil,
+        # Object containing data about the browser used in the e-commerce transaction.
+        # Present if the channel is 'BROWSER'.
+        browser: nil,
+        # Metadata about the challenge method and delivery. Only present when a challenge
+        # is triggered.
+        challenge_metadata: nil,
+        # Entity that orchestrates the challenge. This won't be set for authentications
+        # for which a decision has not yet been made (e.g. in-flight customer decisioning
+        # request).
+        challenge_orchestrated_by: nil,
+        # Entity that made the authentication decision. This won't be set for
+        # authentications for which a decision has not yet been made (e.g. in-flight
+        # customer decisioning request).
+        decision_made_by: nil,
+        # Type of 3DS Requestor Initiated (3RI) request — i.e., a 3DS authentication that
+        # takes place at the initiation of the merchant rather than the cardholder. The
+        # most common example of this is where a merchant is authenticating before billing
+        # for a recurring transaction such as a pay TV subscription or a utility bill.
+        # Maps to EMV 3DS field `threeRIInd`.
+        three_ri_request_type: nil,
+        # Object containing data about the e-commerce transaction for which the merchant
+        # is requesting authentication.
+        transaction: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            token: String,
+            account_type:
+              T.nilable(
+                Lithic::ThreeDSAuthentication::AccountType::TaggedSymbol
+              ),
+            authentication_result:
+              Lithic::ThreeDSAuthentication::AuthenticationResult::TaggedSymbol,
+            card_expiry_check:
+              Lithic::ThreeDSAuthentication::CardExpiryCheck::TaggedSymbol,
+            card_token: String,
+            cardholder: Lithic::ThreeDSAuthentication::Cardholder,
+            channel: Lithic::ThreeDSAuthentication::Channel::TaggedSymbol,
+            created: Time,
+            merchant: Lithic::ThreeDSAuthentication::Merchant,
+            message_category:
+              Lithic::ThreeDSAuthentication::MessageCategory::TaggedSymbol,
+            three_ds_requestor_challenge_indicator:
+              Lithic::ThreeDSAuthentication::ThreeDSRequestorChallengeIndicator::TaggedSymbol,
+            additional_data:
+              T.nilable(Lithic::ThreeDSAuthentication::AdditionalData),
+            app: T.nilable(Lithic::ThreeDSAuthentication::App),
+            authentication_request_type:
+              T.nilable(
+                Lithic::ThreeDSAuthentication::AuthenticationRequestType::TaggedSymbol
+              ),
+            browser: T.nilable(Lithic::ThreeDSAuthentication::Browser),
+            challenge_metadata:
+              T.nilable(Lithic::ThreeDSAuthentication::ChallengeMetadata),
+            challenge_orchestrated_by:
+              T.nilable(
+                Lithic::ThreeDSAuthentication::ChallengeOrchestratedBy::TaggedSymbol
+              ),
+            decision_made_by:
+              T.nilable(
+                Lithic::ThreeDSAuthentication::DecisionMadeBy::TaggedSymbol
+              ),
+            three_ri_request_type:
+              T.nilable(
+                Lithic::ThreeDSAuthentication::ThreeRiRequestType::TaggedSymbol
+              ),
+            transaction: T.nilable(Lithic::ThreeDSAuthentication::Transaction)
+          }
+        )
+      end
+      def to_hash
+      end
+
+      # Type of account/card that is being used for the transaction. Maps to EMV 3DS
+      # field `acctType`.
+      module AccountType
+        extend Lithic::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Lithic::ThreeDSAuthentication::AccountType)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        CREDIT =
+          T.let(
+            :CREDIT,
+            Lithic::ThreeDSAuthentication::AccountType::TaggedSymbol
+          )
+        DEBIT =
+          T.let(
+            :DEBIT,
+            Lithic::ThreeDSAuthentication::AccountType::TaggedSymbol
+          )
+        NOT_APPLICABLE =
+          T.let(
+            :NOT_APPLICABLE,
+            Lithic::ThreeDSAuthentication::AccountType::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[Lithic::ThreeDSAuthentication::AccountType::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+
+      # Indicates the outcome of the 3DS authentication process.
+      module AuthenticationResult
+        extend Lithic::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Lithic::ThreeDSAuthentication::AuthenticationResult)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        DECLINE =
+          T.let(
+            :DECLINE,
+            Lithic::ThreeDSAuthentication::AuthenticationResult::TaggedSymbol
+          )
+        SUCCESS =
+          T.let(
+            :SUCCESS,
+            Lithic::ThreeDSAuthentication::AuthenticationResult::TaggedSymbol
+          )
+        PENDING_CHALLENGE =
+          T.let(
+            :PENDING_CHALLENGE,
+            Lithic::ThreeDSAuthentication::AuthenticationResult::TaggedSymbol
+          )
+        PENDING_DECISION =
+          T.let(
+            :PENDING_DECISION,
+            Lithic::ThreeDSAuthentication::AuthenticationResult::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Lithic::ThreeDSAuthentication::AuthenticationResult::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+
+      # Indicates whether the expiration date provided by the cardholder during checkout
+      # matches Lithic's record of the card's expiration date.
+      module CardExpiryCheck
+        extend Lithic::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Lithic::ThreeDSAuthentication::CardExpiryCheck)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        MATCH =
+          T.let(
+            :MATCH,
+            Lithic::ThreeDSAuthentication::CardExpiryCheck::TaggedSymbol
+          )
+        MISMATCH =
+          T.let(
+            :MISMATCH,
+            Lithic::ThreeDSAuthentication::CardExpiryCheck::TaggedSymbol
+          )
+        NOT_PRESENT =
+          T.let(
+            :NOT_PRESENT,
+            Lithic::ThreeDSAuthentication::CardExpiryCheck::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Lithic::ThreeDSAuthentication::CardExpiryCheck::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+
+      class Cardholder < Lithic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Lithic::ThreeDSAuthentication::Cardholder,
+              Lithic::Internal::AnyHash
+            )
+          end
+
+        # Indicates whether the shipping address and billing address provided by the
+        # cardholder are the same. This value - and assessment of whether the addresses
+        # match - is provided directly in the 3DS request and is not determined by Lithic.
+        # Maps to EMV 3DS field `addrMatch`.
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_accessor :address_match
+
+        # Lithic's evaluation result comparing the transaction's address data with the
+        # cardholder KYC data if it exists. In the event Lithic does not have any
+        # Cardholder KYC data, or the transaction does not contain any address data,
+        # NOT_PRESENT will be returned
+        sig do
+          returns(
+            T.nilable(
+              Lithic::ThreeDSAuthentication::Cardholder::AddressOnFileMatch::TaggedSymbol
+            )
+          )
+        end
+        attr_reader :address_on_file_match
+
+        sig do
+          params(
+            address_on_file_match:
+              Lithic::ThreeDSAuthentication::Cardholder::AddressOnFileMatch::OrSymbol
+          ).void
+        end
+        attr_writer :address_on_file_match
+
+        # Object containing data on the billing address provided during the transaction.
+        sig do
+          returns(
+            T.nilable(Lithic::ThreeDSAuthentication::Cardholder::BillingAddress)
+          )
+        end
+        attr_reader :billing_address
+
+        sig do
+          params(
+            billing_address:
+              Lithic::ThreeDSAuthentication::Cardholder::BillingAddress::OrHash
+          ).void
+        end
+        attr_writer :billing_address
+
+        # Email address that is either provided by the cardholder or is on file with the
+        # merchant in a 3RI request. Maps to EMV 3DS field `email`.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :email
+
+        # Name of the cardholder. Maps to EMV 3DS field `cardholderName`.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :name
+
+        # Home phone number in E.164 format provided by the cardholder. Maps to EMV 3DS
+        # fields `homePhone.cc` and `homePhone.subscriber`.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :phone_number_home
+
+        # Mobile/cell phone number in E.164 format provided by the cardholder. Maps to EMV
+        # 3DS fields `mobilePhone.cc` and `mobilePhone.subscriber`.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :phone_number_mobile
+
+        # Work phone number in E.164 format provided by the cardholder. Maps to EMV 3DS
+        # fields `workPhone.cc` and `workPhone.subscriber`.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :phone_number_work
+
+        # Object containing data on the shipping address provided during the transaction.
+        sig do
+          returns(
+            T.nilable(
+              Lithic::ThreeDSAuthentication::Cardholder::ShippingAddress
+            )
+          )
+        end
+        attr_reader :shipping_address
+
+        sig do
+          params(
+            shipping_address:
+              Lithic::ThreeDSAuthentication::Cardholder::ShippingAddress::OrHash
+          ).void
+        end
+        attr_writer :shipping_address
+
+        # Object containing data about the cardholder provided during the transaction.
+        sig do
+          params(
+            address_match: T.nilable(T::Boolean),
+            address_on_file_match:
+              Lithic::ThreeDSAuthentication::Cardholder::AddressOnFileMatch::OrSymbol,
+            billing_address:
+              Lithic::ThreeDSAuthentication::Cardholder::BillingAddress::OrHash,
+            email: T.nilable(String),
+            name: T.nilable(String),
+            phone_number_home: T.nilable(String),
+            phone_number_mobile: T.nilable(String),
+            phone_number_work: T.nilable(String),
+            shipping_address:
+              Lithic::ThreeDSAuthentication::Cardholder::ShippingAddress::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Indicates whether the shipping address and billing address provided by the
+          # cardholder are the same. This value - and assessment of whether the addresses
+          # match - is provided directly in the 3DS request and is not determined by Lithic.
+          # Maps to EMV 3DS field `addrMatch`.
+          address_match: nil,
+          # Lithic's evaluation result comparing the transaction's address data with the
+          # cardholder KYC data if it exists. In the event Lithic does not have any
+          # Cardholder KYC data, or the transaction does not contain any address data,
+          # NOT_PRESENT will be returned
+          address_on_file_match: nil,
+          # Object containing data on the billing address provided during the transaction.
+          billing_address: nil,
+          # Email address that is either provided by the cardholder or is on file with the
+          # merchant in a 3RI request. Maps to EMV 3DS field `email`.
+          email: nil,
+          # Name of the cardholder. Maps to EMV 3DS field `cardholderName`.
+          name: nil,
+          # Home phone number in E.164 format provided by the cardholder. Maps to EMV 3DS
+          # fields `homePhone.cc` and `homePhone.subscriber`.
+          phone_number_home: nil,
+          # Mobile/cell phone number in E.164 format provided by the cardholder. Maps to EMV
+          # 3DS fields `mobilePhone.cc` and `mobilePhone.subscriber`.
+          phone_number_mobile: nil,
+          # Work phone number in E.164 format provided by the cardholder. Maps to EMV 3DS
+          # fields `workPhone.cc` and `workPhone.subscriber`.
+          phone_number_work: nil,
+          # Object containing data on the shipping address provided during the transaction.
+          shipping_address: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              address_match: T.nilable(T::Boolean),
+              address_on_file_match:
+                Lithic::ThreeDSAuthentication::Cardholder::AddressOnFileMatch::TaggedSymbol,
+              billing_address:
+                Lithic::ThreeDSAuthentication::Cardholder::BillingAddress,
+              email: T.nilable(String),
+              name: T.nilable(String),
+              phone_number_home: T.nilable(String),
+              phone_number_mobile: T.nilable(String),
+              phone_number_work: T.nilable(String),
+              shipping_address:
+                Lithic::ThreeDSAuthentication::Cardholder::ShippingAddress
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # Lithic's evaluation result comparing the transaction's address data with the
+        # cardholder KYC data if it exists. In the event Lithic does not have any
+        # Cardholder KYC data, or the transaction does not contain any address data,
+        # NOT_PRESENT will be returned
+        module AddressOnFileMatch
+          extend Lithic::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                Lithic::ThreeDSAuthentication::Cardholder::AddressOnFileMatch
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          MATCH =
+            T.let(
+              :MATCH,
+              Lithic::ThreeDSAuthentication::Cardholder::AddressOnFileMatch::TaggedSymbol
+            )
+          MATCH_ADDRESS_ONLY =
+            T.let(
+              :MATCH_ADDRESS_ONLY,
+              Lithic::ThreeDSAuthentication::Cardholder::AddressOnFileMatch::TaggedSymbol
+            )
+          MATCH_ZIP_ONLY =
+            T.let(
+              :MATCH_ZIP_ONLY,
+              Lithic::ThreeDSAuthentication::Cardholder::AddressOnFileMatch::TaggedSymbol
+            )
+          MISMATCH =
+            T.let(
+              :MISMATCH,
+              Lithic::ThreeDSAuthentication::Cardholder::AddressOnFileMatch::TaggedSymbol
+            )
+          NOT_PRESENT =
+            T.let(
+              :NOT_PRESENT,
+              Lithic::ThreeDSAuthentication::Cardholder::AddressOnFileMatch::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                Lithic::ThreeDSAuthentication::Cardholder::AddressOnFileMatch::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+
+        class BillingAddress < Lithic::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Lithic::ThreeDSAuthentication::Cardholder::BillingAddress,
+                Lithic::Internal::AnyHash
+              )
+            end
+
+          # First line of the street address provided by the cardholder.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :address1
+
+          # Second line of the street address provided by the cardholder.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :address2
+
+          # Third line of the street address provided by the cardholder.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :address3
+
+          # City of the address provided by the cardholder.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :city
+
+          # Country of the address provided by the cardholder in ISO 3166-1 alpha-3 format
+          # (e.g. USA)
+          sig { returns(T.nilable(String)) }
+          attr_accessor :country
+
+          # Postal code (e.g., ZIP code) of the address provided by the cardholder
+          sig { returns(T.nilable(String)) }
+          attr_accessor :postal_code
+
+          # Object containing data on the billing address provided during the transaction.
+          sig do
+            params(
+              address1: T.nilable(String),
+              address2: T.nilable(String),
+              address3: T.nilable(String),
+              city: T.nilable(String),
+              country: T.nilable(String),
+              postal_code: T.nilable(String)
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # First line of the street address provided by the cardholder.
+            address1: nil,
+            # Second line of the street address provided by the cardholder.
+            address2: nil,
+            # Third line of the street address provided by the cardholder.
+            address3: nil,
+            # City of the address provided by the cardholder.
+            city: nil,
+            # Country of the address provided by the cardholder in ISO 3166-1 alpha-3 format
+            # (e.g. USA)
+            country: nil,
+            # Postal code (e.g., ZIP code) of the address provided by the cardholder
+            postal_code: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                address1: T.nilable(String),
+                address2: T.nilable(String),
+                address3: T.nilable(String),
+                city: T.nilable(String),
+                country: T.nilable(String),
+                postal_code: T.nilable(String)
+              }
+            )
+          end
+          def to_hash
+          end
+        end
+
+        class ShippingAddress < Lithic::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Lithic::ThreeDSAuthentication::Cardholder::ShippingAddress,
+                Lithic::Internal::AnyHash
+              )
+            end
+
+          # First line of the street address provided by the cardholder.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :address1
+
+          # Second line of the street address provided by the cardholder.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :address2
+
+          # Third line of the street address provided by the cardholder.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :address3
+
+          # City of the address provided by the cardholder.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :city
+
+          # Country of the address provided by the cardholder in ISO 3166-1 alpha-3 format
+          # (e.g. USA)
+          sig { returns(T.nilable(String)) }
+          attr_accessor :country
+
+          # Postal code (e.g., ZIP code) of the address provided by the cardholder
+          sig { returns(T.nilable(String)) }
+          attr_accessor :postal_code
+
+          # Object containing data on the shipping address provided during the transaction.
+          sig do
+            params(
+              address1: T.nilable(String),
+              address2: T.nilable(String),
+              address3: T.nilable(String),
+              city: T.nilable(String),
+              country: T.nilable(String),
+              postal_code: T.nilable(String)
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # First line of the street address provided by the cardholder.
+            address1: nil,
+            # Second line of the street address provided by the cardholder.
+            address2: nil,
+            # Third line of the street address provided by the cardholder.
+            address3: nil,
+            # City of the address provided by the cardholder.
+            city: nil,
+            # Country of the address provided by the cardholder in ISO 3166-1 alpha-3 format
+            # (e.g. USA)
+            country: nil,
+            # Postal code (e.g., ZIP code) of the address provided by the cardholder
+            postal_code: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                address1: T.nilable(String),
+                address2: T.nilable(String),
+                address3: T.nilable(String),
+                city: T.nilable(String),
+                country: T.nilable(String),
+                postal_code: T.nilable(String)
+              }
+            )
+          end
+          def to_hash
+          end
+        end
+      end
+
+      # Channel in which the authentication occurs. Maps to EMV 3DS field
+      # `deviceChannel`.
+      module Channel
+        extend Lithic::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, Lithic::ThreeDSAuthentication::Channel) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        APP_BASED =
+          T.let(
+            :APP_BASED,
+            Lithic::ThreeDSAuthentication::Channel::TaggedSymbol
+          )
+        BROWSER =
+          T.let(:BROWSER, Lithic::ThreeDSAuthentication::Channel::TaggedSymbol)
+        THREE_DS_REQUESTOR_INITIATED =
+          T.let(
+            :THREE_DS_REQUESTOR_INITIATED,
+            Lithic::ThreeDSAuthentication::Channel::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[Lithic::ThreeDSAuthentication::Channel::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+
+      class Merchant < Lithic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Lithic::ThreeDSAuthentication::Merchant,
+              Lithic::Internal::AnyHash
+            )
+          end
+
+        # Object containing additional data indicating additional risk factors related to
+        # the e-commerce transaction.
+        sig { returns(Lithic::ThreeDSAuthentication::Merchant::RiskIndicator) }
+        attr_reader :risk_indicator
+
+        sig do
+          params(
+            risk_indicator:
+              Lithic::ThreeDSAuthentication::Merchant::RiskIndicator::OrHash
+          ).void
+        end
+        attr_writer :risk_indicator
+
+        # Merchant identifier as assigned by the acquirer. Maps to EMV 3DS field
+        # `acquirerMerchantId`. May not be present for non-payment authentications.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :id
+
+        # Country code of the merchant requesting 3DS authentication. Maps to EMV 3DS
+        # field `merchantCountryCode`. Permitted values: ISO 3166-1 alpha-3 country code
+        # (e.g., USA). May not be present for non-payment authentications.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :country
+
+        # Merchant category code assigned to the merchant that describes its business
+        # activity type. Maps to EMV 3DS field `mcc`. May not be present for non-payment
+        # authentications.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :mcc
+
+        # Name of the merchant. Maps to EMV 3DS field `merchantName`. May not be present
+        # for non-payment authentications.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :name
+
+        # Object containing data about the merchant involved in the e-commerce
+        # transaction.
+        sig do
+          params(
+            risk_indicator:
+              Lithic::ThreeDSAuthentication::Merchant::RiskIndicator::OrHash,
+            id: T.nilable(String),
+            country: T.nilable(String),
+            mcc: T.nilable(String),
+            name: T.nilable(String)
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Object containing additional data indicating additional risk factors related to
+          # the e-commerce transaction.
+          risk_indicator:,
+          # Merchant identifier as assigned by the acquirer. Maps to EMV 3DS field
+          # `acquirerMerchantId`. May not be present for non-payment authentications.
+          id: nil,
+          # Country code of the merchant requesting 3DS authentication. Maps to EMV 3DS
+          # field `merchantCountryCode`. Permitted values: ISO 3166-1 alpha-3 country code
+          # (e.g., USA). May not be present for non-payment authentications.
+          country: nil,
+          # Merchant category code assigned to the merchant that describes its business
+          # activity type. Maps to EMV 3DS field `mcc`. May not be present for non-payment
+          # authentications.
+          mcc: nil,
+          # Name of the merchant. Maps to EMV 3DS field `merchantName`. May not be present
+          # for non-payment authentications.
+          name: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              risk_indicator:
+                Lithic::ThreeDSAuthentication::Merchant::RiskIndicator,
+              id: T.nilable(String),
+              country: T.nilable(String),
+              mcc: T.nilable(String),
+              name: T.nilable(String)
+            }
+          )
+        end
+        def to_hash
+        end
+
+        class RiskIndicator < Lithic::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Lithic::ThreeDSAuthentication::Merchant::RiskIndicator,
+                Lithic::Internal::AnyHash
+              )
+            end
+
+          # In transactions with electronic delivery, email address to which merchandise is
+          # delivered. Maps to EMV 3DS field `deliveryEmailAddress`.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :delivery_email_address
+
+          # The delivery time frame for the merchandise. Maps to EMV 3DS field
+          # `deliveryTimeframe`.
+          sig do
+            returns(
+              T.nilable(
+                Lithic::ThreeDSAuthentication::Merchant::RiskIndicator::DeliveryTimeFrame::TaggedSymbol
+              )
+            )
+          end
+          attr_accessor :delivery_time_frame
+
+          # In prepaid or gift card purchase transactions, purchase amount total in major
+          # units (e.g., a purchase of USD $205.10 would be 205). Maps to EMV 3DS field
+          # `giftCardAmount`.
+          sig { returns(T.nilable(Integer)) }
+          attr_accessor :gift_card_amount
+
+          # In prepaid or gift card purchase transactions, count of individual prepaid or
+          # gift cards/codes purchased. Maps to EMV 3DS field `giftCardCount`.
+          sig { returns(T.nilable(Integer)) }
+          attr_accessor :gift_card_count
+
+          # In prepaid or gift card purchase transactions, currency code of the gift card.
+          # Maps to EMV 3DS field `giftCardCurr`. Permitted values: ISO 4217 three-character
+          # currency code (e.g., USD).
+          sig { returns(T.nilable(String)) }
+          attr_accessor :gift_card_currency
+
+          # Indicates whether the purchase is for merchandise that is available now or at a
+          # future date. Maps to EMV 3DS field `preOrderPurchaseInd`.
+          sig do
+            returns(
+              T.nilable(
+                Lithic::ThreeDSAuthentication::Merchant::RiskIndicator::OrderAvailability::TaggedSymbol
+              )
+            )
+          end
+          attr_accessor :order_availability
+
+          # In pre-order purchase transactions, the expected date that the merchandise will
+          # be available. Maps to EMV 3DS field `preOrderDate`. Permitted values: Date
+          # string in the ISO 8601 format yyyy-MM-dd'T'hh:mm:ssZ
+          sig { returns(T.nilable(Time)) }
+          attr_accessor :pre_order_available_date
+
+          # Indicates whether the cardholder is reordering previously purchased merchandise.
+          # Maps to EMV 3DS field `reorderItemsInd`.
+          sig do
+            returns(
+              T.nilable(
+                Lithic::ThreeDSAuthentication::Merchant::RiskIndicator::ReorderItems::TaggedSymbol
+              )
+            )
+          end
+          attr_accessor :reorder_items
+
+          # Shipping method that the cardholder chose for the transaction. If purchase
+          # includes one or more item, this indicator is used for the physical goods; if the
+          # purchase only includes digital goods, this indicator is used to describe the
+          # most expensive item purchased. Maps to EMV 3DS field `shipIndicator`.
+          sig do
+            returns(
+              T.nilable(
+                Lithic::ThreeDSAuthentication::Merchant::RiskIndicator::ShippingMethod::TaggedSymbol
+              )
+            )
+          end
+          attr_accessor :shipping_method
+
+          # Object containing additional data indicating additional risk factors related to
+          # the e-commerce transaction.
+          sig do
+            params(
+              delivery_email_address: T.nilable(String),
+              delivery_time_frame:
+                T.nilable(
+                  Lithic::ThreeDSAuthentication::Merchant::RiskIndicator::DeliveryTimeFrame::OrSymbol
+                ),
+              gift_card_amount: T.nilable(Integer),
+              gift_card_count: T.nilable(Integer),
+              gift_card_currency: T.nilable(String),
+              order_availability:
+                T.nilable(
+                  Lithic::ThreeDSAuthentication::Merchant::RiskIndicator::OrderAvailability::OrSymbol
+                ),
+              pre_order_available_date: T.nilable(Time),
+              reorder_items:
+                T.nilable(
+                  Lithic::ThreeDSAuthentication::Merchant::RiskIndicator::ReorderItems::OrSymbol
+                ),
+              shipping_method:
+                T.nilable(
+                  Lithic::ThreeDSAuthentication::Merchant::RiskIndicator::ShippingMethod::OrSymbol
+                )
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # In transactions with electronic delivery, email address to which merchandise is
+            # delivered. Maps to EMV 3DS field `deliveryEmailAddress`.
+            delivery_email_address: nil,
+            # The delivery time frame for the merchandise. Maps to EMV 3DS field
+            # `deliveryTimeframe`.
+            delivery_time_frame: nil,
+            # In prepaid or gift card purchase transactions, purchase amount total in major
+            # units (e.g., a purchase of USD $205.10 would be 205). Maps to EMV 3DS field
+            # `giftCardAmount`.
+            gift_card_amount: nil,
+            # In prepaid or gift card purchase transactions, count of individual prepaid or
+            # gift cards/codes purchased. Maps to EMV 3DS field `giftCardCount`.
+            gift_card_count: nil,
+            # In prepaid or gift card purchase transactions, currency code of the gift card.
+            # Maps to EMV 3DS field `giftCardCurr`. Permitted values: ISO 4217 three-character
+            # currency code (e.g., USD).
+            gift_card_currency: nil,
+            # Indicates whether the purchase is for merchandise that is available now or at a
+            # future date. Maps to EMV 3DS field `preOrderPurchaseInd`.
+            order_availability: nil,
+            # In pre-order purchase transactions, the expected date that the merchandise will
+            # be available. Maps to EMV 3DS field `preOrderDate`. Permitted values: Date
+            # string in the ISO 8601 format yyyy-MM-dd'T'hh:mm:ssZ
+            pre_order_available_date: nil,
+            # Indicates whether the cardholder is reordering previously purchased merchandise.
+            # Maps to EMV 3DS field `reorderItemsInd`.
+            reorder_items: nil,
+            # Shipping method that the cardholder chose for the transaction. If purchase
+            # includes one or more item, this indicator is used for the physical goods; if the
+            # purchase only includes digital goods, this indicator is used to describe the
+            # most expensive item purchased. Maps to EMV 3DS field `shipIndicator`.
+            shipping_method: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                delivery_email_address: T.nilable(String),
+                delivery_time_frame:
+                  T.nilable(
+                    Lithic::ThreeDSAuthentication::Merchant::RiskIndicator::DeliveryTimeFrame::TaggedSymbol
+                  ),
+                gift_card_amount: T.nilable(Integer),
+                gift_card_count: T.nilable(Integer),
+                gift_card_currency: T.nilable(String),
+                order_availability:
+                  T.nilable(
+                    Lithic::ThreeDSAuthentication::Merchant::RiskIndicator::OrderAvailability::TaggedSymbol
+                  ),
+                pre_order_available_date: T.nilable(Time),
+                reorder_items:
+                  T.nilable(
+                    Lithic::ThreeDSAuthentication::Merchant::RiskIndicator::ReorderItems::TaggedSymbol
+                  ),
+                shipping_method:
+                  T.nilable(
+                    Lithic::ThreeDSAuthentication::Merchant::RiskIndicator::ShippingMethod::TaggedSymbol
+                  )
+              }
+            )
+          end
+          def to_hash
+          end
+
+          # The delivery time frame for the merchandise. Maps to EMV 3DS field
+          # `deliveryTimeframe`.
+          module DeliveryTimeFrame
+            extend Lithic::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  Lithic::ThreeDSAuthentication::Merchant::RiskIndicator::DeliveryTimeFrame
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            ELECTRONIC_DELIVERY =
+              T.let(
+                :ELECTRONIC_DELIVERY,
+                Lithic::ThreeDSAuthentication::Merchant::RiskIndicator::DeliveryTimeFrame::TaggedSymbol
+              )
+            OVERNIGHT_SHIPPING =
+              T.let(
+                :OVERNIGHT_SHIPPING,
+                Lithic::ThreeDSAuthentication::Merchant::RiskIndicator::DeliveryTimeFrame::TaggedSymbol
+              )
+            SAME_DAY_SHIPPING =
+              T.let(
+                :SAME_DAY_SHIPPING,
+                Lithic::ThreeDSAuthentication::Merchant::RiskIndicator::DeliveryTimeFrame::TaggedSymbol
+              )
+            TWO_DAY_OR_MORE_SHIPPING =
+              T.let(
+                :TWO_DAY_OR_MORE_SHIPPING,
+                Lithic::ThreeDSAuthentication::Merchant::RiskIndicator::DeliveryTimeFrame::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  Lithic::ThreeDSAuthentication::Merchant::RiskIndicator::DeliveryTimeFrame::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+
+          # Indicates whether the purchase is for merchandise that is available now or at a
+          # future date. Maps to EMV 3DS field `preOrderPurchaseInd`.
+          module OrderAvailability
+            extend Lithic::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  Lithic::ThreeDSAuthentication::Merchant::RiskIndicator::OrderAvailability
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            FUTURE_AVAILABILITY =
+              T.let(
+                :FUTURE_AVAILABILITY,
+                Lithic::ThreeDSAuthentication::Merchant::RiskIndicator::OrderAvailability::TaggedSymbol
+              )
+            MERCHANDISE_AVAILABLE =
+              T.let(
+                :MERCHANDISE_AVAILABLE,
+                Lithic::ThreeDSAuthentication::Merchant::RiskIndicator::OrderAvailability::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  Lithic::ThreeDSAuthentication::Merchant::RiskIndicator::OrderAvailability::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+
+          # Indicates whether the cardholder is reordering previously purchased merchandise.
+          # Maps to EMV 3DS field `reorderItemsInd`.
+          module ReorderItems
+            extend Lithic::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  Lithic::ThreeDSAuthentication::Merchant::RiskIndicator::ReorderItems
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            FIRST_TIME_ORDERED =
+              T.let(
+                :FIRST_TIME_ORDERED,
+                Lithic::ThreeDSAuthentication::Merchant::RiskIndicator::ReorderItems::TaggedSymbol
+              )
+            REORDERED =
+              T.let(
+                :REORDERED,
+                Lithic::ThreeDSAuthentication::Merchant::RiskIndicator::ReorderItems::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  Lithic::ThreeDSAuthentication::Merchant::RiskIndicator::ReorderItems::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+
+          # Shipping method that the cardholder chose for the transaction. If purchase
+          # includes one or more item, this indicator is used for the physical goods; if the
+          # purchase only includes digital goods, this indicator is used to describe the
+          # most expensive item purchased. Maps to EMV 3DS field `shipIndicator`.
+          module ShippingMethod
+            extend Lithic::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  Lithic::ThreeDSAuthentication::Merchant::RiskIndicator::ShippingMethod
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            DIGITAL_GOODS =
+              T.let(
+                :DIGITAL_GOODS,
+                Lithic::ThreeDSAuthentication::Merchant::RiskIndicator::ShippingMethod::TaggedSymbol
+              )
+            LOCKER_DELIVERY =
+              T.let(
+                :LOCKER_DELIVERY,
+                Lithic::ThreeDSAuthentication::Merchant::RiskIndicator::ShippingMethod::TaggedSymbol
+              )
+            OTHER =
+              T.let(
+                :OTHER,
+                Lithic::ThreeDSAuthentication::Merchant::RiskIndicator::ShippingMethod::TaggedSymbol
+              )
+            PICK_UP_AND_GO_DELIVERY =
+              T.let(
+                :PICK_UP_AND_GO_DELIVERY,
+                Lithic::ThreeDSAuthentication::Merchant::RiskIndicator::ShippingMethod::TaggedSymbol
+              )
+            SHIP_TO_BILLING_ADDRESS =
+              T.let(
+                :SHIP_TO_BILLING_ADDRESS,
+                Lithic::ThreeDSAuthentication::Merchant::RiskIndicator::ShippingMethod::TaggedSymbol
+              )
+            SHIP_TO_NON_BILLING_ADDRESS =
+              T.let(
+                :SHIP_TO_NON_BILLING_ADDRESS,
+                Lithic::ThreeDSAuthentication::Merchant::RiskIndicator::ShippingMethod::TaggedSymbol
+              )
+            SHIP_TO_OTHER_VERIFIED_ADDRESS =
+              T.let(
+                :SHIP_TO_OTHER_VERIFIED_ADDRESS,
+                Lithic::ThreeDSAuthentication::Merchant::RiskIndicator::ShippingMethod::TaggedSymbol
+              )
+            SHIP_TO_STORE =
+              T.let(
+                :SHIP_TO_STORE,
+                Lithic::ThreeDSAuthentication::Merchant::RiskIndicator::ShippingMethod::TaggedSymbol
+              )
+            TRAVEL_AND_EVENT_TICKETS =
+              T.let(
+                :TRAVEL_AND_EVENT_TICKETS,
+                Lithic::ThreeDSAuthentication::Merchant::RiskIndicator::ShippingMethod::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  Lithic::ThreeDSAuthentication::Merchant::RiskIndicator::ShippingMethod::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+        end
+      end
+
+      # Either PAYMENT_AUTHENTICATION or NON_PAYMENT_AUTHENTICATION. For
+      # NON_PAYMENT_AUTHENTICATION, additional_data and transaction fields are not
+      # populated.
+      module MessageCategory
+        extend Lithic::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Lithic::ThreeDSAuthentication::MessageCategory)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        NON_PAYMENT_AUTHENTICATION =
+          T.let(
+            :NON_PAYMENT_AUTHENTICATION,
+            Lithic::ThreeDSAuthentication::MessageCategory::TaggedSymbol
+          )
+        PAYMENT_AUTHENTICATION =
+          T.let(
+            :PAYMENT_AUTHENTICATION,
+            Lithic::ThreeDSAuthentication::MessageCategory::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Lithic::ThreeDSAuthentication::MessageCategory::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+
+      # Indicates whether a challenge is requested for this transaction
+      #
+      # - `NO_PREFERENCE` - No Preference
+      # - `NO_CHALLENGE_REQUESTED` - No Challenge Requested
+      # - `CHALLENGE_PREFERENCE` - Challenge requested (3DS Requestor preference)
+      # - `CHALLENGE_MANDATE` - Challenge requested (Mandate)
+      # - `NO_CHALLENGE_RISK_ALREADY_ASSESSED` - No Challenge requested (Transactional
+      #   risk analysis is already performed)
+      # - `DATA_SHARE_ONLY` - No Challenge requested (Data Share Only)
+      # - `OTHER` - Other indicators not captured by above. These are rarely used
+      module ThreeDSRequestorChallengeIndicator
+        extend Lithic::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(
+              Symbol,
+              Lithic::ThreeDSAuthentication::ThreeDSRequestorChallengeIndicator
+            )
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        NO_PREFERENCE =
+          T.let(
+            :NO_PREFERENCE,
+            Lithic::ThreeDSAuthentication::ThreeDSRequestorChallengeIndicator::TaggedSymbol
+          )
+        NO_CHALLENGE_REQUESTED =
+          T.let(
+            :NO_CHALLENGE_REQUESTED,
+            Lithic::ThreeDSAuthentication::ThreeDSRequestorChallengeIndicator::TaggedSymbol
+          )
+        CHALLENGE_PREFERENCE =
+          T.let(
+            :CHALLENGE_PREFERENCE,
+            Lithic::ThreeDSAuthentication::ThreeDSRequestorChallengeIndicator::TaggedSymbol
+          )
+        CHALLENGE_MANDATE =
+          T.let(
+            :CHALLENGE_MANDATE,
+            Lithic::ThreeDSAuthentication::ThreeDSRequestorChallengeIndicator::TaggedSymbol
+          )
+        NO_CHALLENGE_RISK_ALREADY_ASSESSED =
+          T.let(
+            :NO_CHALLENGE_RISK_ALREADY_ASSESSED,
+            Lithic::ThreeDSAuthentication::ThreeDSRequestorChallengeIndicator::TaggedSymbol
+          )
+        DATA_SHARE_ONLY =
+          T.let(
+            :DATA_SHARE_ONLY,
+            Lithic::ThreeDSAuthentication::ThreeDSRequestorChallengeIndicator::TaggedSymbol
+          )
+        OTHER =
+          T.let(
+            :OTHER,
+            Lithic::ThreeDSAuthentication::ThreeDSRequestorChallengeIndicator::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Lithic::ThreeDSAuthentication::ThreeDSRequestorChallengeIndicator::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+
+      class AdditionalData < Lithic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Lithic::ThreeDSAuthentication::AdditionalData,
+              Lithic::Internal::AnyHash
+            )
+          end
+
+        # Mastercard only: Indicates whether the network would have considered the
+        # authentication request to be low risk or not.
+        sig do
+          returns(
+            T.nilable(
+              Lithic::ThreeDSAuthentication::AdditionalData::NetworkDecision::TaggedSymbol
+            )
+          )
+        end
+        attr_accessor :network_decision
+
+        # Mastercard only: Assessment by the network of the authentication risk level,
+        # with a higher value indicating a higher amount of risk. Permitted values:
+        # Integer between 0-950, in increments of 50.
+        sig { returns(T.nilable(Integer)) }
+        attr_accessor :network_risk_score
+
+        # Object containing additional data about the 3DS request that is beyond the EMV
+        # 3DS standard spec (e.g., specific fields that only certain card networks send
+        # but are not required across all 3DS requests).
+        sig do
+          params(
+            network_decision:
+              T.nilable(
+                Lithic::ThreeDSAuthentication::AdditionalData::NetworkDecision::OrSymbol
+              ),
+            network_risk_score: T.nilable(Integer)
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Mastercard only: Indicates whether the network would have considered the
+          # authentication request to be low risk or not.
+          network_decision: nil,
+          # Mastercard only: Assessment by the network of the authentication risk level,
+          # with a higher value indicating a higher amount of risk. Permitted values:
+          # Integer between 0-950, in increments of 50.
+          network_risk_score: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              network_decision:
+                T.nilable(
+                  Lithic::ThreeDSAuthentication::AdditionalData::NetworkDecision::TaggedSymbol
+                ),
+              network_risk_score: T.nilable(Integer)
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # Mastercard only: Indicates whether the network would have considered the
+        # authentication request to be low risk or not.
+        module NetworkDecision
+          extend Lithic::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                Lithic::ThreeDSAuthentication::AdditionalData::NetworkDecision
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          LOW_RISK =
+            T.let(
+              :LOW_RISK,
+              Lithic::ThreeDSAuthentication::AdditionalData::NetworkDecision::TaggedSymbol
+            )
+          NOT_LOW_RISK =
+            T.let(
+              :NOT_LOW_RISK,
+              Lithic::ThreeDSAuthentication::AdditionalData::NetworkDecision::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                Lithic::ThreeDSAuthentication::AdditionalData::NetworkDecision::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+
+      class App < Lithic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(Lithic::ThreeDSAuthentication::App, Lithic::Internal::AnyHash)
+          end
+
+        # Device model: e.g. "Apple iPhone 16".
+        sig { returns(T.nilable(String)) }
+        attr_accessor :device
+
+        # Raw device information - base64-encoded JSON object. Maps to EMV 3DS field
+        # `deviceInfo`.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :device_info
+
+        # IP address of the device.
+        sig { returns(T.nilable(String)) }
+        attr_reader :ip
+
+        sig { params(ip: String).void }
+        attr_writer :ip
+
+        # Latitude coordinate of current device location.
+        sig { returns(T.nilable(Float)) }
+        attr_accessor :latitude
+
+        # Device locale: e.g. "en-US".
+        sig { returns(T.nilable(String)) }
+        attr_accessor :locale
+
+        # Longitude coordinate of current device location.
+        sig { returns(T.nilable(Float)) }
+        attr_accessor :longitude
+
+        # Operating System: e.g. "Android 12", "iOS 17.1".
+        sig { returns(T.nilable(String)) }
+        attr_accessor :os
+
+        # Device platform: Android, iOS, Windows, etc.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :platform
+
+        # Screen height in pixels.
+        sig { returns(T.nilable(Integer)) }
+        attr_accessor :screen_height
+
+        # Screen width in pixels.
+        sig { returns(T.nilable(Integer)) }
+        attr_accessor :screen_width
+
+        # Time zone offset in minutes between UTC and device local time.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :time_zone
+
+        # Object containing data about the app used in the e-commerce transaction. Present
+        # if the channel is 'APP_BASED'.
+        sig do
+          params(
+            device: T.nilable(String),
+            device_info: T.nilable(String),
+            ip: String,
+            latitude: T.nilable(Float),
+            locale: T.nilable(String),
+            longitude: T.nilable(Float),
+            os: T.nilable(String),
+            platform: T.nilable(String),
+            screen_height: T.nilable(Integer),
+            screen_width: T.nilable(Integer),
+            time_zone: T.nilable(String)
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Device model: e.g. "Apple iPhone 16".
+          device: nil,
+          # Raw device information - base64-encoded JSON object. Maps to EMV 3DS field
+          # `deviceInfo`.
+          device_info: nil,
+          # IP address of the device.
+          ip: nil,
+          # Latitude coordinate of current device location.
+          latitude: nil,
+          # Device locale: e.g. "en-US".
+          locale: nil,
+          # Longitude coordinate of current device location.
+          longitude: nil,
+          # Operating System: e.g. "Android 12", "iOS 17.1".
+          os: nil,
+          # Device platform: Android, iOS, Windows, etc.
+          platform: nil,
+          # Screen height in pixels.
+          screen_height: nil,
+          # Screen width in pixels.
+          screen_width: nil,
+          # Time zone offset in minutes between UTC and device local time.
+          time_zone: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              device: T.nilable(String),
+              device_info: T.nilable(String),
+              ip: String,
+              latitude: T.nilable(Float),
+              locale: T.nilable(String),
+              longitude: T.nilable(Float),
+              os: T.nilable(String),
+              platform: T.nilable(String),
+              screen_height: T.nilable(Integer),
+              screen_width: T.nilable(Integer),
+              time_zone: T.nilable(String)
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+
+      # Type of authentication request - i.e., the type of transaction or interaction is
+      # causing the merchant to request an authentication. Maps to EMV 3DS field
+      # `threeDSRequestorAuthenticationInd`.
+      module AuthenticationRequestType
+        extend Lithic::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(
+              Symbol,
+              Lithic::ThreeDSAuthentication::AuthenticationRequestType
+            )
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        ADD_CARD =
+          T.let(
+            :ADD_CARD,
+            Lithic::ThreeDSAuthentication::AuthenticationRequestType::TaggedSymbol
+          )
+        BILLING_AGREEMENT =
+          T.let(
+            :BILLING_AGREEMENT,
+            Lithic::ThreeDSAuthentication::AuthenticationRequestType::TaggedSymbol
+          )
+        DELAYED_SHIPMENT =
+          T.let(
+            :DELAYED_SHIPMENT,
+            Lithic::ThreeDSAuthentication::AuthenticationRequestType::TaggedSymbol
+          )
+        EMV_TOKEN_CARDHOLDER_VERIFICATION =
+          T.let(
+            :EMV_TOKEN_CARDHOLDER_VERIFICATION,
+            Lithic::ThreeDSAuthentication::AuthenticationRequestType::TaggedSymbol
+          )
+        INSTALLMENT_TRANSACTION =
+          T.let(
+            :INSTALLMENT_TRANSACTION,
+            Lithic::ThreeDSAuthentication::AuthenticationRequestType::TaggedSymbol
+          )
+        MAINTAIN_CARD =
+          T.let(
+            :MAINTAIN_CARD,
+            Lithic::ThreeDSAuthentication::AuthenticationRequestType::TaggedSymbol
+          )
+        PAYMENT_TRANSACTION =
+          T.let(
+            :PAYMENT_TRANSACTION,
+            Lithic::ThreeDSAuthentication::AuthenticationRequestType::TaggedSymbol
+          )
+        RECURRING_TRANSACTION =
+          T.let(
+            :RECURRING_TRANSACTION,
+            Lithic::ThreeDSAuthentication::AuthenticationRequestType::TaggedSymbol
+          )
+        SPLIT_PAYMENT =
+          T.let(
+            :SPLIT_PAYMENT,
+            Lithic::ThreeDSAuthentication::AuthenticationRequestType::TaggedSymbol
+          )
+        SPLIT_SHIPMENT =
+          T.let(
+            :SPLIT_SHIPMENT,
+            Lithic::ThreeDSAuthentication::AuthenticationRequestType::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Lithic::ThreeDSAuthentication::AuthenticationRequestType::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+
+      class Browser < Lithic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Lithic::ThreeDSAuthentication::Browser,
+              Lithic::Internal::AnyHash
+            )
+          end
+
+        # Content of the HTTP accept headers as sent from the cardholder's browser to the
+        # 3DS requestor (e.g., merchant or digital wallet).
+        sig { returns(T.nilable(String)) }
+        attr_accessor :accept_header
+
+        # IP address of the browser as returned by the HTTP headers to the 3DS requestor
+        # (e.g., merchant or digital wallet). Maps to EMV 3DS field `browserIP`.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :ip
+
+        # Indicates whether the cardholder's browser has the ability to execute Java. Maps
+        # to EMV 3DS field `browserJavaEnabled`.
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_accessor :java_enabled
+
+        # Indicates whether the cardholder's browser has the ability to execute
+        # JavaScript. Maps to EMV 3DS field `browserJavascriptEnabled`.
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_accessor :javascript_enabled
+
+        # Language of the cardholder's browser as defined in IETF BCP47. Maps to EMV 3DS
+        # field `browserLanguage`.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :language
+
+        # Time zone offset in minutes between UTC and browser local time. Maps to EMV 3DS
+        # field `browserTz`.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :time_zone
+
+        # Content of the HTTP user-agent header. Maps to EMV 3DS field `browserUserAgent`.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :user_agent
+
+        # Object containing data about the browser used in the e-commerce transaction.
+        # Present if the channel is 'BROWSER'.
+        sig do
+          params(
+            accept_header: T.nilable(String),
+            ip: T.nilable(String),
+            java_enabled: T.nilable(T::Boolean),
+            javascript_enabled: T.nilable(T::Boolean),
+            language: T.nilable(String),
+            time_zone: T.nilable(String),
+            user_agent: T.nilable(String)
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Content of the HTTP accept headers as sent from the cardholder's browser to the
+          # 3DS requestor (e.g., merchant or digital wallet).
+          accept_header: nil,
+          # IP address of the browser as returned by the HTTP headers to the 3DS requestor
+          # (e.g., merchant or digital wallet). Maps to EMV 3DS field `browserIP`.
+          ip: nil,
+          # Indicates whether the cardholder's browser has the ability to execute Java. Maps
+          # to EMV 3DS field `browserJavaEnabled`.
+          java_enabled: nil,
+          # Indicates whether the cardholder's browser has the ability to execute
+          # JavaScript. Maps to EMV 3DS field `browserJavascriptEnabled`.
+          javascript_enabled: nil,
+          # Language of the cardholder's browser as defined in IETF BCP47. Maps to EMV 3DS
+          # field `browserLanguage`.
+          language: nil,
+          # Time zone offset in minutes between UTC and browser local time. Maps to EMV 3DS
+          # field `browserTz`.
+          time_zone: nil,
+          # Content of the HTTP user-agent header. Maps to EMV 3DS field `browserUserAgent`.
+          user_agent: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              accept_header: T.nilable(String),
+              ip: T.nilable(String),
+              java_enabled: T.nilable(T::Boolean),
+              javascript_enabled: T.nilable(T::Boolean),
+              language: T.nilable(String),
+              time_zone: T.nilable(String),
+              user_agent: T.nilable(String)
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+
+      class ChallengeMetadata < Lithic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Lithic::ThreeDSAuthentication::ChallengeMetadata,
+              Lithic::Internal::AnyHash
+            )
+          end
+
+        # The type of challenge method used for authentication.
+        sig do
+          returns(
+            Lithic::ThreeDSAuthentication::ChallengeMetadata::MethodType::TaggedSymbol
+          )
+        end
+        attr_accessor :method_type
+
+        # Indicates the status of the challenge
+        #
+        # - SUCCESS - Cardholder completed the challenge successfully
+        # - PENDING - Challenge was issued to the cardholder and was not completed yet
+        # - SMS_DELIVERY_FAILED - Lithic confirmed undeliverability of the SMS to the
+        #   provided phone number. Relevant only for SMS_OTP method
+        # - CARDHOLDER_TIMEOUT - Cardholder failed to complete the challenge within the
+        #   given challenge TTL
+        # - CANCELED_VIA_CHALLENGE_UI - Cardholder canceled the challenge by selecting
+        #   "cancel" on the challenge UI
+        # - CANCELED_OOB - Cardholder canceled the challenge out of band
+        # - ATTEMPTS_EXCEEDED - Cardholder failed the challenge by either entering an
+        #   incorrect OTP more than the allowed number of times or requesting a new OTP
+        #   more than the allowed number of times
+        # - ABORTED - Merchant aborted authentication after a challenge was requested
+        # - ERROR - The challenge failed for a reason different than those documented
+        sig do
+          returns(
+            Lithic::ThreeDSAuthentication::ChallengeMetadata::Status::TaggedSymbol
+          )
+        end
+        attr_accessor :status
+
+        # The phone number used for delivering the OTP. Relevant only for SMS_OTP method.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :phone_number
+
+        # Metadata about the challenge method and delivery. Only present when a challenge
+        # is triggered.
+        sig do
+          params(
+            method_type:
+              Lithic::ThreeDSAuthentication::ChallengeMetadata::MethodType::OrSymbol,
+            status:
+              Lithic::ThreeDSAuthentication::ChallengeMetadata::Status::OrSymbol,
+            phone_number: T.nilable(String)
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # The type of challenge method used for authentication.
+          method_type:,
+          # Indicates the status of the challenge
+          #
+          # - SUCCESS - Cardholder completed the challenge successfully
+          # - PENDING - Challenge was issued to the cardholder and was not completed yet
+          # - SMS_DELIVERY_FAILED - Lithic confirmed undeliverability of the SMS to the
+          #   provided phone number. Relevant only for SMS_OTP method
+          # - CARDHOLDER_TIMEOUT - Cardholder failed to complete the challenge within the
+          #   given challenge TTL
+          # - CANCELED_VIA_CHALLENGE_UI - Cardholder canceled the challenge by selecting
+          #   "cancel" on the challenge UI
+          # - CANCELED_OOB - Cardholder canceled the challenge out of band
+          # - ATTEMPTS_EXCEEDED - Cardholder failed the challenge by either entering an
+          #   incorrect OTP more than the allowed number of times or requesting a new OTP
+          #   more than the allowed number of times
+          # - ABORTED - Merchant aborted authentication after a challenge was requested
+          # - ERROR - The challenge failed for a reason different than those documented
+          status:,
+          # The phone number used for delivering the OTP. Relevant only for SMS_OTP method.
+          phone_number: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              method_type:
+                Lithic::ThreeDSAuthentication::ChallengeMetadata::MethodType::TaggedSymbol,
+              status:
+                Lithic::ThreeDSAuthentication::ChallengeMetadata::Status::TaggedSymbol,
+              phone_number: T.nilable(String)
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # The type of challenge method used for authentication.
+        module MethodType
+          extend Lithic::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                Lithic::ThreeDSAuthentication::ChallengeMetadata::MethodType
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          SMS_OTP =
+            T.let(
+              :SMS_OTP,
+              Lithic::ThreeDSAuthentication::ChallengeMetadata::MethodType::TaggedSymbol
+            )
+          OUT_OF_BAND =
+            T.let(
+              :OUT_OF_BAND,
+              Lithic::ThreeDSAuthentication::ChallengeMetadata::MethodType::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                Lithic::ThreeDSAuthentication::ChallengeMetadata::MethodType::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+
+        # Indicates the status of the challenge
+        #
+        # - SUCCESS - Cardholder completed the challenge successfully
+        # - PENDING - Challenge was issued to the cardholder and was not completed yet
+        # - SMS_DELIVERY_FAILED - Lithic confirmed undeliverability of the SMS to the
+        #   provided phone number. Relevant only for SMS_OTP method
+        # - CARDHOLDER_TIMEOUT - Cardholder failed to complete the challenge within the
+        #   given challenge TTL
+        # - CANCELED_VIA_CHALLENGE_UI - Cardholder canceled the challenge by selecting
+        #   "cancel" on the challenge UI
+        # - CANCELED_OOB - Cardholder canceled the challenge out of band
+        # - ATTEMPTS_EXCEEDED - Cardholder failed the challenge by either entering an
+        #   incorrect OTP more than the allowed number of times or requesting a new OTP
+        #   more than the allowed number of times
+        # - ABORTED - Merchant aborted authentication after a challenge was requested
+        # - ERROR - The challenge failed for a reason different than those documented
+        module Status
+          extend Lithic::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                Lithic::ThreeDSAuthentication::ChallengeMetadata::Status
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          SUCCESS =
+            T.let(
+              :SUCCESS,
+              Lithic::ThreeDSAuthentication::ChallengeMetadata::Status::TaggedSymbol
+            )
+          PENDING =
+            T.let(
+              :PENDING,
+              Lithic::ThreeDSAuthentication::ChallengeMetadata::Status::TaggedSymbol
+            )
+          SMS_DELIVERY_FAILED =
+            T.let(
+              :SMS_DELIVERY_FAILED,
+              Lithic::ThreeDSAuthentication::ChallengeMetadata::Status::TaggedSymbol
+            )
+          CARDHOLDER_TIMEOUT =
+            T.let(
+              :CARDHOLDER_TIMEOUT,
+              Lithic::ThreeDSAuthentication::ChallengeMetadata::Status::TaggedSymbol
+            )
+          CANCELED_VIA_CHALLENGE_UI =
+            T.let(
+              :CANCELED_VIA_CHALLENGE_UI,
+              Lithic::ThreeDSAuthentication::ChallengeMetadata::Status::TaggedSymbol
+            )
+          CANCELED_OOB =
+            T.let(
+              :CANCELED_OOB,
+              Lithic::ThreeDSAuthentication::ChallengeMetadata::Status::TaggedSymbol
+            )
+          ATTEMPTS_EXCEEDED =
+            T.let(
+              :ATTEMPTS_EXCEEDED,
+              Lithic::ThreeDSAuthentication::ChallengeMetadata::Status::TaggedSymbol
+            )
+          ABORTED =
+            T.let(
+              :ABORTED,
+              Lithic::ThreeDSAuthentication::ChallengeMetadata::Status::TaggedSymbol
+            )
+          ERROR =
+            T.let(
+              :ERROR,
+              Lithic::ThreeDSAuthentication::ChallengeMetadata::Status::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                Lithic::ThreeDSAuthentication::ChallengeMetadata::Status::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+
+      # Entity that orchestrates the challenge. This won't be set for authentications
+      # for which a decision has not yet been made (e.g. in-flight customer decisioning
+      # request).
+      module ChallengeOrchestratedBy
+        extend Lithic::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(
+              Symbol,
+              Lithic::ThreeDSAuthentication::ChallengeOrchestratedBy
+            )
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        LITHIC =
+          T.let(
+            :LITHIC,
+            Lithic::ThreeDSAuthentication::ChallengeOrchestratedBy::TaggedSymbol
+          )
+        CUSTOMER =
+          T.let(
+            :CUSTOMER,
+            Lithic::ThreeDSAuthentication::ChallengeOrchestratedBy::TaggedSymbol
+          )
+        NO_CHALLENGE =
+          T.let(
+            :NO_CHALLENGE,
+            Lithic::ThreeDSAuthentication::ChallengeOrchestratedBy::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Lithic::ThreeDSAuthentication::ChallengeOrchestratedBy::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+
+      # Entity that made the authentication decision. This won't be set for
+      # authentications for which a decision has not yet been made (e.g. in-flight
+      # customer decisioning request).
+      module DecisionMadeBy
+        extend Lithic::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Lithic::ThreeDSAuthentication::DecisionMadeBy)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        LITHIC_RULES =
+          T.let(
+            :LITHIC_RULES,
+            Lithic::ThreeDSAuthentication::DecisionMadeBy::TaggedSymbol
+          )
+        LITHIC_DEFAULT =
+          T.let(
+            :LITHIC_DEFAULT,
+            Lithic::ThreeDSAuthentication::DecisionMadeBy::TaggedSymbol
+          )
+        CUSTOMER_RULES =
+          T.let(
+            :CUSTOMER_RULES,
+            Lithic::ThreeDSAuthentication::DecisionMadeBy::TaggedSymbol
+          )
+        CUSTOMER_ENDPOINT =
+          T.let(
+            :CUSTOMER_ENDPOINT,
+            Lithic::ThreeDSAuthentication::DecisionMadeBy::TaggedSymbol
+          )
+        NETWORK =
+          T.let(
+            :NETWORK,
+            Lithic::ThreeDSAuthentication::DecisionMadeBy::TaggedSymbol
+          )
+        UNKNOWN =
+          T.let(
+            :UNKNOWN,
+            Lithic::ThreeDSAuthentication::DecisionMadeBy::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Lithic::ThreeDSAuthentication::DecisionMadeBy::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+
+      # Type of 3DS Requestor Initiated (3RI) request — i.e., a 3DS authentication that
+      # takes place at the initiation of the merchant rather than the cardholder. The
+      # most common example of this is where a merchant is authenticating before billing
+      # for a recurring transaction such as a pay TV subscription or a utility bill.
+      # Maps to EMV 3DS field `threeRIInd`.
+      module ThreeRiRequestType
+        extend Lithic::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Lithic::ThreeDSAuthentication::ThreeRiRequestType)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        ACCOUNT_VERIFICATION =
+          T.let(
+            :ACCOUNT_VERIFICATION,
+            Lithic::ThreeDSAuthentication::ThreeRiRequestType::TaggedSymbol
+          )
+        ADD_CARD =
+          T.let(
+            :ADD_CARD,
+            Lithic::ThreeDSAuthentication::ThreeRiRequestType::TaggedSymbol
+          )
+        BILLING_AGREEMENT =
+          T.let(
+            :BILLING_AGREEMENT,
+            Lithic::ThreeDSAuthentication::ThreeRiRequestType::TaggedSymbol
+          )
+        CARD_SECURITY_CODE_STATUS_CHECK =
+          T.let(
+            :CARD_SECURITY_CODE_STATUS_CHECK,
+            Lithic::ThreeDSAuthentication::ThreeRiRequestType::TaggedSymbol
+          )
+        DELAYED_SHIPMENT =
+          T.let(
+            :DELAYED_SHIPMENT,
+            Lithic::ThreeDSAuthentication::ThreeRiRequestType::TaggedSymbol
+          )
+        DEVICE_BINDING_STATUS_CHECK =
+          T.let(
+            :DEVICE_BINDING_STATUS_CHECK,
+            Lithic::ThreeDSAuthentication::ThreeRiRequestType::TaggedSymbol
+          )
+        INSTALLMENT_TRANSACTION =
+          T.let(
+            :INSTALLMENT_TRANSACTION,
+            Lithic::ThreeDSAuthentication::ThreeRiRequestType::TaggedSymbol
+          )
+        MAIL_ORDER =
+          T.let(
+            :MAIL_ORDER,
+            Lithic::ThreeDSAuthentication::ThreeRiRequestType::TaggedSymbol
+          )
+        MAINTAIN_CARD_INFO =
+          T.let(
+            :MAINTAIN_CARD_INFO,
+            Lithic::ThreeDSAuthentication::ThreeRiRequestType::TaggedSymbol
+          )
+        OTHER_PAYMENT =
+          T.let(
+            :OTHER_PAYMENT,
+            Lithic::ThreeDSAuthentication::ThreeRiRequestType::TaggedSymbol
+          )
+        RECURRING_TRANSACTION =
+          T.let(
+            :RECURRING_TRANSACTION,
+            Lithic::ThreeDSAuthentication::ThreeRiRequestType::TaggedSymbol
+          )
+        SPLIT_PAYMENT =
+          T.let(
+            :SPLIT_PAYMENT,
+            Lithic::ThreeDSAuthentication::ThreeRiRequestType::TaggedSymbol
+          )
+        SPLIT_SHIPMENT =
+          T.let(
+            :SPLIT_SHIPMENT,
+            Lithic::ThreeDSAuthentication::ThreeRiRequestType::TaggedSymbol
+          )
+        TELEPHONE_ORDER =
+          T.let(
+            :TELEPHONE_ORDER,
+            Lithic::ThreeDSAuthentication::ThreeRiRequestType::TaggedSymbol
+          )
+        TOP_UP =
+          T.let(
+            :TOP_UP,
+            Lithic::ThreeDSAuthentication::ThreeRiRequestType::TaggedSymbol
+          )
+        TRUST_LIST_STATUS_CHECK =
+          T.let(
+            :TRUST_LIST_STATUS_CHECK,
+            Lithic::ThreeDSAuthentication::ThreeRiRequestType::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Lithic::ThreeDSAuthentication::ThreeRiRequestType::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+
+      class Transaction < Lithic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Lithic::ThreeDSAuthentication::Transaction,
+              Lithic::Internal::AnyHash
+            )
+          end
+
+        # Amount of the purchase in minor units of currency with all punctuation removed.
+        # Maps to EMV 3DS field `purchaseAmount`.
+        sig { returns(Float) }
+        attr_accessor :amount
+
+        # Approximate amount of the purchase in minor units of cardholder currency.
+        # Derived from `amount` using a daily conversion rate.
+        sig { returns(T.nilable(Float)) }
+        attr_accessor :cardholder_amount
+
+        # Currency of the purchase. Maps to EMV 3DS field `purchaseCurrency`. Permitted
+        # values: ISO 4217 three-character currency code (e.g., USD).
+        sig { returns(String) }
+        attr_accessor :currency
+
+        # Minor units of currency, as specified in ISO 4217 currency exponent. Maps to EMV
+        # 3DS field `purchaseExponent`.
+        sig { returns(Float) }
+        attr_accessor :currency_exponent
+
+        # Date and time when the authentication was generated by the merchant/acquirer's
+        # 3DS server. Maps to EMV 3DS field `purchaseDate`. Permitted values: Date string
+        # in the ISO 8601 format yyyy-MM-dd'T'hh:mm:ssZ.
+        sig { returns(Time) }
+        attr_accessor :date_time
+
+        # Type of the transaction for which a 3DS authentication request is occurring.
+        # Maps to EMV 3DS field `transType`.
+        sig do
+          returns(
+            T.nilable(
+              Lithic::ThreeDSAuthentication::Transaction::Type::TaggedSymbol
+            )
+          )
+        end
+        attr_accessor :type
+
+        # Object containing data about the e-commerce transaction for which the merchant
+        # is requesting authentication.
+        sig do
+          params(
+            amount: Float,
+            cardholder_amount: T.nilable(Float),
+            currency: String,
+            currency_exponent: Float,
+            date_time: Time,
+            type:
+              T.nilable(
+                Lithic::ThreeDSAuthentication::Transaction::Type::OrSymbol
+              )
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Amount of the purchase in minor units of currency with all punctuation removed.
+          # Maps to EMV 3DS field `purchaseAmount`.
+          amount:,
+          # Approximate amount of the purchase in minor units of cardholder currency.
+          # Derived from `amount` using a daily conversion rate.
+          cardholder_amount:,
+          # Currency of the purchase. Maps to EMV 3DS field `purchaseCurrency`. Permitted
+          # values: ISO 4217 three-character currency code (e.g., USD).
+          currency:,
+          # Minor units of currency, as specified in ISO 4217 currency exponent. Maps to EMV
+          # 3DS field `purchaseExponent`.
+          currency_exponent:,
+          # Date and time when the authentication was generated by the merchant/acquirer's
+          # 3DS server. Maps to EMV 3DS field `purchaseDate`. Permitted values: Date string
+          # in the ISO 8601 format yyyy-MM-dd'T'hh:mm:ssZ.
+          date_time:,
+          # Type of the transaction for which a 3DS authentication request is occurring.
+          # Maps to EMV 3DS field `transType`.
+          type:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              amount: Float,
+              cardholder_amount: T.nilable(Float),
+              currency: String,
+              currency_exponent: Float,
+              date_time: Time,
+              type:
+                T.nilable(
+                  Lithic::ThreeDSAuthentication::Transaction::Type::TaggedSymbol
+                )
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # Type of the transaction for which a 3DS authentication request is occurring.
+        # Maps to EMV 3DS field `transType`.
+        module Type
+          extend Lithic::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, Lithic::ThreeDSAuthentication::Transaction::Type)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          ACCOUNT_FUNDING =
+            T.let(
+              :ACCOUNT_FUNDING,
+              Lithic::ThreeDSAuthentication::Transaction::Type::TaggedSymbol
+            )
+          CHECK_ACCEPTANCE =
+            T.let(
+              :CHECK_ACCEPTANCE,
+              Lithic::ThreeDSAuthentication::Transaction::Type::TaggedSymbol
+            )
+          GOODS_SERVICE_PURCHASE =
+            T.let(
+              :GOODS_SERVICE_PURCHASE,
+              Lithic::ThreeDSAuthentication::Transaction::Type::TaggedSymbol
+            )
+          PREPAID_ACTIVATION_AND_LOAD =
+            T.let(
+              :PREPAID_ACTIVATION_AND_LOAD,
+              Lithic::ThreeDSAuthentication::Transaction::Type::TaggedSymbol
+            )
+          QUASI_CASH_TRANSACTION =
+            T.let(
+              :QUASI_CASH_TRANSACTION,
+              Lithic::ThreeDSAuthentication::Transaction::Type::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                Lithic::ThreeDSAuthentication::Transaction::Type::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+    end
+  end
+end