lithic 0.14.0 → 0.16.0

data/lib/lithic/models/card_authorization.rb

@@ -0,0 +1,1372 @@
+# frozen_string_literal: true
+
+module Lithic
+  module Models
+    class CardAuthorization < Lithic::Internal::Type::BaseModel
+      # @!attribute token
+      #   The provisional transaction group uuid associated with the authorization
+      #
+      #   @return [String]
+      required :token, String
+
+      # @!attribute acquirer_fee
+      #   Fee (in cents) assessed by the merchant and paid for by the cardholder. Will be
+      #   zero if no fee is assessed. Rebates may be transmitted as a negative value to
+      #   indicate credited fees.
+      #
+      #   @return [Integer]
+      required :acquirer_fee, Integer
+
+      # @!attribute amount
+      #   @deprecated
+      #
+      #   Deprecated, use `amounts`. Authorization amount of the transaction (in cents),
+      #   including any acquirer fees. The contents of this field are identical to
+      #   `authorization_amount`.
+      #
+      #   @return [Integer]
+      required :amount, Integer
+
+      # @!attribute amounts
+      #   Structured amounts for this authorization. The `cardholder` and `merchant`
+      #   amounts reflect the original network authorization values. For programs with
+      #   hold adjustments enabled (e.g., automated fuel dispensers or tipping MCCs), the
+      #   `hold` amount may exceed the `cardholder` and `merchant` amounts to account for
+      #   anticipated final transaction amounts such as tips or fuel fill-ups
+      #
+      #   @return [Lithic::Models::CardAuthorization::Amounts]
+      required :amounts, -> { Lithic::CardAuthorization::Amounts }
+
+      # @!attribute authorization_amount
+      #   @deprecated
+      #
+      #   Deprecated, use `amounts`. The base transaction amount (in cents) plus the
+      #   acquirer fee field. This is the amount the issuer should authorize against
+      #   unless the issuer is paying the acquirer fee on behalf of the cardholder.
+      #
+      #   @return [Integer]
+      required :authorization_amount, Integer
+
+      # @!attribute avs
+      #
+      #   @return [Lithic::Models::CardAuthorization::Avs]
+      required :avs, -> { Lithic::CardAuthorization::Avs }
+
+      # @!attribute card
+      #   Card object in ASA
+      #
+      #   @return [Lithic::Models::CardAuthorization::Card]
+      required :card, -> { Lithic::CardAuthorization::Card }
+
+      # @!attribute cardholder_currency
+      #   @deprecated
+      #
+      #   Deprecated, use `amounts`. 3-character alphabetic ISO 4217 code for cardholder's
+      #   billing currency.
+      #
+      #   @return [String]
+      required :cardholder_currency, String
+
+      # @!attribute cash_amount
+      #   The portion of the transaction requested as cash back by the cardholder, and
+      #   does not include any acquirer fees. The amount field includes the purchase
+      #   amount, the requested cash back amount, and any acquirer fees.
+      #
+      #   If no cash back was requested, the value of this field will be 0, and the field
+      #   will always be present.
+      #
+      #   @return [Integer]
+      required :cash_amount, Integer
+
+      # @!attribute created
+      #   Date and time when the transaction first occurred in UTC.
+      #
+      #   @return [Time]
+      required :created, Time
+
+      # @!attribute merchant
+      #   Merchant information including full location details.
+      #
+      #   @return [Lithic::Models::CardAuthorization::Merchant]
+      required :merchant, -> { Lithic::CardAuthorization::Merchant }
+
+      # @!attribute merchant_amount
+      #   @deprecated
+      #
+      #   Deprecated, use `amounts`. The amount that the merchant will receive,
+      #   denominated in `merchant_currency` and in the smallest currency unit. Note the
+      #   amount includes `acquirer_fee`, similar to `authorization_amount`. It will be
+      #   different from `authorization_amount` if the merchant is taking payment in a
+      #   different currency.
+      #
+      #   @return [Integer]
+      required :merchant_amount, Integer
+
+      # @!attribute merchant_currency
+      #   @deprecated
+      #
+      #   3-character alphabetic ISO 4217 code for the local currency of the transaction.
+      #
+      #   @return [String]
+      required :merchant_currency, String
+
+      # @!attribute name_validation
+      #   Network name validation data, present when the card network requested name
+      #   validation for this transaction. Contains the cardholder name provided by the
+      #   network and Lithic's computed match result against KYC data on file.
+      #
+      #   @return [Lithic::Models::CardAuthorization::NameValidation, nil]
+      required :name_validation, -> { Lithic::CardAuthorization::NameValidation }, nil?: true
+
+      # @!attribute service_location
+      #   Where the cardholder received the service, when different from the card acceptor
+      #   location. This is populated from network data elements such as Mastercard DE-122
+      #   SE1 SF9-14 and Visa F34 DS02.
+      #
+      #   @return [Lithic::Models::CardAuthorization::ServiceLocation, nil]
+      required :service_location, -> { Lithic::CardAuthorization::ServiceLocation }, nil?: true
+
+      # @!attribute settled_amount
+      #   @deprecated
+      #
+      #   Deprecated, use `amounts`. Amount (in cents) of the transaction that has been
+      #   settled, including any acquirer fees.
+      #
+      #   @return [Integer]
+      required :settled_amount, Integer
+
+      # @!attribute status
+      #   The type of authorization request that this request is for. Note that
+      #   `CREDIT_AUTHORIZATION` and `FINANCIAL_CREDIT_AUTHORIZATION` is only available to
+      #   users with credit decisioning via ASA enabled.
+      #
+      #   @return [Symbol, Lithic::Models::CardAuthorization::Status]
+      required :status, enum: -> { Lithic::CardAuthorization::Status }
+
+      # @!attribute transaction_initiator
+      #   The entity that initiated the transaction.
+      #
+      #   @return [Symbol, Lithic::Models::CardAuthorization::TransactionInitiator]
+      required :transaction_initiator, enum: -> { Lithic::CardAuthorization::TransactionInitiator }
+
+      # @!attribute account_type
+      #
+      #   @return [Symbol, Lithic::Models::CardAuthorization::AccountType, nil]
+      optional :account_type, enum: -> { Lithic::CardAuthorization::AccountType }
+
+      # @!attribute cardholder_authentication
+      #
+      #   @return [Lithic::Models::CardholderAuthentication, nil]
+      optional :cardholder_authentication, -> { Lithic::CardholderAuthentication }
+
+      # @!attribute cashback
+      #   Deprecated, use `cash_amount`.
+      #
+      #   @return [Integer, nil]
+      optional :cashback, Integer
+
+      # @!attribute conversion_rate
+      #   @deprecated
+      #
+      #   Deprecated, use `amounts`. If the transaction was requested in a currency other
+      #   than the settlement currency, this field will be populated to indicate the rate
+      #   used to translate the merchant_amount to the amount (i.e., `merchant_amount` x
+      #   `conversion_rate` = `amount`). Note that the `merchant_amount` is in the local
+      #   currency and the amount is in the settlement currency.
+      #
+      #   @return [Float, nil]
+      optional :conversion_rate, Float
+
+      # @!attribute event_token
+      #   The event token associated with the authorization. This field is only set for
+      #   programs enrolled into the beta.
+      #
+      #   @return [String, nil]
+      optional :event_token, String
+
+      # @!attribute fleet_info
+      #   Optional Object containing information if the Card is a part of a Fleet managed
+      #   program
+      #
+      #   @return [Lithic::Models::CardAuthorization::FleetInfo, nil]
+      optional :fleet_info, -> { Lithic::CardAuthorization::FleetInfo }, nil?: true
+
+      # @!attribute latest_challenge
+      #   The latest Authorization Challenge that was issued to the cardholder for this
+      #   merchant.
+      #
+      #   @return [Lithic::Models::CardAuthorization::LatestChallenge, nil]
+      optional :latest_challenge, -> { Lithic::CardAuthorization::LatestChallenge }
+
+      # @!attribute network
+      #   Card network of the authorization.
+      #
+      #   @return [Symbol, Lithic::Models::CardAuthorization::Network, nil]
+      optional :network, enum: -> { Lithic::CardAuthorization::Network }
+
+      # @!attribute network_risk_score
+      #   Network-provided score assessing risk level associated with a given
+      #   authorization. Scores are on a range of 0-999, with 0 representing the lowest
+      #   risk and 999 representing the highest risk. For Visa transactions, where the raw
+      #   score has a range of 0-99, Lithic will normalize the score by multiplying the
+      #   raw score by 10x.
+      #
+      #   @return [Integer, nil]
+      optional :network_risk_score, Integer, nil?: true
+
+      # @!attribute network_specific_data
+      #   Contains raw data provided by the card network, including attributes that
+      #   provide further context about the authorization. If populated by the network,
+      #   data is organized by Lithic and passed through without further modification.
+      #   Please consult the official network documentation for more details about these
+      #   values and how to use them. This object is only available to certain programs-
+      #   contact your Customer Success Manager to discuss enabling access.
+      #
+      #   @return [Lithic::Models::CardAuthorization::NetworkSpecificData, nil]
+      optional :network_specific_data, -> { Lithic::CardAuthorization::NetworkSpecificData }, nil?: true
+
+      # @!attribute pos
+      #
+      #   @return [Lithic::Models::CardAuthorization::Pos, nil]
+      optional :pos, -> { Lithic::CardAuthorization::Pos }
+
+      # @!attribute token_info
+      #
+      #   @return [Lithic::Models::TokenInfo, nil]
+      optional :token_info, -> { Lithic::TokenInfo }, nil?: true
+
+      # @!attribute ttl
+      #   Deprecated: approximate time-to-live for the authorization.
+      #
+      #   @return [Time, nil]
+      optional :ttl, Time
+
+      # @!method initialize(token:, acquirer_fee:, amount:, amounts:, authorization_amount:, avs:, card:, cardholder_currency:, cash_amount:, created:, merchant:, merchant_amount:, merchant_currency:, name_validation:, service_location:, settled_amount:, status:, transaction_initiator:, account_type: nil, cardholder_authentication: nil, cashback: nil, conversion_rate: nil, event_token: nil, fleet_info: nil, latest_challenge: nil, network: nil, network_risk_score: nil, network_specific_data: nil, pos: nil, token_info: nil, ttl: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Lithic::Models::CardAuthorization} for more details.
+      #
+      #   Card Authorization
+      #
+      #   @param token [String] The provisional transaction group uuid associated with the authorization
+      #
+      #   @param acquirer_fee [Integer] Fee (in cents) assessed by the merchant and paid for by the cardholder. Will be
+      #
+      #   @param amount [Integer] Deprecated, use `amounts`. Authorization amount of the transaction (in cents), i
+      #
+      #   @param amounts [Lithic::Models::CardAuthorization::Amounts] Structured amounts for this authorization. The `cardholder` and `merchant` amoun
+      #
+      #   @param authorization_amount [Integer] Deprecated, use `amounts`. The base transaction amount (in cents) plus the acqui
+      #
+      #   @param avs [Lithic::Models::CardAuthorization::Avs]
+      #
+      #   @param card [Lithic::Models::CardAuthorization::Card] Card object in ASA
+      #
+      #   @param cardholder_currency [String] Deprecated, use `amounts`. 3-character alphabetic ISO 4217 code for cardholder's
+      #
+      #   @param cash_amount [Integer] The portion of the transaction requested as cash back by the cardholder, and doe
+      #
+      #   @param created [Time] Date and time when the transaction first occurred in UTC.
+      #
+      #   @param merchant [Lithic::Models::CardAuthorization::Merchant] Merchant information including full location details.
+      #
+      #   @param merchant_amount [Integer] Deprecated, use `amounts`. The amount that the merchant will receive, denominate
+      #
+      #   @param merchant_currency [String] 3-character alphabetic ISO 4217 code for the local currency of the transaction.
+      #
+      #   @param name_validation [Lithic::Models::CardAuthorization::NameValidation, nil] Network name validation data, present when the card network requested name valid
+      #
+      #   @param service_location [Lithic::Models::CardAuthorization::ServiceLocation, nil] Where the cardholder received the service, when different from the card acceptor
+      #
+      #   @param settled_amount [Integer] Deprecated, use `amounts`. Amount (in cents) of the transaction that has been se
+      #
+      #   @param status [Symbol, Lithic::Models::CardAuthorization::Status] The type of authorization request that this request is for. Note that `CREDIT_AU
+      #
+      #   @param transaction_initiator [Symbol, Lithic::Models::CardAuthorization::TransactionInitiator] The entity that initiated the transaction.
+      #
+      #   @param account_type [Symbol, Lithic::Models::CardAuthorization::AccountType]
+      #
+      #   @param cardholder_authentication [Lithic::Models::CardholderAuthentication]
+      #
+      #   @param cashback [Integer] Deprecated, use `cash_amount`.
+      #
+      #   @param conversion_rate [Float] Deprecated, use `amounts`. If the transaction was requested in a currency other
+      #
+      #   @param event_token [String] The event token associated with the authorization. This field is only set for pr
+      #
+      #   @param fleet_info [Lithic::Models::CardAuthorization::FleetInfo, nil] Optional Object containing information if the Card is a part of a Fleet managed
+      #
+      #   @param latest_challenge [Lithic::Models::CardAuthorization::LatestChallenge] The latest Authorization Challenge that was issued to the cardholder for this me
+      #
+      #   @param network [Symbol, Lithic::Models::CardAuthorization::Network] Card network of the authorization.
+      #
+      #   @param network_risk_score [Integer, nil] Network-provided score assessing risk level associated with a given authorizatio
+      #
+      #   @param network_specific_data [Lithic::Models::CardAuthorization::NetworkSpecificData, nil] Contains raw data provided by the card network, including attributes that provid
+      #
+      #   @param pos [Lithic::Models::CardAuthorization::Pos]
+      #
+      #   @param token_info [Lithic::Models::TokenInfo, nil]
+      #
+      #   @param ttl [Time] Deprecated: approximate time-to-live for the authorization.
+
+      # @see Lithic::Models::CardAuthorization#amounts
+      class Amounts < Lithic::Internal::Type::BaseModel
+        # @!attribute cardholder
+        #
+        #   @return [Lithic::Models::CardAuthorization::Amounts::Cardholder]
+        required :cardholder, -> { Lithic::CardAuthorization::Amounts::Cardholder }
+
+        # @!attribute hold
+        #
+        #   @return [Lithic::Models::CardAuthorization::Amounts::Hold, nil]
+        required :hold, -> { Lithic::CardAuthorization::Amounts::Hold }, nil?: true
+
+        # @!attribute merchant
+        #
+        #   @return [Lithic::Models::CardAuthorization::Amounts::Merchant]
+        required :merchant, -> { Lithic::CardAuthorization::Amounts::Merchant }
+
+        # @!attribute settlement
+        #
+        #   @return [Lithic::Models::CardAuthorization::Amounts::Settlement, nil]
+        required :settlement, -> { Lithic::CardAuthorization::Amounts::Settlement }, nil?: true
+
+        # @!method initialize(cardholder:, hold:, merchant:, settlement:)
+        #   Structured amounts for this authorization. The `cardholder` and `merchant`
+        #   amounts reflect the original network authorization values. For programs with
+        #   hold adjustments enabled (e.g., automated fuel dispensers or tipping MCCs), the
+        #   `hold` amount may exceed the `cardholder` and `merchant` amounts to account for
+        #   anticipated final transaction amounts such as tips or fuel fill-ups
+        #
+        #   @param cardholder [Lithic::Models::CardAuthorization::Amounts::Cardholder]
+        #   @param hold [Lithic::Models::CardAuthorization::Amounts::Hold, nil]
+        #   @param merchant [Lithic::Models::CardAuthorization::Amounts::Merchant]
+        #   @param settlement [Lithic::Models::CardAuthorization::Amounts::Settlement, nil]
+
+        # @see Lithic::Models::CardAuthorization::Amounts#cardholder
+        class Cardholder < Lithic::Internal::Type::BaseModel
+          # @!attribute amount
+          #   Amount in the smallest unit of the applicable currency (e.g., cents)
+          #
+          #   @return [Integer]
+          required :amount, Integer
+
+          # @!attribute conversion_rate
+          #   Exchange rate used for currency conversion
+          #
+          #   @return [String]
+          required :conversion_rate, String
+
+          # @!attribute currency
+          #   3-character alphabetic ISO 4217 currency
+          #
+          #   @return [String]
+          required :currency, String
+
+          # @!method initialize(amount:, conversion_rate:, currency:)
+          #   @param amount [Integer] Amount in the smallest unit of the applicable currency (e.g., cents)
+          #
+          #   @param conversion_rate [String] Exchange rate used for currency conversion
+          #
+          #   @param currency [String] 3-character alphabetic ISO 4217 currency
+        end
+
+        # @see Lithic::Models::CardAuthorization::Amounts#hold
+        class Hold < Lithic::Internal::Type::BaseModel
+          # @!attribute amount
+          #   Amount in the smallest unit of the applicable currency (e.g., cents)
+          #
+          #   @return [Integer]
+          required :amount, Integer
+
+          # @!attribute currency
+          #   3-character alphabetic ISO 4217 currency
+          #
+          #   @return [String]
+          required :currency, String
+
+          # @!method initialize(amount:, currency:)
+          #   @param amount [Integer] Amount in the smallest unit of the applicable currency (e.g., cents)
+          #
+          #   @param currency [String] 3-character alphabetic ISO 4217 currency
+        end
+
+        # @see Lithic::Models::CardAuthorization::Amounts#merchant
+        class Merchant < Lithic::Internal::Type::BaseModel
+          # @!attribute amount
+          #   Amount in the smallest unit of the applicable currency (e.g., cents)
+          #
+          #   @return [Integer]
+          required :amount, Integer
+
+          # @!attribute currency
+          #   3-character alphabetic ISO 4217 currency
+          #
+          #   @return [String]
+          required :currency, String
+
+          # @!method initialize(amount:, currency:)
+          #   @param amount [Integer] Amount in the smallest unit of the applicable currency (e.g., cents)
+          #
+          #   @param currency [String] 3-character alphabetic ISO 4217 currency
+        end
+
+        # @see Lithic::Models::CardAuthorization::Amounts#settlement
+        class Settlement < Lithic::Internal::Type::BaseModel
+          # @!attribute amount
+          #   Amount in the smallest unit of the applicable currency (e.g., cents)
+          #
+          #   @return [Integer]
+          required :amount, Integer
+
+          # @!attribute currency
+          #   3-character alphabetic ISO 4217 currency
+          #
+          #   @return [String]
+          required :currency, String
+
+          # @!method initialize(amount:, currency:)
+          #   @param amount [Integer] Amount in the smallest unit of the applicable currency (e.g., cents)
+          #
+          #   @param currency [String] 3-character alphabetic ISO 4217 currency
+        end
+      end
+
+      # @see Lithic::Models::CardAuthorization#avs
+      class Avs < Lithic::Internal::Type::BaseModel
+        # @!attribute address
+        #   Cardholder address
+        #
+        #   @return [String]
+        required :address, String
+
+        # @!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::CardAuthorization::Avs::AddressOnFileMatch]
+        required :address_on_file_match, enum: -> { Lithic::CardAuthorization::Avs::AddressOnFileMatch }
+
+        # @!attribute zipcode
+        #   Cardholder ZIP code
+        #
+        #   @return [String]
+        required :zipcode, String
+
+        # @!method initialize(address:, address_on_file_match:, zipcode:)
+        #   Some parameter documentations has been truncated, see
+        #   {Lithic::Models::CardAuthorization::Avs} for more details.
+        #
+        #   @param address [String] Cardholder address
+        #
+        #   @param address_on_file_match [Symbol, Lithic::Models::CardAuthorization::Avs::AddressOnFileMatch] Lithic's evaluation result comparing the transaction's address data with the car
+        #
+        #   @param zipcode [String] Cardholder ZIP code
+
+        # 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::CardAuthorization::Avs#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
+      end
+
+      # @see Lithic::Models::CardAuthorization#card
+      class Card < Lithic::Internal::Type::BaseModel
+        # @!attribute token
+        #   Globally unique identifier for the card.
+        #
+        #   @return [String]
+        required :token, String
+
+        # @!attribute last_four
+        #   Last four digits of the card number
+        #
+        #   @return [String]
+        required :last_four, String
+
+        # @!attribute memo
+        #   Customizable name to identify the card
+        #
+        #   @return [String]
+        required :memo, String
+
+        # @!attribute spend_limit
+        #   Amount (in cents) to limit approved authorizations. Purchase requests above the
+        #   spend limit will be declined (refunds and credits will be approved).
+        #
+        #   Note that while spend limits are enforced based on authorized and settled volume
+        #   on a card, they are not recommended to be used for balance or
+        #   reconciliation-level accuracy. Spend limits also cannot block force posted
+        #   charges (i.e., when a merchant sends a clearing message without a prior
+        #   authorization).
+        #
+        #   @return [Integer]
+        required :spend_limit, Integer
+
+        # @!attribute spend_limit_duration
+        #   Note that to support recurring monthly payments, which can occur on different
+        #   day every month, the time window we consider for MONTHLY velocity starts 6 days
+        #   after the current calendar date one month prior.
+        #
+        #   @return [Symbol, Lithic::Models::CardAuthorization::Card::SpendLimitDuration]
+        required :spend_limit_duration, enum: -> { Lithic::CardAuthorization::Card::SpendLimitDuration }
+
+        # @!attribute state
+        #
+        #   @return [Symbol, Lithic::Models::CardAuthorization::Card::State]
+        required :state, enum: -> { Lithic::CardAuthorization::Card::State }
+
+        # @!attribute type
+        #
+        #   @return [Symbol, Lithic::Models::CardAuthorization::Card::Type]
+        required :type, enum: -> { Lithic::CardAuthorization::Card::Type }
+
+        # @!method initialize(token:, last_four:, memo:, spend_limit:, spend_limit_duration:, state:, type:)
+        #   Some parameter documentations has been truncated, see
+        #   {Lithic::Models::CardAuthorization::Card} for more details.
+        #
+        #   Card object in ASA
+        #
+        #   @param token [String] Globally unique identifier for the card.
+        #
+        #   @param last_four [String] Last four digits of the card number
+        #
+        #   @param memo [String] Customizable name to identify the card
+        #
+        #   @param spend_limit [Integer] Amount (in cents) to limit approved authorizations. Purchase requests above the
+        #
+        #   @param spend_limit_duration [Symbol, Lithic::Models::CardAuthorization::Card::SpendLimitDuration] Note that to support recurring monthly payments, which can occur on different da
+        #
+        #   @param state [Symbol, Lithic::Models::CardAuthorization::Card::State]
+        #
+        #   @param type [Symbol, Lithic::Models::CardAuthorization::Card::Type]
+
+        # Note that to support recurring monthly payments, which can occur on different
+        # day every month, the time window we consider for MONTHLY velocity starts 6 days
+        # after the current calendar date one month prior.
+        #
+        # @see Lithic::Models::CardAuthorization::Card#spend_limit_duration
+        module SpendLimitDuration
+          extend Lithic::Internal::Type::Enum
+
+          ANNUALLY = :ANNUALLY
+          FOREVER = :FOREVER
+          MONTHLY = :MONTHLY
+          TRANSACTION = :TRANSACTION
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # @see Lithic::Models::CardAuthorization::Card#state
+        module State
+          extend Lithic::Internal::Type::Enum
+
+          CLOSED = :CLOSED
+          OPEN = :OPEN
+          PAUSED = :PAUSED
+          PENDING_ACTIVATION = :PENDING_ACTIVATION
+          PENDING_FULFILLMENT = :PENDING_FULFILLMENT
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # @see Lithic::Models::CardAuthorization::Card#type
+        module Type
+          extend Lithic::Internal::Type::Enum
+
+          SINGLE_USE = :SINGLE_USE
+          MERCHANT_LOCKED = :MERCHANT_LOCKED
+          UNLOCKED = :UNLOCKED
+          PHYSICAL = :PHYSICAL
+          DIGITAL_WALLET = :DIGITAL_WALLET
+          VIRTUAL = :VIRTUAL
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+
+      # @see Lithic::Models::CardAuthorization#merchant
+      class Merchant < Lithic::Models::Merchant
+        # @!attribute phone_number
+        #   Phone number of card acceptor.
+        #
+        #   @return [String, nil]
+        required :phone_number, String, nil?: true
+
+        # @!attribute postal_code
+        #   Postal code of card acceptor.
+        #
+        #   @return [String, nil]
+        required :postal_code, String, nil?: true
+
+        # @!attribute street_address
+        #   Street address of card acceptor.
+        #
+        #   @return [String, nil]
+        required :street_address, String, nil?: true
+
+        # @!method initialize(phone_number:, postal_code:, street_address:)
+        #   Merchant information including full location details.
+        #
+        #   @param phone_number [String, nil] Phone number of card acceptor.
+        #
+        #   @param postal_code [String, nil] Postal code of card acceptor.
+        #
+        #   @param street_address [String, nil] Street address of card acceptor.
+      end
+
+      # @see Lithic::Models::CardAuthorization#name_validation
+      class NameValidation < Lithic::Internal::Type::BaseModel
+        # @!attribute name
+        #   Cardholder name as provided by the card network.
+        #
+        #   @return [Lithic::Models::CardAuthorization::NameValidation::Name]
+        required :name, -> { Lithic::CardAuthorization::NameValidation::Name }
+
+        # @!attribute name_on_file_match
+        #   Lithic's computed match result comparing the network-provided name to the name
+        #   on file.
+        #
+        #   @return [Lithic::Models::CardAuthorization::NameValidation::NameOnFileMatch]
+        required :name_on_file_match, -> { Lithic::CardAuthorization::NameValidation::NameOnFileMatch }
+
+        # @!method initialize(name:, name_on_file_match:)
+        #   Some parameter documentations has been truncated, see
+        #   {Lithic::Models::CardAuthorization::NameValidation} for more details.
+        #
+        #   Network name validation data, present when the card network requested name
+        #   validation for this transaction. Contains the cardholder name provided by the
+        #   network and Lithic's computed match result against KYC data on file.
+        #
+        #   @param name [Lithic::Models::CardAuthorization::NameValidation::Name] Cardholder name as provided by the card network.
+        #
+        #   @param name_on_file_match [Lithic::Models::CardAuthorization::NameValidation::NameOnFileMatch] Lithic's computed match result comparing the network-provided name to the name o
+
+        # @see Lithic::Models::CardAuthorization::NameValidation#name
+        class Name < Lithic::Internal::Type::BaseModel
+          # @!attribute first
+          #   First name
+          #
+          #   @return [String]
+          required :first, String
+
+          # @!attribute last
+          #   Last name
+          #
+          #   @return [String]
+          required :last, String
+
+          # @!attribute middle
+          #   Middle name
+          #
+          #   @return [String, nil]
+          required :middle, String, nil?: true
+
+          # @!method initialize(first:, last:, middle:)
+          #   Cardholder name as provided by the card network.
+          #
+          #   @param first [String] First name
+          #
+          #   @param last [String] Last name
+          #
+          #   @param middle [String, nil] Middle name
+        end
+
+        # @see Lithic::Models::CardAuthorization::NameValidation#name_on_file_match
+        class NameOnFileMatch < Lithic::Internal::Type::BaseModel
+          # @!attribute full_name
+          #   Overall name match result.
+          #
+          #   @return [Symbol, Lithic::Models::CardAuthorization::NameValidation::NameOnFileMatch::FullName]
+          required :full_name, enum: -> { Lithic::CardAuthorization::NameValidation::NameOnFileMatch::FullName }
+
+          # @!method initialize(full_name:)
+          #   Lithic's computed match result comparing the network-provided name to the name
+          #   on file.
+          #
+          #   @param full_name [Symbol, Lithic::Models::CardAuthorization::NameValidation::NameOnFileMatch::FullName] Overall name match result.
+
+          # Overall name match result.
+          #
+          # @see Lithic::Models::CardAuthorization::NameValidation::NameOnFileMatch#full_name
+          module FullName
+            extend Lithic::Internal::Type::Enum
+
+            MATCH = :MATCH
+            PARTIAL_MATCH = :PARTIAL_MATCH
+            NO_MATCH = :NO_MATCH
+            UNVERIFIED = :UNVERIFIED
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+      end
+
+      # @see Lithic::Models::CardAuthorization#service_location
+      class ServiceLocation < Lithic::Internal::Type::BaseModel
+        # @!attribute city
+        #   City of service location.
+        #
+        #   @return [String, nil]
+        required :city, String, nil?: true
+
+        # @!attribute country
+        #   Country code of service location, ISO 3166-1 alpha-3.
+        #
+        #   @return [String, nil]
+        required :country, String, nil?: true
+
+        # @!attribute postal_code
+        #   Postal code of service location.
+        #
+        #   @return [String, nil]
+        required :postal_code, String, nil?: true
+
+        # @!attribute state
+        #   State/province code of service location, ISO 3166-2.
+        #
+        #   @return [String, nil]
+        required :state, String, nil?: true
+
+        # @!attribute street_address
+        #   Street address of service location.
+        #
+        #   @return [String, nil]
+        required :street_address, String, nil?: true
+
+        # @!method initialize(city:, country:, postal_code:, state:, street_address:)
+        #   Where the cardholder received the service, when different from the card acceptor
+        #   location. This is populated from network data elements such as Mastercard DE-122
+        #   SE1 SF9-14 and Visa F34 DS02.
+        #
+        #   @param city [String, nil] City of service location.
+        #
+        #   @param country [String, nil] Country code of service location, ISO 3166-1 alpha-3.
+        #
+        #   @param postal_code [String, nil] Postal code of service location.
+        #
+        #   @param state [String, nil] State/province code of service location, ISO 3166-2.
+        #
+        #   @param street_address [String, nil] Street address of service location.
+      end
+
+      # The type of authorization request that this request is for. Note that
+      # `CREDIT_AUTHORIZATION` and `FINANCIAL_CREDIT_AUTHORIZATION` is only available to
+      # users with credit decisioning via ASA enabled.
+      #
+      # @see Lithic::Models::CardAuthorization#status
+      module Status
+        extend Lithic::Internal::Type::Enum
+
+        AUTHORIZATION = :AUTHORIZATION
+        CREDIT_AUTHORIZATION = :CREDIT_AUTHORIZATION
+        FINANCIAL_AUTHORIZATION = :FINANCIAL_AUTHORIZATION
+        FINANCIAL_CREDIT_AUTHORIZATION = :FINANCIAL_CREDIT_AUTHORIZATION
+        BALANCE_INQUIRY = :BALANCE_INQUIRY
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # The entity that initiated the transaction.
+      #
+      # @see Lithic::Models::CardAuthorization#transaction_initiator
+      module TransactionInitiator
+        extend Lithic::Internal::Type::Enum
+
+        CARDHOLDER = :CARDHOLDER
+        MERCHANT = :MERCHANT
+        UNKNOWN = :UNKNOWN
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # @see Lithic::Models::CardAuthorization#account_type
+      module AccountType
+        extend Lithic::Internal::Type::Enum
+
+        CHECKING = :CHECKING
+        SAVINGS = :SAVINGS
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # @see Lithic::Models::CardAuthorization#fleet_info
+      class FleetInfo < Lithic::Internal::Type::BaseModel
+        # @!attribute fleet_prompt_code
+        #   Code indicating what the driver was prompted to enter at time of purchase. This
+        #   is configured at a program level and is a static configuration, and does not
+        #   change on a request to request basis
+        #
+        #   @return [Symbol, Lithic::Models::CardAuthorization::FleetInfo::FleetPromptCode]
+        required :fleet_prompt_code, enum: -> { Lithic::CardAuthorization::FleetInfo::FleetPromptCode }
+
+        # @!attribute fleet_restriction_code
+        #   Code indicating which restrictions, if any, there are on purchase. This is
+        #   configured at a program level and is a static configuration, and does not change
+        #   on a request to request basis
+        #
+        #   @return [Symbol, Lithic::Models::CardAuthorization::FleetInfo::FleetRestrictionCode]
+        required :fleet_restriction_code, enum: -> { Lithic::CardAuthorization::FleetInfo::FleetRestrictionCode }
+
+        # @!attribute driver_number
+        #   Number representing the driver
+        #
+        #   @return [String, nil]
+        optional :driver_number, String, nil?: true
+
+        # @!attribute vehicle_number
+        #   Number associated with the vehicle
+        #
+        #   @return [String, nil]
+        optional :vehicle_number, String, nil?: true
+
+        # @!method initialize(fleet_prompt_code:, fleet_restriction_code:, driver_number: nil, vehicle_number: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Lithic::Models::CardAuthorization::FleetInfo} for more details.
+        #
+        #   Optional Object containing information if the Card is a part of a Fleet managed
+        #   program
+        #
+        #   @param fleet_prompt_code [Symbol, Lithic::Models::CardAuthorization::FleetInfo::FleetPromptCode] Code indicating what the driver was prompted to enter at time of purchase. This
+        #
+        #   @param fleet_restriction_code [Symbol, Lithic::Models::CardAuthorization::FleetInfo::FleetRestrictionCode] Code indicating which restrictions, if any, there are on purchase. This is confi
+        #
+        #   @param driver_number [String, nil] Number representing the driver
+        #
+        #   @param vehicle_number [String, nil] Number associated with the vehicle
+
+        # Code indicating what the driver was prompted to enter at time of purchase. This
+        # is configured at a program level and is a static configuration, and does not
+        # change on a request to request basis
+        #
+        # @see Lithic::Models::CardAuthorization::FleetInfo#fleet_prompt_code
+        module FleetPromptCode
+          extend Lithic::Internal::Type::Enum
+
+          NO_PROMPT = :NO_PROMPT
+          VEHICLE_NUMBER = :VEHICLE_NUMBER
+          DRIVER_NUMBER = :DRIVER_NUMBER
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # Code indicating which restrictions, if any, there are on purchase. This is
+        # configured at a program level and is a static configuration, and does not change
+        # on a request to request basis
+        #
+        # @see Lithic::Models::CardAuthorization::FleetInfo#fleet_restriction_code
+        module FleetRestrictionCode
+          extend Lithic::Internal::Type::Enum
+
+          NO_RESTRICTIONS = :NO_RESTRICTIONS
+          FUEL_ONLY = :FUEL_ONLY
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+
+      # @see Lithic::Models::CardAuthorization#latest_challenge
+      class LatestChallenge < Lithic::Internal::Type::BaseModel
+        # @!attribute completed_at
+        #   The date and time when the Authorization Challenge was completed in UTC. Filled
+        #   only if the challenge has been completed.
+        #
+        #   @return [Time, nil]
+        required :completed_at, Time, nil?: true
+
+        # @!attribute created
+        #   The date and time when the Authorization Challenge was created in UTC
+        #
+        #   @return [Time]
+        required :created, Time
+
+        # @!attribute method_
+        #   The method used to deliver the challenge to the cardholder
+        #
+        #   - `SMS` - Challenge was delivered via SMS
+        #   - `OUT_OF_BAND` - Challenge was delivered via an out-of-band method
+        #
+        #   @return [Symbol, Lithic::Models::CardAuthorization::LatestChallenge::Method]
+        required :method_, enum: -> { Lithic::CardAuthorization::LatestChallenge::Method }, api_name: :method
+
+        # @!attribute phone_number
+        #   The phone number used for sending the Authorization Challenge. Present only when
+        #   the challenge method is `SMS`.
+        #
+        #   @return [String, nil]
+        required :phone_number, String, nil?: true
+
+        # @!attribute status
+        #   The status of the Authorization Challenge
+        #
+        #   - `COMPLETED` - Challenge was successfully completed by the cardholder
+        #   - `DECLINED` - Challenge was declined by the cardholder
+        #   - `PENDING` - Challenge is still open
+        #   - `EXPIRED` - Challenge has expired without being completed
+        #   - `ERROR` - There was an error processing the challenge
+        #
+        #   @return [Symbol, Lithic::Models::CardAuthorization::LatestChallenge::Status]
+        required :status, enum: -> { Lithic::CardAuthorization::LatestChallenge::Status }
+
+        # @!method initialize(completed_at:, created:, method_:, phone_number:, status:)
+        #   Some parameter documentations has been truncated, see
+        #   {Lithic::Models::CardAuthorization::LatestChallenge} for more details.
+        #
+        #   The latest Authorization Challenge that was issued to the cardholder for this
+        #   merchant.
+        #
+        #   @param completed_at [Time, nil] The date and time when the Authorization Challenge was completed in UTC. Filled
+        #
+        #   @param created [Time] The date and time when the Authorization Challenge was created in UTC
+        #
+        #   @param method_ [Symbol, Lithic::Models::CardAuthorization::LatestChallenge::Method] The method used to deliver the challenge to the cardholder
+        #
+        #   @param phone_number [String, nil] The phone number used for sending the Authorization Challenge. Present only when
+        #
+        #   @param status [Symbol, Lithic::Models::CardAuthorization::LatestChallenge::Status] The status of the Authorization Challenge
+
+        # The method used to deliver the challenge to the cardholder
+        #
+        # - `SMS` - Challenge was delivered via SMS
+        # - `OUT_OF_BAND` - Challenge was delivered via an out-of-band method
+        #
+        # @see Lithic::Models::CardAuthorization::LatestChallenge#method_
+        module Method
+          extend Lithic::Internal::Type::Enum
+
+          SMS = :SMS
+          OUT_OF_BAND = :OUT_OF_BAND
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # The status of the Authorization Challenge
+        #
+        # - `COMPLETED` - Challenge was successfully completed by the cardholder
+        # - `DECLINED` - Challenge was declined by the cardholder
+        # - `PENDING` - Challenge is still open
+        # - `EXPIRED` - Challenge has expired without being completed
+        # - `ERROR` - There was an error processing the challenge
+        #
+        # @see Lithic::Models::CardAuthorization::LatestChallenge#status
+        module Status
+          extend Lithic::Internal::Type::Enum
+
+          COMPLETED = :COMPLETED
+          DECLINED = :DECLINED
+          PENDING = :PENDING
+          EXPIRED = :EXPIRED
+          ERROR = :ERROR
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+
+      # Card network of the authorization.
+      #
+      # @see Lithic::Models::CardAuthorization#network
+      module Network
+        extend Lithic::Internal::Type::Enum
+
+        AMEX = :AMEX
+        INTERLINK = :INTERLINK
+        MAESTRO = :MAESTRO
+        MASTERCARD = :MASTERCARD
+        UNKNOWN = :UNKNOWN
+        VISA = :VISA
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # @see Lithic::Models::CardAuthorization#network_specific_data
+      class NetworkSpecificData < Lithic::Internal::Type::BaseModel
+        # @!attribute mastercard
+        #
+        #   @return [Lithic::Models::CardAuthorization::NetworkSpecificData::Mastercard, nil]
+        optional :mastercard, -> { Lithic::CardAuthorization::NetworkSpecificData::Mastercard }, nil?: true
+
+        # @!attribute visa
+        #
+        #   @return [Lithic::Models::CardAuthorization::NetworkSpecificData::Visa, nil]
+        optional :visa, -> { Lithic::CardAuthorization::NetworkSpecificData::Visa }, nil?: true
+
+        # @!method initialize(mastercard: nil, visa: nil)
+        #   Contains raw data provided by the card network, including attributes that
+        #   provide further context about the authorization. If populated by the network,
+        #   data is organized by Lithic and passed through without further modification.
+        #   Please consult the official network documentation for more details about these
+        #   values and how to use them. This object is only available to certain programs-
+        #   contact your Customer Success Manager to discuss enabling access.
+        #
+        #   @param mastercard [Lithic::Models::CardAuthorization::NetworkSpecificData::Mastercard, nil]
+        #   @param visa [Lithic::Models::CardAuthorization::NetworkSpecificData::Visa, nil]
+
+        # @see Lithic::Models::CardAuthorization::NetworkSpecificData#mastercard
+        class Mastercard < Lithic::Internal::Type::BaseModel
+          # @!attribute ecommerce_security_level_indicator
+          #   Indicates the electronic commerce security level and UCAF collection.
+          #
+          #   @return [String, nil]
+          optional :ecommerce_security_level_indicator, String, nil?: true
+
+          # @!attribute on_behalf_service_result
+          #   The On-behalf Service performed on the transaction and the results. Contains all
+          #   applicable, on-behalf service results that were performed on a given
+          #   transaction.
+          #
+          #   @return [Array<Lithic::Models::CardAuthorization::NetworkSpecificData::Mastercard::OnBehalfServiceResult>, nil]
+          optional :on_behalf_service_result,
+                   -> {
+                     Lithic::Internal::Type::ArrayOf[Lithic::CardAuthorization::NetworkSpecificData::Mastercard::OnBehalfServiceResult]
+                   },
+                   nil?: true
+
+          # @!attribute transaction_type_identifier
+          #   Indicates the type of additional transaction purpose.
+          #
+          #   @return [String, nil]
+          optional :transaction_type_identifier, String, nil?: true
+
+          # @!method initialize(ecommerce_security_level_indicator: nil, on_behalf_service_result: nil, transaction_type_identifier: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Lithic::Models::CardAuthorization::NetworkSpecificData::Mastercard} for more
+          #   details.
+          #
+          #   @param ecommerce_security_level_indicator [String, nil] Indicates the electronic commerce security level and UCAF collection.
+          #
+          #   @param on_behalf_service_result [Array<Lithic::Models::CardAuthorization::NetworkSpecificData::Mastercard::OnBehalfServiceResult>, nil] The On-behalf Service performed on the transaction and the results. Contains all
+          #
+          #   @param transaction_type_identifier [String, nil] Indicates the type of additional transaction purpose.
+
+          class OnBehalfServiceResult < Lithic::Internal::Type::BaseModel
+            # @!attribute result_1
+            #   Indicates the results of the service processing.
+            #
+            #   @return [String]
+            required :result_1, String
+
+            # @!attribute result_2
+            #   Identifies the results of the service processing.
+            #
+            #   @return [String]
+            required :result_2, String
+
+            # @!attribute service
+            #   Indicates the service performed on the transaction.
+            #
+            #   @return [String]
+            required :service, String
+
+            # @!method initialize(result_1:, result_2:, service:)
+            #   @param result_1 [String] Indicates the results of the service processing.
+            #
+            #   @param result_2 [String] Identifies the results of the service processing.
+            #
+            #   @param service [String] Indicates the service performed on the transaction.
+          end
+        end
+
+        # @see Lithic::Models::CardAuthorization::NetworkSpecificData#visa
+        class Visa < Lithic::Internal::Type::BaseModel
+          # @!attribute business_application_identifier
+          #   Identifies the purpose or category of a transaction, used to classify and
+          #   process transactions according to Visa’s rules.
+          #
+          #   @return [String, nil]
+          optional :business_application_identifier, String, nil?: true
+
+          # @!method initialize(business_application_identifier: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Lithic::Models::CardAuthorization::NetworkSpecificData::Visa} for more details.
+          #
+          #   @param business_application_identifier [String, nil] Identifies the purpose or category of a transaction, used to classify and proces
+        end
+      end
+
+      # @see Lithic::Models::CardAuthorization#pos
+      class Pos < Lithic::Internal::Type::BaseModel
+        # @!attribute entry_mode
+        #   POS > Entry Mode object in ASA
+        #
+        #   @return [Lithic::Models::CardAuthorization::Pos::EntryMode, nil]
+        optional :entry_mode, -> { Lithic::CardAuthorization::Pos::EntryMode }
+
+        # @!attribute terminal
+        #
+        #   @return [Lithic::Models::CardAuthorization::Pos::Terminal, nil]
+        optional :terminal, -> { Lithic::CardAuthorization::Pos::Terminal }
+
+        # @!method initialize(entry_mode: nil, terminal: nil)
+        #   @param entry_mode [Lithic::Models::CardAuthorization::Pos::EntryMode] POS > Entry Mode object in ASA
+        #
+        #   @param terminal [Lithic::Models::CardAuthorization::Pos::Terminal]
+
+        # @see Lithic::Models::CardAuthorization::Pos#entry_mode
+        class EntryMode < Lithic::Internal::Type::BaseModel
+          # @!attribute card
+          #   Card Presence Indicator
+          #
+          #   @return [Symbol, Lithic::Models::CardAuthorization::Pos::EntryMode::Card, nil]
+          optional :card, enum: -> { Lithic::CardAuthorization::Pos::EntryMode::Card }
+
+          # @!attribute cardholder
+          #   Cardholder Presence Indicator
+          #
+          #   @return [Symbol, Lithic::Models::CardAuthorization::Pos::EntryMode::Cardholder, nil]
+          optional :cardholder, enum: -> { Lithic::CardAuthorization::Pos::EntryMode::Cardholder }
+
+          # @!attribute pan
+          #   Method of entry for the PAN
+          #
+          #   @return [Symbol, Lithic::Models::CardAuthorization::Pos::EntryMode::Pan, nil]
+          optional :pan, enum: -> { Lithic::CardAuthorization::Pos::EntryMode::Pan }
+
+          # @!attribute pin_entered
+          #   Indicates whether the cardholder entered the PIN. True if the PIN was entered.
+          #
+          #   @return [Boolean, nil]
+          optional :pin_entered, Lithic::Internal::Type::Boolean
+
+          # @!method initialize(card: nil, cardholder: nil, pan: nil, pin_entered: nil)
+          #   POS > Entry Mode object in ASA
+          #
+          #   @param card [Symbol, Lithic::Models::CardAuthorization::Pos::EntryMode::Card] Card Presence Indicator
+          #
+          #   @param cardholder [Symbol, Lithic::Models::CardAuthorization::Pos::EntryMode::Cardholder] Cardholder Presence Indicator
+          #
+          #   @param pan [Symbol, Lithic::Models::CardAuthorization::Pos::EntryMode::Pan] Method of entry for the PAN
+          #
+          #   @param pin_entered [Boolean] Indicates whether the cardholder entered the PIN. True if the PIN was entered.
+
+          # Card Presence Indicator
+          #
+          # @see Lithic::Models::CardAuthorization::Pos::EntryMode#card
+          module Card
+            extend Lithic::Internal::Type::Enum
+
+            PRESENT = :PRESENT
+            NOT_PRESENT = :NOT_PRESENT
+            UNKNOWN = :UNKNOWN
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # Cardholder Presence Indicator
+          #
+          # @see Lithic::Models::CardAuthorization::Pos::EntryMode#cardholder
+          module Cardholder
+            extend Lithic::Internal::Type::Enum
+
+            DEFERRED_BILLING = :DEFERRED_BILLING
+            ELECTRONIC_ORDER = :ELECTRONIC_ORDER
+            INSTALLMENT = :INSTALLMENT
+            MAIL_ORDER = :MAIL_ORDER
+            NOT_PRESENT = :NOT_PRESENT
+            PRESENT = :PRESENT
+            REOCCURRING = :REOCCURRING
+            TELEPHONE_ORDER = :TELEPHONE_ORDER
+            UNKNOWN = :UNKNOWN
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # Method of entry for the PAN
+          #
+          # @see Lithic::Models::CardAuthorization::Pos::EntryMode#pan
+          module Pan
+            extend Lithic::Internal::Type::Enum
+
+            AUTO_ENTRY = :AUTO_ENTRY
+            BAR_CODE = :BAR_CODE
+            CONTACTLESS = :CONTACTLESS
+            ECOMMERCE = :ECOMMERCE
+            ERROR_KEYED = :ERROR_KEYED
+            ERROR_MAGNETIC_STRIPE = :ERROR_MAGNETIC_STRIPE
+            ICC = :ICC
+            KEY_ENTERED = :KEY_ENTERED
+            MAGNETIC_STRIPE = :MAGNETIC_STRIPE
+            MANUAL = :MANUAL
+            OCR = :OCR
+            SECURE_CARDLESS = :SECURE_CARDLESS
+            UNSPECIFIED = :UNSPECIFIED
+            UNKNOWN = :UNKNOWN
+            CREDENTIAL_ON_FILE = :CREDENTIAL_ON_FILE
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
+        # @see Lithic::Models::CardAuthorization::Pos#terminal
+        class Terminal < Lithic::Internal::Type::BaseModel
+          # @!attribute attended
+          #   True if a clerk is present at the sale.
+          #
+          #   @return [Boolean]
+          required :attended, Lithic::Internal::Type::Boolean
+
+          # @!attribute card_retention_capable
+          #   True if the terminal is capable of retaining the card.
+          #
+          #   @return [Boolean]
+          required :card_retention_capable, Lithic::Internal::Type::Boolean
+
+          # @!attribute on_premise
+          #   True if the sale was made at the place of business (vs. mobile).
+          #
+          #   @return [Boolean]
+          required :on_premise, Lithic::Internal::Type::Boolean
+
+          # @!attribute operator
+          #   The person that is designated to swipe the card
+          #
+          #   @return [Symbol, Lithic::Models::CardAuthorization::Pos::Terminal::Operator]
+          required :operator, enum: -> { Lithic::CardAuthorization::Pos::Terminal::Operator }
+
+          # @!attribute partial_approval_capable
+          #   True if the terminal is capable of partial approval. Partial approval is when
+          #   part of a transaction is approved and another payment must be used for the
+          #   remainder. Example scenario: A $40 transaction is attempted on a prepaid card
+          #   with a $25 balance. If partial approval is enabled, $25 can be authorized, at
+          #   which point the POS will prompt the user for an additional payment of $15.
+          #
+          #   @return [Boolean]
+          required :partial_approval_capable, Lithic::Internal::Type::Boolean
+
+          # @!attribute pin_capability
+          #   Status of whether the POS is able to accept PINs
+          #
+          #   @return [Symbol, Lithic::Models::CardAuthorization::Pos::Terminal::PinCapability]
+          required :pin_capability, enum: -> { Lithic::CardAuthorization::Pos::Terminal::PinCapability }
+
+          # @!attribute type
+          #   POS Type
+          #
+          #   @return [Symbol, Lithic::Models::CardAuthorization::Pos::Terminal::Type]
+          required :type, enum: -> { Lithic::CardAuthorization::Pos::Terminal::Type }
+
+          # @!attribute acceptor_terminal_id
+          #   Uniquely identifies a terminal at the card acceptor location of acquiring
+          #   institutions or merchant POS Systems. Left justified with trailing spaces.
+          #
+          #   @return [String, nil]
+          optional :acceptor_terminal_id, String, nil?: true
+
+          # @!method initialize(attended:, card_retention_capable:, on_premise:, operator:, partial_approval_capable:, pin_capability:, type:, acceptor_terminal_id: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Lithic::Models::CardAuthorization::Pos::Terminal} for more details.
+          #
+          #   @param attended [Boolean] True if a clerk is present at the sale.
+          #
+          #   @param card_retention_capable [Boolean] True if the terminal is capable of retaining the card.
+          #
+          #   @param on_premise [Boolean] True if the sale was made at the place of business (vs. mobile).
+          #
+          #   @param operator [Symbol, Lithic::Models::CardAuthorization::Pos::Terminal::Operator] The person that is designated to swipe the card
+          #
+          #   @param partial_approval_capable [Boolean] True if the terminal is capable of partial approval. Partial approval is when pa
+          #
+          #   @param pin_capability [Symbol, Lithic::Models::CardAuthorization::Pos::Terminal::PinCapability] Status of whether the POS is able to accept PINs
+          #
+          #   @param type [Symbol, Lithic::Models::CardAuthorization::Pos::Terminal::Type] POS Type
+          #
+          #   @param acceptor_terminal_id [String, nil] Uniquely identifies a terminal at the card acceptor location of acquiring instit
+
+          # The person that is designated to swipe the card
+          #
+          # @see Lithic::Models::CardAuthorization::Pos::Terminal#operator
+          module Operator
+            extend Lithic::Internal::Type::Enum
+
+            ADMINISTRATIVE = :ADMINISTRATIVE
+            CARDHOLDER = :CARDHOLDER
+            CARD_ACCEPTOR = :CARD_ACCEPTOR
+            UNKNOWN = :UNKNOWN
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # Status of whether the POS is able to accept PINs
+          #
+          # @see Lithic::Models::CardAuthorization::Pos::Terminal#pin_capability
+          module PinCapability
+            extend Lithic::Internal::Type::Enum
+
+            CAPABLE = :CAPABLE
+            INOPERATIVE = :INOPERATIVE
+            NOT_CAPABLE = :NOT_CAPABLE
+            UNSPECIFIED = :UNSPECIFIED
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # POS Type
+          #
+          # @see Lithic::Models::CardAuthorization::Pos::Terminal#type
+          module Type
+            extend Lithic::Internal::Type::Enum
+
+            ADMINISTRATIVE = :ADMINISTRATIVE
+            ATM = :ATM
+            AUTHORIZATION = :AUTHORIZATION
+            COUPON_MACHINE = :COUPON_MACHINE
+            DIAL_TERMINAL = :DIAL_TERMINAL
+            ECOMMERCE = :ECOMMERCE
+            ECR = :ECR
+            FUEL_MACHINE = :FUEL_MACHINE
+            HOME_TERMINAL = :HOME_TERMINAL
+            MICR = :MICR
+            OFF_PREMISE = :OFF_PREMISE
+            PAYMENT = :PAYMENT
+            PDA = :PDA
+            PHONE = :PHONE
+            POINT = :POINT
+            POS_TERMINAL = :POS_TERMINAL
+            PUBLIC_UTILITY = :PUBLIC_UTILITY
+            SELF_SERVICE = :SELF_SERVICE
+            TELEVISION = :TELEVISION
+            TELLER = :TELLER
+            TRAVELERS_CHECK_MACHINE = :TRAVELERS_CHECK_MACHINE
+            VENDING = :VENDING
+            VOICE = :VOICE
+            UNKNOWN = :UNKNOWN
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+      end
+    end
+  end
+end