lithic 0.10.0 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 11e88e82fcc0153f5cdb72e8c89059d80322983cad5a04f21f7ee8cb58652a86
-  data.tar.gz: 326182c35442ef57d523b917d1f561302916593e64d9be3e72c4d8c47607ffd5
+  metadata.gz: 553b9c0f364c3ceda24f43c9070054640c640d3a64098de3b0ba14482cd5e3fa
+  data.tar.gz: 60d02df14fc6c2b57f8cbe950626641d8d97615c4739834e2ed0e6568e9a2160
 SHA512:
-  metadata.gz: da808cf2213f4fb880952816609649f93de70b6b4c544820d0bc3a86c93644f63bafb3a78debe42c0ba3c42bc5c9b62fdef755353f79234f6081990c72be9478
-  data.tar.gz: 29c1e2e9d8dbecf4f4fe2d20942afc6b625935627fe15deffc3b49ab03722f07aadd0eacf5c2146920feb50d6c6ab57f5e18544517dc6ca076c536fbbf890c13
+  metadata.gz: 49da4437a7eb8c6e4641e0317172d04d04894bf7d105ab6cfa09b9c841f87889610a5a70788477cf6395721fa377b621b451590428db5cb63ebcb21373535cf2
+  data.tar.gz: d727b8abf57c1facda792f2c410f64b1fbe055541c44c7d8002027e103704e1165042e185a1b01a1af55cda82ccbfaa16e3af844fea082ec9aed4001d4d24cf7

data/CHANGELOG.md

@@ -1,5 +1,44 @@
 # Changelog
 
