lithic 0.1.0.pre.alpha.30 → 0.1.0.pre.alpha.32

data/rbi/lithic/models/auth_rules/velocity_limit_params_period_window.rbi

@@ -10,6 +10,8 @@ module Lithic
       #   Eastern Time.
       # - `MONTH`: Velocity over the current month since 00:00 / 12 AM on the first of
       #   the month in Eastern Time.
+      # - `YEAR`: Velocity over the current year since 00:00 / 12 AM on January 1st in
+      #   Eastern Time.
       module VelocityLimitParamsPeriodWindow
         extend Lithic::Internal::Type::Enum
 
@@ -34,6 +36,11 @@ module Lithic
             :MONTH,
             Lithic::AuthRules::VelocityLimitParamsPeriodWindow::TaggedSymbol
           )
+        YEAR =
+          T.let(
+            :YEAR,
+            Lithic::AuthRules::VelocityLimitParamsPeriodWindow::TaggedSymbol
+          )
 
         sig do
           override.returns(

data/rbi/lithic/models/financial_account.rbi

@@ -353,6 +353,8 @@ module Lithic
             :PROGRAM_RECEIVABLES,
             Lithic::FinancialAccount::Type::TaggedSymbol
           )
+        COLLECTION =
+          T.let(:COLLECTION, Lithic::FinancialAccount::Type::TaggedSymbol)
 
         sig do
           override.returns(

data/rbi/lithic/models/financial_account_register_account_number_params.rbi

@@ -0,0 +1,38 @@
+# typed: strong
+
+module Lithic
+  module Models
+    class FinancialAccountRegisterAccountNumberParams < Lithic::Internal::Type::BaseModel
+      extend Lithic::Internal::Type::RequestParameters::Converter
+      include Lithic::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(
+            Lithic::FinancialAccountRegisterAccountNumberParams,
+            Lithic::Internal::AnyHash
+          )
+        end
+
+      sig { returns(String) }
+      attr_accessor :account_number
+
+      sig do
+        params(
+          account_number: String,
+          request_options: Lithic::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(account_number:, request_options: {})
+      end
+
+      sig do
+        override.returns(
+          { account_number: String, request_options: Lithic::RequestOptions }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/lithic/models/funding_event_list_response.rbi

@@ -23,7 +23,8 @@ module Lithic
       end
       attr_accessor :collection_resource_type
 
-      # IDs of collections
+      # IDs of collections, further information can be gathered from the appropriate
+      # collection API based on collection_resource_type
       sig { returns(T::Array[String]) }
       attr_accessor :collection_tokens
 
@@ -35,19 +36,19 @@ module Lithic
       sig { returns(Time) }
       attr_accessor :high_watermark
 
-      # Time of the previous high watermark
-      sig { returns(Time) }
-      attr_accessor :previous_high_watermark
-
-      # List of settlements
+      # Network settlement summary breakdown by network settlement date
       sig do
         returns(
           T::Array[
-            Lithic::Models::FundingEventListResponse::SettlementBreakdown
+            Lithic::Models::FundingEventListResponse::NetworkSettlementSummary
           ]
         )
       end
-      attr_accessor :settlement_breakdowns
+      attr_accessor :network_settlement_summary
+
+      # Time of the previous high watermark
+      sig { returns(Time) }
+      attr_accessor :previous_high_watermark
 
       # Time of the update
       sig { returns(Time) }
@@ -61,11 +62,11 @@ module Lithic
           collection_tokens: T::Array[String],
           created: Time,
           high_watermark: Time,
-          previous_high_watermark: Time,
-          settlement_breakdowns:
+          network_settlement_summary:
             T::Array[
-              Lithic::Models::FundingEventListResponse::SettlementBreakdown::OrHash
+              Lithic::Models::FundingEventListResponse::NetworkSettlementSummary::OrHash
             ],
+          previous_high_watermark: Time,
           updated: Time
         ).returns(T.attached_class)
       end
@@ -74,16 +75,17 @@ module Lithic
         token:,
         # Collection resource type
         collection_resource_type:,
-        # IDs of collections
+        # IDs of collections, further information can be gathered from the appropriate
+        # collection API based on collection_resource_type
         collection_tokens:,
         # Time of the creation
         created:,
         # Time of the high watermark
         high_watermark:,
+        # Network settlement summary breakdown by network settlement date
+        network_settlement_summary:,
         # Time of the previous high watermark
         previous_high_watermark:,
-        # List of settlements
-        settlement_breakdowns:,
         # Time of the update
         updated:
       )
@@ -98,11 +100,11 @@ module Lithic
             collection_tokens: T::Array[String],
             created: Time,
             high_watermark: Time,
-            previous_high_watermark: Time,
-            settlement_breakdowns:
+            network_settlement_summary:
               T::Array[
-                Lithic::Models::FundingEventListResponse::SettlementBreakdown
+                Lithic::Models::FundingEventListResponse::NetworkSettlementSummary
               ],
+            previous_high_watermark: Time,
             updated: Time
           }
         )
