lithic 0.21.0 → 0.23.0

data/rbi/lithic/models/funding_event_list_params.rbi

@@ -11,6 +11,22 @@ module Lithic
           T.any(Lithic::FundingEventListParams, Lithic::Internal::AnyHash)
         end
 
+      # Date string in RFC 3339 format. Only entries created after the specified time
+      # will be included. UTC time zone.
+      sig { returns(T.nilable(Time)) }
+      attr_reader :begin_
+
+      sig { params(begin_: Time).void }
+      attr_writer :begin_
+
+      # Date string in RFC 3339 format. Only entries created before the specified time
+      # will be included. UTC time zone.
+      sig { returns(T.nilable(Time)) }
+      attr_reader :end_
+
+      sig { params(end_: Time).void }
+      attr_writer :end_
+
       # A cursor representing an item's token before which a page of results should end.
       # Used to retrieve the previous page of results before this item.
       sig { returns(T.nilable(String)) }
@@ -19,6 +35,14 @@ module Lithic
       sig { params(ending_before: String).void }
       attr_writer :ending_before
 
+      # Only funding events with a settlement breakout for this network settlement date
+      # will be included.
+      sig { returns(T.nilable(Date)) }
+      attr_reader :network_settlement_date
+
+      sig { params(network_settlement_date: Date).void }
+      attr_writer :network_settlement_date
+
       # Page size (for pagination).
       sig { returns(T.nilable(Integer)) }
       attr_reader :page_size
