lithic 0.11.0 → 0.12.0

data/lib/lithic/resources/external_bank_accounts.rb

@@ -176,6 +176,37 @@ module Lithic
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Lithic::Models::ExternalBankAccountSetVerificationMethodParams} for more
+      # details.
+      #
+      # Update the verification method for an external bank account. Verification method
+      # can only be updated if the `verification_state` is `PENDING`.
+      #
+      # @overload set_verification_method(external_bank_account_token, verification_method:, financial_account_token: nil, request_options: {})
+      #
+      # @param external_bank_account_token [String]
+      #
+      # @param verification_method [Symbol, Lithic::Models::ExternalBankAccountSetVerificationMethodParams::VerificationMethod] The verification method to set for the external bank account
+      #
+      # @param financial_account_token [String] The financial account token of the operating account to fund the micro deposits.
+      #
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Lithic::Models::ExternalBankAccount]
+      #
+      # @see Lithic::Models::ExternalBankAccountSetVerificationMethodParams
+      def set_verification_method(external_bank_account_token, params)
+        parsed, options = Lithic::ExternalBankAccountSetVerificationMethodParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: ["v1/external_bank_accounts/%1$s/set_verification_method", external_bank_account_token],
+          body: parsed,
+          model: Lithic::ExternalBankAccount,
+          options: options
+        )
+      end
+
       # Unpause an external bank account
       #
       # @overload unpause(external_bank_account_token, request_options: {})

data/lib/lithic/resources/webhooks.rb

@@ -9,7 +9,7 @@ module Lithic
       # @param headers [Hash{String => String}] The webhook request headers
       # @param secret [String, nil] The webhook secret. If not provided, reads from LITHIC_WEBHOOK_SECRET environment variable.
       #
