lithic 0.1.0.pre.alpha.56 → 0.1.0

data/lib/lithic/models/three_ds_authentication.rb

@@ -0,0 +1,1259 @@
+# frozen_string_literal: true
+
+module Lithic
+  module Models
+    class ThreeDSAuthentication < Lithic::Internal::Type::BaseModel
+      # @!attribute token
+      #   Globally unique identifier for the 3DS authentication. Permitted values:
+      #   36-digit version 4 UUID (including hyphens).
+      #
+      #   @return [String]
+      required :token, String
+
+      # @!attribute account_type
+      #   Type of account/card that is being used for the transaction. Maps to EMV 3DS
+      #   field `acctType`.
+      #
+      #   @return [Symbol, Lithic::Models::ThreeDSAuthentication::AccountType, nil]
+      required :account_type, enum: -> { Lithic::ThreeDSAuthentication::AccountType }, nil?: true
+
+      # @!attribute authentication_result
+      #   Indicates the outcome of the 3DS authentication process.
+      #
+      #   @return [Symbol, Lithic::Models::ThreeDSAuthentication::AuthenticationResult]
+      required :authentication_result, enum: -> { Lithic::ThreeDSAuthentication::AuthenticationResult }
+
+      # @!attribute card_expiry_check
+      #   Indicates whether the expiration date provided by the cardholder during checkout
+      #   matches Lithic's record of the card's expiration date.
+      #
+      #   @return [Symbol, Lithic::Models::ThreeDSAuthentication::CardExpiryCheck]
+      required :card_expiry_check, enum: -> { Lithic::ThreeDSAuthentication::CardExpiryCheck }
+
+      # @!attribute card_token
+      #   Globally unique identifier for the card on which the 3DS authentication has
+      #   occurred. Permitted values: 36-digit version 4 UUID (including hyphens).
+      #
+      #   @return [String]
+      required :card_token, String
+
+      # @!attribute cardholder
+      #   Object containing data about the cardholder provided during the transaction.
+      #
+      #   @return [Lithic::Models::ThreeDSAuthentication::Cardholder]
+      required :cardholder, -> { Lithic::ThreeDSAuthentication::Cardholder }
+
+      # @!attribute channel
+      #   Channel in which the authentication occurs. Maps to EMV 3DS field
+      #   `deviceChannel`.
+      #
+      #   @return [Symbol, Lithic::Models::ThreeDSAuthentication::Channel]
+      required :channel, enum: -> { Lithic::ThreeDSAuthentication::Channel }
+
+      # @!attribute created
+      #   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.
+      #
+      #   @return [Time]
+      required :created, Time
+
+      # @!attribute merchant
+      #   Object containing data about the merchant involved in the e-commerce
+      #   transaction.
+      #
+      #   @return [Lithic::Models::ThreeDSAuthentication::Merchant]
+      required :merchant, -> { Lithic::ThreeDSAuthentication::Merchant }
+
+      # @!attribute message_category
+      #   Either PAYMENT_AUTHENTICATION or NON_PAYMENT_AUTHENTICATION. For
+      #   NON_PAYMENT_AUTHENTICATION, additional_data and transaction fields are not
+      #   populated.
+      #
+      #   @return [Symbol, Lithic::Models::ThreeDSAuthentication::MessageCategory]
+      required :message_category, enum: -> { Lithic::ThreeDSAuthentication::MessageCategory }
+
+      # @!attribute three_ds_requestor_challenge_indicator
+      #   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
+      #
+      #   @return [Symbol, Lithic::Models::ThreeDSAuthentication::ThreeDSRequestorChallengeIndicator]
+      required :three_ds_requestor_challenge_indicator,
+               enum: -> { Lithic::ThreeDSAuthentication::ThreeDSRequestorChallengeIndicator }
+
+      # @!attribute additional_data
+      #   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).
+      #
+      #   @return [Lithic::Models::ThreeDSAuthentication::AdditionalData, nil]
+      optional :additional_data, -> { Lithic::ThreeDSAuthentication::AdditionalData }, nil?: true
+
+      # @!attribute app
+      #   Object containing data about the app used in the e-commerce transaction. Present
+      #   if the channel is 'APP_BASED'.
+      #
+      #   @return [Lithic::Models::ThreeDSAuthentication::App, nil]
+      optional :app, -> { Lithic::ThreeDSAuthentication::App }, nil?: true
+
+      # @!attribute authentication_request_type
+      #   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`.
+      #
+      #   @return [Symbol, Lithic::Models::ThreeDSAuthentication::AuthenticationRequestType, nil]
+      optional :authentication_request_type,
+               enum: -> { Lithic::ThreeDSAuthentication::AuthenticationRequestType },
+               nil?: true
+
+      # @!attribute browser
+      #   Object containing data about the browser used in the e-commerce transaction.
+      #   Present if the channel is 'BROWSER'.
+      #
+      #   @return [Lithic::Models::ThreeDSAuthentication::Browser, nil]
+      optional :browser, -> { Lithic::ThreeDSAuthentication::Browser }, nil?: true
+
+      # @!attribute challenge_metadata
+      #   Metadata about the challenge method and delivery. Only present when a challenge
+      #   is triggered.
+      #
+      #   @return [Lithic::Models::ThreeDSAuthentication::ChallengeMetadata, nil]
+      optional :challenge_metadata, -> { Lithic::ThreeDSAuthentication::ChallengeMetadata }, nil?: true
+
+      # @!attribute challenge_orchestrated_by
+      #   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).
+      #
+      #   @return [Symbol, Lithic::Models::ThreeDSAuthentication::ChallengeOrchestratedBy, nil]
+      optional :challenge_orchestrated_by,
+               enum: -> { Lithic::ThreeDSAuthentication::ChallengeOrchestratedBy },
+               nil?: true
+
+      # @!attribute decision_made_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).
+      #
+      #   @return [Symbol, Lithic::Models::ThreeDSAuthentication::DecisionMadeBy, nil]
+      optional :decision_made_by, enum: -> { Lithic::ThreeDSAuthentication::DecisionMadeBy }, nil?: true
+
+      # @!attribute three_ri_request_type
+      #   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`.
+      #
+      #   @return [Symbol, Lithic::Models::ThreeDSAuthentication::ThreeRiRequestType, nil]
+      optional :three_ri_request_type,
+               enum: -> { Lithic::ThreeDSAuthentication::ThreeRiRequestType },
+               nil?: true
+
+      # @!attribute transaction
+      #   Object containing data about the e-commerce transaction for which the merchant
+      #   is requesting authentication.
+      #
+      #   @return [Lithic::Models::ThreeDSAuthentication::Transaction, nil]
+      optional :transaction, -> { Lithic::ThreeDSAuthentication::Transaction }, nil?: true
+
+      # @!method initialize(token:, account_type:, authentication_result:, card_expiry_check:, card_token:, cardholder:, channel:, created:, merchant:, message_category:, three_ds_requestor_challenge_indicator:, additional_data: nil, app: nil, authentication_request_type: nil, browser: nil, challenge_metadata: nil, challenge_orchestrated_by: nil, decision_made_by: nil, three_ri_request_type: nil, transaction: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Lithic::Models::ThreeDSAuthentication} for more details.
+      #
+      #   Represents a 3DS authentication
+      #
+      #   @param token [String] Globally unique identifier for the 3DS authentication. Permitted values: 36-digi
+      #
+      #   @param account_type [Symbol, Lithic::Models::ThreeDSAuthentication::AccountType, nil] Type of account/card that is being used for the transaction. Maps to EMV 3DS fie
+      #
+      #   @param authentication_result [Symbol, Lithic::Models::ThreeDSAuthentication::AuthenticationResult] Indicates the outcome of the 3DS authentication process.
+      #
+      #   @param card_expiry_check [Symbol, Lithic::Models::ThreeDSAuthentication::CardExpiryCheck] Indicates whether the expiration date provided by the cardholder during checkout
+      #
+      #   @param card_token [String] Globally unique identifier for the card on which the 3DS authentication has occu
+      #
+      #   @param cardholder [Lithic::Models::ThreeDSAuthentication::Cardholder] Object containing data about the cardholder provided during the transaction.
+      #
+      #   @param channel [Symbol, Lithic::Models::ThreeDSAuthentication::Channel] Channel in which the authentication occurs. Maps to EMV 3DS field `deviceChannel
+      #
+      #   @param created [Time] Date and time when the authentication was created in Lithic's system. Permitted
+      #
+      #   @param merchant [Lithic::Models::ThreeDSAuthentication::Merchant] Object containing data about the merchant involved in the e-commerce transaction
+      #
+      #   @param message_category [Symbol, Lithic::Models::ThreeDSAuthentication::MessageCategory] Either PAYMENT_AUTHENTICATION or NON_PAYMENT_AUTHENTICATION. For NON_PAYMENT_AUT
+      #
+      #   @param three_ds_requestor_challenge_indicator [Symbol, Lithic::Models::ThreeDSAuthentication::ThreeDSRequestorChallengeIndicator] Indicates whether a challenge is requested for this transaction
+      #
+      #   @param additional_data [Lithic::Models::ThreeDSAuthentication::AdditionalData, nil] Object containing additional data about the 3DS request that is beyond the EMV 3
+      #
+      #   @param app [Lithic::Models::ThreeDSAuthentication::App, nil] Object containing data about the app used in the e-commerce transaction. Present
+      #
+      #   @param authentication_request_type [Symbol, Lithic::Models::ThreeDSAuthentication::AuthenticationRequestType, nil] Type of authentication request - i.e., the type of transaction or interaction is
+      #
+      #   @param browser [Lithic::Models::ThreeDSAuthentication::Browser, nil] Object containing data about the browser used in the e-commerce transaction. Pre
+      #
+      #   @param challenge_metadata [Lithic::Models::ThreeDSAuthentication::ChallengeMetadata, nil] Metadata about the challenge method and delivery. Only present when a challenge
+      #
+      #   @param challenge_orchestrated_by [Symbol, Lithic::Models::ThreeDSAuthentication::ChallengeOrchestratedBy, nil] Entity that orchestrates the challenge. This won't be set for authentications fo
+      #
+      #   @param decision_made_by [Symbol, Lithic::Models::ThreeDSAuthentication::DecisionMadeBy, nil] Entity that made the authentication decision. This won't be set for authenticati
+      #
+      #   @param three_ri_request_type [Symbol, Lithic::Models::ThreeDSAuthentication::ThreeRiRequestType, nil] Type of 3DS Requestor Initiated (3RI) request — i.e., a 3DS authentication that
+      #
+      #   @param transaction [Lithic::Models::ThreeDSAuthentication::Transaction, nil] Object containing data about the e-commerce transaction for which the merchant i
+
+      # Type of account/card that is being used for the transaction. Maps to EMV 3DS
+      # field `acctType`.
+      #
+      # @see Lithic::Models::ThreeDSAuthentication#account_type
+      module AccountType
+        extend Lithic::Internal::Type::Enum
+
+        CREDIT = :CREDIT
+        DEBIT = :DEBIT
+        NOT_APPLICABLE = :NOT_APPLICABLE
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # Indicates the outcome of the 3DS authentication process.
+      #
+      # @see Lithic::Models::ThreeDSAuthentication#authentication_result
+      module AuthenticationResult
+        extend Lithic::Internal::Type::Enum
+
+        DECLINE = :DECLINE
+        SUCCESS = :SUCCESS
+        PENDING_CHALLENGE = :PENDING_CHALLENGE
+        PENDING_DECISION = :PENDING_DECISION
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # Indicates whether the expiration date provided by the cardholder during checkout
+      # matches Lithic's record of the card's expiration date.
+      #
+      # @see Lithic::Models::ThreeDSAuthentication#card_expiry_check
+      module CardExpiryCheck
+        extend Lithic::Internal::Type::Enum
+
+        MATCH = :MATCH
+        MISMATCH = :MISMATCH
+        NOT_PRESENT = :NOT_PRESENT
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # @see Lithic::Models::ThreeDSAuthentication#cardholder
+      class Cardholder < Lithic::Internal::Type::BaseModel
+        # @!attribute address_match
+        #   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`.
+        #
+        #   @return [Boolean, nil]
+        optional :address_match, Lithic::Internal::Type::Boolean, nil?: true
+
+        # @!attribute address_on_file_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
+        #
+        #   @return [Symbol, Lithic::Models::ThreeDSAuthentication::Cardholder::AddressOnFileMatch, nil]
+        optional :address_on_file_match,
+                 enum: -> { Lithic::ThreeDSAuthentication::Cardholder::AddressOnFileMatch }
+
+        # @!attribute billing_address
+        #   Object containing data on the billing address provided during the transaction.
+        #
+        #   @return [Lithic::Models::ThreeDSAuthentication::Cardholder::BillingAddress, nil]
+        optional :billing_address, -> { Lithic::ThreeDSAuthentication::Cardholder::BillingAddress }
+
+        # @!attribute email
+        #   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`.
+        #
+        #   @return [String, nil]
+        optional :email, String, nil?: true
+
+        # @!attribute name
+        #   Name of the cardholder. Maps to EMV 3DS field `cardholderName`.
+        #
+        #   @return [String, nil]
+        optional :name, String, nil?: true
+
+        # @!attribute phone_number_home
+        #   Home phone number in E.164 format provided by the cardholder. Maps to EMV 3DS
+        #   fields `homePhone.cc` and `homePhone.subscriber`.
+        #
+        #   @return [String, nil]
+        optional :phone_number_home, String, nil?: true
+
+        # @!attribute phone_number_mobile
+        #   Mobile/cell phone number in E.164 format provided by the cardholder. Maps to EMV
+        #   3DS fields `mobilePhone.cc` and `mobilePhone.subscriber`.
+        #
+        #   @return [String, nil]
+        optional :phone_number_mobile, String, nil?: true
+
+        # @!attribute phone_number_work
+        #   Work phone number in E.164 format provided by the cardholder. Maps to EMV 3DS
+        #   fields `workPhone.cc` and `workPhone.subscriber`.
+        #
+        #   @return [String, nil]
+        optional :phone_number_work, String, nil?: true
+
+        # @!attribute shipping_address
+        #   Object containing data on the shipping address provided during the transaction.
+        #
+        #   @return [Lithic::Models::ThreeDSAuthentication::Cardholder::ShippingAddress, nil]
+        optional :shipping_address, -> { Lithic::ThreeDSAuthentication::Cardholder::ShippingAddress }
+
+        # @!method initialize(address_match: nil, address_on_file_match: nil, billing_address: nil, email: nil, name: nil, phone_number_home: nil, phone_number_mobile: nil, phone_number_work: nil, shipping_address: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Lithic::Models::ThreeDSAuthentication::Cardholder} for more details.
+        #
+        #   Object containing data about the cardholder provided during the transaction.
+        #
+        #   @param address_match [Boolean, nil] Indicates whether the shipping address and billing address provided by the cardh
+        #
+        #   @param address_on_file_match [Symbol, Lithic::Models::ThreeDSAuthentication::Cardholder::AddressOnFileMatch] Lithic's evaluation result comparing the transaction's address data with the car
+        #
+        #   @param billing_address [Lithic::Models::ThreeDSAuthentication::Cardholder::BillingAddress] Object containing data on the billing address provided during the transaction.
+        #
+        #   @param email [String, nil] Email address that is either provided by the cardholder or is on file with the m
+        #
+        #   @param name [String, nil] Name of the cardholder. Maps to EMV 3DS field `cardholderName`.
+        #
+        #   @param phone_number_home [String, nil] Home phone number in E.164 format provided by the cardholder. Maps to EMV 3DS fi
+        #
+        #   @param phone_number_mobile [String, nil] Mobile/cell phone number in E.164 format provided by the cardholder. Maps to EMV
+        #
+        #   @param phone_number_work [String, nil] Work phone number in E.164 format provided by the cardholder. Maps to EMV 3DS fi
+        #
+        #   @param shipping_address [Lithic::Models::ThreeDSAuthentication::Cardholder::ShippingAddress] Object containing data on the shipping address provided during the transaction.
+
+        # 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
+        #
+        # @see Lithic::Models::ThreeDSAuthentication::Cardholder#address_on_file_match
+        module AddressOnFileMatch
+          extend Lithic::Internal::Type::Enum
+
+          MATCH = :MATCH
+          MATCH_ADDRESS_ONLY = :MATCH_ADDRESS_ONLY
+          MATCH_ZIP_ONLY = :MATCH_ZIP_ONLY
+          MISMATCH = :MISMATCH
+          NOT_PRESENT = :NOT_PRESENT
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # @see Lithic::Models::ThreeDSAuthentication::Cardholder#billing_address
+        class BillingAddress < Lithic::Internal::Type::BaseModel
+          # @!attribute address1
+          #   First line of the street address provided by the cardholder.
+          #
+          #   @return [String, nil]
+          optional :address1, String, nil?: true
+
+          # @!attribute address2
+          #   Second line of the street address provided by the cardholder.
+          #
+          #   @return [String, nil]
+          optional :address2, String, nil?: true
+
+          # @!attribute address3
+          #   Third line of the street address provided by the cardholder.
+          #
+          #   @return [String, nil]
+          optional :address3, String, nil?: true
+
+          # @!attribute city
+          #   City of the address provided by the cardholder.
+          #
+          #   @return [String, nil]
+          optional :city, String, nil?: true
+
+          # @!attribute country
+          #   Country of the address provided by the cardholder in ISO 3166-1 alpha-3 format
+          #   (e.g. USA)
+          #
+          #   @return [String, nil]
+          optional :country, String, nil?: true
+
+          # @!attribute postal_code
+          #   Postal code (e.g., ZIP code) of the address provided by the cardholder
+          #
+          #   @return [String, nil]
+          optional :postal_code, String, nil?: true
+
+          # @!method initialize(address1: nil, address2: nil, address3: nil, city: nil, country: nil, postal_code: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Lithic::Models::ThreeDSAuthentication::Cardholder::BillingAddress} for more
+          #   details.
+          #
+          #   Object containing data on the billing address provided during the transaction.
+          #
+          #   @param address1 [String, nil] First line of the street address provided by the cardholder.
+          #
+          #   @param address2 [String, nil] Second line of the street address provided by the cardholder.
+          #
+          #   @param address3 [String, nil] Third line of the street address provided by the cardholder.
+          #
+          #   @param city [String, nil] City of the address provided by the cardholder.
+          #
+          #   @param country [String, nil] Country of the address provided by the cardholder in ISO 3166-1 alpha-3 format (
+          #
+          #   @param postal_code [String, nil] Postal code (e.g., ZIP code) of the address provided by the cardholder
+        end
+
+        # @see Lithic::Models::ThreeDSAuthentication::Cardholder#shipping_address
+        class ShippingAddress < Lithic::Internal::Type::BaseModel
+          # @!attribute address1
+          #   First line of the street address provided by the cardholder.
+          #
+          #   @return [String, nil]
+          optional :address1, String, nil?: true
+
+          # @!attribute address2
+          #   Second line of the street address provided by the cardholder.
+          #
+          #   @return [String, nil]
+          optional :address2, String, nil?: true
+
+          # @!attribute address3
+          #   Third line of the street address provided by the cardholder.
+          #
+          #   @return [String, nil]
+          optional :address3, String, nil?: true
+
+          # @!attribute city
+          #   City of the address provided by the cardholder.
+          #
+          #   @return [String, nil]
+          optional :city, String, nil?: true
+
+          # @!attribute country
+          #   Country of the address provided by the cardholder in ISO 3166-1 alpha-3 format
+          #   (e.g. USA)
+          #
+          #   @return [String, nil]
+          optional :country, String, nil?: true
+
+          # @!attribute postal_code
+          #   Postal code (e.g., ZIP code) of the address provided by the cardholder
+          #
+          #   @return [String, nil]
+          optional :postal_code, String, nil?: true
+
+          # @!method initialize(address1: nil, address2: nil, address3: nil, city: nil, country: nil, postal_code: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Lithic::Models::ThreeDSAuthentication::Cardholder::ShippingAddress} for more
+          #   details.
+          #
+          #   Object containing data on the shipping address provided during the transaction.
+          #
+          #   @param address1 [String, nil] First line of the street address provided by the cardholder.
+          #
+          #   @param address2 [String, nil] Second line of the street address provided by the cardholder.
+          #
+          #   @param address3 [String, nil] Third line of the street address provided by the cardholder.
+          #
+          #   @param city [String, nil] City of the address provided by the cardholder.
+          #
+          #   @param country [String, nil] Country of the address provided by the cardholder in ISO 3166-1 alpha-3 format (
+          #
+          #   @param postal_code [String, nil] Postal code (e.g., ZIP code) of the address provided by the cardholder
+        end
+      end
+
+      # Channel in which the authentication occurs. Maps to EMV 3DS field
+      # `deviceChannel`.
+      #
+      # @see Lithic::Models::ThreeDSAuthentication#channel
+      module Channel
+        extend Lithic::Internal::Type::Enum
+
+        APP_BASED = :APP_BASED
+        BROWSER = :BROWSER
+        THREE_DS_REQUESTOR_INITIATED = :THREE_DS_REQUESTOR_INITIATED
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # @see Lithic::Models::ThreeDSAuthentication#merchant
+      class Merchant < Lithic::Internal::Type::BaseModel
+        # @!attribute risk_indicator
+        #   Object containing additional data indicating additional risk factors related to
+        #   the e-commerce transaction.
+        #
+        #   @return [Lithic::Models::ThreeDSAuthentication::Merchant::RiskIndicator]
+        required :risk_indicator, -> { Lithic::ThreeDSAuthentication::Merchant::RiskIndicator }
+
+        # @!attribute id
+        #   Merchant identifier as assigned by the acquirer. Maps to EMV 3DS field
+        #   `acquirerMerchantId`. May not be present for non-payment authentications.
+        #
+        #   @return [String, nil]
+        optional :id, String, nil?: true
+
+        # @!attribute country
+        #   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.
+        #
+        #   @return [String, nil]
+        optional :country, String, nil?: true
+
+        # @!attribute mcc
+        #   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.
+        #
+        #   @return [String, nil]
+        optional :mcc, String, nil?: true
+
+        # @!attribute name
+        #   Name of the merchant. Maps to EMV 3DS field `merchantName`. May not be present
+        #   for non-payment authentications.
+        #
+        #   @return [String, nil]
+        optional :name, String, nil?: true
+
+        # @!method initialize(risk_indicator:, id: nil, country: nil, mcc: nil, name: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Lithic::Models::ThreeDSAuthentication::Merchant} for more details.
+        #
+        #   Object containing data about the merchant involved in the e-commerce
+        #   transaction.
+        #
+        #   @param risk_indicator [Lithic::Models::ThreeDSAuthentication::Merchant::RiskIndicator] Object containing additional data indicating additional risk factors related to
+        #
+        #   @param id [String, nil] Merchant identifier as assigned by the acquirer. Maps to EMV 3DS field `acquirer
+        #
+        #   @param country [String, nil] Country code of the merchant requesting 3DS authentication. Maps to EMV 3DS fiel
+        #
+        #   @param mcc [String, nil] Merchant category code assigned to the merchant that describes its business acti
+        #
+        #   @param name [String, nil] Name of the merchant. Maps to EMV 3DS field `merchantName`. May not be present f
+
+        # @see Lithic::Models::ThreeDSAuthentication::Merchant#risk_indicator
+        class RiskIndicator < Lithic::Internal::Type::BaseModel
+          # @!attribute delivery_email_address
+          #   In transactions with electronic delivery, email address to which merchandise is
+          #   delivered. Maps to EMV 3DS field `deliveryEmailAddress`.
+          #
+          #   @return [String, nil]
+          optional :delivery_email_address, String, nil?: true
+
+          # @!attribute delivery_time_frame
+          #   The delivery time frame for the merchandise. Maps to EMV 3DS field
+          #   `deliveryTimeframe`.
+          #
+          #   @return [Symbol, Lithic::Models::ThreeDSAuthentication::Merchant::RiskIndicator::DeliveryTimeFrame, nil]
+          optional :delivery_time_frame,
+                   enum: -> { Lithic::ThreeDSAuthentication::Merchant::RiskIndicator::DeliveryTimeFrame },
+                   nil?: true
+
+          # @!attribute gift_card_amount
+          #   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`.
+          #
+          #   @return [Integer, nil]
+          optional :gift_card_amount, Integer, nil?: true
+
+          # @!attribute gift_card_count
+          #   In prepaid or gift card purchase transactions, count of individual prepaid or
+          #   gift cards/codes purchased. Maps to EMV 3DS field `giftCardCount`.
+          #
+          #   @return [Integer, nil]
+          optional :gift_card_count, Integer, nil?: true
+
+          # @!attribute gift_card_currency
+          #   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).
+          #
+          #   @return [String, nil]
+          optional :gift_card_currency, String, nil?: true
+
+          # @!attribute order_availability
+          #   Indicates whether the purchase is for merchandise that is available now or at a
+          #   future date. Maps to EMV 3DS field `preOrderPurchaseInd`.
+          #
+          #   @return [Symbol, Lithic::Models::ThreeDSAuthentication::Merchant::RiskIndicator::OrderAvailability, nil]
+          optional :order_availability,
+                   enum: -> { Lithic::ThreeDSAuthentication::Merchant::RiskIndicator::OrderAvailability },
+                   nil?: true
+
+          # @!attribute pre_order_available_date
+          #   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
+          #
+          #   @return [Time, nil]
+          optional :pre_order_available_date, Time, nil?: true
+
+          # @!attribute reorder_items
+          #   Indicates whether the cardholder is reordering previously purchased merchandise.
+          #   Maps to EMV 3DS field `reorderItemsInd`.
+          #
+          #   @return [Symbol, Lithic::Models::ThreeDSAuthentication::Merchant::RiskIndicator::ReorderItems, nil]
+          optional :reorder_items,
+                   enum: -> { Lithic::ThreeDSAuthentication::Merchant::RiskIndicator::ReorderItems },
+                   nil?: true
+
+          # @!attribute shipping_method
+          #   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`.
+          #
+          #   @return [Symbol, Lithic::Models::ThreeDSAuthentication::Merchant::RiskIndicator::ShippingMethod, nil]
+          optional :shipping_method,
+                   enum: -> { Lithic::ThreeDSAuthentication::Merchant::RiskIndicator::ShippingMethod },
+                   nil?: true
+
+          # @!method initialize(delivery_email_address: nil, delivery_time_frame: nil, gift_card_amount: nil, gift_card_count: nil, gift_card_currency: nil, order_availability: nil, pre_order_available_date: nil, reorder_items: nil, shipping_method: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Lithic::Models::ThreeDSAuthentication::Merchant::RiskIndicator} for more
+          #   details.
+          #
+          #   Object containing additional data indicating additional risk factors related to
+          #   the e-commerce transaction.
+          #
+          #   @param delivery_email_address [String, nil] In transactions with electronic delivery, email address to which merchandise is
+          #
+          #   @param delivery_time_frame [Symbol, Lithic::Models::ThreeDSAuthentication::Merchant::RiskIndicator::DeliveryTimeFrame, nil] The delivery time frame for the merchandise. Maps to EMV 3DS field `deliveryTime
+          #
+          #   @param gift_card_amount [Integer, nil] In prepaid or gift card purchase transactions, purchase amount total in major un
+          #
+          #   @param gift_card_count [Integer, nil] In prepaid or gift card purchase transactions, count of individual prepaid or gi
+          #
+          #   @param gift_card_currency [String, nil] In prepaid or gift card purchase transactions, currency code of the gift card. M
+          #
+          #   @param order_availability [Symbol, Lithic::Models::ThreeDSAuthentication::Merchant::RiskIndicator::OrderAvailability, nil] Indicates whether the purchase is for merchandise that is available now or at a
+          #
+          #   @param pre_order_available_date [Time, nil] In pre-order purchase transactions, the expected date that the merchandise will
+          #
+          #   @param reorder_items [Symbol, Lithic::Models::ThreeDSAuthentication::Merchant::RiskIndicator::ReorderItems, nil] Indicates whether the cardholder is reordering previously purchased merchandise.
+          #
+          #   @param shipping_method [Symbol, Lithic::Models::ThreeDSAuthentication::Merchant::RiskIndicator::ShippingMethod, nil] Shipping method that the cardholder chose for the transaction. If purchase inclu
+
+          # The delivery time frame for the merchandise. Maps to EMV 3DS field
+          # `deliveryTimeframe`.
+          #
+          # @see Lithic::Models::ThreeDSAuthentication::Merchant::RiskIndicator#delivery_time_frame
+          module DeliveryTimeFrame
+            extend Lithic::Internal::Type::Enum
+
+            ELECTRONIC_DELIVERY = :ELECTRONIC_DELIVERY
+            OVERNIGHT_SHIPPING = :OVERNIGHT_SHIPPING
+            SAME_DAY_SHIPPING = :SAME_DAY_SHIPPING
+            TWO_DAY_OR_MORE_SHIPPING = :TWO_DAY_OR_MORE_SHIPPING
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # Indicates whether the purchase is for merchandise that is available now or at a
+          # future date. Maps to EMV 3DS field `preOrderPurchaseInd`.
+          #
+          # @see Lithic::Models::ThreeDSAuthentication::Merchant::RiskIndicator#order_availability
+          module OrderAvailability
+            extend Lithic::Internal::Type::Enum
+
+            FUTURE_AVAILABILITY = :FUTURE_AVAILABILITY
+            MERCHANDISE_AVAILABLE = :MERCHANDISE_AVAILABLE
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # Indicates whether the cardholder is reordering previously purchased merchandise.
+          # Maps to EMV 3DS field `reorderItemsInd`.
+          #
+          # @see Lithic::Models::ThreeDSAuthentication::Merchant::RiskIndicator#reorder_items
+          module ReorderItems
+            extend Lithic::Internal::Type::Enum
+
+            FIRST_TIME_ORDERED = :FIRST_TIME_ORDERED
+            REORDERED = :REORDERED
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          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`.
+          #
+          # @see Lithic::Models::ThreeDSAuthentication::Merchant::RiskIndicator#shipping_method
+          module ShippingMethod
+            extend Lithic::Internal::Type::Enum
+
+            DIGITAL_GOODS = :DIGITAL_GOODS
+            LOCKER_DELIVERY = :LOCKER_DELIVERY
+            OTHER = :OTHER
+            PICK_UP_AND_GO_DELIVERY = :PICK_UP_AND_GO_DELIVERY
+            SHIP_TO_BILLING_ADDRESS = :SHIP_TO_BILLING_ADDRESS
+            SHIP_TO_NON_BILLING_ADDRESS = :SHIP_TO_NON_BILLING_ADDRESS
+            SHIP_TO_OTHER_VERIFIED_ADDRESS = :SHIP_TO_OTHER_VERIFIED_ADDRESS
+            SHIP_TO_STORE = :SHIP_TO_STORE
+            TRAVEL_AND_EVENT_TICKETS = :TRAVEL_AND_EVENT_TICKETS
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+      end
+
+      # Either PAYMENT_AUTHENTICATION or NON_PAYMENT_AUTHENTICATION. For
+      # NON_PAYMENT_AUTHENTICATION, additional_data and transaction fields are not
+      # populated.
+      #
+      # @see Lithic::Models::ThreeDSAuthentication#message_category
+      module MessageCategory
+        extend Lithic::Internal::Type::Enum
+
+        NON_PAYMENT_AUTHENTICATION = :NON_PAYMENT_AUTHENTICATION
+        PAYMENT_AUTHENTICATION = :PAYMENT_AUTHENTICATION
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      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
+      #
+      # @see Lithic::Models::ThreeDSAuthentication#three_ds_requestor_challenge_indicator
+      module ThreeDSRequestorChallengeIndicator
+        extend Lithic::Internal::Type::Enum
+
+        NO_PREFERENCE = :NO_PREFERENCE
+        NO_CHALLENGE_REQUESTED = :NO_CHALLENGE_REQUESTED
+        CHALLENGE_PREFERENCE = :CHALLENGE_PREFERENCE
+        CHALLENGE_MANDATE = :CHALLENGE_MANDATE
+        NO_CHALLENGE_RISK_ALREADY_ASSESSED = :NO_CHALLENGE_RISK_ALREADY_ASSESSED
+        DATA_SHARE_ONLY = :DATA_SHARE_ONLY
+        OTHER = :OTHER
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # @see Lithic::Models::ThreeDSAuthentication#additional_data
+      class AdditionalData < Lithic::Internal::Type::BaseModel
+        # @!attribute network_decision
+        #   Mastercard only: Indicates whether the network would have considered the
+        #   authentication request to be low risk or not.
+        #
+        #   @return [Symbol, Lithic::Models::ThreeDSAuthentication::AdditionalData::NetworkDecision, nil]
+        optional :network_decision,
+                 enum: -> { Lithic::ThreeDSAuthentication::AdditionalData::NetworkDecision },
+                 nil?: true
+
+        # @!attribute network_risk_score
+        #   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.
+        #
+        #   @return [Integer, nil]
+        optional :network_risk_score, Integer, nil?: true
+
+        # @!method initialize(network_decision: nil, network_risk_score: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Lithic::Models::ThreeDSAuthentication::AdditionalData} for more details.
+        #
+        #   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).
+        #
+        #   @param network_decision [Symbol, Lithic::Models::ThreeDSAuthentication::AdditionalData::NetworkDecision, nil] Mastercard only: Indicates whether the network would have considered the authent
+        #
+        #   @param network_risk_score [Integer, nil] Mastercard only: Assessment by the network of the authentication risk level, wit
+
+        # Mastercard only: Indicates whether the network would have considered the
+        # authentication request to be low risk or not.
+        #
+        # @see Lithic::Models::ThreeDSAuthentication::AdditionalData#network_decision
+        module NetworkDecision
+          extend Lithic::Internal::Type::Enum
+
+          LOW_RISK = :LOW_RISK
+          NOT_LOW_RISK = :NOT_LOW_RISK
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+
+      # @see Lithic::Models::ThreeDSAuthentication#app
+      class App < Lithic::Internal::Type::BaseModel
+        # @!attribute device
+        #   Device model: e.g. "Apple iPhone 16".
+        #
+        #   @return [String, nil]
+        optional :device, String, nil?: true
+
+        # @!attribute device_info
+        #   Raw device information - base64-encoded JSON object. Maps to EMV 3DS field
+        #   `deviceInfo`.
+        #
+        #   @return [String, nil]
+        optional :device_info, String, nil?: true
+
+        # @!attribute ip
+        #   IP address of the device.
+        #
+        #   @return [String, nil]
+        optional :ip, String
+
+        # @!attribute latitude
+        #   Latitude coordinate of current device location.
+        #
+        #   @return [Float, nil]
+        optional :latitude, Float, nil?: true
+
+        # @!attribute locale
+        #   Device locale: e.g. "en-US".
+        #
+        #   @return [String, nil]
+        optional :locale, String, nil?: true
+
+        # @!attribute longitude
+        #   Longitude coordinate of current device location.
+        #
+        #   @return [Float, nil]
+        optional :longitude, Float, nil?: true
+
+        # @!attribute os
+        #   Operating System: e.g. "Android 12", "iOS 17.1".
+        #
+        #   @return [String, nil]
+        optional :os, String, nil?: true
+
+        # @!attribute platform
+        #   Device platform: Android, iOS, Windows, etc.
+        #
+        #   @return [String, nil]
+        optional :platform, String, nil?: true
+
+        # @!attribute screen_height
+        #   Screen height in pixels.
+        #
+        #   @return [Integer, nil]
+        optional :screen_height, Integer, nil?: true
+
+        # @!attribute screen_width
+        #   Screen width in pixels.
+        #
+        #   @return [Integer, nil]
+        optional :screen_width, Integer, nil?: true
+
+        # @!attribute time_zone
+        #   Time zone offset in minutes between UTC and device local time.
+        #
+        #   @return [String, nil]
+        optional :time_zone, String, nil?: true
+
+        # @!method initialize(device: nil, device_info: nil, ip: nil, latitude: nil, locale: nil, longitude: nil, os: nil, platform: nil, screen_height: nil, screen_width: nil, time_zone: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Lithic::Models::ThreeDSAuthentication::App} for more details.
+        #
+        #   Object containing data about the app used in the e-commerce transaction. Present
+        #   if the channel is 'APP_BASED'.
+        #
+        #   @param device [String, nil] Device model: e.g. "Apple iPhone 16".
+        #
+        #   @param device_info [String, nil] Raw device information - base64-encoded JSON object. Maps to EMV 3DS field `devi
+        #
+        #   @param ip [String] IP address of the device.
+        #
+        #   @param latitude [Float, nil] Latitude coordinate of current device location.
+        #
+        #   @param locale [String, nil] Device locale: e.g. "en-US".
+        #
+        #   @param longitude [Float, nil] Longitude coordinate of current device location.
+        #
+        #   @param os [String, nil] Operating System: e.g. "Android 12", "iOS 17.1".
+        #
+        #   @param platform [String, nil] Device platform: Android, iOS, Windows, etc.
+        #
+        #   @param screen_height [Integer, nil] Screen height in pixels.
+        #
+        #   @param screen_width [Integer, nil] Screen width in pixels.
+        #
+        #   @param time_zone [String, nil] Time zone offset in minutes between UTC and device local time.
+      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`.
+      #
+      # @see Lithic::Models::ThreeDSAuthentication#authentication_request_type
+      module AuthenticationRequestType
+        extend Lithic::Internal::Type::Enum
+
+        ADD_CARD = :ADD_CARD
+        BILLING_AGREEMENT = :BILLING_AGREEMENT
+        DELAYED_SHIPMENT = :DELAYED_SHIPMENT
+        EMV_TOKEN_CARDHOLDER_VERIFICATION = :EMV_TOKEN_CARDHOLDER_VERIFICATION
+        INSTALLMENT_TRANSACTION = :INSTALLMENT_TRANSACTION
+        MAINTAIN_CARD = :MAINTAIN_CARD
+        PAYMENT_TRANSACTION = :PAYMENT_TRANSACTION
+        RECURRING_TRANSACTION = :RECURRING_TRANSACTION
+        SPLIT_PAYMENT = :SPLIT_PAYMENT
+        SPLIT_SHIPMENT = :SPLIT_SHIPMENT
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # @see Lithic::Models::ThreeDSAuthentication#browser
+      class Browser < Lithic::Internal::Type::BaseModel
+        # @!attribute accept_header
+        #   Content of the HTTP accept headers as sent from the cardholder's browser to the
+        #   3DS requestor (e.g., merchant or digital wallet).
+        #
+        #   @return [String, nil]
+        optional :accept_header, String, nil?: true
+
+        # @!attribute ip
+        #   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`.
+        #
+        #   @return [String, nil]
+        optional :ip, String, nil?: true
+
+        # @!attribute java_enabled
+        #   Indicates whether the cardholder's browser has the ability to execute Java. Maps
+        #   to EMV 3DS field `browserJavaEnabled`.
+        #
+        #   @return [Boolean, nil]
+        optional :java_enabled, Lithic::Internal::Type::Boolean, nil?: true
+
+        # @!attribute javascript_enabled
+        #   Indicates whether the cardholder's browser has the ability to execute
+        #   JavaScript. Maps to EMV 3DS field `browserJavascriptEnabled`.
+        #
+        #   @return [Boolean, nil]
+        optional :javascript_enabled, Lithic::Internal::Type::Boolean, nil?: true
+
+        # @!attribute language
+        #   Language of the cardholder's browser as defined in IETF BCP47. Maps to EMV 3DS
+        #   field `browserLanguage`.
+        #
+        #   @return [String, nil]
+        optional :language, String, nil?: true
+
+        # @!attribute time_zone
+        #   Time zone offset in minutes between UTC and browser local time. Maps to EMV 3DS
+        #   field `browserTz`.
+        #
+        #   @return [String, nil]
+        optional :time_zone, String, nil?: true
+
+        # @!attribute user_agent
+        #   Content of the HTTP user-agent header. Maps to EMV 3DS field `browserUserAgent`.
+        #
+        #   @return [String, nil]
+        optional :user_agent, String, nil?: true
+
+        # @!method initialize(accept_header: nil, ip: nil, java_enabled: nil, javascript_enabled: nil, language: nil, time_zone: nil, user_agent: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Lithic::Models::ThreeDSAuthentication::Browser} for more details.
+        #
+        #   Object containing data about the browser used in the e-commerce transaction.
+        #   Present if the channel is 'BROWSER'.
+        #
+        #   @param accept_header [String, nil] Content of the HTTP accept headers as sent from the cardholder's browser to the
+        #
+        #   @param ip [String, nil] IP address of the browser as returned by the HTTP headers to the 3DS requestor (
+        #
+        #   @param java_enabled [Boolean, nil] Indicates whether the cardholder's browser has the ability to execute Java. Maps
+        #
+        #   @param javascript_enabled [Boolean, nil] Indicates whether the cardholder's browser has the ability to execute JavaScript
+        #
+        #   @param language [String, nil] Language of the cardholder's browser as defined in IETF BCP47. Maps to EMV 3DS f
+        #
+        #   @param time_zone [String, nil] Time zone offset in minutes between UTC and browser local time. Maps to EMV 3DS
+        #
+        #   @param user_agent [String, nil] Content of the HTTP user-agent header. Maps to EMV 3DS field `browserUserAgent`.
+      end
+
+      # @see Lithic::Models::ThreeDSAuthentication#challenge_metadata
+      class ChallengeMetadata < Lithic::Internal::Type::BaseModel
+        # @!attribute method_type
+        #   The type of challenge method used for authentication.
+        #
+        #   @return [Symbol, Lithic::Models::ThreeDSAuthentication::ChallengeMetadata::MethodType]
+        required :method_type, enum: -> { Lithic::ThreeDSAuthentication::ChallengeMetadata::MethodType }
+
+        # @!attribute status
+        #   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
+        #
+        #   @return [Symbol, Lithic::Models::ThreeDSAuthentication::ChallengeMetadata::Status]
+        required :status, enum: -> { Lithic::ThreeDSAuthentication::ChallengeMetadata::Status }
+
+        # @!attribute phone_number
+        #   The phone number used for delivering the OTP. Relevant only for SMS_OTP method.
+        #
+        #   @return [String, nil]
+        optional :phone_number, String, nil?: true
+
+        # @!method initialize(method_type:, status:, phone_number: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Lithic::Models::ThreeDSAuthentication::ChallengeMetadata} for more details.
+        #
+        #   Metadata about the challenge method and delivery. Only present when a challenge
+        #   is triggered.
+        #
+        #   @param method_type [Symbol, Lithic::Models::ThreeDSAuthentication::ChallengeMetadata::MethodType] The type of challenge method used for authentication.
+        #
+        #   @param status [Symbol, Lithic::Models::ThreeDSAuthentication::ChallengeMetadata::Status] Indicates the status of the challenge
+        #
+        #   @param phone_number [String, nil] The phone number used for delivering the OTP. Relevant only for SMS_OTP method.
+
+        # The type of challenge method used for authentication.
+        #
+        # @see Lithic::Models::ThreeDSAuthentication::ChallengeMetadata#method_type
+        module MethodType
+          extend Lithic::Internal::Type::Enum
+
+          SMS_OTP = :SMS_OTP
+          OUT_OF_BAND = :OUT_OF_BAND
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        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
+        #
+        # @see Lithic::Models::ThreeDSAuthentication::ChallengeMetadata#status
+        module Status
+          extend Lithic::Internal::Type::Enum
+
+          SUCCESS = :SUCCESS
+          PENDING = :PENDING
+          SMS_DELIVERY_FAILED = :SMS_DELIVERY_FAILED
+          CARDHOLDER_TIMEOUT = :CARDHOLDER_TIMEOUT
+          CANCELED_VIA_CHALLENGE_UI = :CANCELED_VIA_CHALLENGE_UI
+          CANCELED_OOB = :CANCELED_OOB
+          ATTEMPTS_EXCEEDED = :ATTEMPTS_EXCEEDED
+          ABORTED = :ABORTED
+          ERROR = :ERROR
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        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).
+      #
+      # @see Lithic::Models::ThreeDSAuthentication#challenge_orchestrated_by
+      module ChallengeOrchestratedBy
+        extend Lithic::Internal::Type::Enum
+
+        LITHIC = :LITHIC
+        CUSTOMER = :CUSTOMER
+        NO_CHALLENGE = :NO_CHALLENGE
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      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).
+      #
+      # @see Lithic::Models::ThreeDSAuthentication#decision_made_by
+      module DecisionMadeBy
+        extend Lithic::Internal::Type::Enum
+
+        LITHIC_RULES = :LITHIC_RULES
+        LITHIC_DEFAULT = :LITHIC_DEFAULT
+        CUSTOMER_RULES = :CUSTOMER_RULES
+        CUSTOMER_ENDPOINT = :CUSTOMER_ENDPOINT
+        NETWORK = :NETWORK
+        UNKNOWN = :UNKNOWN
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      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`.
+      #
+      # @see Lithic::Models::ThreeDSAuthentication#three_ri_request_type
+      module ThreeRiRequestType
+        extend Lithic::Internal::Type::Enum
+
+        ACCOUNT_VERIFICATION = :ACCOUNT_VERIFICATION
+        ADD_CARD = :ADD_CARD
+        BILLING_AGREEMENT = :BILLING_AGREEMENT
+        CARD_SECURITY_CODE_STATUS_CHECK = :CARD_SECURITY_CODE_STATUS_CHECK
+        DELAYED_SHIPMENT = :DELAYED_SHIPMENT
+        DEVICE_BINDING_STATUS_CHECK = :DEVICE_BINDING_STATUS_CHECK
+        INSTALLMENT_TRANSACTION = :INSTALLMENT_TRANSACTION
+        MAIL_ORDER = :MAIL_ORDER
+        MAINTAIN_CARD_INFO = :MAINTAIN_CARD_INFO
+        OTHER_PAYMENT = :OTHER_PAYMENT
+        RECURRING_TRANSACTION = :RECURRING_TRANSACTION
+        SPLIT_PAYMENT = :SPLIT_PAYMENT
+        SPLIT_SHIPMENT = :SPLIT_SHIPMENT
+        TELEPHONE_ORDER = :TELEPHONE_ORDER
+        TOP_UP = :TOP_UP
+        TRUST_LIST_STATUS_CHECK = :TRUST_LIST_STATUS_CHECK
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # @see Lithic::Models::ThreeDSAuthentication#transaction
+      class Transaction < Lithic::Internal::Type::BaseModel
+        # @!attribute amount
+        #   Amount of the purchase in minor units of currency with all punctuation removed.
+        #   Maps to EMV 3DS field `purchaseAmount`.
+        #
+        #   @return [Float]
+        required :amount, Float
+
+        # @!attribute cardholder_amount
+        #   Approximate amount of the purchase in minor units of cardholder currency.
+        #   Derived from `amount` using a daily conversion rate.
+        #
+        #   @return [Float, nil]
+        required :cardholder_amount, Float, nil?: true
+
+        # @!attribute currency
+        #   Currency of the purchase. Maps to EMV 3DS field `purchaseCurrency`. Permitted
+        #   values: ISO 4217 three-character currency code (e.g., USD).
+        #
+        #   @return [String]
+        required :currency, String
+
+        # @!attribute currency_exponent
+        #   Minor units of currency, as specified in ISO 4217 currency exponent. Maps to EMV
+        #   3DS field `purchaseExponent`.
+        #
+        #   @return [Float]
+        required :currency_exponent, Float
+
+        # @!attribute date_time
+        #   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.
+        #
+        #   @return [Time]
+        required :date_time, Time
+
+        # @!attribute type
+        #   Type of the transaction for which a 3DS authentication request is occurring.
+        #   Maps to EMV 3DS field `transType`.
+        #
+        #   @return [Symbol, Lithic::Models::ThreeDSAuthentication::Transaction::Type, nil]
+        required :type, enum: -> { Lithic::ThreeDSAuthentication::Transaction::Type }, nil?: true
+
+        # @!method initialize(amount:, cardholder_amount:, currency:, currency_exponent:, date_time:, type:)
+        #   Some parameter documentations has been truncated, see
+        #   {Lithic::Models::ThreeDSAuthentication::Transaction} for more details.
+        #
+        #   Object containing data about the e-commerce transaction for which the merchant
+        #   is requesting authentication.
+        #
+        #   @param amount [Float] Amount of the purchase in minor units of currency with all punctuation removed.
+        #
+        #   @param cardholder_amount [Float, nil] Approximate amount of the purchase in minor units of cardholder currency. Derive
+        #
+        #   @param currency [String] Currency of the purchase. Maps to EMV 3DS field `purchaseCurrency`. Permitted va
+        #
+        #   @param currency_exponent [Float] Minor units of currency, as specified in ISO 4217 currency exponent. Maps to EMV
+        #
+        #   @param date_time [Time] Date and time when the authentication was generated by the merchant/acquirer's 3
+        #
+        #   @param type [Symbol, Lithic::Models::ThreeDSAuthentication::Transaction::Type, nil] Type of the transaction for which a 3DS authentication request is occurring. Map
+
+        # Type of the transaction for which a 3DS authentication request is occurring.
+        # Maps to EMV 3DS field `transType`.
+        #
+        # @see Lithic::Models::ThreeDSAuthentication::Transaction#type
+        module Type
+          extend Lithic::Internal::Type::Enum
+
+          ACCOUNT_FUNDING = :ACCOUNT_FUNDING
+          CHECK_ACCEPTANCE = :CHECK_ACCEPTANCE
+          GOODS_SERVICE_PURCHASE = :GOODS_SERVICE_PURCHASE
+          PREPAID_ACTIVATION_AND_LOAD = :PREPAID_ACTIVATION_AND_LOAD
+          QUASI_CASH_TRANSACTION = :QUASI_CASH_TRANSACTION
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end