lithic 0.12.0 → 0.13.0

data/lib/lithic/models/auth_rules/conditional_card_transaction_update_action_parameters.rb

@@ -0,0 +1,244 @@
+# frozen_string_literal: true
+
+module Lithic
+  module Models
+    module AuthRules
+      class ConditionalCardTransactionUpdateActionParameters < Lithic::Internal::Type::BaseModel
+        # @!attribute action
+        #   The action to take if the conditions are met.
+        #
+        #   @return [Lithic::Models::AuthRules::CardTransactionUpdateAction::TagAction, Lithic::Models::AuthRules::CardTransactionUpdateAction::CreateCaseAction]
+        required :action, union: -> { Lithic::AuthRules::CardTransactionUpdateAction }
+
+        # @!attribute conditions
+        #
+        #   @return [Array<Lithic::Models::AuthRules::ConditionalCardTransactionUpdateActionParameters::Condition>]
+        required :conditions,
+                 -> { Lithic::Internal::Type::ArrayOf[Lithic::AuthRules::ConditionalCardTransactionUpdateActionParameters::Condition] }
+
+        # @!method initialize(action:, conditions:)
+        #   @param action [Lithic::Models::AuthRules::CardTransactionUpdateAction::TagAction, Lithic::Models::AuthRules::CardTransactionUpdateAction::CreateCaseAction] The action to take if the conditions are met.
+        #
+        #   @param conditions [Array<Lithic::Models::AuthRules::ConditionalCardTransactionUpdateActionParameters::Condition>]
+
+        class Condition < Lithic::Internal::Type::BaseModel
+          # @!attribute attribute
+          #   The attribute to target.
+          #
+          #   The following attributes may be targeted:
+          #
+          #   - `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.
+          #   - `COUNTRY`: Country of 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.
+          #   - `CURRENCY`: 3-character alphabetic ISO 4217 code for the merchant currency of
+          #     the transaction.
+          #   - `MERCHANT_ID`: Unique alphanumeric identifier for the payment card acceptor
+          #     (merchant).
+          #   - `DESCRIPTOR`: Short description of card acceptor.
+          #   - `TRANSACTION_AMOUNT`: The base transaction amount (in cents) plus the acquirer
+          #     fee field in the settlement/cardholder billing currency. This is the amount
+          #     the issuer should authorize against unless the issuer is paying the acquirer
+          #     fee on behalf of the cardholder.
+          #   - `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.
+          #   - `TRANSACTION_STATUS`: The status of the transaction. Valid values are
+          #     `PENDING`, `VOIDED`, `SETTLING`, `SETTLED`, `BOUNCED`, `RETURNED`, `DECLINED`,
+          #     `EXPIRED`.
+          #   - `LAST_EVENT_TYPE`: The type of the most recent event on the transaction. Valid
+          #     values are `AUTHORIZATION`, `AUTHORIZATION_ADVICE`, `AUTHORIZATION_EXPIRY`,
+          #     `AUTHORIZATION_REVERSAL`, `BALANCE_INQUIRY`, `CLEARING`, `CORRECTION_CREDIT`,
+          #     `CORRECTION_DEBIT`, `CREDIT_AUTHORIZATION`, `CREDIT_AUTHORIZATION_ADVICE`,
+          #     `FINANCIAL_AUTHORIZATION`, `FINANCIAL_CREDIT_AUTHORIZATION`, `RETURN`,
+          #     `RETURN_REVERSAL`.
+          #   - `LIABILITY_SHIFT`: Indicates whether chargeback liability shift to the issuer
+          #     applies to the transaction. Valid values are `NONE`, `3DS_AUTHENTICATED`, or
+          #     `TOKEN_AUTHENTICATED`.
+          #   - `PAN_ENTRY_MODE`: The method by which the cardholder's primary account number
+          #     (PAN) was entered. Valid values are `AUTO_ENTRY`, `BAR_CODE`, `CONTACTLESS`,
+          #     `ECOMMERCE`, `ERROR_KEYED`, `ERROR_MAGNETIC_STRIPE`, `ICC`, `KEY_ENTERED`,
+          #     `MAGNETIC_STRIPE`, `MANUAL`, `OCR`, `SECURE_CARDLESS`, `UNSPECIFIED`,
+          #     `UNKNOWN`, or `CREDENTIAL_ON_FILE`.
+          #   - `WALLET_TYPE`: For transactions using a digital wallet token, indicates the
+          #     source of the token. Valid values are `APPLE_PAY`, `GOOGLE_PAY`,
+          #     `SAMSUNG_PAY`, `MASTERPASS`, `MERCHANT`, `OTHER`, `NONE`.
+          #   - `CARD_AGE`: The age of the card in seconds at the time of the transaction.
+          #   - `ACCOUNT_AGE`: The age of the account in seconds at the time of the
+          #     transaction.
+          #   - `SPEND_VELOCITY_COUNT`: The number of transactions matching the specified
+          #     filters within the given period. Requires `parameters` with `scope`, `period`,
+          #     and optional `filters`.
+          #   - `SPEND_VELOCITY_AMOUNT`: The total spend amount (in cents) of transactions
+          #     matching the specified filters within the given period. Requires `parameters`
+          #     with `scope`, `period`, and optional `filters`.
+          #
+          #   @return [Symbol, Lithic::Models::AuthRules::ConditionalCardTransactionUpdateActionParameters::Condition::Attribute]
+          required :attribute,
+                   enum: -> { Lithic::AuthRules::ConditionalCardTransactionUpdateActionParameters::Condition::Attribute }
+
+          # @!attribute operation
+          #   The operation to apply to the attribute
+          #
+          #   @return [Symbol, Lithic::Models::AuthRules::ConditionalOperation]
+          required :operation, enum: -> { Lithic::AuthRules::ConditionalOperation }
+
+          # @!attribute value
+          #   A regex string, to be used with `MATCHES` or `DOES_NOT_MATCH`
+          #
+          #   @return [String, Integer, Array<String>, Time]
+          required :value, union: -> { Lithic::AuthRules::ConditionalValue }
+
+          # @!attribute parameters
+          #   Additional parameters for spend velocity attributes. Required when `attribute`
+          #   is `SPEND_VELOCITY_COUNT` or `SPEND_VELOCITY_AMOUNT`. Not used for other
+          #   attributes.
+          #
+          #   @return [Lithic::Models::AuthRules::ConditionalCardTransactionUpdateActionParameters::Condition::Parameters, nil]
+          optional :parameters,
+                   -> { Lithic::AuthRules::ConditionalCardTransactionUpdateActionParameters::Condition::Parameters }
+
+          # @!method initialize(attribute:, operation:, value:, parameters: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Lithic::Models::AuthRules::ConditionalCardTransactionUpdateActionParameters::Condition}
+          #   for more details.
+          #
+          #   @param attribute [Symbol, Lithic::Models::AuthRules::ConditionalCardTransactionUpdateActionParameters::Condition::Attribute] The attribute to target.
+          #
+          #   @param operation [Symbol, Lithic::Models::AuthRules::ConditionalOperation] The operation to apply to the attribute
+          #
+          #   @param value [String, Integer, Array<String>, Time] A regex string, to be used with `MATCHES` or `DOES_NOT_MATCH`
+          #
+          #   @param parameters [Lithic::Models::AuthRules::ConditionalCardTransactionUpdateActionParameters::Condition::Parameters] Additional parameters for spend velocity attributes. Required when `attribute` i
+
+          # The attribute to target.
+          #
+          # The following attributes may be targeted:
+          #
+          # - `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.
+          # - `COUNTRY`: Country of 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.
+          # - `CURRENCY`: 3-character alphabetic ISO 4217 code for the merchant currency of
+          #   the transaction.
+          # - `MERCHANT_ID`: Unique alphanumeric identifier for the payment card acceptor
+          #   (merchant).
+          # - `DESCRIPTOR`: Short description of card acceptor.
+          # - `TRANSACTION_AMOUNT`: The base transaction amount (in cents) plus the acquirer
+          #   fee field in the settlement/cardholder billing currency. This is the amount
+          #   the issuer should authorize against unless the issuer is paying the acquirer
+          #   fee on behalf of the cardholder.
+          # - `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.
+          # - `TRANSACTION_STATUS`: The status of the transaction. Valid values are
+          #   `PENDING`, `VOIDED`, `SETTLING`, `SETTLED`, `BOUNCED`, `RETURNED`, `DECLINED`,
+          #   `EXPIRED`.
+          # - `LAST_EVENT_TYPE`: The type of the most recent event on the transaction. Valid
+          #   values are `AUTHORIZATION`, `AUTHORIZATION_ADVICE`, `AUTHORIZATION_EXPIRY`,
+          #   `AUTHORIZATION_REVERSAL`, `BALANCE_INQUIRY`, `CLEARING`, `CORRECTION_CREDIT`,
+          #   `CORRECTION_DEBIT`, `CREDIT_AUTHORIZATION`, `CREDIT_AUTHORIZATION_ADVICE`,
+          #   `FINANCIAL_AUTHORIZATION`, `FINANCIAL_CREDIT_AUTHORIZATION`, `RETURN`,
+          #   `RETURN_REVERSAL`.
+          # - `LIABILITY_SHIFT`: Indicates whether chargeback liability shift to the issuer
+          #   applies to the transaction. Valid values are `NONE`, `3DS_AUTHENTICATED`, or
+          #   `TOKEN_AUTHENTICATED`.
+          # - `PAN_ENTRY_MODE`: The method by which the cardholder's primary account number
+          #   (PAN) was entered. Valid values are `AUTO_ENTRY`, `BAR_CODE`, `CONTACTLESS`,
+          #   `ECOMMERCE`, `ERROR_KEYED`, `ERROR_MAGNETIC_STRIPE`, `ICC`, `KEY_ENTERED`,
+          #   `MAGNETIC_STRIPE`, `MANUAL`, `OCR`, `SECURE_CARDLESS`, `UNSPECIFIED`,
+          #   `UNKNOWN`, or `CREDENTIAL_ON_FILE`.
+          # - `WALLET_TYPE`: For transactions using a digital wallet token, indicates the
+          #   source of the token. Valid values are `APPLE_PAY`, `GOOGLE_PAY`,
+          #   `SAMSUNG_PAY`, `MASTERPASS`, `MERCHANT`, `OTHER`, `NONE`.
+          # - `CARD_AGE`: The age of the card in seconds at the time of the transaction.
+          # - `ACCOUNT_AGE`: The age of the account in seconds at the time of the
+          #   transaction.
+          # - `SPEND_VELOCITY_COUNT`: The number of transactions matching the specified
+          #   filters within the given period. Requires `parameters` with `scope`, `period`,
+          #   and optional `filters`.
+          # - `SPEND_VELOCITY_AMOUNT`: The total spend amount (in cents) of transactions
+          #   matching the specified filters within the given period. Requires `parameters`
+          #   with `scope`, `period`, and optional `filters`.
+          #
+          # @see Lithic::Models::AuthRules::ConditionalCardTransactionUpdateActionParameters::Condition#attribute
+          module Attribute
+            extend Lithic::Internal::Type::Enum
+
+            MCC = :MCC
+            COUNTRY = :COUNTRY
+            CURRENCY = :CURRENCY
+            MERCHANT_ID = :MERCHANT_ID
+            DESCRIPTOR = :DESCRIPTOR
+            TRANSACTION_AMOUNT = :TRANSACTION_AMOUNT
+            RISK_SCORE = :RISK_SCORE
+            TRANSACTION_STATUS = :TRANSACTION_STATUS
+            LAST_EVENT_TYPE = :LAST_EVENT_TYPE
+            LIABILITY_SHIFT = :LIABILITY_SHIFT
+            PAN_ENTRY_MODE = :PAN_ENTRY_MODE
+            WALLET_TYPE = :WALLET_TYPE
+            CARD_AGE = :CARD_AGE
+            ACCOUNT_AGE = :ACCOUNT_AGE
+            SPEND_VELOCITY_COUNT = :SPEND_VELOCITY_COUNT
+            SPEND_VELOCITY_AMOUNT = :SPEND_VELOCITY_AMOUNT
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # @see Lithic::Models::AuthRules::ConditionalCardTransactionUpdateActionParameters::Condition#parameters
+          class Parameters < Lithic::Internal::Type::BaseModel
+            # @!attribute filters
+            #
+            #   @return [Lithic::Models::AuthRules::SpendVelocityFilters, nil]
+            optional :filters, -> { Lithic::AuthRules::SpendVelocityFilters }
+
+            # @!attribute period
+            #   The time period over which to calculate the spend velocity.
+            #
+            #   @return [Lithic::Models::AuthRules::VelocityLimitPeriod::TrailingWindowObject, Lithic::Models::AuthRules::VelocityLimitPeriod::FixedWindowDay, Lithic::Models::AuthRules::VelocityLimitPeriod::FixedWindowWeek, Lithic::Models::AuthRules::VelocityLimitPeriod::FixedWindowMonth, Lithic::Models::AuthRules::VelocityLimitPeriod::FixedWindowYear, nil]
+            optional :period, union: -> { Lithic::AuthRules::VelocityLimitPeriod }
+
+            # @!attribute scope
+            #   The entity scope to evaluate the attribute against.
+            #
+            #   @return [Symbol, Lithic::Models::AuthRules::ConditionalCardTransactionUpdateActionParameters::Condition::Parameters::Scope, nil]
+            optional :scope,
+                     enum: -> { Lithic::AuthRules::ConditionalCardTransactionUpdateActionParameters::Condition::Parameters::Scope }
+
+            # @!method initialize(filters: nil, period: nil, scope: nil)
+            #   Additional parameters for spend velocity attributes. Required when `attribute`
+            #   is `SPEND_VELOCITY_COUNT` or `SPEND_VELOCITY_AMOUNT`. Not used for other
+            #   attributes.
+            #
+            #   @param filters [Lithic::Models::AuthRules::SpendVelocityFilters]
+            #
+            #   @param period [Lithic::Models::AuthRules::VelocityLimitPeriod::TrailingWindowObject, Lithic::Models::AuthRules::VelocityLimitPeriod::FixedWindowDay, Lithic::Models::AuthRules::VelocityLimitPeriod::FixedWindowWeek, Lithic::Models::AuthRules::VelocityLimitPeriod::FixedWindowMonth, Lithic::Models::AuthRules::VelocityLimitPeriod::FixedWindowYear] The time period over which to calculate the spend velocity.
+            #
+            #   @param scope [Symbol, Lithic::Models::AuthRules::ConditionalCardTransactionUpdateActionParameters::Condition::Parameters::Scope] The entity scope to evaluate the attribute against.
+
+            # The entity scope to evaluate the attribute against.
+            #
+            # @see Lithic::Models::AuthRules::ConditionalCardTransactionUpdateActionParameters::Condition::Parameters#scope
+            module Scope
+              extend Lithic::Internal::Type::Enum
+
+              CARD = :CARD
+              ACCOUNT = :ACCOUNT
+              GLOBAL = :GLOBAL
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/lithic/models/auth_rules/event_stream.rb