-      # @return [Lithic::Models::AccountHolderCreatedWebhookEvent, Lithic::Models::ParsedWebhookEvent::KYBPayload, Lithic::Models::ParsedWebhookEvent::KYCPayload, Lithic::Models::ParsedWebhookEvent::LegacyPayload, Lithic::Models::AccountHolderVerificationWebhookEvent, Lithic::Models::AccountHolderDocumentUpdatedWebhookEvent, Lithic::Models::CardAuthorizationApprovalRequestWebhookEvent, Lithic::Models::AuthRulesBacktestReportCreatedWebhookEvent, Lithic::Models::BalanceUpdatedWebhookEvent, Lithic::Models::BookTransferTransactionCreatedWebhookEvent, Lithic::Models::BookTransferTransactionUpdatedWebhookEvent, Lithic::Models::CardCreatedWebhookEvent, Lithic::Models::CardConvertedWebhookEvent, Lithic::Models::CardRenewedWebhookEvent, Lithic::Models::CardReissuedWebhookEvent, Lithic::Models::CardShippedWebhookEvent, Lithic::Models::CardUpdatedWebhookEvent, Lithic::Models::CardTransactionUpdatedWebhookEvent, Lithic::Models::CardTransactionEnhancedDataCreatedWebhookEvent, Lithic::Models::CardTransactionEnhancedDataUpdatedWebhookEvent, Lithic::Models::DigitalWalletTokenizationApprovalRequestWebhookEvent, Lithic::Models::DigitalWalletTokenizationResultWebhookEvent, Lithic::Models::DigitalWalletTokenizationTwoFactorAuthenticationCodeWebhookEvent, Lithic::Models::DigitalWalletTokenizationTwoFactorAuthenticationCodeSentWebhookEvent, Lithic::Models::DigitalWalletTokenizationUpdatedWebhookEvent, Lithic::Models::DisputeUpdatedWebhookEvent, Lithic::Models::DisputeEvidenceUploadFailedWebhookEvent, Lithic::Models::ExternalBankAccountCreatedWebhookEvent, Lithic::Models::ExternalBankAccountUpdatedWebhookEvent, Lithic::Models::ExternalPaymentCreatedWebhookEvent, Lithic::Models::ExternalPaymentUpdatedWebhookEvent, Lithic::Models::FinancialAccountCreatedWebhookEvent, Lithic::Models::FinancialAccountUpdatedWebhookEvent, Lithic::Models::FundingEventCreatedWebhookEvent, Lithic::Models::LoanTapeCreatedWebhookEvent, Lithic::Models::LoanTapeUpdatedWebhookEvent, Lithic::Models::ManagementOperationCreatedWebhookEvent, Lithic::Models::ManagementOperationUpdatedWebhookEvent, Lithic::Models::InternalTransactionCreatedWebhookEvent, Lithic::Models::InternalTransactionUpdatedWebhookEvent, Lithic::Models::NetworkTotalCreatedWebhookEvent, Lithic::Models::NetworkTotalUpdatedWebhookEvent, Lithic::Models::PaymentTransactionCreatedWebhookEvent, Lithic::Models::PaymentTransactionUpdatedWebhookEvent, Lithic::Models::SettlementReportUpdatedWebhookEvent, Lithic::Models::StatementsCreatedWebhookEvent, Lithic::Models::ThreeDSAuthenticationCreatedWebhookEvent, Lithic::Models::ThreeDSAuthenticationUpdatedWebhookEvent, Lithic::Models::ThreeDSAuthenticationChallengeWebhookEvent, Lithic::Models::TokenizationApprovalRequestWebhookEvent, Lithic::Models::TokenizationResultWebhookEvent, Lithic::Models::TokenizationTwoFactorAuthenticationCodeWebhookEvent, Lithic::Models::TokenizationTwoFactorAuthenticationCodeSentWebhookEvent, Lithic::Models::TokenizationUpdatedWebhookEvent, Lithic::Models::ThreeDSAuthenticationApprovalRequestWebhookEvent, Lithic::Models::DisputeTransactionCreatedWebhookEvent, Lithic::Models::DisputeTransactionUpdatedWebhookEvent]      #
+      # @return [Lithic::Models::AccountHolderCreatedWebhookEvent, Lithic::Models::ParsedWebhookEvent::KYBPayload, Lithic::Models::ParsedWebhookEvent::KYCPayload, Lithic::Models::ParsedWebhookEvent::LegacyPayload, Lithic::Models::AccountHolderVerificationWebhookEvent, Lithic::Models::AccountHolderDocumentUpdatedWebhookEvent, Lithic::Models::CardAuthorizationApprovalRequestWebhookEvent, Lithic::Models::CardAuthorizationChallengeResponseWebhookEvent, Lithic::Models::AuthRulesBacktestReportCreatedWebhookEvent, Lithic::Models::BalanceUpdatedWebhookEvent, Lithic::Models::BookTransferTransactionCreatedWebhookEvent, Lithic::Models::BookTransferTransactionUpdatedWebhookEvent, Lithic::Models::CardCreatedWebhookEvent, Lithic::Models::CardConvertedWebhookEvent, Lithic::Models::CardRenewedWebhookEvent, Lithic::Models::CardReissuedWebhookEvent, Lithic::Models::CardShippedWebhookEvent, Lithic::Models::CardUpdatedWebhookEvent, Lithic::Models::CardTransactionUpdatedWebhookEvent, Lithic::Models::CardTransactionEnhancedDataCreatedWebhookEvent, Lithic::Models::CardTransactionEnhancedDataUpdatedWebhookEvent, Lithic::Models::DigitalWalletTokenizationApprovalRequestWebhookEvent, Lithic::Models::DigitalWalletTokenizationResultWebhookEvent, Lithic::Models::DigitalWalletTokenizationTwoFactorAuthenticationCodeWebhookEvent, Lithic::Models::DigitalWalletTokenizationTwoFactorAuthenticationCodeSentWebhookEvent, Lithic::Models::DigitalWalletTokenizationUpdatedWebhookEvent, Lithic::Models::DisputeUpdatedWebhookEvent, Lithic::Models::DisputeEvidenceUploadFailedWebhookEvent, Lithic::Models::ExternalBankAccountCreatedWebhookEvent, Lithic::Models::ExternalBankAccountUpdatedWebhookEvent, Lithic::Models::ExternalPaymentCreatedWebhookEvent, Lithic::Models::ExternalPaymentUpdatedWebhookEvent, Lithic::Models::FinancialAccountCreatedWebhookEvent, Lithic::Models::FinancialAccountUpdatedWebhookEvent, Lithic::Models::FundingEventCreatedWebhookEvent, Lithic::Models::LoanTapeCreatedWebhookEvent, Lithic::Models::LoanTapeUpdatedWebhookEvent, Lithic::Models::ManagementOperationCreatedWebhookEvent, Lithic::Models::ManagementOperationUpdatedWebhookEvent, Lithic::Models::InternalTransactionCreatedWebhookEvent, Lithic::Models::InternalTransactionUpdatedWebhookEvent, Lithic::Models::NetworkTotalCreatedWebhookEvent, Lithic::Models::NetworkTotalUpdatedWebhookEvent, Lithic::Models::PaymentTransactionCreatedWebhookEvent, Lithic::Models::PaymentTransactionUpdatedWebhookEvent, Lithic::Models::SettlementReportUpdatedWebhookEvent, Lithic::Models::StatementsCreatedWebhookEvent, Lithic::Models::ThreeDSAuthenticationCreatedWebhookEvent, Lithic::Models::ThreeDSAuthenticationUpdatedWebhookEvent, Lithic::Models::ThreeDSAuthenticationChallengeWebhookEvent, Lithic::Models::TokenizationApprovalRequestWebhookEvent, Lithic::Models::TokenizationResultWebhookEvent, Lithic::Models::TokenizationTwoFactorAuthenticationCodeWebhookEvent, Lithic::Models::TokenizationTwoFactorAuthenticationCodeSentWebhookEvent, Lithic::Models::TokenizationUpdatedWebhookEvent, Lithic::Models::ThreeDSAuthenticationApprovalRequestWebhookEvent, Lithic::Models::DisputeTransactionCreatedWebhookEvent, Lithic::Models::DisputeTransactionUpdatedWebhookEvent]      #
       # @raise [ArgumentError] if secret is not provided and LITHIC_WEBHOOK_SECRET env var is not set
       # @raise [Lithic::Errors::MissingDependencyError] if the standardwebhooks gem is not installed
       # @raise [StandardWebhooks::WebhookVerificationError] if the signature is invalid

