lithic 0.1.0.pre.alpha.54 → 0.1.0.pre.alpha.56

data/lib/lithic/models/tokenization.rb

@@ -28,12 +28,6 @@ module Lithic
       #   @return [Time]
       required :created_at, Time
 
-      # @!attribute device_id
-      #   The device identifier associated with the tokenization.
-      #
-      #   @return [String, nil]
-      required :device_id, String, nil?: true
-
       # @!attribute dpan
       #   The dynamic pan assigned to the token by the network.
       #
@@ -47,11 +41,12 @@ module Lithic
       required :status, enum: -> { Lithic::Tokenization::Status }
 
       # @!attribute token_requestor_name
-      #   The entity that requested the tokenization. Represents a Digital Wallet or
-      #   merchant.
+      #   The entity that requested the tokenization. For digital wallets, this will be
+      #   one of the defined wallet types. For merchant tokenizations, this will be a
+      #   free-form merchant name string.
       #
-      #   @return [Symbol, Lithic::Models::Tokenization::TokenRequestorName]
-      required :token_requestor_name, enum: -> { Lithic::Tokenization::TokenRequestorName }
+      #   @return [Symbol, String, Lithic::Models::Tokenization::TokenRequestorName]
+      required :token_requestor_name, union: -> { Lithic::Tokenization::TokenRequestorName }
 
       # @!attribute token_unique_reference
       #   The network's unique reference for the tokenization.
@@ -71,14 +66,20 @@ module Lithic
       #   @return [Time]
       required :updated_at, Time
 
+      # @!attribute device_id
+      #   The device identifier associated with the tokenization.
+      #
+      #   @return [String, nil]
+      optional :device_id, String, nil?: true
+
       # @!attribute digital_card_art_token
-      #   Specifies the digital card art displayed in the user’s digital wallet after
+      #   Specifies the digital card art displayed in the user's digital wallet after
       #   tokenization. This will be null if the tokenization was created without an
       #   associated digital card art. See
       #   [Flexible Card Art Guide](https://docs.lithic.com/docs/about-digital-wallets#flexible-card-art).
       #
       #   @return [String, nil]
-      optional :digital_card_art_token, String
+      optional :digital_card_art_token, String, nil?: true
 
       # @!attribute events
       #   A list of events related to the tokenization.
@@ -92,7 +93,7 @@ module Lithic
       #   @return [String, nil]
       optional :payment_account_reference_id, String, nil?: true
 
-      # @!method initialize(token:, account_token:, card_token:, created_at:, device_id:, dpan:, status:, token_requestor_name:, token_unique_reference:, tokenization_channel:, updated_at:, digital_card_art_token: nil, events: nil, payment_account_reference_id: nil)
+      # @!method initialize(token:, account_token:, card_token:, created_at:, dpan:, status:, token_requestor_name:, token_unique_reference:, tokenization_channel:, updated_at:, device_id: nil, digital_card_art_token: nil, events: nil, payment_account_reference_id: nil)
       #   Some parameter documentations has been truncated, see
       #   {Lithic::Models::Tokenization} for more details.
       #
@@ -104,13 +105,11 @@ module Lithic
       #
       #   @param created_at [Time] Date and time when the tokenization first occurred. UTC time zone.
       #
-      #   @param device_id [String, nil] The device identifier associated with the tokenization.
-      #
       #   @param dpan [String, nil] The dynamic pan assigned to the token by the network.
       #
       #   @param status [Symbol, Lithic::Models::Tokenization::Status] The status of the tokenization request
       #
-      #   @param token_requestor_name [Symbol, Lithic::Models::Tokenization::TokenRequestorName] The entity that requested the tokenization. Represents a Digital Wallet or merch
+      #   @param token_requestor_name [Symbol, String, Lithic::Models::Tokenization::TokenRequestorName] The entity that requested the tokenization. For digital wallets, this will be on
       #
       #   @param token_unique_reference [String] The network's unique reference for the tokenization.
       #
