lithic 0.1.0.pre.alpha.38 → 0.1.0.pre.alpha.40

data/rbi/lithic/models/account_update_params.rbi

@@ -11,6 +11,13 @@ module Lithic
           T.any(Lithic::AccountUpdateParams, Lithic::Internal::AnyHash)
         end
 
+      # Additional context or information related to the account.
+      sig { returns(T.nilable(String)) }
+      attr_reader :comment
+
+      sig { params(comment: String).void }
+      attr_writer :comment
+
       # Amount (in cents) for the account's daily spend limit (e.g. 100000 would be a
       # $1,000 limit). By default the daily spend limit is set to $1,250.
       sig { returns(T.nilable(Integer)) }
@@ -47,6 +54,43 @@ module Lithic
       sig { params(state: Lithic::AccountUpdateParams::State::OrSymbol).void }
       attr_writer :state
 
+      # Account state substatus values:
+      #
+      # - `FRAUD_IDENTIFIED` - The account has been recognized as being created or used
+      #   with stolen or fabricated identity information, encompassing both true
+      #   identity theft and synthetic identities.
+      # - `SUSPICIOUS_ACTIVITY` - The account has exhibited suspicious behavior, such as
+      #   unauthorized access or fraudulent transactions, necessitating further
+      #   investigation.
+      # - `RISK_VIOLATION` - The account has been involved in deliberate misuse by the
+      #   legitimate account holder. Examples include disputing valid transactions
+      #   without cause, falsely claiming non-receipt of goods, or engaging in
+      #   intentional bust-out schemes to exploit account services.
+      # - `END_USER_REQUEST` - The account holder has voluntarily requested the closure
+      #   of the account for personal reasons. This encompasses situations such as
+      #   bankruptcy, other financial considerations, or the account holder's death.
+      # - `ISSUER_REQUEST` - The issuer has initiated the closure of the account due to
+      #   business strategy, risk management, inactivity, product changes, regulatory
+      #   concerns, or violations of terms and conditions.
+      # - `NOT_ACTIVE` - The account has not had any transactions or payment activity
+      #   within a specified period. This status applies to accounts that are paused or
+      #   closed due to inactivity.
+      # - `INTERNAL_REVIEW` - The account is temporarily paused pending further internal
+      #   review. In future implementations, this status may prevent clients from
+      #   activating the account via APIs until the review is completed.
+      # - `OTHER` - The reason for the account's current status does not fall into any
+      #   of the above categories. A comment should be provided to specify the
+      #   particular reason.
+      sig do
+        returns(T.nilable(Lithic::AccountUpdateParams::Substatus::OrSymbol))
+      end
+      attr_reader :substatus
+
+      sig do
+        params(substatus: Lithic::AccountUpdateParams::Substatus::OrSymbol).void
+      end
+      attr_writer :substatus
+
       # Address used during Address Verification Service (AVS) checks during
       # transactions if enabled via Auth Rules. This field is deprecated as AVS checks
       # are no longer supported by Auth Rules. The field will be removed from the schema