data/lib/lithic/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Lithic
-  VERSION = "0.11.0"
+  VERSION = "0.12.0"
 end

data/lib/lithic.rb

@@ -168,6 +168,7 @@ require_relative "lithic/models/book_transfer_transaction_created_webhook_event"
 require_relative "lithic/models/book_transfer_transaction_updated_webhook_event"
 require_relative "lithic/models/card"
 require_relative "lithic/models/card_authorization_approval_request_webhook_event"
+require_relative "lithic/models/card_authorization_challenge_response_webhook_event"
 require_relative "lithic/models/card_bulk_order"
 require_relative "lithic/models/card_bulk_order_create_params"
 require_relative "lithic/models/card_bulk_order_list_params"
@@ -270,6 +271,7 @@ require_relative "lithic/models/external_bank_account_retry_micro_deposits_respo
 require_relative "lithic/models/external_bank_account_retry_prenote_params"
 require_relative "lithic/models/external_bank_accounts/micro_deposit_create_params"
 require_relative "lithic/models/external_bank_accounts/micro_deposit_create_response"
+require_relative "lithic/models/external_bank_account_set_verification_method_params"
 require_relative "lithic/models/external_bank_account_unpause_params"
 require_relative "lithic/models/external_bank_account_updated_webhook_event"
 require_relative "lithic/models/external_bank_account_update_params"

data/rbi/lithic/models/auth_rules/conditional_authorization_action_parameters.rbi

@@ -176,6 +176,33 @@ module Lithic
           # - `CARD_AGE`: The age of the card in seconds at the time of the authorization.
           # - `ACCOUNT_AGE`: The age of the account holder's account in seconds at the time
           #   of the authorization.