@@ -118,7 +117,9 @@ module Lithic
       #
       #   @param updated_at [Time] Latest date and time when the tokenization was updated. UTC time zone.
       #
-      #   @param digital_card_art_token [String] Specifies the digital card art displayed in the user’s digital wallet after toke
+      #   @param device_id [String, nil] The device identifier associated with the tokenization.
+      #
+      #   @param digital_card_art_token [String, nil] Specifies the digital card art displayed in the user's digital wallet after toke
       #
       #   @param events [Array<Lithic::Models::Tokenization::Event>] A list of events related to the tokenization.
       #
@@ -142,12 +143,49 @@ module Lithic
         #   @return [Array<Symbol>]
       end
 
-      # The entity that requested the tokenization. Represents a Digital Wallet or
-      # merchant.
+      # The entity that requested the tokenization. For digital wallets, this will be
+      # one of the defined wallet types. For merchant tokenizations, this will be a
+      # free-form merchant name string.
       #
       # @see Lithic::Models::Tokenization#token_requestor_name
       module TokenRequestorName
-        extend Lithic::Internal::Type::Enum
+        extend Lithic::Internal::Type::Union
+
+        variant const: -> { Lithic::Models::Tokenization::TokenRequestorName::AMAZON_ONE }
+
+        variant const: -> { Lithic::Models::Tokenization::TokenRequestorName::ANDROID_PAY }
+
+        variant const: -> { Lithic::Models::Tokenization::TokenRequestorName::APPLE_PAY }
+
+        variant const: -> { Lithic::Models::Tokenization::TokenRequestorName::FACEBOOK }
+
+        variant const: -> { Lithic::Models::Tokenization::TokenRequestorName::FITBIT_PAY }
+
+        variant const: -> { Lithic::Models::Tokenization::TokenRequestorName::GARMIN_PAY }
+
+        variant const: -> { Lithic::Models::Tokenization::TokenRequestorName::GOOGLE_PAY }
+
+        variant const: -> { Lithic::Models::Tokenization::TokenRequestorName::MICROSOFT_PAY }
+
+        variant const: -> { Lithic::Models::Tokenization::TokenRequestorName::NETFLIX }
+
+        variant const: -> { Lithic::Models::Tokenization::TokenRequestorName::SAMSUNG_PAY }
+
+        variant const: -> { Lithic::Models::Tokenization::TokenRequestorName::UNKNOWN }
+
+        variant const: -> { Lithic::Models::Tokenization::TokenRequestorName::VISA_CHECKOUT }
+
+        # Merchant name for merchant tokenizations
+        variant String
+
+        # @!method self.variants
+        #   @return [Array(Symbol, String)]
+
+        define_sorbet_constant!(:Variants) do
+          T.type_alias { T.any(Lithic::Tokenization::TokenRequestorName::TaggedSymbol, String) }
+        end
+
+        # @!group
 
         AMAZON_ONE = :AMAZON_ONE
         ANDROID_PAY = :ANDROID_PAY
@@ -155,14 +193,14 @@ module Lithic
         FACEBOOK = :FACEBOOK
         FITBIT_PAY = :FITBIT_PAY
         GARMIN_PAY = :GARMIN_PAY
+        GOOGLE_PAY = :GOOGLE_PAY
         MICROSOFT_PAY = :MICROSOFT_PAY
         NETFLIX = :NETFLIX
         SAMSUNG_PAY = :SAMSUNG_PAY
         UNKNOWN = :UNKNOWN
         VISA_CHECKOUT = :VISA_CHECKOUT
 
-        # @!method self.values
-        #   @return [Array<Symbol>]
+        # @!endgroup
       end
 
       # The channel through which the tokenization was made.
@@ -197,19 +235,45 @@ module Lithic
         #   @return [Symbol, Lithic::Models::Tokenization::Event::Result, nil]
         optional :result, enum: -> { Lithic::Tokenization::Event::Result }
 