@@ -36,16 +60,28 @@ module Lithic
 
       sig do
         params(
+          begin_: Time,
+          end_: Time,
           ending_before: String,
+          network_settlement_date: Date,
           page_size: Integer,
           starting_after: String,
           request_options: Lithic::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
       def self.new(
+        # Date string in RFC 3339 format. Only entries created after the specified time
+        # will be included. UTC time zone.
+        begin_: nil,
+        # Date string in RFC 3339 format. Only entries created before the specified time
+        # will be included. UTC time zone.
+        end_: nil,
         # A cursor representing an item's token before which a page of results should end.
         # Used to retrieve the previous page of results before this item.
         ending_before: nil,
+        # Only funding events with a settlement breakout for this network settlement date
+        # will be included.
+        network_settlement_date: nil,
         # Page size (for pagination).
         page_size: nil,
         # A cursor representing an item's token after which a page of results should
@@ -58,7 +94,10 @@ module Lithic
       sig do
         override.returns(
           {
+            begin_: Time,
+            end_: Time,
             ending_before: String,
+            network_settlement_date: Date,
             page_size: Integer,
             starting_after: String,
             request_options: Lithic::RequestOptions

data/rbi/lithic/models/hold.rbi

@@ -13,10 +13,6 @@ module Lithic
       sig { returns(Time) }
       attr_accessor :created
 
-      # Status of a hold transaction
-      sig { returns(Lithic::Hold::Status::TaggedSymbol) }
-      attr_accessor :status
-
       # ISO 8601 timestamp of when the transaction was last updated
       sig { returns(Time) }
       attr_accessor :updated
@@ -63,6 +59,13 @@ module Lithic
       sig { params(result: Lithic::Hold::Result::OrSymbol).void }
       attr_writer :result
 
+      # Status of a hold transaction
+      sig { returns(T.nilable(Lithic::Hold::Status::TaggedSymbol)) }
+      attr_reader :status
+
+      sig { params(status: Lithic::Hold::Status::OrSymbol).void }
+      attr_writer :status
+
       sig { returns(T.nilable(String)) }
       attr_accessor :user_defined_id
 
@@ -74,7 +77,6 @@ module Lithic
         params(
           token: String,
           created: Time,
-          status: Lithic::Hold::Status::OrSymbol,
           updated: Time,
           currency: String,
           events: T::Array[Lithic::HoldEvent::OrHash],
@@ -83,6 +85,7 @@ module Lithic
           financial_account_token: String,
           pending_amount: Integer,
           result: Lithic::Hold::Result::OrSymbol,
+          status: Lithic::Hold::Status::OrSymbol,
           user_defined_id: T.nilable(String)
         ).returns(T.attached_class)
       end
@@ -91,8 +94,6 @@ module Lithic
         token:,
         # ISO 8601 timestamp of when the transaction was created
         created:,
-        # Status of a hold transaction
-        status:,
         # ISO 8601 timestamp of when the transaction was last updated
         updated:,
         currency: nil,
@@ -105,6 +106,8 @@ module Lithic
         # Current pending amount (0 when resolved)
         pending_amount: nil,
         result: nil,
+        # Status of a hold transaction
+        status: nil,
         user_defined_id: nil
       )
       end
@@ -114,7 +117,6 @@ module Lithic
           {
             token: String,
             created: Time,
-            status: Lithic::Hold::Status::TaggedSymbol,
             updated: Time,
             currency: String,
             events: T::Array[Lithic::HoldEvent],
@@ -123,6 +125,7 @@ module Lithic
             financial_account_token: String,
             pending_amount: Integer,
             result: Lithic::Hold::Result::TaggedSymbol,
+            status: Lithic::Hold::Status::TaggedSymbol,
             user_defined_id: T.nilable(String)
           }
         )
@@ -130,27 +133,6 @@ module Lithic
       def to_hash
       end
 
-      # Status of a hold transaction
-      module Status
-        extend Lithic::Internal::Type::Enum
-
-        TaggedSymbol = T.type_alias { T.all(Symbol, Lithic::Hold::Status) }
-        OrSymbol = T.type_alias { T.any(Symbol, String) }
-
-        PENDING = T.let(:PENDING, Lithic::Hold::Status::TaggedSymbol)
-        SETTLED = T.let(:SETTLED, Lithic::Hold::Status::TaggedSymbol)
-        EXPIRED = T.let(:EXPIRED, Lithic::Hold::Status::TaggedSymbol)
-        VOIDED = T.let(:VOIDED, Lithic::Hold::Status::TaggedSymbol)
-        DECLINED = T.let(:DECLINED, Lithic::Hold::Status::TaggedSymbol)
-        REVERSED = T.let(:REVERSED, Lithic::Hold::Status::TaggedSymbol)
-        CANCELED = T.let(:CANCELED, Lithic::Hold::Status::TaggedSymbol)
-        RETURNED = T.let(:RETURNED, Lithic::Hold::Status::TaggedSymbol)
-
-        sig { override.returns(T::Array[Lithic::Hold::Status::TaggedSymbol]) }
-        def self.values
-        end
-      end
-
       # HOLD - Hold Transaction
       module Family
         extend Lithic::Internal::Type::Enum
@@ -178,6 +160,23 @@ module Lithic
         def self.values
         end
       end
+
+      # Status of a hold transaction
+      module Status
+        extend Lithic::Internal::Type::Enum
+
+        TaggedSymbol = T.type_alias { T.all(Symbol, Lithic::Hold::Status) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        PENDING = T.let(:PENDING, Lithic::Hold::Status::TaggedSymbol)
+        SETTLED = T.let(:SETTLED, Lithic::Hold::Status::TaggedSymbol)
+        EXPIRED = T.let(:EXPIRED, Lithic::Hold::Status::TaggedSymbol)
+        VOIDED = T.let(:VOIDED, Lithic::Hold::Status::TaggedSymbol)
+
+        sig { override.returns(T::Array[Lithic::Hold::Status::TaggedSymbol]) }
+        def self.values
+        end
+      end
     end
   end
 end

data/rbi/lithic/models/ip_range_retrieve_params.rbi

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

data/rbi/lithic/models/ip_range_retrieve_response.rbi

@@ -0,0 +1,40 @@
+# typed: strong
+
+module Lithic
+  module Models
+    class IPRangeRetrieveResponse < Lithic::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Lithic::Models::IPRangeRetrieveResponse,
+            Lithic::Internal::AnyHash
+          )
+        end
+
+      # IP ranges that responder requests are sent from, in CIDR notation
+      sig { returns(T::Array[String]) }
+      attr_accessor :responders
+
+      # Date and time the IP ranges were last changed
+      sig { returns(Time) }
+      attr_accessor :updated
+
+      sig do
+        params(responders: T::Array[String], updated: Time).returns(
+          T.attached_class
+        )
+      end
+      def self.new(
+        # IP ranges that responder requests are sent from, in CIDR notation
+        responders:,
+        # Date and time the IP ranges were last changed
+        updated:
+      )
+      end
+
+      sig { override.returns({ responders: T::Array[String], updated: Time }) }
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/lithic/models/kyb.rbi

@@ -176,7 +176,8 @@ module Lithic
           end
 
         # Individual's current address - PO boxes, UPS drops, and FedEx drops are not
-        # acceptable; APO/FPO are acceptable. Only USA addresses are currently supported.
+        # acceptable; APO/FPO are acceptable. Only USA addresses are supported for the KYB
+        # and KYC workflows.
         sig { returns(Lithic::Address) }
         attr_reader :address
 
@@ -228,7 +229,8 @@ module Lithic
         end
         def self.new(
           # Individual's current address - PO boxes, UPS drops, and FedEx drops are not
-          # acceptable; APO/FPO are acceptable. Only USA addresses are currently supported.
+          # acceptable; APO/FPO are acceptable. Only USA addresses are supported for the KYB
+          # and KYC workflows.
           address:,
           # Individual's date of birth, as an RFC 3339 date.
           dob:,
@@ -366,7 +368,8 @@ module Lithic
           end
 
         # Individual's current address - PO boxes, UPS drops, and FedEx drops are not
-        # acceptable; APO/FPO are acceptable. Only USA addresses are currently supported.
+        # acceptable; APO/FPO are acceptable. Only USA addresses are supported for the KYB
+        # and KYC workflows.
         sig { returns(Lithic::Address) }
         attr_reader :address
 
@@ -425,7 +428,8 @@ module Lithic
         end
         def self.new(
           # Individual's current address - PO boxes, UPS drops, and FedEx drops are not
-          # acceptable; APO/FPO are acceptable. Only USA addresses are currently supported.
+          # acceptable; APO/FPO are acceptable. Only USA addresses are supported for the KYB
+          # and KYC workflows.
           address:,
           # Individual's date of birth, as an RFC 3339 date.
           dob:,

data/rbi/lithic/models/kyb_business_entity.rbi

@@ -103,21 +103,12 @@ module Lithic
         sig { returns(String) }
         attr_accessor :city
 
-        # Valid country code. Only USA is currently supported, entered in uppercase ISO
-        # 3166-1 alpha-3 three-character format.
+        # Valid country code, entered in uppercase ISO 3166-1 alpha-3 three-character
+        # format. Supported countries depend on the onboarding workflow used for the
+        # account holder.
         sig { returns(String) }
         attr_accessor :country
 
-        # Valid postal code. Only USA ZIP codes are currently supported, entered as a
-        # five-digit ZIP or nine-digit ZIP+4.
-        sig { returns(String) }
-        attr_accessor :postal_code
-
-        # Valid state code. Only USA state codes are currently supported, entered in
-        # uppercase ISO 3166-2 two-character format.
-        sig { returns(String) }
-        attr_accessor :state
-
         # Unit or apartment number (if applicable).
         sig { returns(T.nilable(String)) }
         attr_reader :address2
@@ -125,6 +116,31 @@ module Lithic
         sig { params(address2: String).void }
         attr_writer :address2
 
+        # Valid postal code. For USA addresses, enter either a five-digit postal code or a
+        # nine-digit postal code (ZIP+4) using the format 12345-1234. Required for all
+        # countries except the following, which do not use postal codes: ABW, AGO, ARE,
+        # ATG, BDI, BEN, BFA, BHS, BLZ, BOL, BWA, CIV, CMR, COD, COG, COK, COM, DJI, DMA,
+        # ERI, FJI, GAB, GMB, GNQ, GRD, GUY, HKG, KIR, MAC, MLI, MRT, NIU, NRU, QAT, RWA,
+        # SLB, SLE, SSD, SUR, SXM, SYC, TGO, TKL, TLS, TON, TUV, UGA, VUT, YEM, ZWE
+        sig { returns(T.nilable(String)) }
+        attr_accessor :postal_code
+
+        # Valid state, province, or subdivision code, entered as the uppercase ISO 3166-2
+        # code for the country without the country prefix. For example, `CA` for
+        # California. Optional unless the address is in one of the following countries,
+        # where it is required:
+        #
+        # - `USA`
+        # - `CAN`
+        # - `AUS`
+        # - `CHN`
+        # - `KOR`
+        # - `MEX`
+        # - `MYS`
+        # - `NZL`
+        sig { returns(T.nilable(String)) }
+        attr_accessor :state
+
         # Business''s physical address - PO boxes, UPS drops, and FedEx drops are not
         # acceptable; APO/FPO are acceptable.
         sig do
@@ -132,9 +148,9 @@ module Lithic
             address1: String,
             city: String,
             country: String,
-            postal_code: String,
-            state: String,
-            address2: String
+            address2: String,
+            postal_code: T.nilable(String),
+            state: T.nilable(String)
           ).returns(T.attached_class)
         end
         def self.new(
@@ -142,17 +158,33 @@ module Lithic
           address1:,
           # Name of city.
           city:,
-          # Valid country code. Only USA is currently supported, entered in uppercase ISO
-          # 3166-1 alpha-3 three-character format.
+          # Valid country code, entered in uppercase ISO 3166-1 alpha-3 three-character
+          # format. Supported countries depend on the onboarding workflow used for the
+          # account holder.
           country:,
-          # Valid postal code. Only USA ZIP codes are currently supported, entered as a
-          # five-digit ZIP or nine-digit ZIP+4.
-          postal_code:,
-          # Valid state code. Only USA state codes are currently supported, entered in
-          # uppercase ISO 3166-2 two-character format.
-          state:,
           # Unit or apartment number (if applicable).
-          address2: nil
+          address2: nil,
+          # Valid postal code. For USA addresses, enter either a five-digit postal code or a
+          # nine-digit postal code (ZIP+4) using the format 12345-1234. Required for all
+          # countries except the following, which do not use postal codes: ABW, AGO, ARE,
+          # ATG, BDI, BEN, BFA, BHS, BLZ, BOL, BWA, CIV, CMR, COD, COG, COK, COM, DJI, DMA,
+          # ERI, FJI, GAB, GMB, GNQ, GRD, GUY, HKG, KIR, MAC, MLI, MRT, NIU, NRU, QAT, RWA,
+          # SLB, SLE, SSD, SUR, SXM, SYC, TGO, TKL, TLS, TON, TUV, UGA, VUT, YEM, ZWE
+          postal_code: nil,
+          # Valid state, province, or subdivision code, entered as the uppercase ISO 3166-2
+          # code for the country without the country prefix. For example, `CA` for
+          # California. Optional unless the address is in one of the following countries,
+          # where it is required:
+          #
+          # - `USA`
+          # - `CAN`
+          # - `AUS`
+          # - `CHN`
+          # - `KOR`
+          # - `MEX`
+          # - `MYS`
+          # - `NZL`
+          state: nil
         )
         end
 
@@ -162,9 +194,9 @@ module Lithic
               address1: String,
               city: String,
               country: String,
-              postal_code: String,
-              state: String,
-              address2: String
+              address2: String,
+              postal_code: T.nilable(String),
+              state: T.nilable(String)
             }
           )
         end

data/rbi/lithic/models/kyc.rbi

@@ -92,7 +92,8 @@ module Lithic
           end
 
         # Individual's current address - PO boxes, UPS drops, and FedEx drops are not
-        # acceptable; APO/FPO are acceptable. Only USA addresses are currently supported.
+        # acceptable; APO/FPO are acceptable. Only USA addresses are supported for the KYB
+        # and KYC workflows.
         sig { returns(Lithic::Address) }
         attr_reader :address
 
@@ -142,7 +143,8 @@ module Lithic
         end
         def self.new(
           # Individual's current address - PO boxes, UPS drops, and FedEx drops are not
-          # acceptable; APO/FPO are acceptable. Only USA addresses are currently supported.
+          # acceptable; APO/FPO are acceptable. Only USA addresses are supported for the KYB
+          # and KYC workflows.
           address:,
           # Individual's date of birth, as an RFC 3339 date.
           dob:,

data/rbi/lithic/models/non_pci_card.rbi

@@ -78,6 +78,12 @@ module Lithic
       sig { returns(Lithic::NonPCICard::State::TaggedSymbol) }
       attr_accessor :state
 
+      # Key-value pairs for tagging resources. Tags allow you to associate arbitrary
+      # metadata with a resource for your own purposes. A resource can have at most 50
+      # tags, with keys up to 40 characters and values up to 500 characters
+      sig { returns(T::Hash[Symbol, String]) }
+      attr_accessor :tags
+
       # Card types: _ `VIRTUAL` - Card will authorize at any merchant and can be added
       # to a digital wallet like Apple Pay or Google Pay (if the card program is digital
       # wallet-enabled). _ `PHYSICAL` - Manufactured and sent to the cardholder. We
@@ -215,6 +221,7 @@ module Lithic
           spend_limit: Integer,
           spend_limit_duration: Lithic::SpendLimitDuration::OrSymbol,
           state: Lithic::NonPCICard::State::OrSymbol,
+          tags: T::Hash[Symbol, String],
           type: Lithic::NonPCICard::Type::OrSymbol,
           auth_rule_tokens: T::Array[String],
           bulk_order_token: T.nilable(String),
@@ -280,6 +287,10 @@ module Lithic
         # In sandbox, the same daily batch fulfillment occurs, but no cards are actually
         # manufactured.
         state:,
+        # Key-value pairs for tagging resources. Tags allow you to associate arbitrary
+        # metadata with a resource for your own purposes. A resource can have at most 50
+        # tags, with keys up to 40 characters and values up to 500 characters
+        tags:,
         # Card types: _ `VIRTUAL` - Card will authorize at any merchant and can be added
         # to a digital wallet like Apple Pay or Google Pay (if the card program is digital
         # wallet-enabled). _ `PHYSICAL` - Manufactured and sent to the cardholder. We
@@ -366,6 +377,7 @@ module Lithic
             spend_limit: Integer,
             spend_limit_duration: Lithic::SpendLimitDuration::TaggedSymbol,
             state: Lithic::NonPCICard::State::TaggedSymbol,
+            tags: T::Hash[Symbol, String],
             type: Lithic::NonPCICard::Type::TaggedSymbol,
             auth_rule_tokens: T::Array[String],
             bulk_order_token: T.nilable(String),