+          # - `AMOUNT_Z_SCORE`: The z-score of the transaction amount relative to the
+          #   entity's transaction history. Null if fewer than 30 approved transactions in
+          #   the specified window. Requires `parameters.scope` and `parameters.interval`.
+          # - `AVG_TRANSACTION_AMOUNT`: The average approved transaction amount for the
+          #   entity over the specified window, in cents. Requires `parameters.scope` and
+          #   `parameters.interval`.
+          # - `STDEV_TRANSACTION_AMOUNT`: The standard deviation of approved transaction
+          #   amounts for the entity over the specified window, in cents. Null if fewer than
+          #   30 approved transactions in the specified window. Requires `parameters.scope`
+          #   and `parameters.interval`.
+          # - `IS_NEW_COUNTRY`: Whether the transaction's merchant country has not been seen
+          #   in the entity's transaction history. Valid values are `TRUE`, `FALSE`.
+          #   Requires `parameters.scope`.
+          # - `IS_NEW_MCC`: Whether the transaction's MCC has not been seen in the entity's
+          #   transaction history. Valid values are `TRUE`, `FALSE`. Requires
+          #   `parameters.scope`.
+          # - `IS_FIRST_TRANSACTION`: Whether this is the first transaction for the entity.
+          #   Valid values are `TRUE`, `FALSE`. Requires `parameters.scope`.
+          # - `CONSECUTIVE_DECLINES`: The number of consecutive declined transactions for
+          #   the entity over the last 30 days (rolling). Requires `parameters.scope`. Not
+          #   supported for `BUSINESS_ACCOUNT` scope.
+          # - `TIME_SINCE_LAST_TRANSACTION`: The number of days since the last approved
+          #   transaction for the entity. Requires `parameters.scope`.
+          # - `DISTINCT_COUNTRY_COUNT`: The number of distinct merchant countries seen in
+          #   the entity's transaction history. Requires `parameters.scope`.
+          # - `THREE_DS_SUCCESS_RATE`: The 3DS authentication success rate for the card, as
+          #   a percentage from 0.0 to 100.0. Card-scoped only; no `parameters` required.
           sig do
             returns(
               Lithic::AuthRules::ConditionalAuthorizationActionParameters::Condition::Attribute::OrSymbol
@@ -191,12 +218,36 @@ module Lithic
           sig { returns(Lithic::AuthRules::ConditionalValue::Variants) }
           attr_accessor :value
 
+          # Additional parameters required for transaction history signal attributes.
+          # Required when `attribute` is one of `AMOUNT_Z_SCORE`, `AVG_TRANSACTION_AMOUNT`,
+          # `STDEV_TRANSACTION_AMOUNT`, `IS_NEW_COUNTRY`, `IS_NEW_MCC`,
+          # `IS_FIRST_TRANSACTION`, `CONSECUTIVE_DECLINES`, `TIME_SINCE_LAST_TRANSACTION`,
+          # or `DISTINCT_COUNTRY_COUNT`. Not used for other attributes.
+          sig do
+            returns(
+              T.nilable(
+                Lithic::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters
+              )
+            )
+          end
+          attr_reader :parameters
+
+          sig do
+            params(
+              parameters:
+                Lithic::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::OrHash
+            ).void
+          end
+          attr_writer :parameters
+
           sig do
             params(
               attribute:
                 Lithic::AuthRules::ConditionalAuthorizationActionParameters::Condition::Attribute::OrSymbol,
               operation: Lithic::AuthRules::ConditionalOperation::OrSymbol,
-              value: Lithic::AuthRules::ConditionalValue::Variants
+              value: Lithic::AuthRules::ConditionalValue::Variants,
+              parameters:
+                Lithic::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::OrHash
             ).returns(T.attached_class)
           end
           def self.new(
@@ -271,11 +322,44 @@ module Lithic
             # - `CARD_AGE`: The age of the card in seconds at the time of the authorization.
             # - `ACCOUNT_AGE`: The age of the account holder's account in seconds at the time
             #   of the authorization.
+            # - `AMOUNT_Z_SCORE`: The z-score of the transaction amount relative to the
+            #   entity's transaction history. Null if fewer than 30 approved transactions in
+            #   the specified window. Requires `parameters.scope` and `parameters.interval`.
+            # - `AVG_TRANSACTION_AMOUNT`: The average approved transaction amount for the
+            #   entity over the specified window, in cents. Requires `parameters.scope` and
+            #   `parameters.interval`.
+            # - `STDEV_TRANSACTION_AMOUNT`: The standard deviation of approved transaction
+            #   amounts for the entity over the specified window, in cents. Null if fewer than
+            #   30 approved transactions in the specified window. Requires `parameters.scope`
+            #   and `parameters.interval`.
+            # - `IS_NEW_COUNTRY`: Whether the transaction's merchant country has not been seen
+            #   in the entity's transaction history. Valid values are `TRUE`, `FALSE`.
+            #   Requires `parameters.scope`.
+            # - `IS_NEW_MCC`: Whether the transaction's MCC has not been seen in the entity's
+            #   transaction history. Valid values are `TRUE`, `FALSE`. Requires
+            #   `parameters.scope`.
+            # - `IS_FIRST_TRANSACTION`: Whether this is the first transaction for the entity.
+            #   Valid values are `TRUE`, `FALSE`. Requires `parameters.scope`.
+            # - `CONSECUTIVE_DECLINES`: The number of consecutive declined transactions for
+            #   the entity over the last 30 days (rolling). Requires `parameters.scope`. Not
+            #   supported for `BUSINESS_ACCOUNT` scope.
+            # - `TIME_SINCE_LAST_TRANSACTION`: The number of days since the last approved
+            #   transaction for the entity. Requires `parameters.scope`.
+            # - `DISTINCT_COUNTRY_COUNT`: The number of distinct merchant countries seen in
+            #   the entity's transaction history. Requires `parameters.scope`.
+            # - `THREE_DS_SUCCESS_RATE`: The 3DS authentication success rate for the card, as
+            #   a percentage from 0.0 to 100.0. Card-scoped only; no `parameters` required.
             attribute:,
             # The operation to apply to the attribute
             operation:,
             # A regex string, to be used with `MATCHES` or `DOES_NOT_MATCH`
-            value:
+            value:,
+            # Additional parameters required for transaction history signal attributes.
+            # Required when `attribute` is one of `AMOUNT_Z_SCORE`, `AVG_TRANSACTION_AMOUNT`,
+            # `STDEV_TRANSACTION_AMOUNT`, `IS_NEW_COUNTRY`, `IS_NEW_MCC`,
+            # `IS_FIRST_TRANSACTION`, `CONSECUTIVE_DECLINES`, `TIME_SINCE_LAST_TRANSACTION`,
+            # or `DISTINCT_COUNTRY_COUNT`. Not used for other attributes.
+            parameters: nil
           )
           end
 
@@ -285,7 +369,9 @@ module Lithic
                 attribute:
                   Lithic::AuthRules::ConditionalAuthorizationActionParameters::Condition::Attribute::OrSymbol,
                 operation: Lithic::AuthRules::ConditionalOperation::OrSymbol,
-                value: Lithic::AuthRules::ConditionalValue::Variants
+                value: Lithic::AuthRules::ConditionalValue::Variants,
+                parameters:
+                  Lithic::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters
               }
             )
           end