+## 0.11.0 (2026-04-13)
+
+Full Changelog: [v0.10.0...v0.11.0](https://github.com/lithic-com/lithic-ruby/compare/v0.10.0...v0.11.0)
+
+### Features
+
+* **api:** add card decline count attributes to auth_rules conditional authorization ([d8d98d9](https://github.com/lithic-com/lithic-ruby/commit/d8d98d927f33b011b1a28c37df6b971ab7c895a0))
+* **api:** add DELINQUENT substatus to financial account update status ([6a49f69](https://github.com/lithic-com/lithic-ruby/commit/6a49f690f00b7c261e22201aaac8521db124e4dc))
+* **api:** add interchange/chargeback/provisional_credit_account to financial account type enums ([3d54444](https://github.com/lithic-com/lithic-ruby/commit/3d544442bb1ecfc4c69c806fb72cf8a1b0564c8d))
+* **api:** add override_company_name field to payment create parameters ([7e916b6](https://github.com/lithic-com/lithic-ruby/commit/7e916b6bb6e41494aab381d5a30bb83f9ea6ca23))
+* **api:** add statement_totals field to financial accounts statement ([1fa7586](https://github.com/lithic-com/lithic-ruby/commit/1fa758668e1caf7beefca72abe384c99d112ae85))
+* **api:** add transaction_token field to auth_rules examples ([4729281](https://github.com/lithic-com/lithic-ruby/commit/47292818b9afc96e2ac358235012b4deb8987016))
+* **api:** add transaction_token field to auth_rules v2 results response ([acca757](https://github.com/lithic-com/lithic-ruby/commit/acca757780ead14f428e035409c3b7cb815d9d83))
+
+
+### Bug Fixes
+
+* align path encoding with RFC 3986 section 3.3 ([5624e72](https://github.com/lithic-com/lithic-ruby/commit/5624e7234a615d0de2ecc92e007be91a54a90c98))
+* **internal:** correct multipart form field name encoding ([abfc1fd](https://github.com/lithic-com/lithic-ruby/commit/abfc1fdd7c78682932979e362448f95bca347d43))
+* multipart encoding for file arrays ([5a0bdeb](https://github.com/lithic-com/lithic-ruby/commit/5a0bdeb87640bd6340039f86a366886894e9991a))
+* **types:** [breaking] remove deprecated fields from auth_rules report_stats ([f3089b7](https://github.com/lithic-com/lithic-ruby/commit/f3089b7a510244d7c566bc69cc68d4564b899bec))
+* **types:** make credit_product_token optional in financial_accounts statement ([a0fa401](https://github.com/lithic-com/lithic-ruby/commit/a0fa40166b98f3d7e91878d5ea948027c72ea440))
+* **types:** remove INTERCHANGE/CHARGEBACK from FinancialAccount/InstanceFinancialAccountType ([6077d32](https://github.com/lithic-com/lithic-ruby/commit/6077d32ca7a8bc77204000d9c2e0cf7f28569c4b))
+* **types:** require Card fields, remove hostname in authorization approval webhook ([fb4f7d9](https://github.com/lithic-com/lithic-ruby/commit/fb4f7d98735f400ca090a07b7fe59373e8eb9ef1))
+* variable name typo ([0156ca5](https://github.com/lithic-com/lithic-ruby/commit/0156ca5e46b58cdfb25fdbcd293d16778e762c2a))
+
+
+### Chores
+
+* **ci:** skip lint on metadata-only changes ([810ca31](https://github.com/lithic-com/lithic-ruby/commit/810ca31d3deeb0fd04c5843496dc601187076633))
+* **ci:** support opting out of skipping builds on metadata-only commits ([40b20fb](https://github.com/lithic-com/lithic-ruby/commit/40b20fb0c3c2c31e2870ee2df86d4a55fac67a04))
+
+
+### Documentation
+
+* **api:** update nature_of_business and qr_code_url field descriptions ([b11902d](https://github.com/lithic-com/lithic-ruby/commit/b11902d30b4b337e7ffc05358df51c18e6ea6648))
+* improve examples ([a7a4a69](https://github.com/lithic-com/lithic-ruby/commit/a7a4a69c9c6930cb8fb3b6bfe4b10e32d1a49213))
+* update examples ([985e1f5](https://github.com/lithic-com/lithic-ruby/commit/985e1f5f0e12517dce490224aaf82021875c8101))
+
 ## 0.10.0 (2026-03-23)
 
 Full Changelog: [v0.9.0...v0.10.0](https://github.com/lithic-com/lithic-ruby/compare/v0.9.0...v0.10.0)

data/README.md

@@ -24,7 +24,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "lithic", "~> 0.10.0"
+gem "lithic", "~> 0.11.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/lithic/internal/util.rb

@@ -157,7 +157,7 @@ module Lithic
           in Hash | nil => coerced
             coerced
           else
-            message = "Expected a #{Hash} or #{Lithic::Internal::Type::BaseModel}, got #{data.inspect}"
+            message = "Expected a #{Hash} or #{Lithic::Internal::Type::BaseModel}, got #{input.inspect}"
             raise ArgumentError.new(message)
           end
         end
@@ -237,6 +237,11 @@ module Lithic
         end
       end
 
+      # @type [Regexp]
+      #
+      # https://www.rfc-editor.org/rfc/rfc3986.html#section-3.3
+      RFC_3986_NOT_PCHARS = /[^A-Za-z0-9\-._~!$&'()*+,;=:@]+/
+
       class << self
         # @api private
         #
@@ -247,6 +252,15 @@ module Lithic
           "#{uri.scheme}://#{uri.host}#{":#{uri.port}" unless uri.port == uri.default_port}"
         end
 
+        # @api private
+        #
+        # @param path [String, Integer]
+        #
+        # @return [String]
+        def encode_path(path)
+          path.to_s.gsub(Lithic::Internal::Util::RFC_3986_NOT_PCHARS) { ERB::Util.url_encode(_1) }
+        end
+
         # @api private
         #
         # @param path [String, Array<String>]
@@ -259,7 +273,7 @@ module Lithic
           in []
             ""
           in [String => p, *interpolations]
-            encoded = interpolations.map { ERB::Util.url_encode(_1) }
+            encoded = interpolations.map { encode_path(_1) }
             format(p, *encoded)
           end
         end
@@ -571,16 +585,15 @@ module Lithic
           y << "Content-Disposition: form-data"
 
           unless key.nil?
-            name = ERB::Util.url_encode(key.to_s)
-            y << "; name=\"#{name}\""
+            y << "; name=\"#{key}\""
           end
 
           case val
           in Lithic::FilePart unless val.filename.nil?
-            filename = ERB::Util.url_encode(val.filename)
+            filename = encode_path(val.filename)
             y << "; filename=\"#{filename}\""
           in Pathname | IO
-            filename = ERB::Util.url_encode(::File.basename(val.to_path))
+            filename = encode_path(::File.basename(val.to_path))
             y << "; filename=\"#{filename}\""
           else
           end
@@ -597,6 +610,7 @@ module Lithic
         #
         # @return [Array(String, Enumerable<String>)]
         private def encode_multipart_streaming(body)
+          # rubocop:disable Style/CaseEquality
           # RFC 1521 Section 7.2.1 says we should have 70 char maximum for boundary length
           boundary = SecureRandom.urlsafe_base64(46)
 
@@ -606,7 +620,7 @@ module Lithic
             in Hash
               body.each do |key, val|
                 case val
-                in Array if val.all? { primitive?(_1) }
+                in Array if val.all? { primitive?(_1) || Lithic::Internal::Type::FileInput === _1 }
                   val.each do |v|
                     write_multipart_chunk(y, boundary: boundary, key: key, val: v, closing: closing)
                   end
@@ -622,6 +636,7 @@ module Lithic
 
           fused_io = fused_enum(strio) { closing.each(&:call) }
           [boundary, fused_io]
+          # rubocop:enable Style/CaseEquality
         end
 
         # @api private

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

@@ -77,12 +77,20 @@ module Lithic
           #   @return [Time, nil]
           optional :timestamp, Time
 
-          # @!method initialize(decision: nil, event_token: nil, timestamp: nil)
+          # @!attribute transaction_token
+          #   The token of the transaction associated with the event
+          #
+          #   @return [String, nil]
+          optional :transaction_token, String, nil?: true
+
+          # @!method initialize(decision: nil, event_token: nil, timestamp: nil, transaction_token: nil)
           #   @param decision [Symbol, Lithic::Models::AuthRules::BacktestStats::Example::Decision] The decision made by the rule for this event.
           #
           #   @param event_token [String] The event token.
           #
           #   @param timestamp [Time] The timestamp of the event.
+          #
+          #   @param transaction_token [String, nil] The token of the transaction associated with the event
 
           # The decision made by the rule for this event.
           #

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

@@ -75,6 +75,12 @@ module Lithic
           #     trailing hour up and until the authorization.
           #   - `CARD_TRANSACTION_COUNT_24H`: The number of transactions on the card in the
           #     trailing 24 hours up and until the authorization.
+          #   - `CARD_DECLINE_COUNT_15M`: The number of declined transactions on the card in
+          #     the trailing 15 minutes before the authorization.
+          #   - `CARD_DECLINE_COUNT_1H`: The number of declined transactions on the card in
+          #     the trailing hour up and until the authorization.
+          #   - `CARD_DECLINE_COUNT_24H`: The number of declined transactions on the card in
+          #     the trailing 24 hours up and until the authorization.
           #   - `CARD_STATE`: The current state of the card associated with the transaction.
           #     Valid values are `CLOSED`, `OPEN`, `PAUSED`, `PENDING_ACTIVATION`,
           #     `PENDING_FULFILLMENT`.
@@ -168,6 +174,12 @@ module Lithic
           #   trailing hour up and until the authorization.
           # - `CARD_TRANSACTION_COUNT_24H`: The number of transactions on the card in the
           #   trailing 24 hours up and until the authorization.
+          # - `CARD_DECLINE_COUNT_15M`: The number of declined transactions on the card in
+          #   the trailing 15 minutes before the authorization.
+          # - `CARD_DECLINE_COUNT_1H`: The number of declined transactions on the card in
+          #   the trailing hour up and until the authorization.
+          # - `CARD_DECLINE_COUNT_24H`: The number of declined transactions on the card in
+          #   the trailing 24 hours up and until the authorization.
           # - `CARD_STATE`: The current state of the card associated with the transaction.
           #   Valid values are `CLOSED`, `OPEN`, `PAUSED`, `PENDING_ACTIVATION`,
           #   `PENDING_FULFILLMENT`.
@@ -212,6 +224,9 @@ module Lithic
             CARD_TRANSACTION_COUNT_15_M = :CARD_TRANSACTION_COUNT_15M
             CARD_TRANSACTION_COUNT_1_H = :CARD_TRANSACTION_COUNT_1H
             CARD_TRANSACTION_COUNT_24_H = :CARD_TRANSACTION_COUNT_24H
+            CARD_DECLINE_COUNT_15_M = :CARD_DECLINE_COUNT_15M
+            CARD_DECLINE_COUNT_1_H = :CARD_DECLINE_COUNT_1H
+            CARD_DECLINE_COUNT_24_H = :CARD_DECLINE_COUNT_24H
             CARD_STATE = :CARD_STATE
             PIN_ENTERED = :PIN_ENTERED
             PIN_STATUS = :PIN_STATUS

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

@@ -6,110 +6,77 @@ module Lithic
       class ReportStats < Lithic::Internal::Type::BaseModel
         # @!attribute action_counts
         #   A mapping of action types to the number of times that action was returned by
-        #   this rule during the relevant period. Actions are the possible outcomes of a
+        #   this version during the relevant period. Actions are the possible outcomes of a
         #   rule evaluation, such as DECLINE, CHALLENGE, REQUIRE_TFA, etc. In case rule
         #   didn't trigger any action, it's counted under NO_ACTION key.
         #
-        #   @return [Hash{Symbol=>Integer}, nil]
-        optional :action_counts, Lithic::Internal::Type::HashOf[Integer]
+        #   @return [Hash{Symbol=>Integer}]
+        required :action_counts, Lithic::Internal::Type::HashOf[Integer]
 
-        # @!attribute approved
-        #   @deprecated
-        #
-        #   The total number of historical transactions approved by this rule during the
-        #   relevant period, or the number of transactions that would have been approved if
-        #   the rule was evaluated in shadow mode.
-        #
-        #   @return [Integer, nil]
-        optional :approved, Integer
-
-        # @!attribute challenged
-        #   @deprecated
-        #
-        #   The total number of historical transactions challenged by this rule during the
-        #   relevant period, or the number of transactions that would have been challenged
-        #   if the rule was evaluated in shadow mode. Currently applicable only for 3DS Auth
-        #   Rules.
+        # @!attribute examples
+        #   Example events and their outcomes for this version.
         #
-        #   @return [Integer, nil]
-        optional :challenged, Integer
+        #   @return [Array<Lithic::Models::AuthRules::ReportStats::Example>]
+        required :examples, -> { Lithic::Internal::Type::ArrayOf[Lithic::AuthRules::ReportStats::Example] }
 
-        # @!attribute declined
-        #   @deprecated
-        #
-        #   The total number of historical transactions declined by this rule during the
-        #   relevant period, or the number of transactions that would have been declined if
-        #   the rule was evaluated in shadow mode.
+        # @!attribute state
+        #   The evaluation mode of this version during the reported period.
         #
-        #   @return [Integer, nil]
-        optional :declined, Integer
+        #   @return [Symbol, Lithic::Models::AuthRules::ReportStats::State]
+        required :state, enum: -> { Lithic::AuthRules::ReportStats::State }
 
-        # @!attribute examples
-        #   Example events and their outcomes.
+        # @!attribute version
+        #   The rule version number.
         #
-        #   @return [Array<Lithic::Models::AuthRules::ReportStats::Example>, nil]
-        optional :examples, -> { Lithic::Internal::Type::ArrayOf[Lithic::AuthRules::ReportStats::Example] }
+        #   @return [Integer]
+        required :version, Integer
 
-        # @!method initialize(action_counts: nil, approved: nil, challenged: nil, declined: nil, examples: nil)
+        # @!method initialize(action_counts:, examples:, state:, version:)
         #   Some parameter documentations has been truncated, see
         #   {Lithic::Models::AuthRules::ReportStats} for more details.
         #
         #   @param action_counts [Hash{Symbol=>Integer}] A mapping of action types to the number of times that action was returned by thi
         #
-        #   @param approved [Integer] The total number of historical transactions approved by this rule during the rel
-        #
-        #   @param challenged [Integer] The total number of historical transactions challenged by this rule during the r
+        #   @param examples [Array<Lithic::Models::AuthRules::ReportStats::Example>] Example events and their outcomes for this version.
         #
-        #   @param declined [Integer] The total number of historical transactions declined by this rule during the rel
+        #   @param state [Symbol, Lithic::Models::AuthRules::ReportStats::State] The evaluation mode of this version during the reported period.
         #
-        #   @param examples [Array<Lithic::Models::AuthRules::ReportStats::Example>] Example events and their outcomes.
+        #   @param version [Integer] The rule version number.
 
         class Example < Lithic::Internal::Type::BaseModel
           # @!attribute actions
-          #   The actions taken by the rule for this event.
+          #   The actions taken by this version for this event.
           #
-          #   @return [Array<Lithic::Models::AuthRules::ReportStats::Example::Action::DeclineActionAuthorization, Lithic::Models::AuthRules::ReportStats::Example::Action::ChallengeActionAuthorization, Lithic::Models::AuthRules::ReportStats::Example::Action::ResultAuthentication3DSAction, Lithic::Models::AuthRules::ReportStats::Example::Action::DeclineActionTokenization, Lithic::Models::AuthRules::ReportStats::Example::Action::RequireTfaAction, Lithic::Models::AuthRules::ReportStats::Example::Action::ApproveActionACH, Lithic::Models::AuthRules::ReportStats::Example::Action::ReturnAction>, nil]
-          optional :actions,
+          #   @return [Array<Lithic::Models::AuthRules::ReportStats::Example::Action::DeclineActionAuthorization, Lithic::Models::AuthRules::ReportStats::Example::Action::ChallengeActionAuthorization, Lithic::Models::AuthRules::ReportStats::Example::Action::ResultAuthentication3DSAction, Lithic::Models::AuthRules::ReportStats::Example::Action::DeclineActionTokenization, Lithic::Models::AuthRules::ReportStats::Example::Action::RequireTfaAction, Lithic::Models::AuthRules::ReportStats::Example::Action::ApproveActionACH, Lithic::Models::AuthRules::ReportStats::Example::Action::ReturnAction>]
+          required :actions,
                    -> { Lithic::Internal::Type::ArrayOf[union: Lithic::AuthRules::ReportStats::Example::Action] }
 
-          # @!attribute approved
-          #   @deprecated
-          #
-          #   Whether the rule would have approved the request.
-          #
-          #   @return [Boolean, nil]
-          optional :approved, Lithic::Internal::Type::Boolean
-
-          # @!attribute decision
-          #   @deprecated
-          #
-          #   The decision made by the rule for this event.
-          #
-          #   @return [Symbol, Lithic::Models::AuthRules::ReportStats::Example::Decision, nil]
-          optional :decision, enum: -> { Lithic::AuthRules::ReportStats::Example::Decision }
-
           # @!attribute event_token
           #   The event token.
           #
-          #   @return [String, nil]
-          optional :event_token, String
+          #   @return [String]
+          required :event_token, String
 
           # @!attribute timestamp
           #   The timestamp of the event.
           #
-          #   @return [Time, nil]
-          optional :timestamp, Time
+          #   @return [Time]
+          required :timestamp, Time
 
-          # @!method initialize(actions: nil, approved: nil, decision: nil, event_token: nil, timestamp: nil)
-          #   @param actions [Array<Lithic::Models::AuthRules::ReportStats::Example::Action::DeclineActionAuthorization, Lithic::Models::AuthRules::ReportStats::Example::Action::ChallengeActionAuthorization, Lithic::Models::AuthRules::ReportStats::Example::Action::ResultAuthentication3DSAction, Lithic::Models::AuthRules::ReportStats::Example::Action::DeclineActionTokenization, Lithic::Models::AuthRules::ReportStats::Example::Action::RequireTfaAction, Lithic::Models::AuthRules::ReportStats::Example::Action::ApproveActionACH, Lithic::Models::AuthRules::ReportStats::Example::Action::ReturnAction>] The actions taken by the rule for this event.
+          # @!attribute transaction_token
+          #   The token of the transaction associated with the event
           #
-          #   @param approved [Boolean] Whether the rule would have approved the request.
-          #
-          #   @param decision [Symbol, Lithic::Models::AuthRules::ReportStats::Example::Decision] The decision made by the rule for this event.
+          #   @return [String, nil]
+          optional :transaction_token, String, nil?: true
+
+          # @!method initialize(actions:, event_token:, timestamp:, transaction_token: nil)
+          #   @param actions [Array<Lithic::Models::AuthRules::ReportStats::Example::Action::DeclineActionAuthorization, Lithic::Models::AuthRules::ReportStats::Example::Action::ChallengeActionAuthorization, Lithic::Models::AuthRules::ReportStats::Example::Action::ResultAuthentication3DSAction, Lithic::Models::AuthRules::ReportStats::Example::Action::DeclineActionTokenization, Lithic::Models::AuthRules::ReportStats::Example::Action::RequireTfaAction, Lithic::Models::AuthRules::ReportStats::Example::Action::ApproveActionACH, Lithic::Models::AuthRules::ReportStats::Example::Action::ReturnAction>] The actions taken by this version for this event.
           #
           #   @param event_token [String] The event token.
           #
           #   @param timestamp [Time] The timestamp of the event.
+          #
+          #   @param transaction_token [String, nil] The token of the transaction associated with the event
 
           module Action
             extend Lithic::Internal::Type::Union
@@ -529,22 +496,20 @@ module Lithic
             # @!method self.variants
             #   @return [Array(Lithic::Models::AuthRules::ReportStats::Example::Action::DeclineActionAuthorization, Lithic::Models::AuthRules::ReportStats::Example::Action::ChallengeActionAuthorization, Lithic::Models::AuthRules::ReportStats::Example::Action::ResultAuthentication3DSAction, Lithic::Models::AuthRules::ReportStats::Example::Action::DeclineActionTokenization, Lithic::Models::AuthRules::ReportStats::Example::Action::RequireTfaAction, Lithic::Models::AuthRules::ReportStats::Example::Action::ApproveActionACH, Lithic::Models::AuthRules::ReportStats::Example::Action::ReturnAction)]
           end
+        end
 
-          # @deprecated
-          #
-          # The decision made by the rule for this event.
-          #
-          # @see Lithic::Models::AuthRules::ReportStats::Example#decision
-          module Decision
-            extend Lithic::Internal::Type::Enum
+        # The evaluation mode of this version during the reported period.
+        #
+        # @see Lithic::Models::AuthRules::ReportStats#state
+        module State
+          extend Lithic::Internal::Type::Enum
 
-            APPROVED = :APPROVED
-            DECLINED = :DECLINED
-            CHALLENGED = :CHALLENGED
+          ACTIVE = :ACTIVE
+          SHADOW = :SHADOW
+          INACTIVE = :INACTIVE
 
-            # @!method self.values
-            #   @return [Array<Symbol>]
-          end
+          # @!method self.values
+          #   @return [Array<Symbol>]
         end
       end
     end

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

@@ -67,7 +67,13 @@ module Lithic
           #   @return [Integer]
           required :rule_version, Integer
 
-          # @!method initialize(token:, actions:, auth_rule_token:, evaluation_time:, event_token:, mode:, rule_version:, event_stream: :AUTHORIZATION)
+          # @!attribute transaction_token
+          #   The token of the transaction that triggered the rule evaluation
+          #
+          #   @return [String, nil]
+          required :transaction_token, String, nil?: true
+
+          # @!method initialize(token:, actions:, auth_rule_token:, evaluation_time:, event_token:, mode:, rule_version:, transaction_token:, event_stream: :AUTHORIZATION)
           #   @param token [String] Globally unique identifier for the evaluation
           #
           #   @param actions [Array<Lithic::Models::AuthRules::V2ListResultsResponse::AuthorizationResult::Action::DeclineActionAuthorization, Lithic::Models::AuthRules::V2ListResultsResponse::AuthorizationResult::Action::ChallengeActionAuthorization>] Actions returned by the rule evaluation
@@ -82,6 +88,8 @@ module Lithic
           #
           #   @param rule_version [Integer] Version of the rule that was evaluated
           #
+          #   @param transaction_token [String, nil] The token of the transaction that triggered the rule evaluation
+          #
           #   @param event_stream [Symbol, :AUTHORIZATION] The event stream during which the rule was evaluated
 
           module Action
@@ -295,7 +303,13 @@ module Lithic
           #   @return [Integer]
           required :rule_version, Integer
 
-          # @!method initialize(token:, actions:, auth_rule_token:, evaluation_time:, event_token:, mode:, rule_version:, event_stream: :THREE_DS_AUTHENTICATION)
+          # @!attribute transaction_token
+          #   The token of the transaction that triggered the rule evaluation
+          #
+          #   @return [String, nil]
+          required :transaction_token, String, nil?: true
+
+          # @!method initialize(token:, actions:, auth_rule_token:, evaluation_time:, event_token:, mode:, rule_version:, transaction_token:, event_stream: :THREE_DS_AUTHENTICATION)
           #   @param token [String] Globally unique identifier for the evaluation
           #
           #   @param actions [Array<Lithic::Models::AuthRules::V2ListResultsResponse::Authentication3DSResult::Action>] Actions returned by the rule evaluation
@@ -310,6 +324,8 @@ module Lithic
           #
           #   @param rule_version [Integer] Version of the rule that was evaluated
           #
+          #   @param transaction_token [String, nil] The token of the transaction that triggered the rule evaluation
+          #
           #   @param event_stream [Symbol, :THREE_DS_AUTHENTICATION] The event stream during which the rule was evaluated
 
           class Action < Lithic::Internal::Type::BaseModel
@@ -406,7 +422,13 @@ module Lithic
           #   @return [Integer]
           required :rule_version, Integer
 
-          # @!method initialize(token:, actions:, auth_rule_token:, evaluation_time:, event_token:, mode:, rule_version:, event_stream: :TOKENIZATION)
+          # @!attribute transaction_token
+          #   The token of the transaction that triggered the rule evaluation
+          #
+          #   @return [String, nil]
+          required :transaction_token, String, nil?: true
+
+          # @!method initialize(token:, actions:, auth_rule_token:, evaluation_time:, event_token:, mode:, rule_version:, transaction_token:, event_stream: :TOKENIZATION)
           #   @param token [String] Globally unique identifier for the evaluation
           #
           #   @param actions [Array<Lithic::Models::AuthRules::V2ListResultsResponse::TokenizationResult::Action::DeclineActionTokenization, Lithic::Models::AuthRules::V2ListResultsResponse::TokenizationResult::Action::RequireTfaAction>] Actions returned by the rule evaluation
@@ -421,6 +443,8 @@ module Lithic
           #
           #   @param rule_version [Integer] Version of the rule that was evaluated
           #
+          #   @param transaction_token [String, nil] The token of the transaction that triggered the rule evaluation
+          #
           #   @param event_stream [Symbol, :TOKENIZATION] The event stream during which the rule was evaluated
 
           module Action
@@ -631,7 +655,13 @@ module Lithic
           #   @return [Integer]
           required :rule_version, Integer
 
-          # @!method initialize(token:, actions:, auth_rule_token:, evaluation_time:, event_stream:, event_token:, mode:, rule_version:)
+          # @!attribute transaction_token
+          #   The token of the transaction that triggered the rule evaluation
+          #
+          #   @return [String, nil]
+          required :transaction_token, String, nil?: true
+
+          # @!method initialize(token:, actions:, auth_rule_token:, evaluation_time:, event_stream:, event_token:, mode:, rule_version:, transaction_token:)
           #   @param token [String] Globally unique identifier for the evaluation
           #
           #   @param actions [Array<Lithic::Models::AuthRules::V2ListResultsResponse::ACHResult::Action::ApproveActionACH, Lithic::Models::AuthRules::V2ListResultsResponse::ACHResult::Action::ReturnAction>] Actions returned by the rule evaluation
@@ -647,6 +677,8 @@ module Lithic
           #   @param mode [Symbol, Lithic::Models::AuthRules::V2ListResultsResponse::ACHResult::Mode] The state of the Auth Rule
           #
           #   @param rule_version [Integer] Version of the rule that was evaluated
+          #
+          #   @param transaction_token [String, nil] The token of the transaction that triggered the rule evaluation
 
           module Action
             extend Lithic::Internal::Type::Union