@@ -12,6 +12,7 @@ module Lithic
         TOKENIZATION = :TOKENIZATION
         ACH_CREDIT_RECEIPT = :ACH_CREDIT_RECEIPT
         ACH_DEBIT_RECEIPT = :ACH_DEBIT_RECEIPT
+        CARD_TRANSACTION_UPDATE = :CARD_TRANSACTION_UPDATE
 
         # @!method self.values
         #   @return [Array<Symbol>]

data/lib/lithic/models/auth_rules/spend_velocity_filters.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Lithic
+  module Models
+    module AuthRules
+      class SpendVelocityFilters < Lithic::Models::AuthRules::VelocityLimitFilters
+        # @!attribute exclude_tags
+        #   Tag key-value pairs to exclude from the velocity calculation. Transactions
+        #   matching all specified tag key-value pairs will be excluded from the calculated
+        #   velocity.
+        #
+        #   @return [Hash{Symbol=>String}, nil]
+        optional :exclude_tags, Lithic::Internal::Type::HashOf[String], nil?: true
+
+        # @!attribute include_tags
+        #   Tag key-value pairs to include in the velocity calculation. Only transactions
+        #   matching all specified tag key-value pairs will be included in the calculated
+        #   velocity.
+        #
+        #   @return [Hash{Symbol=>String}, nil]
+        optional :include_tags, Lithic::Internal::Type::HashOf[String], nil?: true
+
+        # @!method initialize(exclude_tags: nil, include_tags: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Lithic::Models::AuthRules::SpendVelocityFilters} for more details.
+        #
+        #   @param exclude_tags [Hash{Symbol=>String}, nil] Tag key-value pairs to exclude from the velocity calculation. Transactions match
+        #
+        #   @param include_tags [Hash{Symbol=>String}, nil] Tag key-value pairs to include in the velocity calculation. Only transactions ma
+      end
+    end
+  end
+end