+        # @!attribute rule_results
+        #   Results from rules that were evaluated for this tokenization
+        #
+        #   @return [Array<Lithic::Models::Tokenization::Event::RuleResult>, nil]
+        optional :rule_results, -> { Lithic::Internal::Type::ArrayOf[Lithic::Tokenization::Event::RuleResult] }
+
+        # @!attribute tokenization_decline_reasons
+        #   List of reasons why the tokenization was declined
+        #
+        #   @return [Array<Symbol, Lithic::Models::Tokenization::Event::TokenizationDeclineReason>, nil]
+        optional :tokenization_decline_reasons,
+                 -> { Lithic::Internal::Type::ArrayOf[enum: Lithic::Tokenization::Event::TokenizationDeclineReason] }
+
+        # @!attribute tokenization_tfa_reasons
+        #   List of reasons why two-factor authentication was required
+        #
+        #   @return [Array<Symbol, Lithic::Models::Tokenization::Event::TokenizationTfaReason>, nil]
+        optional :tokenization_tfa_reasons,
+                 -> { Lithic::Internal::Type::ArrayOf[enum: Lithic::Tokenization::Event::TokenizationTfaReason] }
+
         # @!attribute type
         #   Enum representing the type of tokenization event that occurred
         #
         #   @return [Symbol, Lithic::Models::Tokenization::Event::Type, nil]
         optional :type, enum: -> { Lithic::Tokenization::Event::Type }
 
-        # @!method initialize(token: nil, created_at: nil, result: nil, type: nil)
+        # @!method initialize(token: nil, created_at: nil, result: nil, rule_results: nil, tokenization_decline_reasons: nil, tokenization_tfa_reasons: nil, type: nil)
         #   @param token [String] Globally unique identifier for a Tokenization Event
         #
         #   @param created_at [Time] Date and time when the tokenization event first occurred. UTC time zone.
         #
         #   @param result [Symbol, Lithic::Models::Tokenization::Event::Result] Enum representing the result of the tokenization event
         #
+        #   @param rule_results [Array<Lithic::Models::Tokenization::Event::RuleResult>] Results from rules that were evaluated for this tokenization
+        #
+        #   @param tokenization_decline_reasons [Array<Symbol, Lithic::Models::Tokenization::Event::TokenizationDeclineReason>] List of reasons why the tokenization was declined
+        #
+        #   @param tokenization_tfa_reasons [Array<Symbol, Lithic::Models::Tokenization::Event::TokenizationTfaReason>] List of reasons why two-factor authentication was required
+        #
         #   @param type [Symbol, Lithic::Models::Tokenization::Event::Type] Enum representing the type of tokenization event that occurred
 
         # Enum representing the result of the tokenization event
@@ -235,6 +299,108 @@ module Lithic
           #   @return [Array<Symbol>]
         end
 
