lithic 0.21.0 → 0.23.0

data/lib/lithic/models/funding_event_list_params.rb

@@ -7,6 +7,20 @@ module Lithic
       extend Lithic::Internal::Type::RequestParameters::Converter
       include Lithic::Internal::Type::RequestParameters
 
+      # @!attribute begin_
+      #   Date string in RFC 3339 format. Only entries created after the specified time
+      #   will be included. UTC time zone.
+      #
+      #   @return [Time, nil]
+      optional :begin_, Time
+
+      # @!attribute end_
+      #   Date string in RFC 3339 format. Only entries created before the specified time
+      #   will be included. UTC time zone.
+      #
+      #   @return [Time, nil]
+      optional :end_, Time
+
       # @!attribute ending_before
       #   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.
@@ -14,6 +28,13 @@ module Lithic
       #   @return [String, nil]
       optional :ending_before, String
 
+      # @!attribute network_settlement_date
+      #   Only funding events with a settlement breakout for this network settlement date
+      #   will be included.
+      #
+      #   @return [Date, nil]
+      optional :network_settlement_date, Date
+
       # @!attribute page_size
       #   Page size (for pagination).
       #
@@ -27,12 +48,18 @@ module Lithic
       #   @return [String, nil]
       optional :starting_after, String
 
-      # @!method initialize(ending_before: nil, page_size: nil, starting_after: nil, request_options: {})
+      # @!method initialize(begin_: nil, end_: nil, ending_before: nil, network_settlement_date: nil, page_size: nil, starting_after: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Lithic::Models::FundingEventListParams} for more details.
       #
+      #   @param begin_ [Time] Date string in RFC 3339 format. Only entries created after the specified time wi
+      #
+      #   @param end_ [Time] Date string in RFC 3339 format. Only entries created before the specified time w
+      #
       #   @param ending_before [String] A cursor representing an item's token before which a page of results should end.
       #
+      #   @param network_settlement_date [Date] Only funding events with a settlement breakout for this network settlement date
+      #
       #   @param page_size [Integer] Page size (for pagination).
       #
       #   @param starting_after [String] A cursor representing an item's token after which a page of results should begin

data/lib/lithic/models/hold.rb

@@ -16,12 +16,6 @@ module Lithic
       #   @return [Time]
       required :created, Time
 
-      # @!attribute status
-      #   Status of a hold transaction
-      #
-      #   @return [Symbol, Lithic::Models::Hold::Status]
-      required :status, enum: -> { Lithic::Hold::Status }
-
       # @!attribute updated
       #   ISO 8601 timestamp of when the transaction was last updated
       #
@@ -66,12 +60,18 @@ module Lithic
       #   @return [Symbol, Lithic::Models::Hold::Result, nil]
       optional :result, enum: -> { Lithic::Hold::Result }
 
+      # @!attribute status
+      #   Status of a hold transaction
+      #
+      #   @return [Symbol, Lithic::Models::Hold::Status, nil]
+      optional :status, enum: -> { Lithic::Hold::Status }
+
       # @!attribute user_defined_id
       #
       #   @return [String, nil]
       optional :user_defined_id, String, nil?: true
 
-      # @!method initialize(token:, created:, status:, updated:, currency: nil, events: nil, expiration_datetime: nil, family: nil, financial_account_token: nil, pending_amount: nil, result: nil, user_defined_id: nil)
+      # @!method initialize(token:, created:, updated:, currency: nil, events: nil, expiration_datetime: nil, family: nil, financial_account_token: nil, pending_amount: nil, result: nil, status: nil, user_defined_id: nil)
       #   A hold transaction representing reserved funds on a financial account. Holds
       #   move funds from available to pending balance in anticipation of future payments.
       #   They can be resolved via settlement (linked to payment), manual release, or
@@ -81,8 +81,6 @@ module Lithic
       #
       #   @param created [Time] ISO 8601 timestamp of when the transaction was created
       #
-      #   @param status [Symbol, Lithic::Models::Hold::Status] Status of a hold transaction
-      #
       #   @param updated [Time] ISO 8601 timestamp of when the transaction was last updated
       #
       #   @param currency [String]
@@ -99,26 +97,9 @@ module Lithic
       #
       #   @param result [Symbol, Lithic::Models::Hold::Result]
       #