@@ -66,16 +110,20 @@ module Lithic
 
       sig do
         params(
+          comment: String,
           daily_spend_limit: Integer,
           lifetime_spend_limit: Integer,
           monthly_spend_limit: Integer,
           state: Lithic::AccountUpdateParams::State::OrSymbol,
+          substatus: Lithic::AccountUpdateParams::Substatus::OrSymbol,
           verification_address:
             Lithic::AccountUpdateParams::VerificationAddress::OrHash,
           request_options: Lithic::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
       def self.new(
+        # Additional context or information related to the account.
+        comment: nil,
         # Amount (in cents) for the account's daily spend limit (e.g. 100000 would be a
         # $1,000 limit). By default the daily spend limit is set to $1,250.
         daily_spend_limit: nil,
@@ -92,6 +140,34 @@ module Lithic
         monthly_spend_limit: nil,
         # Account states.
         state: nil,
+        # Account state substatus values:
+        #
+        # - `FRAUD_IDENTIFIED` - The account has been recognized as being created or used
+        #   with stolen or fabricated identity information, encompassing both true
+        #   identity theft and synthetic identities.
+        # - `SUSPICIOUS_ACTIVITY` - The account has exhibited suspicious behavior, such as
+        #   unauthorized access or fraudulent transactions, necessitating further
+        #   investigation.
+        # - `RISK_VIOLATION` - The account has been involved in deliberate misuse by the
+        #   legitimate account holder. Examples include disputing valid transactions
+        #   without cause, falsely claiming non-receipt of goods, or engaging in
+        #   intentional bust-out schemes to exploit account services.
+        # - `END_USER_REQUEST` - The account holder has voluntarily requested the closure
+        #   of the account for personal reasons. This encompasses situations such as
+        #   bankruptcy, other financial considerations, or the account holder's death.
+        # - `ISSUER_REQUEST` - The issuer has initiated the closure of the account due to
+        #   business strategy, risk management, inactivity, product changes, regulatory
+        #   concerns, or violations of terms and conditions.
+        # - `NOT_ACTIVE` - The account has not had any transactions or payment activity
+        #   within a specified period. This status applies to accounts that are paused or
+        #   closed due to inactivity.
+        # - `INTERNAL_REVIEW` - The account is temporarily paused pending further internal
+        #   review. In future implementations, this status may prevent clients from
+        #   activating the account via APIs until the review is completed.
+        # - `OTHER` - The reason for the account's current status does not fall into any
+        #   of the above categories. A comment should be provided to specify the
+        #   particular reason.
+        substatus: nil,
         # Address used during Address Verification Service (AVS) checks during
         # transactions if enabled via Auth Rules. This field is deprecated as AVS checks
         # are no longer supported by Auth Rules. The field will be removed from the schema
@@ -104,10 +180,12 @@ module Lithic
       sig do
         override.returns(
           {
+            comment: String,
             daily_spend_limit: Integer,
             lifetime_spend_limit: Integer,
             monthly_spend_limit: Integer,
             state: Lithic::AccountUpdateParams::State::OrSymbol,
+            substatus: Lithic::AccountUpdateParams::Substatus::OrSymbol,
             verification_address:
               Lithic::AccountUpdateParams::VerificationAddress,
             request_options: Lithic::RequestOptions
@@ -141,6 +219,87 @@ module Lithic
         end
       end
 
+      # Account state substatus values:
+      #
+      # - `FRAUD_IDENTIFIED` - The account has been recognized as being created or used
+      #   with stolen or fabricated identity information, encompassing both true
+      #   identity theft and synthetic identities.
+      # - `SUSPICIOUS_ACTIVITY` - The account has exhibited suspicious behavior, such as
+      #   unauthorized access or fraudulent transactions, necessitating further
+      #   investigation.
+      # - `RISK_VIOLATION` - The account has been involved in deliberate misuse by the
+      #   legitimate account holder. Examples include disputing valid transactions
+      #   without cause, falsely claiming non-receipt of goods, or engaging in
+      #   intentional bust-out schemes to exploit account services.
+      # - `END_USER_REQUEST` - The account holder has voluntarily requested the closure
+      #   of the account for personal reasons. This encompasses situations such as
+      #   bankruptcy, other financial considerations, or the account holder's death.
+      # - `ISSUER_REQUEST` - The issuer has initiated the closure of the account due to
+      #   business strategy, risk management, inactivity, product changes, regulatory
+      #   concerns, or violations of terms and conditions.
+      # - `NOT_ACTIVE` - The account has not had any transactions or payment activity
+      #   within a specified period. This status applies to accounts that are paused or
+      #   closed due to inactivity.
+      # - `INTERNAL_REVIEW` - The account is temporarily paused pending further internal
+      #   review. In future implementations, this status may prevent clients from
+      #   activating the account via APIs until the review is completed.
+      # - `OTHER` - The reason for the account's current status does not fall into any
+      #   of the above categories. A comment should be provided to specify the
+      #   particular reason.
+      module Substatus
+        extend Lithic::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, Lithic::AccountUpdateParams::Substatus) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        FRAUD_IDENTIFIED =
+          T.let(
+            :FRAUD_IDENTIFIED,
+            Lithic::AccountUpdateParams::Substatus::TaggedSymbol
+          )
+        SUSPICIOUS_ACTIVITY =
+          T.let(
+            :SUSPICIOUS_ACTIVITY,
+            Lithic::AccountUpdateParams::Substatus::TaggedSymbol
+          )
+        RISK_VIOLATION =
+          T.let(
+            :RISK_VIOLATION,
+            Lithic::AccountUpdateParams::Substatus::TaggedSymbol
+          )
+        END_USER_REQUEST =
+          T.let(
+            :END_USER_REQUEST,
+            Lithic::AccountUpdateParams::Substatus::TaggedSymbol
+          )
+        ISSUER_REQUEST =
+          T.let(
+            :ISSUER_REQUEST,
+            Lithic::AccountUpdateParams::Substatus::TaggedSymbol
+          )
+        NOT_ACTIVE =
+          T.let(
+            :NOT_ACTIVE,
+            Lithic::AccountUpdateParams::Substatus::TaggedSymbol
+          )
+        INTERNAL_REVIEW =
+          T.let(
+            :INTERNAL_REVIEW,
+            Lithic::AccountUpdateParams::Substatus::TaggedSymbol
+          )
+        OTHER =
+          T.let(:OTHER, Lithic::AccountUpdateParams::Substatus::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[Lithic::AccountUpdateParams::Substatus::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+
       class VerificationAddress < Lithic::Internal::Type::BaseModel
         OrHash =
           T.type_alias do

data/rbi/lithic/models/aggregate_balance.rbi

@@ -143,6 +143,11 @@ module Lithic
             :RESERVE,
             Lithic::AggregateBalance::FinancialAccountType::TaggedSymbol
           )
+        SECURITY =
+          T.let(
+            :SECURITY,
+            Lithic::AggregateBalance::FinancialAccountType::TaggedSymbol
+          )
 
         sig do
           override.returns(

data/rbi/lithic/models/aggregate_balance_list_params.rbi

@@ -83,6 +83,11 @@ module Lithic
             :RESERVE,
             Lithic::AggregateBalanceListParams::FinancialAccountType::TaggedSymbol
           )
+        SECURITY =
+          T.let(
+            :SECURITY,
+            Lithic::AggregateBalanceListParams::FinancialAccountType::TaggedSymbol
+          )
 
         sig do
           override.returns(

data/rbi/lithic/models/auth_rules/conditional_3ds_action_parameters.rbi

@@ -123,11 +123,8 @@ module Lithic
           #   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 authentication. 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.
+          # - `RISK_SCORE`: Mastercard only: Assessment by the network of the authentication
+          #   risk level, with a higher value indicating a higher amount of risk.
           # - `MESSAGE_CATEGORY`: The category of the authentication being processed.
           sig do
             returns(
@@ -211,11 +208,8 @@ module Lithic
             #   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 authentication. 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.
+            # - `RISK_SCORE`: Mastercard only: Assessment by the network of the authentication
+            #   risk level, with a higher value indicating a higher amount of risk.
             # - `MESSAGE_CATEGORY`: The category of the authentication being processed.
             attribute: nil,
             # The operation to apply to the attribute
@@ -258,11 +252,8 @@ module Lithic
           #   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 authentication. 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.
+          # - `RISK_SCORE`: Mastercard only: Assessment by the network of the authentication
+          #   risk level, with a higher value indicating a higher amount of risk.
           # - `MESSAGE_CATEGORY`: The category of the authentication being processed.
           module Attribute
             extend Lithic::Internal::Type::Enum

data/rbi/lithic/models/auth_rules/velocity_limit_params.rbi

@@ -28,7 +28,12 @@ module Lithic
           returns(
             T.any(
               Integer,
-              Lithic::AuthRules::VelocityLimitParamsPeriodWindow::OrSymbol
+              Lithic::AuthRules::VelocityLimitParamsPeriodWindow::FixedWindow::OrSymbol,
+              Lithic::AuthRules::VelocityLimitParamsPeriodWindow::TrailingWindowObject,
+              Lithic::AuthRules::VelocityLimitParamsPeriodWindow::FixedWindowDay,
+              Lithic::AuthRules::VelocityLimitParamsPeriodWindow::FixedWindowWeek,
+              Lithic::AuthRules::VelocityLimitParamsPeriodWindow::FixedWindowMonth,
+              Lithic::AuthRules::VelocityLimitParamsPeriodWindow::FixedWindowYear
             )
           )
         end
@@ -57,7 +62,12 @@ module Lithic
             period:
               T.any(
                 Integer,
-                Lithic::AuthRules::VelocityLimitParamsPeriodWindow::OrSymbol
+                Lithic::AuthRules::VelocityLimitParamsPeriodWindow::FixedWindow::OrSymbol,
+                Lithic::AuthRules::VelocityLimitParamsPeriodWindow::TrailingWindowObject::OrHash,
+                Lithic::AuthRules::VelocityLimitParamsPeriodWindow::FixedWindowDay::OrHash,
+                Lithic::AuthRules::VelocityLimitParamsPeriodWindow::FixedWindowWeek::OrHash,
+                Lithic::AuthRules::VelocityLimitParamsPeriodWindow::FixedWindowMonth::OrHash,
+                Lithic::AuthRules::VelocityLimitParamsPeriodWindow::FixedWindowYear::OrHash
               ),
             scope: Lithic::AuthRules::VelocityLimitParams::Scope::OrSymbol,
             limit_amount: T.nilable(Integer),
@@ -90,7 +100,12 @@ module Lithic
               period:
                 T.any(
                   Integer,
-                  Lithic::AuthRules::VelocityLimitParamsPeriodWindow::OrSymbol
+                  Lithic::AuthRules::VelocityLimitParamsPeriodWindow::FixedWindow::OrSymbol,
+                  Lithic::AuthRules::VelocityLimitParamsPeriodWindow::TrailingWindowObject,
+                  Lithic::AuthRules::VelocityLimitParamsPeriodWindow::FixedWindowDay,
+                  Lithic::AuthRules::VelocityLimitParamsPeriodWindow::FixedWindowWeek,
+                  Lithic::AuthRules::VelocityLimitParamsPeriodWindow::FixedWindowMonth,
+                  Lithic::AuthRules::VelocityLimitParamsPeriodWindow::FixedWindowYear
                 ),
               scope: Lithic::AuthRules::VelocityLimitParams::Scope::OrSymbol,
               limit_amount: T.nilable(Integer),
@@ -172,28 +187,6 @@ module Lithic
           end
         end
 
-        # The size of the trailing window to calculate Spend Velocity over in seconds. The
-        # minimum value is 10 seconds, and the maximum value is 2678400 seconds (31 days).
-        module Period
-          extend Lithic::Internal::Type::Union
-
-          Variants =
-            T.type_alias do
-              T.any(
-                Integer,
-                Lithic::AuthRules::VelocityLimitParamsPeriodWindow::TaggedSymbol
-              )
-            end
-
-          sig do
-            override.returns(
-              T::Array[Lithic::AuthRules::VelocityLimitParams::Period::Variants]
-            )
-          end
-          def self.variants
-          end
-        end
-
         module Scope
           extend Lithic::Internal::Type::Enum