+        class RuleResult < Lithic::Internal::Type::BaseModel
+          # @!attribute auth_rule_token
+          #   The Auth Rule Token associated with the rule. If this is set to null, then the
+          #   result was not associated with a customer-configured rule. This may happen in
+          #   cases where a tokenization is declined or requires TFA due to a
+          #   Lithic-configured security or compliance rule, for example.
+          #
+          #   @return [String, nil]
+          required :auth_rule_token, String, nil?: true
+
+          # @!attribute explanation
+          #   A human-readable explanation outlining the motivation for the rule's result
+          #
+          #   @return [String, nil]
+          required :explanation, String, nil?: true
+
+          # @!attribute name
+          #   The name for the rule, if any was configured
+          #
+          #   @return [String, nil]
+          required :name, String, nil?: true
+
+          # @!attribute result
+          #   The result associated with this rule
+          #
+          #   @return [Symbol, Lithic::Models::Tokenization::Event::RuleResult::Result]
+          required :result, enum: -> { Lithic::Tokenization::Event::RuleResult::Result }
+
+          # @!method initialize(auth_rule_token:, explanation:, name:, result:)
+          #   Some parameter documentations has been truncated, see
+          #   {Lithic::Models::Tokenization::Event::RuleResult} for more details.
+          #
+          #   @param auth_rule_token [String, nil] The Auth Rule Token associated with the rule. If this is set to null, then the r
+          #
+          #   @param explanation [String, nil] A human-readable explanation outlining the motivation for the rule's result
+          #
+          #   @param name [String, nil] The name for the rule, if any was configured
+          #
+          #   @param result [Symbol, Lithic::Models::Tokenization::Event::RuleResult::Result] The result associated with this rule
+
+          # The result associated with this rule
+          #
+          # @see Lithic::Models::Tokenization::Event::RuleResult#result
+          module Result
+            extend Lithic::Internal::Type::Enum
+
+            APPROVED = :APPROVED
+            DECLINED = :DECLINED
+            REQUIRE_TFA = :REQUIRE_TFA
+            ERROR = :ERROR
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
+        # Reason code for why a tokenization was declined
+        module TokenizationDeclineReason
+          extend Lithic::Internal::Type::Enum
+
+          ACCOUNT_SCORE_1 = :ACCOUNT_SCORE_1
+          DEVICE_SCORE_1 = :DEVICE_SCORE_1
+          ALL_WALLET_DECLINE_REASONS_PRESENT = :ALL_WALLET_DECLINE_REASONS_PRESENT
+          WALLET_RECOMMENDED_DECISION_RED = :WALLET_RECOMMENDED_DECISION_RED
+          CVC_MISMATCH = :CVC_MISMATCH
+          CARD_EXPIRY_MONTH_MISMATCH = :CARD_EXPIRY_MONTH_MISMATCH
+          CARD_EXPIRY_YEAR_MISMATCH = :CARD_EXPIRY_YEAR_MISMATCH
+          CARD_INVALID_STATE = :CARD_INVALID_STATE
+          CUSTOMER_RED_PATH = :CUSTOMER_RED_PATH
+          INVALID_CUSTOMER_RESPONSE = :INVALID_CUSTOMER_RESPONSE
+          NETWORK_FAILURE = :NETWORK_FAILURE
+          GENERIC_DECLINE = :GENERIC_DECLINE
+          DIGITAL_CARD_ART_REQUIRED = :DIGITAL_CARD_ART_REQUIRED
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # Reason code for why a tokenization required two-factor authentication
+        module TokenizationTfaReason
+          extend Lithic::Internal::Type::Enum
+
+          WALLET_RECOMMENDED_TFA = :WALLET_RECOMMENDED_TFA
+          SUSPICIOUS_ACTIVITY = :SUSPICIOUS_ACTIVITY
+          DEVICE_RECENTLY_LOST = :DEVICE_RECENTLY_LOST
+          TOO_MANY_RECENT_ATTEMPTS = :TOO_MANY_RECENT_ATTEMPTS
+          TOO_MANY_RECENT_TOKENS = :TOO_MANY_RECENT_TOKENS
+          TOO_MANY_DIFFERENT_CARDHOLDERS = :TOO_MANY_DIFFERENT_CARDHOLDERS
+          OUTSIDE_HOME_TERRITORY = :OUTSIDE_HOME_TERRITORY
+          HAS_SUSPENDED_TOKENS = :HAS_SUSPENDED_TOKENS
+          HIGH_RISK = :HIGH_RISK
+          ACCOUNT_SCORE_LOW = :ACCOUNT_SCORE_LOW
+          DEVICE_SCORE_LOW = :DEVICE_SCORE_LOW
+          CARD_STATE_TFA = :CARD_STATE_TFA
+          HARDCODED_TFA = :HARDCODED_TFA
+          CUSTOMER_RULE_TFA = :CUSTOMER_RULE_TFA
+          DEVICE_HOST_CARD_EMULATION = :DEVICE_HOST_CARD_EMULATION
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
         # Enum representing the type of tokenization event that occurred
         #
         # @see Lithic::Models::Tokenization::Event#type