-      #   @param user_defined_id [String, nil]
-
-      # Status of a hold transaction
+      #   @param status [Symbol, Lithic::Models::Hold::Status] Status of a hold transaction
       #
-      # @see Lithic::Models::Hold#status
-      module Status
-        extend Lithic::Internal::Type::Enum
-
-        PENDING = :PENDING
-        SETTLED = :SETTLED
-        EXPIRED = :EXPIRED
-        VOIDED = :VOIDED
-        DECLINED = :DECLINED
-        REVERSED = :REVERSED
-        CANCELED = :CANCELED
-        RETURNED = :RETURNED
-
-        # @!method self.values
-        #   @return [Array<Symbol>]
-      end
+      #   @param user_defined_id [String, nil]
 
       # HOLD - Hold Transaction
       #
@@ -142,6 +123,21 @@ module Lithic
         # @!method self.values
         #   @return [Array<Symbol>]
       end
+
+      # Status of a hold transaction
+      #
+      # @see Lithic::Models::Hold#status
+      module Status
+        extend Lithic::Internal::Type::Enum
+
+        PENDING = :PENDING
+        SETTLED = :SETTLED
+        EXPIRED = :EXPIRED
+        VOIDED = :VOIDED
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
     end
   end
 end

data/lib/lithic/models/ip_range_retrieve_params.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Lithic
+  module Models
+    # @see Lithic::Resources::IPRanges#retrieve
+    class IPRangeRetrieveParams < Lithic::Internal::Type::BaseModel
+      extend Lithic::Internal::Type::RequestParameters::Converter
+      include Lithic::Internal::Type::RequestParameters
+
+      # @!method initialize(request_options: {})
+      #   @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/lithic/models/ip_range_retrieve_response.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Lithic
+  module Models
+    # @see Lithic::Resources::IPRanges#retrieve
+    class IPRangeRetrieveResponse < Lithic::Internal::Type::BaseModel
+      # @!attribute responders
+      #   IP ranges that responder requests are sent from, in CIDR notation
+      #
+      #   @return [Array<String>]
+      required :responders, Lithic::Internal::Type::ArrayOf[String]
+
+      # @!attribute updated
+      #   Date and time the IP ranges were last changed
+      #
+      #   @return [Time]
+      required :updated, Time
+
+      # @!method initialize(responders:, updated:)
+      #   @param responders [Array<String>] IP ranges that responder requests are sent from, in CIDR notation
+      #
+      #   @param updated [Time] Date and time the IP ranges were last changed
+    end
+  end
+end

data/lib/lithic/models/kyb.rb

@@ -113,7 +113,8 @@ module Lithic
       class BeneficialOwnerIndividual < Lithic::Internal::Type::BaseModel
         # @!attribute address
         #   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.
         #
         #   @return [Lithic::Models::Address]
         required :address, -> { Lithic::Address }
@@ -246,7 +247,8 @@ module Lithic
       class ControlPerson < Lithic::Internal::Type::BaseModel
         # @!attribute address
         #   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.
         #
         #   @return [Lithic::Models::Address]
         required :address, -> { Lithic::Address }

data/lib/lithic/models/kyb_business_entity.rb

@@ -75,33 +75,49 @@ module Lithic
         required :city, String
 
         # @!attribute country
-        #   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.
         #
         #   @return [String]
         required :country, String
 
+        # @!attribute address2
+        #   Unit or apartment number (if applicable).
+        #
+        #   @return [String, nil]
+        optional :address2, String
+
         # @!attribute postal_code
-        #   Valid postal code. Only USA ZIP codes are currently supported, entered as a
-        #   five-digit ZIP or nine-digit ZIP+4.
+        #   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
         #
-        #   @return [String]
-        required :postal_code, String
+        #   @return [String, nil]
+        optional :postal_code, String, nil?: true
 
         # @!attribute state
-        #   Valid state code. Only USA state codes are currently supported, entered in
-        #   uppercase ISO 3166-2 two-character format.
+        #   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:
         #
-        #   @return [String]
-        required :state, String
-
-        # @!attribute address2
-        #   Unit or apartment number (if applicable).
+        #   - `USA`
+        #   - `CAN`
+        #   - `AUS`
+        #   - `CHN`
+        #   - `KOR`
+        #   - `MEX`
+        #   - `MYS`
+        #   - `NZL`
         #
         #   @return [String, nil]