@@ -363,6 +449,33 @@ module Lithic
           # - `CARD_AGE`: The age of the card in seconds at the time of the authorization.
           # - `ACCOUNT_AGE`: The age of the account holder's account in seconds at the time
           #   of the authorization.
+          # - `AMOUNT_Z_SCORE`: The z-score of the transaction amount relative to the
+          #   entity's transaction history. Null if fewer than 30 approved transactions in
+          #   the specified window. Requires `parameters.scope` and `parameters.interval`.
+          # - `AVG_TRANSACTION_AMOUNT`: The average approved transaction amount for the
+          #   entity over the specified window, in cents. Requires `parameters.scope` and
+          #   `parameters.interval`.
+          # - `STDEV_TRANSACTION_AMOUNT`: The standard deviation of approved transaction
+          #   amounts for the entity over the specified window, in cents. Null if fewer than
+          #   30 approved transactions in the specified window. Requires `parameters.scope`
+          #   and `parameters.interval`.
+          # - `IS_NEW_COUNTRY`: Whether the transaction's merchant country has not been seen
+          #   in the entity's transaction history. Valid values are `TRUE`, `FALSE`.
+          #   Requires `parameters.scope`.
+          # - `IS_NEW_MCC`: Whether the transaction's MCC has not been seen in the entity's
+          #   transaction history. Valid values are `TRUE`, `FALSE`. Requires
+          #   `parameters.scope`.
+          # - `IS_FIRST_TRANSACTION`: Whether this is the first transaction for the entity.
+          #   Valid values are `TRUE`, `FALSE`. Requires `parameters.scope`.
+          # - `CONSECUTIVE_DECLINES`: The number of consecutive declined transactions for
+          #   the entity over the last 30 days (rolling). Requires `parameters.scope`. Not
+          #   supported for `BUSINESS_ACCOUNT` scope.
+          # - `TIME_SINCE_LAST_TRANSACTION`: The number of days since the last approved
+          #   transaction for the entity. Requires `parameters.scope`.
+          # - `DISTINCT_COUNTRY_COUNT`: The number of distinct merchant countries seen in
+          #   the entity's transaction history. Requires `parameters.scope`.
+          # - `THREE_DS_SUCCESS_RATE`: The 3DS authentication success rate for the card, as
+          #   a percentage from 0.0 to 100.0. Card-scoped only; no `parameters` required.
           module Attribute
             extend Lithic::Internal::Type::Enum
 