data/lib/lithic/models/transaction.rb

@@ -94,8 +94,8 @@ module Lithic
 
       # @!attribute merchant
       #
-      #   @return [Lithic::Models::Transaction::Merchant]
-      required :merchant, -> { Lithic::Transaction::Merchant }
+      #   @return [Lithic::Models::Merchant]
+      required :merchant, -> { Lithic::Merchant }
 
       # @!attribute merchant_amount
       #   @deprecated
@@ -208,7 +208,7 @@ module Lithic
       #
       #   @param financial_account_token [String, nil]
       #
-      #   @param merchant [Lithic::Models::Transaction::Merchant]
+      #   @param merchant [Lithic::Models::Merchant]
       #
       #   @param merchant_amount [Integer, nil] Analogous to the 'amount', but in the merchant currency.
       #
@@ -378,23 +378,12 @@ module Lithic
 
       # @see Lithic::Models::Transaction#cardholder_authentication
       class CardholderAuthentication < Lithic::Internal::Type::BaseModel
-        # @!attribute three_ds_version
-        #   @deprecated
-        #
-        #   The 3DS version used for the authentication
-        #
-        #   @return [String, nil]
-        required :three_ds_version, String, api_name: :"3ds_version", nil?: true
-
-        # @!attribute acquirer_exemption
-        #   @deprecated
-        #
-        #   Whether an acquirer exemption applied to the transaction. Not currently
-        #   populated and will be removed in the future.
+        # @!attribute authentication_method
+        #   Indicates the method used to authenticate the cardholder.
         #
-        #   @return [Symbol, Lithic::Models::Transaction::CardholderAuthentication::AcquirerExemption]
-        required :acquirer_exemption,
-                 enum: -> { Lithic::Transaction::CardholderAuthentication::AcquirerExemption }
+        #   @return [Symbol, Lithic::Models::Transaction::CardholderAuthentication::AuthenticationMethod]
+        required :authentication_method,
+                 enum: -> { Lithic::Transaction::CardholderAuthentication::AuthenticationMethod }
 
         # @!attribute authentication_result
         #   Indicates the outcome of the 3DS authentication process.
@@ -433,40 +422,11 @@ module Lithic
         #   @return [String, nil]
         required :three_ds_authentication_token, String, nil?: true
 
-        # @!attribute verification_attempted
-        #   @deprecated
-        #
-        #   Indicates whether a 3DS challenge flow was used, and if so, what the
-        #   verification method was. (deprecated, use `authentication_result`)
-        #
-        #   @return [Symbol, Lithic::Models::Transaction::CardholderAuthentication::VerificationAttempted]
-        required :verification_attempted,
-                 enum: -> { Lithic::Transaction::CardholderAuthentication::VerificationAttempted }
-
-        # @!attribute verification_result
-        #   @deprecated
-        #
-        #   Indicates whether a transaction is considered 3DS authenticated. (deprecated,
-        #   use `authentication_result`)
-        #
-        #   @return [Symbol, Lithic::Models::Transaction::CardholderAuthentication::VerificationResult]
-        required :verification_result,
-                 enum: -> { Lithic::Transaction::CardholderAuthentication::VerificationResult }
-
-        # @!attribute authentication_method
-        #   Indicates the method used to authenticate the cardholder.
-        #
-        #   @return [Symbol, Lithic::Models::Transaction::CardholderAuthentication::AuthenticationMethod, nil]
-        optional :authentication_method,
-                 enum: -> { Lithic::Transaction::CardholderAuthentication::AuthenticationMethod }
-
-        # @!method initialize(three_ds_version:, acquirer_exemption:, authentication_result:, decision_made_by:, liability_shift:, three_ds_authentication_token:, verification_attempted:, verification_result:, authentication_method: nil)
+        # @!method initialize(authentication_method:, authentication_result:, decision_made_by:, liability_shift:, three_ds_authentication_token:)
         #   Some parameter documentations has been truncated, see
         #   {Lithic::Models::Transaction::CardholderAuthentication} for more details.
         #