@@ -145,30 +147,35 @@ module Lithic
         end
       end
 
-      class SettlementBreakdown < Lithic::Internal::Type::BaseModel
+      class NetworkSettlementSummary < Lithic::Internal::Type::BaseModel
         OrHash =
           T.type_alias do
             T.any(
-              Lithic::Models::FundingEventListResponse::SettlementBreakdown,
+              Lithic::Models::FundingEventListResponse::NetworkSettlementSummary,
               Lithic::Internal::AnyHash
             )
           end
 
-        sig { returns(Integer) }
-        attr_accessor :amount
-
         sig { returns(Date) }
-        attr_accessor :settlement_date
+        attr_accessor :network_settlement_date
+
+        sig { returns(Integer) }
+        attr_accessor :settled_gross_amount
 
         sig do
-          params(amount: Integer, settlement_date: Date).returns(
-            T.attached_class
-          )
+          params(
+            network_settlement_date: Date,
+            settled_gross_amount: Integer
+          ).returns(T.attached_class)
         end
-        def self.new(amount:, settlement_date:)
+        def self.new(network_settlement_date:, settled_gross_amount:)
         end
 
-        sig { override.returns({ amount: Integer, settlement_date: Date }) }
+        sig do
+          override.returns(
+            { network_settlement_date: Date, settled_gross_amount: Integer }
+          )
+        end
         def to_hash
         end
       end

data/rbi/lithic/models/funding_event_retrieve_response.rbi

@@ -23,7 +23,8 @@ module Lithic
       end
       attr_accessor :collection_resource_type
 
-      # IDs of collections
+      # IDs of collections, further information can be gathered from the appropriate
+      # collection API based on collection_resource_type
       sig { returns(T::Array[String]) }
       attr_accessor :collection_tokens
 
@@ -35,19 +36,19 @@ module Lithic
       sig { returns(Time) }
       attr_accessor :high_watermark
 
-      # Time of the previous high watermark
-      sig { returns(Time) }
-      attr_accessor :previous_high_watermark
-
-      # List of settlements
+      # Network settlement summary breakdown by network settlement date
       sig do
         returns(
           T::Array[
-            Lithic::Models::FundingEventRetrieveResponse::SettlementBreakdown
+            Lithic::Models::FundingEventRetrieveResponse::NetworkSettlementSummary
           ]
         )
       end
-      attr_accessor :settlement_breakdowns
+      attr_accessor :network_settlement_summary
+
+      # Time of the previous high watermark
+      sig { returns(Time) }
+      attr_accessor :previous_high_watermark
 
       # Time of the update
       sig { returns(Time) }
@@ -61,11 +62,11 @@ module Lithic
           collection_tokens: T::Array[String],
           created: Time,
           high_watermark: Time,
-          previous_high_watermark: Time,
-          settlement_breakdowns:
+          network_settlement_summary:
             T::Array[
-              Lithic::Models::FundingEventRetrieveResponse::SettlementBreakdown::OrHash
+              Lithic::Models::FundingEventRetrieveResponse::NetworkSettlementSummary::OrHash
             ],