data/lib/lithic/models/auth_rules/v2_create_params.rb

@@ -30,7 +30,7 @@ module Lithic
             # @!attribute parameters
             #   Parameters for the Auth Rule
             #
-            #   @return [Lithic::Models::AuthRules::ConditionalBlockParameters, Lithic::Models::AuthRules::VelocityLimitParams, Lithic::Models::AuthRules::MerchantLockParameters, Lithic::Models::AuthRules::Conditional3DSActionParameters, Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters, Lithic::Models::AuthRules::ConditionalACHActionParameters, Lithic::Models::AuthRules::ConditionalTokenizationActionParameters, Lithic::Models::AuthRules::TypescriptCodeParameters]
+            #   @return [Lithic::Models::AuthRules::ConditionalBlockParameters, Lithic::Models::AuthRules::VelocityLimitParams, Lithic::Models::AuthRules::MerchantLockParameters, Lithic::Models::AuthRules::Conditional3DSActionParameters, Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters, Lithic::Models::AuthRules::ConditionalACHActionParameters, Lithic::Models::AuthRules::ConditionalTokenizationActionParameters, Lithic::Models::AuthRules::ConditionalCardTransactionUpdateActionParameters, Lithic::Models::AuthRules::TypescriptCodeParameters]
             required :parameters, union: -> { Lithic::AuthRules::V2CreateParams::Body::AccountLevelRule::Parameters }
 
             # @!attribute type