-        #   @param three_ds_version [String, nil] The 3DS version used for the authentication
-        #
-        #   @param acquirer_exemption [Symbol, Lithic::Models::Transaction::CardholderAuthentication::AcquirerExemption] Whether an acquirer exemption applied to the transaction. Not currently populate
+        #   @param authentication_method [Symbol, Lithic::Models::Transaction::CardholderAuthentication::AuthenticationMethod] Indicates the method used to authenticate the cardholder.
         #
         #   @param authentication_result [Symbol, Lithic::Models::Transaction::CardholderAuthentication::AuthenticationResult] Indicates the outcome of the 3DS authentication process.
         #
@@ -475,30 +435,16 @@ module Lithic
         #   @param liability_shift [Symbol, Lithic::Models::Transaction::CardholderAuthentication::LiabilityShift] Indicates whether chargeback liability shift applies to the transaction. Possibl
         #
         #   @param three_ds_authentication_token [String, nil] Unique identifier you can use to match a given 3DS authentication (available via
-        #
-        #   @param verification_attempted [Symbol, Lithic::Models::Transaction::CardholderAuthentication::VerificationAttempted] Indicates whether a 3DS challenge flow was used, and if so, what the verificatio
-        #
-        #   @param verification_result [Symbol, Lithic::Models::Transaction::CardholderAuthentication::VerificationResult] Indicates whether a transaction is considered 3DS authenticated. (deprecated, us
-        #
-        #   @param authentication_method [Symbol, Lithic::Models::Transaction::CardholderAuthentication::AuthenticationMethod] Indicates the method used to authenticate the cardholder.
 
-        # @deprecated
-        #
-        # Whether an acquirer exemption applied to the transaction. Not currently
-        # populated and will be removed in the future.
+        # Indicates the method used to authenticate the cardholder.
         #
-        # @see Lithic::Models::Transaction::CardholderAuthentication#acquirer_exemption
-        module AcquirerExemption
+        # @see Lithic::Models::Transaction::CardholderAuthentication#authentication_method
+        module AuthenticationMethod
           extend Lithic::Internal::Type::Enum
 
-          AUTHENTICATION_OUTAGE_EXCEPTION = :AUTHENTICATION_OUTAGE_EXCEPTION
-          LOW_VALUE = :LOW_VALUE
-          MERCHANT_INITIATED_TRANSACTION = :MERCHANT_INITIATED_TRANSACTION
+          FRICTIONLESS = :FRICTIONLESS
+          CHALLENGE = :CHALLENGE
           NONE = :NONE
-          RECURRING_PAYMENT = :RECURRING_PAYMENT
-          SECURE_CORPORATE_PAYMENT = :SECURE_CORPORATE_PAYMENT
-          STRONG_CUSTOMER_AUTHENTICATION_DELEGATION = :STRONG_CUSTOMER_AUTHENTICATION_DELEGATION
-          TRANSACTION_RISK_ANALYSIS = :TRANSACTION_RISK_ANALYSIS
 
           # @!method self.values
           #   @return [Array<Symbol>]
@@ -558,122 +504,6 @@ module Lithic
           # @!method self.values
           #   @return [Array<Symbol>]
         end