+          previous_high_watermark: Time,
           updated: Time
         ).returns(T.attached_class)
       end
@@ -74,16 +75,17 @@ module Lithic
         token:,
         # Collection resource type
         collection_resource_type:,
-        # IDs of collections
+        # IDs of collections, further information can be gathered from the appropriate
+        # collection API based on collection_resource_type
         collection_tokens:,
         # Time of the creation
         created:,
         # Time of the high watermark
         high_watermark:,
+        # Network settlement summary breakdown by network settlement date
+        network_settlement_summary:,
         # Time of the previous high watermark
         previous_high_watermark:,
-        # List of settlements
-        settlement_breakdowns:,
         # Time of the update
         updated:
       )
@@ -98,11 +100,11 @@ module Lithic
             collection_tokens: T::Array[String],
             created: Time,
             high_watermark: Time,
-            previous_high_watermark: Time,
-            settlement_breakdowns:
+            network_settlement_summary:
               T::Array[
-                Lithic::Models::FundingEventRetrieveResponse::SettlementBreakdown
+                Lithic::Models::FundingEventRetrieveResponse::NetworkSettlementSummary
               ],
+            previous_high_watermark: Time,
             updated: Time
           }
         )
@@ -145,30 +147,35 @@ module Lithic
         end
       end
 
-      class SettlementBreakdown < Lithic::Internal::Type::BaseModel
+      class NetworkSettlementSummary < Lithic::Internal::Type::BaseModel
         OrHash =
           T.type_alias do
             T.any(
-              Lithic::Models::FundingEventRetrieveResponse::SettlementBreakdown,
+              Lithic::Models::FundingEventRetrieveResponse::NetworkSettlementSummary,
               Lithic::Internal::AnyHash
             )
           end
 
-        sig { returns(Integer) }
-        attr_accessor :amount
-
         sig { returns(Date) }
-        attr_accessor :settlement_date
+        attr_accessor :network_settlement_date
+
+        sig { returns(Integer) }
+        attr_accessor :settled_gross_amount
 
         sig do
-          params(amount: Integer, settlement_date: Date).returns(
-            T.attached_class
-          )
+          params(
+            network_settlement_date: Date,
+            settled_gross_amount: Integer
+          ).returns(T.attached_class)
         end
-        def self.new(amount:, settlement_date:)
+        def self.new(network_settlement_date:, settled_gross_amount:)
         end
 
-        sig { override.returns({ amount: Integer, settlement_date: Date }) }
+        sig do
+          override.returns(
+            { network_settlement_date: Date, settled_gross_amount: Integer }
+          )
+        end
         def to_hash
         end
       end

data/rbi/lithic/models/instance_financial_account_type.rbi

@@ -38,6 +38,8 @@ module Lithic
           :PROGRAM_RECEIVABLES,
           Lithic::InstanceFinancialAccountType::TaggedSymbol
         )