@@ -505,6 +618,56 @@ module Lithic
                 :ACCOUNT_AGE,
                 Lithic::AuthRules::ConditionalAuthorizationActionParameters::Condition::Attribute::TaggedSymbol
               )
+            AMOUNT_Z_SCORE =
+              T.let(
+                :AMOUNT_Z_SCORE,
+                Lithic::AuthRules::ConditionalAuthorizationActionParameters::Condition::Attribute::TaggedSymbol
+              )
+            AVG_TRANSACTION_AMOUNT =
+              T.let(
+                :AVG_TRANSACTION_AMOUNT,
+                Lithic::AuthRules::ConditionalAuthorizationActionParameters::Condition::Attribute::TaggedSymbol
+              )
+            STDEV_TRANSACTION_AMOUNT =
+              T.let(
+                :STDEV_TRANSACTION_AMOUNT,
+                Lithic::AuthRules::ConditionalAuthorizationActionParameters::Condition::Attribute::TaggedSymbol
+              )
+            IS_NEW_COUNTRY =
+              T.let(
+                :IS_NEW_COUNTRY,
+                Lithic::AuthRules::ConditionalAuthorizationActionParameters::Condition::Attribute::TaggedSymbol
+              )
+            IS_NEW_MCC =
+              T.let(
+                :IS_NEW_MCC,
+                Lithic::AuthRules::ConditionalAuthorizationActionParameters::Condition::Attribute::TaggedSymbol
+              )
+            IS_FIRST_TRANSACTION =
+              T.let(
+                :IS_FIRST_TRANSACTION,
+                Lithic::AuthRules::ConditionalAuthorizationActionParameters::Condition::Attribute::TaggedSymbol
+              )
+            CONSECUTIVE_DECLINES =
+              T.let(
+                :CONSECUTIVE_DECLINES,
+                Lithic::AuthRules::ConditionalAuthorizationActionParameters::Condition::Attribute::TaggedSymbol
+              )
+            TIME_SINCE_LAST_TRANSACTION =
+              T.let(
+                :TIME_SINCE_LAST_TRANSACTION,
+                Lithic::AuthRules::ConditionalAuthorizationActionParameters::Condition::Attribute::TaggedSymbol
+              )
+            DISTINCT_COUNTRY_COUNT =
+              T.let(
+                :DISTINCT_COUNTRY_COUNT,
+                Lithic::AuthRules::ConditionalAuthorizationActionParameters::Condition::Attribute::TaggedSymbol
+              )
+            THREE_DS_SUCCESS_RATE =
+              T.let(
+                :THREE_DS_SUCCESS_RATE,
+                Lithic::AuthRules::ConditionalAuthorizationActionParameters::Condition::Attribute::TaggedSymbol
+              )
 
             sig do
               override.returns(
@@ -516,6 +679,177 @@ module Lithic
             def self.values
             end
           end
+
+          class Parameters < Lithic::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  Lithic::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters,
+                  Lithic::Internal::AnyHash
+                )
+              end
+
+            # The time window for statistical attributes (`AMOUNT_Z_SCORE`,
+            # `AVG_TRANSACTION_AMOUNT`, `STDEV_TRANSACTION_AMOUNT`). Use `LIFETIME` for
+            # all-time history or a specific window (`7D`, `30D`, `90D`).
+            sig do
+              returns(
+                T.nilable(
+                  Lithic::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::Interval::OrSymbol
+                )
+              )
+            end
+            attr_reader :interval
+
+            sig do
+              params(
+                interval:
+                  Lithic::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::Interval::OrSymbol
+              ).void
+            end
+            attr_writer :interval
+
+            # The entity scope to evaluate the attribute against.
+            sig do
+              returns(
+                T.nilable(
+                  Lithic::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::Scope::OrSymbol
+                )
+              )
+            end
+            attr_reader :scope
+
+            sig do
+              params(
+                scope:
+                  Lithic::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::Scope::OrSymbol
+              ).void
+            end
+            attr_writer :scope
+
+            # Additional parameters required for transaction history signal attributes.
+            # Required when `attribute` is one of `AMOUNT_Z_SCORE`, `AVG_TRANSACTION_AMOUNT`,
+            # `STDEV_TRANSACTION_AMOUNT`, `IS_NEW_COUNTRY`, `IS_NEW_MCC`,
+            # `IS_FIRST_TRANSACTION`, `CONSECUTIVE_DECLINES`, `TIME_SINCE_LAST_TRANSACTION`,
+            # or `DISTINCT_COUNTRY_COUNT`. Not used for other attributes.
+            sig do
+              params(
+                interval:
+                  Lithic::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::Interval::OrSymbol,
+                scope:
+                  Lithic::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::Scope::OrSymbol
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              # The time window for statistical attributes (`AMOUNT_Z_SCORE`,
+              # `AVG_TRANSACTION_AMOUNT`, `STDEV_TRANSACTION_AMOUNT`). Use `LIFETIME` for
+              # all-time history or a specific window (`7D`, `30D`, `90D`).
+              interval: nil,
+              # The entity scope to evaluate the attribute against.
+              scope: nil
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  interval:
+                    Lithic::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::Interval::OrSymbol,
+                  scope:
+                    Lithic::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::Scope::OrSymbol
+                }
+              )
+            end
+            def to_hash
+            end
+
+            # The time window for statistical attributes (`AMOUNT_Z_SCORE`,
+            # `AVG_TRANSACTION_AMOUNT`, `STDEV_TRANSACTION_AMOUNT`). Use `LIFETIME` for
+            # all-time history or a specific window (`7D`, `30D`, `90D`).
+            module Interval
+              extend Lithic::Internal::Type::Enum
+
+              TaggedSymbol =
+                T.type_alias do
+                  T.all(
+                    Symbol,
+                    Lithic::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::Interval
+                  )
+                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              LIFETIME =
+                T.let(
+                  :LIFETIME,
+                  Lithic::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::Interval::TaggedSymbol
+                )
+              INTERVAL_7_D =
+                T.let(
+                  :"7D",
+                  Lithic::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::Interval::TaggedSymbol
+                )
+              INTERVAL_30_D =
+                T.let(
+                  :"30D",
+                  Lithic::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::Interval::TaggedSymbol
+                )
+              INTERVAL_90_D =
+                T.let(
+                  :"90D",
+                  Lithic::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::Interval::TaggedSymbol
+                )
+
+              sig do
+                override.returns(
+                  T::Array[
+                    Lithic::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::Interval::TaggedSymbol
+                  ]
+                )
+              end
+              def self.values
+              end
+            end
+
+            # The entity scope to evaluate the attribute against.
+            module Scope
+              extend Lithic::Internal::Type::Enum
+
+              TaggedSymbol =
+                T.type_alias do
+                  T.all(
+                    Symbol,
+                    Lithic::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::Scope
+                  )
+                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              CARD =
+                T.let(
+                  :CARD,
+                  Lithic::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::Scope::TaggedSymbol
+                )
+              ACCOUNT =
+                T.let(
+                  :ACCOUNT,
+                  Lithic::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::Scope::TaggedSymbol
+                )
+              BUSINESS_ACCOUNT =
+                T.let(
+                  :BUSINESS_ACCOUNT,
+                  Lithic::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::Scope::TaggedSymbol
+                )
+
+              sig do
+                override.returns(
+                  T::Array[
+                    Lithic::AuthRules::ConditionalAuthorizationActionParameters::Condition::Parameters::Scope::TaggedSymbol
+                  ]
+                )
+              end
+              def self.values
+              end
+            end
+          end
         end
       end
     end