-        optional :address2, String
+        optional :state, String, nil?: true
 
-        # @!method initialize(address1:, city:, country:, postal_code:, state:, address2: nil)
+        # @!method initialize(address1:, city:, country:, address2: nil, postal_code: nil, state: nil)
         #   Some parameter documentations has been truncated, see
         #   {Lithic::Models::KYBBusinessEntity::Address} for more details.
         #
@@ -112,13 +128,13 @@ module Lithic
         #
         #   @param city [String] Name of city.
         #
-        #   @param country [String] Valid country code. Only USA is currently supported, entered in uppercase ISO 31
+        #   @param country [String] Valid country code, entered in uppercase ISO 3166-1 alpha-3 three-character form
         #
-        #   @param postal_code [String] Valid postal code. Only USA ZIP codes are currently supported, entered as a five
+        #   @param address2 [String] Unit or apartment number (if applicable).
         #
-        #   @param state [String] Valid state code. Only USA state codes are currently supported, entered in upper
+        #   @param postal_code [String, nil] Valid postal code. For USA addresses, enter either a five-digit postal code or a
         #
-        #   @param address2 [String] Unit or apartment number (if applicable).
+        #   @param state [String, nil] Valid state, province, or subdivision code, entered as the uppercase ISO 3166-2
       end
     end
   end

data/lib/lithic/models/kyc.rb

@@ -58,7 +58,8 @@ module Lithic
       class Individual < Lithic::Internal::Type::BaseModel
         # @!attribute address
         #   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.
         #
         #   @return [Lithic::Models::Address]
         required :address, -> { Lithic::Address }

data/lib/lithic/models/non_pci_card.rb

@@ -91,6 +91,14 @@ module Lithic
       #   @return [Symbol, Lithic::Models::NonPCICard::State]
       required :state, enum: -> { Lithic::NonPCICard::State }
 
+      # @!attribute tags
+      #   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
+      #
+      #   @return [Hash{Symbol=>String}]
+      required :tags, Lithic::Internal::Type::HashOf[String]
+
       # @!attribute type
       #   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
@@ -223,7 +231,7 @@ module Lithic
       #   @return [Symbol, Lithic::Models::NonPCICard::Substatus, nil]
       optional :substatus, enum: -> { Lithic::NonPCICard::Substatus }, nil?: true
 
-      # @!method initialize(token:, account_token:, card_program_token:, created:, funding:, last_four:, pin_status:, spend_limit:, spend_limit_duration:, state:, type:, auth_rule_tokens: nil, bulk_order_token: nil, cardholder_currency: nil, comment: nil, digital_card_art_token: nil, exp_month: nil, exp_year: nil, hostname: nil, memo: nil, network_program_token: nil, pending_commands: nil, product_id: nil, replacement_for: nil, substatus: nil)
+      # @!method initialize(token:, account_token:, card_program_token:, created:, funding:, last_four:, pin_status:, spend_limit:, spend_limit_duration:, state:, tags:, type:, auth_rule_tokens: nil, bulk_order_token: nil, cardholder_currency: nil, comment: nil, digital_card_art_token: nil, exp_month: nil, exp_year: nil, hostname: nil, memo: nil, network_program_token: nil, pending_commands: nil, product_id: nil, replacement_for: nil, substatus: nil)
       #   Some parameter documentations has been truncated, see
       #   {Lithic::Models::NonPCICard} for more details.
       #
@@ -250,6 +258,8 @@ module Lithic
       #   @param state [Symbol, Lithic::Models::NonPCICard::State] Card state values: \* `CLOSED` - Card will no longer approve authorizations.
       #   Clos
       #
+      #   @param tags [Hash{Symbol=>String}] Key-value pairs for tagging resources. Tags allow you to associate arbitrary met
+      #
       #   @param type [Symbol, Lithic::Models::NonPCICard::Type] Card types: \* `VIRTUAL` - Card will authorize at any merchant and can be added
       #   t
       #

data/lib/lithic/models/parsed_webhook_event.rb