+      COLLECTION =
+        T.let(:COLLECTION, Lithic::InstanceFinancialAccountType::TaggedSymbol)
 
       sig do
         override.returns(

data/rbi/lithic/models/payment.rbi

@@ -255,7 +255,7 @@ module Lithic
         # - `ACH_ORIGINATION_REVIEWED` - ACH origination has completed the review process.
         # - `ACH_ORIGINATION_CANCELLED` - ACH origination has been cancelled.
         # - `ACH_ORIGINATION_PROCESSED` - ACH origination has been processed and sent to
-        #   the fed.
+        #   the Federal Reserve.
         # - `ACH_ORIGINATION_SETTLED` - ACH origination has settled.
         # - `ACH_ORIGINATION_RELEASED` - ACH origination released from pending to
         #   available balance.
@@ -318,7 +318,7 @@ module Lithic
           # - `ACH_ORIGINATION_REVIEWED` - ACH origination has completed the review process.
           # - `ACH_ORIGINATION_CANCELLED` - ACH origination has been cancelled.
           # - `ACH_ORIGINATION_PROCESSED` - ACH origination has been processed and sent to
-          #   the fed.
+          #   the Federal Reserve.
           # - `ACH_ORIGINATION_SETTLED` - ACH origination has settled.
           # - `ACH_ORIGINATION_RELEASED` - ACH origination released from pending to
           #   available balance.
@@ -383,7 +383,7 @@ module Lithic
         # - `ACH_ORIGINATION_REVIEWED` - ACH origination has completed the review process.
         # - `ACH_ORIGINATION_CANCELLED` - ACH origination has been cancelled.
         # - `ACH_ORIGINATION_PROCESSED` - ACH origination has been processed and sent to
-        #   the fed.
+        #   the Federal Reserve.
         # - `ACH_ORIGINATION_SETTLED` - ACH origination has settled.
         # - `ACH_ORIGINATION_RELEASED` - ACH origination released from pending to
         #   available balance.

data/rbi/lithic/models/required_document.rbi

@@ -12,7 +12,7 @@ module Lithic
       sig { returns(String) }
       attr_accessor :entity_token
 
-      # rovides the status reasons that will be satisfied by providing one of the valid
+      # Provides the status reasons that will be satisfied by providing one of the valid
       # documents.
       sig { returns(T::Array[String]) }
       attr_accessor :status_reasons
@@ -32,7 +32,7 @@ module Lithic
       def self.new(
         # Globally unique identifier for an entity.
         entity_token:,
-        # rovides the status reasons that will be satisfied by providing one of the valid
+        # Provides the status reasons that will be satisfied by providing one of the valid
         # documents.
         status_reasons:,
         # A list of valid documents that will satisfy the KYC requirements for the

data/rbi/lithic/models/settlement_detail.rbi

@@ -79,7 +79,9 @@ module Lithic
       sig { returns(String) }
       attr_accessor :report_date
 
-      # Date of when money movement is triggered for the transaction.
+      # Date of when money movement is triggered for the transaction. One exception
+      # applies - for Mastercard dual message settlement, this is the settlement
+      # advisement date, which is distinct from the date of money movement.
       sig { returns(String) }
       attr_accessor :settlement_date
 
@@ -168,7 +170,9 @@ module Lithic
         other_fees_gross_amount:,
         # Date of when the report was first generated.
         report_date:,
-        # Date of when money movement is triggered for the transaction.
+        # Date of when money movement is triggered for the transaction. One exception
+        # applies - for Mastercard dual message settlement, this is the settlement
+        # advisement date, which is distinct from the date of money movement.
         settlement_date:,
         # Globally unique identifier denoting the associated Transaction object.
         transaction_token:,

data/rbi/lithic/models/transaction.rbi

@@ -21,7 +21,8 @@ module Lithic
       attr_accessor :acquirer_fee
 
       # Unique identifier assigned to a transaction by the acquirer that can be used in
-      # dispute and chargeback filing.
+      # dispute and chargeback filing. This field has been deprecated in favor of the
+      # `acquirer_reference_number` that resides in the event-level `network_info`.
       sig { returns(T.nilable(String)) }
       attr_accessor :acquirer_reference_number
 
@@ -180,7 +181,8 @@ module Lithic
         # as a negative value to indicate credited fees.
         acquirer_fee:,
         # Unique identifier assigned to a transaction by the acquirer that can be used in
-        # dispute and chargeback filing.
+        # dispute and chargeback filing. This field has been deprecated in favor of the
+        # `acquirer_reference_number` that resides in the event-level `network_info`.
         acquirer_reference_number:,
         # When the transaction is pending, this represents the authorization amount of the
         # transaction in the anticipated settlement currency. Once the transaction has
@@ -813,6 +815,11 @@ module Lithic
             end
           OrSymbol = T.type_alias { T.any(Symbol, String) }
 
+          CUSTOMER_RULES =
+            T.let(
+              :CUSTOMER_RULES,
+              Lithic::Transaction::CardholderAuthentication::DecisionMadeBy::TaggedSymbol
+            )
           CUSTOMER_ENDPOINT =
             T.let(
               :CUSTOMER_ENDPOINT,

data/rbi/lithic/models/verification_method.rbi

@@ -15,6 +15,7 @@ module Lithic
       PRENOTE = T.let(:PRENOTE, Lithic::VerificationMethod::TaggedSymbol)
       EXTERNALLY_VERIFIED =
         T.let(:EXTERNALLY_VERIFIED, Lithic::VerificationMethod::TaggedSymbol)
+      UNVERIFIED = T.let(:UNVERIFIED, Lithic::VerificationMethod::TaggedSymbol)
 
       sig do
         override.returns(T::Array[Lithic::VerificationMethod::TaggedSymbol])

data/rbi/lithic/models.rbi

@@ -205,6 +205,9 @@ module Lithic
 
   FinancialAccountListParams = Lithic::Models::FinancialAccountListParams
 
+  FinancialAccountRegisterAccountNumberParams =
+    Lithic::Models::FinancialAccountRegisterAccountNumberParams
+
   FinancialAccountRetrieveParams =
     Lithic::Models::FinancialAccountRetrieveParams
 

data/rbi/lithic/resources/accounts.rbi

@@ -53,8 +53,8 @@ module Lithic
         state: 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 Authorization Rules. The field will be removed from
-        # the schema in a future release.
+        # are no longer supported by Auth Rules. The field will be removed from the schema
+        # in a future release.
         verification_address: nil,
         request_options: {}
       )

data/rbi/lithic/resources/auth_rules/v2/backtests.rbi

@@ -5,16 +5,15 @@ module Lithic
     class AuthRules
       class V2
         class Backtests
-          # Initiates a request to asynchronously generate a backtest for an authorization
-          # rule. During backtesting, both the active version (if one exists) and the draft
-          # version of the Authorization Rule are evaluated by replaying historical
-          # transaction data against the rule's conditions. This process allows customers to
-          # simulate and understand the effects of proposed rule changes before deployment.
-          # The generated backtest report provides detailed results showing whether the
-          # draft version of the Auth Rule would have approved or declined historical
-          # transactions which were processed during the backtest period. These reports help
-          # evaluate how changes to rule configurations might affect overall transaction
-          # approval rates.
+          # Initiates a request to asynchronously generate a backtest for an Auth rule.
+          # During backtesting, both the active version (if one exists) and the draft
+          # version of the Auth Rule are evaluated by replaying historical transaction data
+          # against the rule's conditions. This process allows customers to simulate and
+          # understand the effects of proposed rule changes before deployment. The generated
+          # backtest report provides detailed results showing whether the draft version of
+          # the Auth Rule would have approved or declined historical transactions which were
+          # processed during the backtest period. These reports help evaluate how changes to
+          # rule configurations might affect overall transaction approval rates.
           #
           # The generated backtest report will be delivered asynchronously through a webhook
           # with `event_type` = `auth_rules.backtest_report.created`. See the docs on
@@ -49,7 +48,7 @@ module Lithic
           )
           end
 
-          # Returns the backtest results of an authorization rule (if available).
+          # Returns the backtest results of an Auth rule (if available).
           #
           # Backtesting is an asynchronous process that requires time to complete. If a
           # customer retrieves the backtest results using this endpoint before the report is
@@ -65,8 +64,8 @@ module Lithic
           # also always represent the configuration of the rule at the time requests are
           # made to this endpoint. For example, the results for `current_version` in the
           # served backtest report will be consistent with which version of the rule is
-          # currently activated in the Auth Stream, regardless of which version of the rule
-          # was active in the Auth Stream at the time a backtest is requested.
+          # currently activated in the respective event stream, regardless of which version
+          # of the rule was active in the event stream at the time a backtest is requested.
           sig do
             params(
               auth_rule_backtest_token: String,