@@ -44,7 +44,8 @@ module Lithic
             #   - `VELOCITY_LIMIT`: AUTHORIZATION event stream.
             #   - `MERCHANT_LOCK`: AUTHORIZATION event stream.
             #   - `CONDITIONAL_ACTION`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
-            #     ACH_CREDIT_RECEIPT, or ACH_DEBIT_RECEIPT event stream.
+            #     ACH_CREDIT_RECEIPT, ACH_DEBIT_RECEIPT, or CARD_TRANSACTION_UPDATE event
+            #     stream.
             #   - `TYPESCRIPT_CODE`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
             #     ACH_CREDIT_RECEIPT, or ACH_DEBIT_RECEIPT event stream.
             #
@@ -80,7 +81,7 @@ module Lithic
             #   {Lithic::Models::AuthRules::V2CreateParams::Body::AccountLevelRule} for more
             #   details.
             #
-            #   @param parameters [Lithic::Models::AuthRules::ConditionalBlockParameters, Lithic::Models::AuthRules::VelocityLimitParams, Lithic::Models::AuthRules::MerchantLockParameters, Lithic::Models::AuthRules::Conditional3DSActionParameters, Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters, Lithic::Models::AuthRules::ConditionalACHActionParameters, Lithic::Models::AuthRules::ConditionalTokenizationActionParameters, Lithic::Models::AuthRules::TypescriptCodeParameters] Parameters for the Auth Rule
+            #   @param parameters [Lithic::Models::AuthRules::ConditionalBlockParameters, Lithic::Models::AuthRules::VelocityLimitParams, Lithic::Models::AuthRules::MerchantLockParameters, Lithic::Models::AuthRules::Conditional3DSActionParameters, Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters, Lithic::Models::AuthRules::ConditionalACHActionParameters, Lithic::Models::AuthRules::ConditionalTokenizationActionParameters, Lithic::Models::AuthRules::ConditionalCardTransactionUpdateActionParameters, Lithic::Models::AuthRules::TypescriptCodeParameters] Parameters for the Auth Rule
             #
             #   @param type [Symbol, Lithic::Models::AuthRules::V2CreateParams::Body::AccountLevelRule::Type] The type of Auth Rule. For certain rule types, this determines the event stream
             #
@@ -113,11 +114,13 @@ module Lithic
 
               variant -> { Lithic::AuthRules::ConditionalTokenizationActionParameters }
 
+              variant -> { Lithic::AuthRules::ConditionalCardTransactionUpdateActionParameters }
+
               # Parameters for defining a TypeScript code rule
               variant -> { Lithic::AuthRules::TypescriptCodeParameters }
 
               # @!method self.variants
-              #   @return [Array(Lithic::Models::AuthRules::ConditionalBlockParameters, Lithic::Models::AuthRules::VelocityLimitParams, Lithic::Models::AuthRules::MerchantLockParameters, Lithic::Models::AuthRules::Conditional3DSActionParameters, Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters, Lithic::Models::AuthRules::ConditionalACHActionParameters, Lithic::Models::AuthRules::ConditionalTokenizationActionParameters, Lithic::Models::AuthRules::TypescriptCodeParameters)]
+              #   @return [Array(Lithic::Models::AuthRules::ConditionalBlockParameters, Lithic::Models::AuthRules::VelocityLimitParams, Lithic::Models::AuthRules::MerchantLockParameters, Lithic::Models::AuthRules::Conditional3DSActionParameters, Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters, Lithic::Models::AuthRules::ConditionalACHActionParameters, Lithic::Models::AuthRules::ConditionalTokenizationActionParameters, Lithic::Models::AuthRules::ConditionalCardTransactionUpdateActionParameters, Lithic::Models::AuthRules::TypescriptCodeParameters)]
             end
 
             # The type of Auth Rule. For certain rule types, this determines the event stream
@@ -130,7 +133,8 @@ module Lithic
             # - `VELOCITY_LIMIT`: AUTHORIZATION event stream.
             # - `MERCHANT_LOCK`: AUTHORIZATION event stream.
             # - `CONDITIONAL_ACTION`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
-            #   ACH_CREDIT_RECEIPT, or ACH_DEBIT_RECEIPT event stream.
+            #   ACH_CREDIT_RECEIPT, ACH_DEBIT_RECEIPT, or CARD_TRANSACTION_UPDATE event
+            #   stream.
             # - `TYPESCRIPT_CODE`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
             #   ACH_CREDIT_RECEIPT, or ACH_DEBIT_RECEIPT event stream.
             #