@@ -273,7 +273,8 @@ module Lithic
           class BeneficialOwnerIndividual < Lithic::Internal::Type::BaseModel
             # @!attribute address
             #   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.
             #
             #   @return [Lithic::Models::ParsedWebhookEvent::KYBPayload::UpdateRequest::BeneficialOwnerIndividual::Address, nil]
             optional :address,
@@ -342,51 +343,68 @@ module Lithic
               required :city, String
 
               # @!attribute country
-              #   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.
               #
               #   @return [String]
               required :country, String
 
-              # @!attribute postal_code
-              #   Valid postal code. Only USA ZIP codes are currently supported, entered as a
-              #   five-digit ZIP or nine-digit ZIP+4.
+              # @!attribute address2
+              #   Unit or apartment number (if applicable).
               #
-              #   @return [String]
-              required :postal_code, String
+              #   @return [String, nil]
+              optional :address2, String
 
-              # @!attribute state
-              #   Valid state code. Only USA state codes are currently supported, entered in
-              #   uppercase ISO 3166-2 two-character format.
+              # @!attribute postal_code
+              #   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
               #
-              #   @return [String]
-              required :state, String
+              #   @return [String, nil]
+              optional :postal_code, String, nil?: true
 
-              # @!attribute address2
-              #   Unit or apartment number (if applicable).
+              # @!attribute state
+              #   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`
               #
               #   @return [String, nil]
-              optional :address2, String
+              optional :state, String, nil?: true
 
-              # @!method initialize(address1:, city:, country:, postal_code:, state:, address2: nil)
+              # @!method initialize(address1:, city:, country:, address2: nil, postal_code: nil, state: nil)
               #   Some parameter documentations has been truncated, see
               #   {Lithic::Models::ParsedWebhookEvent::KYBPayload::UpdateRequest::BeneficialOwnerIndividual::Address}
               #   for more details.
               #
               #   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.
               #
               #   @param address1 [String] Valid deliverable address (no PO boxes).
               #
               #   @param city [String] Name of city.
               #
-              #   @param country [String] Valid country code. Only USA is currently supported, entered in uppercase ISO 31
+              #   @param country [String] Valid country code, entered in uppercase ISO 3166-1 alpha-3 three-character form
               #
-              #   @param postal_code [String] Valid postal code. Only USA ZIP codes are currently supported, entered as a five
+              #   @param address2 [String] Unit or apartment number (if applicable).
               #
-              #   @param state [String] Valid state code. Only USA state codes are currently supported, entered in upper
+              #   @param postal_code [String, nil] Valid postal code. For USA addresses, enter either a five-digit postal code or a
               #
-              #   @param address2 [String] Unit or apartment number (if applicable).
+              #   @param state [String, nil] Valid state, province, or subdivision code, entered as the uppercase ISO 3166-2
             end
           end
 
@@ -394,7 +412,8 @@ module Lithic
           class ControlPerson < Lithic::Internal::Type::BaseModel
             # @!attribute address
             #   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.
             #
             #   @return [Lithic::Models::ParsedWebhookEvent::KYBPayload::UpdateRequest::ControlPerson::Address, nil]
             optional :address, -> { Lithic::ParsedWebhookEvent::KYBPayload::UpdateRequest::ControlPerson::Address }
@@ -471,51 +490,68 @@ module Lithic
               required :city, String
 
               # @!attribute country
-              #   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.
               #
               #   @return [String]
               required :country, String
 
-              # @!attribute postal_code
-              #   Valid postal code. Only USA ZIP codes are currently supported, entered as a
-              #   five-digit ZIP or nine-digit ZIP+4.
+              # @!attribute address2
+              #   Unit or apartment number (if applicable).
               #
-              #   @return [String]
-              required :postal_code, String
+              #   @return [String, nil]
+              optional :address2, String
 
-              # @!attribute state
-              #   Valid state code. Only USA state codes are currently supported, entered in
-              #   uppercase ISO 3166-2 two-character format.
+              # @!attribute postal_code
+              #   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
               #
-              #   @return [String]
-              required :state, String
+              #   @return [String, nil]
+              optional :postal_code, String, nil?: true
 
-              # @!attribute address2
-              #   Unit or apartment number (if applicable).
+              # @!attribute state
+              #   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`
               #
               #   @return [String, nil]
