lithic 0.20.0 → 0.22.0

data/lib/lithic.rb

@@ -120,6 +120,9 @@ require_relative "lithic/models/api_status"
 require_relative "lithic/models/auth_rules/ach_payment_update_action"
 require_relative "lithic/models/auth_rules/auth_rule"
 require_relative "lithic/models/auth_rules/auth_rule_condition"
+require_relative "lithic/models/auth_rules/auth_rule_entities"
+require_relative "lithic/models/auth_rules/auth_rule_entities_response"
+require_relative "lithic/models/auth_rules/auth_rule_entity"
 require_relative "lithic/models/auth_rules/auth_rule_version"
 require_relative "lithic/models/auth_rules/backtest_stats"
 require_relative "lithic/models/auth_rules/card_transaction_update_action"
@@ -129,7 +132,6 @@ require_relative "lithic/models/auth_rules/conditional_ach_payment_update_action
 require_relative "lithic/models/auth_rules/conditional_attribute"
 require_relative "lithic/models/auth_rules/conditional_authorization_action_parameters"
 require_relative "lithic/models/auth_rules/conditional_authorization_adjustment_parameters"
-require_relative "lithic/models/auth_rules/conditional_block_parameters"
 require_relative "lithic/models/auth_rules/conditional_card_transaction_update_action_parameters"
 require_relative "lithic/models/auth_rules/conditional_operation"
 require_relative "lithic/models/auth_rules/conditional_tokenization_action_parameters"
@@ -157,6 +159,7 @@ require_relative "lithic/models/auth_rules/v2_retrieve_features_response"
 require_relative "lithic/models/auth_rules/v2_retrieve_params"
 require_relative "lithic/models/auth_rules/v2_retrieve_report_params"
 require_relative "lithic/models/auth_rules/v2_retrieve_report_response"
+require_relative "lithic/models/auth_rules/v2_update_entities_params"
 require_relative "lithic/models/auth_rules/v2_update_params"
 require_relative "lithic/models/auth_rules/velocity_limit_params"
 require_relative "lithic/models/auth_rules/velocity_limit_period"
@@ -169,6 +172,7 @@ require_relative "lithic/models/balance_list_params"
 require_relative "lithic/models/balance_updated_webhook_event"
 require_relative "lithic/models/blockchain_recipient"
 require_relative "lithic/models/blockchain_recipient_create_params"
+require_relative "lithic/models/blockchain_recipient_retrieve_params"
 require_relative "lithic/models/book_transfer_create_params"
 require_relative "lithic/models/book_transfer_list_params"
 require_relative "lithic/models/book_transfer_retrieve_params"
@@ -194,6 +198,7 @@ require_relative "lithic/models/card_embed_params"
 require_relative "lithic/models/card_embed_response"
 require_relative "lithic/models/cardholder_authentication"
 require_relative "lithic/models/card_list_params"
+require_relative "lithic/models/card_pin_updated_webhook_event"
 require_relative "lithic/models/card_program"
 require_relative "lithic/models/card_program_list_params"
 require_relative "lithic/models/card_program_retrieve_params"
@@ -322,9 +327,16 @@ require_relative "lithic/models/financial_accounts/credit_configuration_retrieve
 require_relative "lithic/models/financial_accounts/credit_configuration_update_params"
 require_relative "lithic/models/financial_accounts/financial_account_credit_config"
 require_relative "lithic/models/financial_accounts/loan_tape_configuration"
+require_relative "lithic/models/financial_accounts/open_to_buy"
 require_relative "lithic/models/financial_accounts/statements"
 require_relative "lithic/models/financial_accounts/financial_transaction_list_params"
 require_relative "lithic/models/financial_accounts/financial_transaction_retrieve_params"
+require_relative "lithic/models/financial_accounts/installment_plan"
+require_relative "lithic/models/financial_accounts/installment_plan_list_params"
+require_relative "lithic/models/financial_accounts/installment_plan_retrieve_params"
+require_relative "lithic/models/financial_accounts/installment_plans/installment_plan_statement"
+require_relative "lithic/models/financial_accounts/installment_plans/statement_list_params"
+require_relative "lithic/models/financial_accounts/installment_plans/statement_retrieve_params"
 require_relative "lithic/models/financial_accounts/interest_tier_schedule_create_params"
 require_relative "lithic/models/financial_accounts/interest_tier_schedule_delete_params"
 require_relative "lithic/models/financial_accounts/interest_tier_schedule_list_params"
@@ -334,10 +346,13 @@ require_relative "lithic/models/financial_accounts/loan_tape_configuration_retri
 require_relative "lithic/models/financial_accounts/loan_tape_list_params"
 require_relative "lithic/models/financial_accounts/loan_tape_rebuild_configuration"
 require_relative "lithic/models/financial_accounts/loan_tape_retrieve_params"
+require_relative "lithic/models/financial_accounts/open_to_buy_retrieve_params"
+require_relative "lithic/models/financial_accounts/open_to_buy_summary"
 require_relative "lithic/models/financial_accounts/statement_list_params"
 require_relative "lithic/models/financial_accounts/statement_retrieve_params"
 require_relative "lithic/models/financial_accounts/statements/line_item_list_params"
 require_relative "lithic/models/financial_accounts/statements/statement_line_items"
+require_relative "lithic/models/financial_accounts/transaction_category_balances"
 require_relative "lithic/models/financial_account_updated_webhook_event"
 require_relative "lithic/models/financial_account_update_params"
 require_relative "lithic/models/financial_account_update_status_params"