@@ -159,7 +163,7 @@ module Lithic
             # @!attribute parameters
             #   Parameters for the Auth Rule
             #
-            #   @return [Lithic::Models::AuthRules::ConditionalBlockParameters, Lithic::Models::AuthRules::VelocityLimitParams, Lithic::Models::AuthRules::MerchantLockParameters, Lithic::Models::AuthRules::Conditional3DSActionParameters, Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters, Lithic::Models::AuthRules::ConditionalACHActionParameters, Lithic::Models::AuthRules::ConditionalTokenizationActionParameters, Lithic::Models::AuthRules::TypescriptCodeParameters]
+            #   @return [Lithic::Models::AuthRules::ConditionalBlockParameters, Lithic::Models::AuthRules::VelocityLimitParams, Lithic::Models::AuthRules::MerchantLockParameters, Lithic::Models::AuthRules::Conditional3DSActionParameters, Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters, Lithic::Models::AuthRules::ConditionalACHActionParameters, Lithic::Models::AuthRules::ConditionalTokenizationActionParameters, Lithic::Models::AuthRules::ConditionalCardTransactionUpdateActionParameters, Lithic::Models::AuthRules::TypescriptCodeParameters]
             required :parameters, union: -> { Lithic::AuthRules::V2CreateParams::Body::CardLevelRule::Parameters }
 
             # @!attribute type
@@ -173,7 +177,8 @@ module Lithic
             #   - `VELOCITY_LIMIT`: AUTHORIZATION event stream.
             #   - `MERCHANT_LOCK`: AUTHORIZATION event stream.
             #   - `CONDITIONAL_ACTION`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
-            #     ACH_CREDIT_RECEIPT, or ACH_DEBIT_RECEIPT event stream.
+            #     ACH_CREDIT_RECEIPT, ACH_DEBIT_RECEIPT, or CARD_TRANSACTION_UPDATE event
+            #     stream.
             #   - `TYPESCRIPT_CODE`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
             #     ACH_CREDIT_RECEIPT, or ACH_DEBIT_RECEIPT event stream.
             #
@@ -199,7 +204,7 @@ module Lithic
             #
             #   @param card_tokens [Array<String>] Card tokens to which the Auth Rule applies.
             #
-            #   @param parameters [Lithic::Models::AuthRules::ConditionalBlockParameters, Lithic::Models::AuthRules::VelocityLimitParams, Lithic::Models::AuthRules::MerchantLockParameters, Lithic::Models::AuthRules::Conditional3DSActionParameters, Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters, Lithic::Models::AuthRules::ConditionalACHActionParameters, Lithic::Models::AuthRules::ConditionalTokenizationActionParameters, Lithic::Models::AuthRules::TypescriptCodeParameters] Parameters for the Auth Rule
+            #   @param parameters [Lithic::Models::AuthRules::ConditionalBlockParameters, Lithic::Models::AuthRules::VelocityLimitParams, Lithic::Models::AuthRules::MerchantLockParameters, Lithic::Models::AuthRules::Conditional3DSActionParameters, Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters, Lithic::Models::AuthRules::ConditionalACHActionParameters, Lithic::Models::AuthRules::ConditionalTokenizationActionParameters, Lithic::Models::AuthRules::ConditionalCardTransactionUpdateActionParameters, Lithic::Models::AuthRules::TypescriptCodeParameters] Parameters for the Auth Rule
             #
             #   @param type [Symbol, Lithic::Models::AuthRules::V2CreateParams::Body::CardLevelRule::Type] The type of Auth Rule. For certain rule types, this determines the event stream
             #
@@ -228,11 +233,13 @@ module Lithic
 
               variant -> { Lithic::AuthRules::ConditionalTokenizationActionParameters }
 
+              variant -> { Lithic::AuthRules::ConditionalCardTransactionUpdateActionParameters }
+
               # Parameters for defining a TypeScript code rule
               variant -> { Lithic::AuthRules::TypescriptCodeParameters }
 
               # @!method self.variants
-              #   @return [Array(Lithic::Models::AuthRules::ConditionalBlockParameters, Lithic::Models::AuthRules::VelocityLimitParams, Lithic::Models::AuthRules::MerchantLockParameters, Lithic::Models::AuthRules::Conditional3DSActionParameters, Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters, Lithic::Models::AuthRules::ConditionalACHActionParameters, Lithic::Models::AuthRules::ConditionalTokenizationActionParameters, Lithic::Models::AuthRules::TypescriptCodeParameters)]
+              #   @return [Array(Lithic::Models::AuthRules::ConditionalBlockParameters, Lithic::Models::AuthRules::VelocityLimitParams, Lithic::Models::AuthRules::MerchantLockParameters, Lithic::Models::AuthRules::Conditional3DSActionParameters, Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters, Lithic::Models::AuthRules::ConditionalACHActionParameters, Lithic::Models::AuthRules::ConditionalTokenizationActionParameters, Lithic::Models::AuthRules::ConditionalCardTransactionUpdateActionParameters, Lithic::Models::AuthRules::TypescriptCodeParameters)]
             end
 
             # The type of Auth Rule. For certain rule types, this determines the event stream
@@ -245,7 +252,8 @@ module Lithic
             # - `VELOCITY_LIMIT`: AUTHORIZATION event stream.
             # - `MERCHANT_LOCK`: AUTHORIZATION event stream.
             # - `CONDITIONAL_ACTION`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