data/rbi/lithic/models/auth_rules/rule_feature.rbi

@@ -24,6 +24,10 @@ module Lithic
       # - `SPEND_VELOCITY`: Spend velocity data for the card or account. Requires
       #   `scope`, `period`, and optionally `filters` to configure the velocity
       #   calculation. Available for AUTHORIZATION event stream rules.
+      # - `TRANSACTION_HISTORY_SIGNALS`: Behavioral feature state derived from the
+      #   entity's transaction history. Requires `scope` to specify whether to load
+      #   card, account, or business account history. Available for AUTHORIZATION event
+      #   stream rules.
       module RuleFeature
         extend Lithic::Internal::Type::Union
 
@@ -37,7 +41,8 @@ module Lithic
               Lithic::AuthRules::RuleFeature::CardFeature,
               Lithic::AuthRules::RuleFeature::AccountHolderFeature,
               Lithic::AuthRules::RuleFeature::IPMetadataFeature,
-              Lithic::AuthRules::RuleFeature::SpendVelocityFeature
+              Lithic::AuthRules::RuleFeature::SpendVelocityFeature,
+              Lithic::AuthRules::RuleFeature::TransactionHistorySignalsFeature
             )
           end
 
@@ -403,6 +408,104 @@ module Lithic
           end
         end
 