-
-        # @deprecated
-        #
-        # Indicates whether a 3DS challenge flow was used, and if so, what the
-        # verification method was. (deprecated, use `authentication_result`)
-        #
-        # @see Lithic::Models::Transaction::CardholderAuthentication#verification_attempted
-        module VerificationAttempted
-          extend Lithic::Internal::Type::Enum
-
-          NONE = :NONE
-          OTHER = :OTHER
-
-          # @!method self.values
-          #   @return [Array<Symbol>]
-        end
-
-        # @deprecated
-        #
-        # Indicates whether a transaction is considered 3DS authenticated. (deprecated,
-        # use `authentication_result`)
-        #
-        # @see Lithic::Models::Transaction::CardholderAuthentication#verification_result
-        module VerificationResult
-          extend Lithic::Internal::Type::Enum
-
-          CANCELLED = :CANCELLED
-          FAILED = :FAILED
-          FRICTIONLESS = :FRICTIONLESS
-          NOT_ATTEMPTED = :NOT_ATTEMPTED
-          REJECTED = :REJECTED
-          SUCCESS = :SUCCESS
-
-          # @!method self.values
-          #   @return [Array<Symbol>]
-        end
-
-        # Indicates the method used to authenticate the cardholder.
-        #
-        # @see Lithic::Models::Transaction::CardholderAuthentication#authentication_method
-        module AuthenticationMethod
-          extend Lithic::Internal::Type::Enum
-
-          FRICTIONLESS = :FRICTIONLESS
-          CHALLENGE = :CHALLENGE
-          NONE = :NONE
-
-          # @!method self.values
-          #   @return [Array<Symbol>]
-        end
-      end
-
-      # @see Lithic::Models::Transaction#merchant
-      class Merchant < Lithic::Internal::Type::BaseModel
-        # @!attribute acceptor_id
-        #   Unique alphanumeric identifier for the payment card acceptor (merchant).
-        #
-        #   @return [String]
-        required :acceptor_id, String
-
-        # @!attribute acquiring_institution_id
-        #   Unique numeric identifier of the acquiring institution.
-        #
-        #   @return [String]
-        required :acquiring_institution_id, String
-
-        # @!attribute city
-        #   City of card acceptor. Note that in many cases, particularly in card-not-present
-        #   transactions, merchants may send through a phone number or URL in this field.
-        #
-        #   @return [String]
-        required :city, String
-
-        # @!attribute country
-        #   Country or entity of card acceptor. Possible values are: (1) all ISO 3166-1
-        #   alpha-3 country codes, (2) QZZ for Kosovo, and (3) ANT for Netherlands Antilles.
-        #
-        #   @return [String]
-        required :country, String
-
-        # @!attribute descriptor
-        #   Short description of card acceptor.
-        #
-        #   @return [String]
-        required :descriptor, String
-
-        # @!attribute mcc
-        #   Merchant category code (MCC). A four-digit number listed in ISO 18245. An MCC is
-        #   used to classify a business by the types of goods or services it provides.
-        #
-        #   @return [String]
-        required :mcc, String
-
-        # @!attribute state
-        #   Geographic state of card acceptor.
-        #
-        #   @return [String]
-        required :state, String
-
-        # @!method initialize(acceptor_id:, acquiring_institution_id:, city:, country:, descriptor:, mcc:, state:)
-        #   Some parameter documentations has been truncated, see
-        #   {Lithic::Models::Transaction::Merchant} for more details.
-        #
-        #   @param acceptor_id [String] Unique alphanumeric identifier for the payment card acceptor (merchant).
-        #
-        #   @param acquiring_institution_id [String] Unique numeric identifier of the acquiring institution.
-        #
-        #   @param city [String] City of card acceptor. Note that in many cases, particularly in card-not-present
-        #
-        #   @param country [String] Country or entity of card acceptor. Possible values are: (1) all ISO 3166-1 alph
-        #
-        #   @param descriptor [String] Short description of card acceptor.
-        #
-        #   @param mcc [String] Merchant category code (MCC). A four-digit number listed in ISO 18245. An MCC is
-        #
-        #   @param state [String] Geographic state of card acceptor.
       end
 
       # Card network of the authorization. Value is `UNKNOWN` when Lithic cannot