-            #   ACH_CREDIT_RECEIPT, or ACH_DEBIT_RECEIPT event stream.
+            #   ACH_CREDIT_RECEIPT, ACH_DEBIT_RECEIPT, or CARD_TRANSACTION_UPDATE event
+            #   stream.
             # - `TYPESCRIPT_CODE`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
             #   ACH_CREDIT_RECEIPT, or ACH_DEBIT_RECEIPT event stream.
             #
@@ -268,7 +276,7 @@ module Lithic
             # @!attribute parameters
             #   Parameters for the Auth Rule
             #
-            #   @return [Lithic::Models::AuthRules::ConditionalBlockParameters, Lithic::Models::AuthRules::VelocityLimitParams, Lithic::Models::AuthRules::MerchantLockParameters, Lithic::Models::AuthRules::Conditional3DSActionParameters, Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters, Lithic::Models::AuthRules::ConditionalACHActionParameters, Lithic::Models::AuthRules::ConditionalTokenizationActionParameters, Lithic::Models::AuthRules::TypescriptCodeParameters]
+            #   @return [Lithic::Models::AuthRules::ConditionalBlockParameters, Lithic::Models::AuthRules::VelocityLimitParams, Lithic::Models::AuthRules::MerchantLockParameters, Lithic::Models::AuthRules::Conditional3DSActionParameters, Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters, Lithic::Models::AuthRules::ConditionalACHActionParameters, Lithic::Models::AuthRules::ConditionalTokenizationActionParameters, Lithic::Models::AuthRules::ConditionalCardTransactionUpdateActionParameters, Lithic::Models::AuthRules::TypescriptCodeParameters]
             required :parameters, union: -> { Lithic::AuthRules::V2CreateParams::Body::ProgramLevelRule::Parameters }
 
             # @!attribute program_level
@@ -288,7 +296,8 @@ module Lithic
             #   - `VELOCITY_LIMIT`: AUTHORIZATION event stream.
             #   - `MERCHANT_LOCK`: AUTHORIZATION event stream.
             #   - `CONDITIONAL_ACTION`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
-            #     ACH_CREDIT_RECEIPT, or ACH_DEBIT_RECEIPT event stream.
+            #     ACH_CREDIT_RECEIPT, ACH_DEBIT_RECEIPT, or CARD_TRANSACTION_UPDATE event
+            #     stream.
             #   - `TYPESCRIPT_CODE`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
             #     ACH_CREDIT_RECEIPT, or ACH_DEBIT_RECEIPT event stream.
             #
@@ -330,7 +339,7 @@ module Lithic
             #   {Lithic::Models::AuthRules::V2CreateParams::Body::ProgramLevelRule} for more
             #   details.
             #
-            #   @param parameters [Lithic::Models::AuthRules::ConditionalBlockParameters, Lithic::Models::AuthRules::VelocityLimitParams, Lithic::Models::AuthRules::MerchantLockParameters, Lithic::Models::AuthRules::Conditional3DSActionParameters, Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters, Lithic::Models::AuthRules::ConditionalACHActionParameters, Lithic::Models::AuthRules::ConditionalTokenizationActionParameters, Lithic::Models::AuthRules::TypescriptCodeParameters] Parameters for the Auth Rule
+            #   @param parameters [Lithic::Models::AuthRules::ConditionalBlockParameters, Lithic::Models::AuthRules::VelocityLimitParams, Lithic::Models::AuthRules::MerchantLockParameters, Lithic::Models::AuthRules::Conditional3DSActionParameters, Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters, Lithic::Models::AuthRules::ConditionalACHActionParameters, Lithic::Models::AuthRules::ConditionalTokenizationActionParameters, Lithic::Models::AuthRules::ConditionalCardTransactionUpdateActionParameters, Lithic::Models::AuthRules::TypescriptCodeParameters] Parameters for the Auth Rule
             #
             #   @param program_level [Boolean] Whether the Auth Rule applies to all authorizations on the card program.
             #
@@ -367,11 +376,13 @@ module Lithic
 
               variant -> { Lithic::AuthRules::ConditionalTokenizationActionParameters }
 
+              variant -> { Lithic::AuthRules::ConditionalCardTransactionUpdateActionParameters }
+
               # Parameters for defining a TypeScript code rule
               variant -> { Lithic::AuthRules::TypescriptCodeParameters }
 
               # @!method self.variants
-              #   @return [Array(Lithic::Models::AuthRules::ConditionalBlockParameters, Lithic::Models::AuthRules::VelocityLimitParams, Lithic::Models::AuthRules::MerchantLockParameters, Lithic::Models::AuthRules::Conditional3DSActionParameters, Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters, Lithic::Models::AuthRules::ConditionalACHActionParameters, Lithic::Models::AuthRules::ConditionalTokenizationActionParameters, Lithic::Models::AuthRules::TypescriptCodeParameters)]
+              #   @return [Array(Lithic::Models::AuthRules::ConditionalBlockParameters, Lithic::Models::AuthRules::VelocityLimitParams, Lithic::Models::AuthRules::MerchantLockParameters, Lithic::Models::AuthRules::Conditional3DSActionParameters, Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters, Lithic::Models::AuthRules::ConditionalACHActionParameters, Lithic::Models::AuthRules::ConditionalTokenizationActionParameters, Lithic::Models::AuthRules::ConditionalCardTransactionUpdateActionParameters, Lithic::Models::AuthRules::TypescriptCodeParameters)]
             end
 
             # The type of Auth Rule. For certain rule types, this determines the event stream
@@ -384,7 +395,8 @@ module Lithic
             # - `VELOCITY_LIMIT`: AUTHORIZATION event stream.
             # - `MERCHANT_LOCK`: AUTHORIZATION event stream.
             # - `CONDITIONAL_ACTION`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