+        class TransactionHistorySignalsFeature < Lithic::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Lithic::AuthRules::RuleFeature::TransactionHistorySignalsFeature,
+                Lithic::Internal::AnyHash
+              )
+            end
+
+          # The entity scope to load transaction history signals for.
+          sig do
+            returns(
+              Lithic::AuthRules::RuleFeature::TransactionHistorySignalsFeature::Scope::OrSymbol
+            )
+          end
+          attr_accessor :scope
+
+          sig { returns(Symbol) }
+          attr_accessor :type
+
+          # The variable name for this feature in the rule function signature
+          sig { returns(T.nilable(String)) }
+          attr_reader :name
+
+          sig { params(name: String).void }
+          attr_writer :name
+
+          sig do
+            params(
+              scope:
+                Lithic::AuthRules::RuleFeature::TransactionHistorySignalsFeature::Scope::OrSymbol,
+              name: String,
+              type: Symbol
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # The entity scope to load transaction history signals for.
+            scope:,
+            # The variable name for this feature in the rule function signature
+            name: nil,
+            type: :TRANSACTION_HISTORY_SIGNALS
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                scope:
+                  Lithic::AuthRules::RuleFeature::TransactionHistorySignalsFeature::Scope::OrSymbol,
+                type: Symbol,
+                name: String
+              }
+            )
+          end
+          def to_hash
+          end
+
+          # The entity scope to load transaction history signals for.
+          module Scope
+            extend Lithic::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  Lithic::AuthRules::RuleFeature::TransactionHistorySignalsFeature::Scope
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            CARD =
+              T.let(
+                :CARD,
+                Lithic::AuthRules::RuleFeature::TransactionHistorySignalsFeature::Scope::TaggedSymbol
+              )
+            ACCOUNT =
+              T.let(
+                :ACCOUNT,
+                Lithic::AuthRules::RuleFeature::TransactionHistorySignalsFeature::Scope::TaggedSymbol
+              )
+            BUSINESS_ACCOUNT =
+              T.let(
+                :BUSINESS_ACCOUNT,
+                Lithic::AuthRules::RuleFeature::TransactionHistorySignalsFeature::Scope::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  Lithic::AuthRules::RuleFeature::TransactionHistorySignalsFeature::Scope::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+        end
+
         sig do
           override.returns(T::Array[Lithic::AuthRules::RuleFeature::Variants])
         end

data/rbi/lithic/models/auth_rules/typescript_code_parameters.rbi

@@ -30,7 +30,8 @@ module Lithic
                 Lithic::AuthRules::RuleFeature::CardFeature,
                 Lithic::AuthRules::RuleFeature::AccountHolderFeature,
                 Lithic::AuthRules::RuleFeature::IPMetadataFeature,
-                Lithic::AuthRules::RuleFeature::SpendVelocityFeature
+                Lithic::AuthRules::RuleFeature::SpendVelocityFeature,
+                Lithic::AuthRules::RuleFeature::TransactionHistorySignalsFeature
               )
             ]
           )
@@ -51,7 +52,8 @@ module Lithic
                   Lithic::AuthRules::RuleFeature::CardFeature::OrHash,
                   Lithic::AuthRules::RuleFeature::AccountHolderFeature::OrHash,
                   Lithic::AuthRules::RuleFeature::IPMetadataFeature::OrHash,
-                  Lithic::AuthRules::RuleFeature::SpendVelocityFeature::OrHash
+                  Lithic::AuthRules::RuleFeature::SpendVelocityFeature::OrHash,
+                  Lithic::AuthRules::RuleFeature::TransactionHistorySignalsFeature::OrHash
                 )
               ]
           ).returns(T.attached_class)
@@ -80,7 +82,8 @@ module Lithic
                     Lithic::AuthRules::RuleFeature::CardFeature,
                     Lithic::AuthRules::RuleFeature::AccountHolderFeature,
                     Lithic::AuthRules::RuleFeature::IPMetadataFeature,
-                    Lithic::AuthRules::RuleFeature::SpendVelocityFeature
+                    Lithic::AuthRules::RuleFeature::SpendVelocityFeature,
+                    Lithic::AuthRules::RuleFeature::TransactionHistorySignalsFeature
                   )
                 ]
             }