@@ -383,6 +398,8 @@ require_relative "lithic/models/owner_type"
 require_relative "lithic/models/parsed_webhook_event"
 require_relative "lithic/models/payment_create_params"
 require_relative "lithic/models/payment_create_response"
+require_relative "lithic/models/payment_create_stablecoin_params"
+require_relative "lithic/models/payment_create_stablecoin_response"
 require_relative "lithic/models/payment_list_params"
 require_relative "lithic/models/payment_retrieve_params"
 require_relative "lithic/models/payment_retry_params"
@@ -550,9 +567,12 @@ require_relative "lithic/resources/financial_accounts"
 require_relative "lithic/resources/financial_accounts/balances"
 require_relative "lithic/resources/financial_accounts/credit_configuration"
 require_relative "lithic/resources/financial_accounts/financial_transactions"
+require_relative "lithic/resources/financial_accounts/installment_plans"
+require_relative "lithic/resources/financial_accounts/installment_plans/statements"
 require_relative "lithic/resources/financial_accounts/interest_tier_schedule"
 require_relative "lithic/resources/financial_accounts/loan_tape_configuration"
 require_relative "lithic/resources/financial_accounts/loan_tapes"
+require_relative "lithic/resources/financial_accounts/open_to_buy"
 require_relative "lithic/resources/financial_accounts/statements"
 require_relative "lithic/resources/financial_accounts/statements/line_items"
 require_relative "lithic/resources/fraud"

data/rbi/lithic/models/account_activity_list_params.rbi

@@ -250,6 +250,11 @@ module Lithic
             :EXTERNAL_RTP,
             Lithic::AccountActivityListParams::Category::TaggedSymbol
           )
+        EXTERNAL_STABLECOIN =
+          T.let(
+            :EXTERNAL_STABLECOIN,
+            Lithic::AccountActivityListParams::Category::TaggedSymbol
+          )
         EXTERNAL_TRANSFER =
           T.let(
             :EXTERNAL_TRANSFER,

data/rbi/lithic/models/account_activity_list_response.rbi

@@ -256,6 +256,11 @@ module Lithic
               :EXTERNAL_RTP,
               Lithic::Models::AccountActivityListResponse::Internal::Category::TaggedSymbol
             )
+          EXTERNAL_STABLECOIN =
+            T.let(
+              :EXTERNAL_STABLECOIN,
+              Lithic::Models::AccountActivityListResponse::Internal::Category::TaggedSymbol
+            )
           EXTERNAL_TRANSFER =
             T.let(
               :EXTERNAL_TRANSFER,

data/rbi/lithic/models/account_activity_retrieve_transaction_response.rbi

@@ -256,6 +256,11 @@ module Lithic
               :EXTERNAL_RTP,
               Lithic::Models::AccountActivityRetrieveTransactionResponse::Internal::Category::TaggedSymbol
             )
+          EXTERNAL_STABLECOIN =
+            T.let(
+              :EXTERNAL_STABLECOIN,
+              Lithic::Models::AccountActivityRetrieveTransactionResponse::Internal::Category::TaggedSymbol
+            )
           EXTERNAL_TRANSFER =
             T.let(
               :EXTERNAL_TRANSFER,

data/rbi/lithic/models/account_holder_create_params.rbi

@@ -406,7 +406,8 @@ module Lithic
             attr_accessor :last_name
 
             # 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(T.nilable(Lithic::Address)) }
             attr_reader :address
 
@@ -464,7 +465,8 @@ module Lithic
               # Individual's last name, as it appears on government-issued identity documents.
               last_name:,
               # 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: nil,
               # Individual's date of birth, as an RFC 3339 date.
               dob: nil,
@@ -516,7 +518,8 @@ module Lithic
             attr_accessor :last_name
 
             # 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(T.nilable(Lithic::Address)) }
             attr_reader :address
 
@@ -580,7 +583,8 @@ module Lithic
               # Individual's last name, as it appears on government-issued identity documents.
               last_name:,
               # 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: nil,
               # Individual's date of birth, as an RFC 3339 date.
               dob: nil,

data/rbi/lithic/models/account_holder_simulate_enrollment_review_response.rbi

@@ -445,7 +445,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 do
           returns(
             T.nilable(
@@ -512,7 +513,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: nil,
           # Individual's date of birth, as an RFC 3339 date.
           dob: nil,
@@ -562,21 +564,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
@@ -584,16 +577,42 @@ 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
+
           # 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 do
             params(
               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(
@@ -601,17 +620,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
 
@@ -621,9 +656,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
@@ -642,7 +677,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 do
           returns(
             T.nilable(
@@ -720,7 +756,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: nil,
           # Individual's date of birth, as an RFC 3339 date.
           dob: nil,
@@ -770,21 +807,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
@@ -792,16 +820,42 @@ 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
+
           # 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 do
             params(
               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(
@@ -809,17 +863,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
 
@@ -829,9 +899,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
@@ -886,7 +956,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 do
           returns(
             T.nilable(
@@ -955,7 +1026,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: nil,
           # Individual's date of birth, as an RFC 3339 date.
           dob: nil,
@@ -1005,21 +1077,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
@@ -1027,16 +1090,42 @@ 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
+
           # 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 do
             params(
               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(
@@ -1044,17 +1133,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
 
@@ -1064,9 +1169,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