-              optional :address2, String
+              optional :state, String, nil?: true
 
-              # @!method initialize(address1:, city:, country:, postal_code:, state:, address2: nil)
+              # @!method initialize(address1:, city:, country:, address2: nil, postal_code: nil, state: nil)
               #   Some parameter documentations has been truncated, see
               #   {Lithic::Models::ParsedWebhookEvent::KYBPayload::UpdateRequest::ControlPerson::Address}
               #   for more details.
               #
               #   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.
               #
               #   @param address1 [String] Valid deliverable address (no PO boxes).
               #
               #   @param city [String] Name of city.
               #
-              #   @param country [String] Valid country code. Only USA is currently supported, entered in uppercase ISO 31
+              #   @param country [String] Valid country code, entered in uppercase ISO 3166-1 alpha-3 three-character form
               #
-              #   @param postal_code [String] Valid postal code. Only USA ZIP codes are currently supported, entered as a five
+              #   @param address2 [String] Unit or apartment number (if applicable).
               #
-              #   @param state [String] Valid state code. Only USA state codes are currently supported, entered in upper
+              #   @param postal_code [String, nil] Valid postal code. For USA addresses, enter either a five-digit postal code or a
               #
-              #   @param address2 [String] Unit or apartment number (if applicable).
+              #   @param state [String, nil] Valid state, province, or subdivision code, entered as the uppercase ISO 3166-2
             end
           end
         end
@@ -595,7 +631,8 @@ module Lithic
           class Individual < Lithic::Internal::Type::BaseModel
             # @!attribute address
             #   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.
             #
             #   @return [Lithic::Models::ParsedWebhookEvent::KYCPayload::UpdateRequest::Individual::Address, nil]
             optional :address, -> { Lithic::ParsedWebhookEvent::KYCPayload::UpdateRequest::Individual::Address }
@@ -666,51 +703,68 @@ module Lithic
               required :city, String
 
               # @!attribute country
-              #   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.
               #
               #   @return [String]
               required :country, String
 
-              # @!attribute postal_code
-              #   Valid postal code. Only USA ZIP codes are currently supported, entered as a
-              #   five-digit ZIP or nine-digit ZIP+4.
+              # @!attribute address2
+              #   Unit or apartment number (if applicable).
               #
-              #   @return [String]
-              required :postal_code, String
+              #   @return [String, nil]
+              optional :address2, String
 
-              # @!attribute state
-              #   Valid state code. Only USA state codes are currently supported, entered in
-              #   uppercase ISO 3166-2 two-character format.
+              # @!attribute postal_code
+              #   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
               #
-              #   @return [String]
-              required :state, String
+              #   @return [String, nil]
+              optional :postal_code, String, nil?: true
 
-              # @!attribute address2
-              #   Unit or apartment number (if applicable).
+              # @!attribute state
+              #   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`
               #
               #   @return [String, nil]
-              optional :address2, String
+              optional :state, String, nil?: true
 
-              # @!method initialize(address1:, city:, country:, postal_code:, state:, address2: nil)
+              # @!method initialize(address1:, city:, country:, address2: nil, postal_code: nil, state: nil)
               #   Some parameter documentations has been truncated, see
               #   {Lithic::Models::ParsedWebhookEvent::KYCPayload::UpdateRequest::Individual::Address}
               #   for more details.
               #
               #   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.
               #
               #   @param address1 [String] Valid deliverable address (no PO boxes).
               #
               #   @param city [String] Name of city.
               #
-              #   @param country [String] Valid country code. Only USA is currently supported, entered in uppercase ISO 31
+              #   @param country [String] Valid country code, entered in uppercase ISO 3166-1 alpha-3 three-character form
               #
-              #   @param postal_code [String] Valid postal code. Only USA ZIP codes are currently supported, entered as a five
+              #   @param address2 [String] Unit or apartment number (if applicable).
               #
-              #   @param state [String] Valid state code. Only USA state codes are currently supported, entered in upper
+              #   @param postal_code [String, nil] Valid postal code. For USA addresses, enter either a five-digit postal code or a
               #
-              #   @param address2 [String] Unit or apartment number (if applicable).
+              #   @param state [String, nil] Valid state, province, or subdivision code, entered as the uppercase ISO 3166-2
             end
           end
         end