-            #   ACH_CREDIT_RECEIPT, or ACH_DEBIT_RECEIPT event stream.
+            #   ACH_CREDIT_RECEIPT, ACH_DEBIT_RECEIPT, or CARD_TRANSACTION_UPDATE event
+            #   stream.
             # - `TYPESCRIPT_CODE`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
             #   ACH_CREDIT_RECEIPT, or ACH_DEBIT_RECEIPT event stream.
             #

data/lib/lithic/models/auth_rules/v2_draft_params.rb

@@ -16,13 +16,13 @@ module Lithic
         # @!attribute parameters
         #   Parameters for the Auth Rule
         #
-        #   @return [Lithic::Models::AuthRules::ConditionalBlockParameters, Lithic::Models::AuthRules::VelocityLimitParams, Lithic::Models::AuthRules::MerchantLockParameters, Lithic::Models::AuthRules::Conditional3DSActionParameters, Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters, Lithic::Models::AuthRules::ConditionalACHActionParameters, Lithic::Models::AuthRules::ConditionalTokenizationActionParameters, Lithic::Models::AuthRules::TypescriptCodeParameters, nil]
+        #   @return [Lithic::Models::AuthRules::ConditionalBlockParameters, Lithic::Models::AuthRules::VelocityLimitParams, Lithic::Models::AuthRules::MerchantLockParameters, Lithic::Models::AuthRules::Conditional3DSActionParameters, Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters, Lithic::Models::AuthRules::ConditionalACHActionParameters, Lithic::Models::AuthRules::ConditionalTokenizationActionParameters, Lithic::Models::AuthRules::ConditionalCardTransactionUpdateActionParameters, Lithic::Models::AuthRules::TypescriptCodeParameters, nil]
         optional :parameters, union: -> { Lithic::AuthRules::V2DraftParams::Parameters }, nil?: true
 
         # @!method initialize(auth_rule_token:, parameters: nil, request_options: {})
         #   @param auth_rule_token [String]
         #
-        #   @param parameters [Lithic::Models::AuthRules::ConditionalBlockParameters, Lithic::Models::AuthRules::VelocityLimitParams, Lithic::Models::AuthRules::MerchantLockParameters, Lithic::Models::AuthRules::Conditional3DSActionParameters, Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters, Lithic::Models::AuthRules::ConditionalACHActionParameters, Lithic::Models::AuthRules::ConditionalTokenizationActionParameters, Lithic::Models::AuthRules::TypescriptCodeParameters, nil] Parameters for the Auth Rule
+        #   @param parameters [Lithic::Models::AuthRules::ConditionalBlockParameters, Lithic::Models::AuthRules::VelocityLimitParams, Lithic::Models::AuthRules::MerchantLockParameters, Lithic::Models::AuthRules::Conditional3DSActionParameters, Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters, Lithic::Models::AuthRules::ConditionalACHActionParameters, Lithic::Models::AuthRules::ConditionalTokenizationActionParameters, Lithic::Models::AuthRules::ConditionalCardTransactionUpdateActionParameters, Lithic::Models::AuthRules::TypescriptCodeParameters, nil] Parameters for the Auth Rule
         #
         #   @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}]
 
@@ -45,11 +45,13 @@ module Lithic
 
           variant -> { Lithic::AuthRules::ConditionalTokenizationActionParameters }
 
+          variant -> { Lithic::AuthRules::ConditionalCardTransactionUpdateActionParameters }
+
           # Parameters for defining a TypeScript code rule
           variant -> { Lithic::AuthRules::TypescriptCodeParameters }
 
           # @!method self.variants
-          #   @return [Array(Lithic::Models::AuthRules::ConditionalBlockParameters, Lithic::Models::AuthRules::VelocityLimitParams, Lithic::Models::AuthRules::MerchantLockParameters, Lithic::Models::AuthRules::Conditional3DSActionParameters, Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters, Lithic::Models::AuthRules::ConditionalACHActionParameters, Lithic::Models::AuthRules::ConditionalTokenizationActionParameters, Lithic::Models::AuthRules::TypescriptCodeParameters)]
+          #   @return [Array(Lithic::Models::AuthRules::ConditionalBlockParameters, Lithic::Models::AuthRules::VelocityLimitParams, Lithic::Models::AuthRules::MerchantLockParameters, Lithic::Models::AuthRules::Conditional3DSActionParameters, Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters, Lithic::Models::AuthRules::ConditionalACHActionParameters, Lithic::Models::AuthRules::ConditionalTokenizationActionParameters, Lithic::Models::AuthRules::ConditionalCardTransactionUpdateActionParameters, Lithic::Models::AuthRules::TypescriptCodeParameters)]
         end
       end
     end

data/lib/lithic/models/card_create_params.rb

@@ -72,14 +72,16 @@ module Lithic
 
       # @!attribute exp_month
       #   Two digit (MM) expiry month. If neither `exp_month` nor `exp_year` is provided,
-      #   an expiration date will be generated.
+      #   an expiration date five years in the future will be generated. Five years is the
+      #   maximum expiration date.
       #
       #   @return [String, nil]
       optional :exp_month, String
 
       # @!attribute exp_year
       #   Four digit (yyyy) expiry year. If neither `exp_month` nor `exp_year` is
-      #   provided, an expiration date will be generated.
+      #   provided, an expiration date five years in the future will be generated. Five
+      #   years is the maximum expiration date.
       #
       #   @return [String, nil]
       optional :exp_year, String

data/lib/lithic/models/card_renew_params.rb

@@ -26,14 +26,16 @@ module Lithic
 
       # @!attribute exp_month
       #   Two digit (MM) expiry month. If neither `exp_month` nor `exp_year` is provided,
-      #   an expiration date six years in the future will be generated.
+      #   an expiration date five years in the future will be generated. Five years is the
+      #   maximum expiration date.
       #
       #   @return [String, nil]
       optional :exp_month, String
 
       # @!attribute exp_year
       #   Four digit (yyyy) expiry year. If neither `exp_month` nor `exp_year` is
-      #   provided, an expiration date six years in the future will be generated.
+      #   provided, an expiration date five years in the future will be generated. Five
+      #   years is the maximum expiration date.
       #
       #   @return [String, nil]
       optional :exp_year, String

data/lib/lithic/models/non_pci_card.rb

@@ -29,10 +29,10 @@ module Lithic
       required :created, Time
 
       # @!attribute funding
-      #   Deprecated: Funding account for the card.
+      #   Funding account for a card
       #
-      #   @return [Lithic::Models::NonPCICard::Funding]
-      required :funding, -> { Lithic::NonPCICard::Funding }
+      #   @return [Lithic::Models::NonPCICard::Funding, nil]
+      required :funding, -> { Lithic::NonPCICard::Funding }, nil?: true
 
       # @!attribute last_four
       #   Last four digits of the card number.
@@ -141,7 +141,7 @@ module Lithic
       #   by Lithic to use.
       #
       #   @return [String, nil]
-      optional :digital_card_art_token, String
+      optional :digital_card_art_token, String, nil?: true
 
       # @!attribute exp_month
       #   Two digit (MM) expiry month.
@@ -189,7 +189,7 @@ module Lithic
       #   should be manufactured with.
       #
       #   @return [String, nil]
-      optional :product_id, String
+      optional :product_id, String, nil?: true
 
       # @!attribute replacement_for
       #   If the card is a replacement for another card, the globally unique identifier
@@ -221,7 +221,7 @@ module Lithic
       #   of the above categories. A comment can be provided to specify the reason.
       #
       #   @return [Symbol, Lithic::Models::NonPCICard::Substatus, nil]
-      optional :substatus, enum: -> { Lithic::NonPCICard::Substatus }
+      optional :substatus, enum: -> { Lithic::NonPCICard::Substatus }, nil?: true
 
       # @!method initialize(token:, account_token:, card_program_token:, created:, funding:, last_four:, pin_status:, spend_limit:, spend_limit_duration:, state:, type:, auth_rule_tokens: nil, bulk_order_token: nil, cardholder_currency: nil, comment: nil, digital_card_art_token: nil, exp_month: nil, exp_year: nil, hostname: nil, memo: nil, network_program_token: nil, pending_commands: nil, product_id: nil, replacement_for: nil, substatus: nil)
       #   Some parameter documentations has been truncated, see
@@ -237,7 +237,7 @@ module Lithic
       #
       #   @param created [Time] An RFC 3339 timestamp for when the card was created. UTC time zone.
       #
-      #   @param funding [Lithic::Models::NonPCICard::Funding] Deprecated: Funding account for the card.
+      #   @param funding [Lithic::Models::NonPCICard::Funding, nil] Funding account for a card
       #
       #   @param last_four [String] Last four digits of the card number.
       #
@@ -261,7 +261,7 @@ module Lithic
       #
       #   @param comment [String] Additional context or information related to the card.
       #
-      #   @param digital_card_art_token [String] Specifies the digital card art to be displayed in the user's digital wallet afte
+      #   @param digital_card_art_token [String, nil] Specifies the digital card art to be displayed in the user's digital wallet afte
       #
       #   @param exp_month [String] Two digit (MM) expiry month.
       #
@@ -275,11 +275,11 @@ module Lithic
       #
       #   @param pending_commands [Array<String>] Indicates if there are offline PIN changes pending card interaction with an offl
       #
-      #   @param product_id [String] Only applicable to cards of type `PHYSICAL`. This must be configured with Lithic
+      #   @param product_id [String, nil] Only applicable to cards of type `PHYSICAL`. This must be configured with Lithic
       #
       #   @param replacement_for [String, nil] If the card is a replacement for another card, the globally unique identifier fo
       #
-      #   @param substatus [Symbol, Lithic::Models::NonPCICard::Substatus] Card state substatus values: \* `LOST` - The physical card is no longer in the
+      #   @param substatus [Symbol, Lithic::Models::NonPCICard::Substatus, nil] Card state substatus values: \* `LOST` - The physical card is no longer in the
       #   ca
 
       # @see Lithic::Models::NonPCICard#funding
@@ -330,13 +330,13 @@ module Lithic
         #   The nickname given to the `FundingAccount` or `null` if it has no nickname.
         #
         #   @return [String, nil]
-        optional :nickname, String
+        optional :nickname, String, nil?: true
 
         # @!method initialize(token:, created:, last_four:, state:, type:, account_name: nil, nickname: nil)
         #   Some parameter documentations has been truncated, see
         #   {Lithic::Models::NonPCICard::Funding} for more details.
         #
-        #   Deprecated: Funding account for the card.
+        #   Funding account for a card
         #
         #   @param token [String] A globally unique identifier for this FundingAccount.
         #
@@ -351,7 +351,7 @@ module Lithic
         #
         #   @param account_name [String] Account name identifying the funding source. This may be `null`.
         #
-        #   @param nickname [String] The nickname given to the `FundingAccount` or `null` if it has no nickname.
+        #   @param nickname [String, nil] The nickname given to the `FundingAccount` or `null` if it has no nickname.
 
         # State of funding source. Funding source states: _ `ENABLED` - The funding
         # account is available to use for card creation and transactions. _ `PENDING` -

data/lib/lithic/models/reports/settlement/network_total_list_params.rb

@@ -112,6 +112,7 @@ module Lithic
           module Network
             extend Lithic::Internal::Type::Enum
 
+            AMEX = :AMEX
             VISA = :VISA
             MASTERCARD = :MASTERCARD
             MAESTRO = :MAESTRO