lithic 0.20.0 → 0.22.0

data/lib/lithic/models/financial_accounts/transaction_category_balances.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Lithic
+  module Models
+    module FinancialAccounts
+      class TransactionCategoryBalances < Lithic::Internal::Type::BaseModel
+        # @!attribute balance_transfers
+        #   Amounts attributable to balance transfers
+        #
+        #   @return [Lithic::Models::FinancialAccounts::CategoryBalances]
+        required :balance_transfers, -> { Lithic::FinancialAccounts::CategoryBalances }
+
+        # @!attribute cash_advances
+        #   Amounts attributable to cash advances
+        #
+        #   @return [Lithic::Models::FinancialAccounts::CategoryBalances]
+        required :cash_advances, -> { Lithic::FinancialAccounts::CategoryBalances }
+
+        # @!attribute purchases
+        #   Amounts attributable to purchases
+        #
+        #   @return [Lithic::Models::FinancialAccounts::CategoryBalances]
+        required :purchases, -> { Lithic::FinancialAccounts::CategoryBalances }
+
+        # @!method initialize(balance_transfers:, cash_advances:, purchases:)
+        #   @param balance_transfers [Lithic::Models::FinancialAccounts::CategoryBalances] Amounts attributable to balance transfers
+        #
+        #   @param cash_advances [Lithic::Models::FinancialAccounts::CategoryBalances] Amounts attributable to cash advances
+        #
+        #   @param purchases [Lithic::Models::FinancialAccounts::CategoryBalances] Amounts attributable to purchases
+      end
+    end
+  end
+end

data/lib/lithic/models/financial_event.rb

@@ -121,6 +121,11 @@ module Lithic
         EXTERNAL_RTP_RELEASED = :EXTERNAL_RTP_RELEASED
         EXTERNAL_RTP_REVERSED = :EXTERNAL_RTP_REVERSED
         EXTERNAL_RTP_SETTLED = :EXTERNAL_RTP_SETTLED
+        EXTERNAL_STABLECOIN_CANCELED = :EXTERNAL_STABLECOIN_CANCELED
+        EXTERNAL_STABLECOIN_INITIATED = :EXTERNAL_STABLECOIN_INITIATED
+        EXTERNAL_STABLECOIN_RELEASED = :EXTERNAL_STABLECOIN_RELEASED
+        EXTERNAL_STABLECOIN_REVERSED = :EXTERNAL_STABLECOIN_REVERSED
+        EXTERNAL_STABLECOIN_SETTLED = :EXTERNAL_STABLECOIN_SETTLED
         EXTERNAL_TRANSFER_CANCELED = :EXTERNAL_TRANSFER_CANCELED
         EXTERNAL_TRANSFER_INITIATED = :EXTERNAL_TRANSFER_INITIATED
         EXTERNAL_TRANSFER_RELEASED = :EXTERNAL_TRANSFER_RELEASED
@@ -131,8 +136,12 @@ module Lithic
         EXTERNAL_WIRE_RELEASED = :EXTERNAL_WIRE_RELEASED
         EXTERNAL_WIRE_REVERSED = :EXTERNAL_WIRE_REVERSED
         EXTERNAL_WIRE_SETTLED = :EXTERNAL_WIRE_SETTLED
+        FEE = :FEE
+        FEE_REVERSAL = :FEE_REVERSAL
         FINANCIAL_AUTHORIZATION = :FINANCIAL_AUTHORIZATION
         FINANCIAL_CREDIT_AUTHORIZATION = :FINANCIAL_CREDIT_AUTHORIZATION
+        INSTALLMENT_FEE = :INSTALLMENT_FEE
+        INSTALLMENT_FEE_REVERSAL = :INSTALLMENT_FEE_REVERSAL
         INTEREST = :INTEREST
         INTEREST_REVERSAL = :INTEREST_REVERSAL
         INTERNAL_ADJUSTMENT = :INTERNAL_ADJUSTMENT

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/management_operation_create_params.rb

@@ -126,6 +126,8 @@ module Lithic
         CURRENCY_CONVERSION_REVERSAL = :CURRENCY_CONVERSION_REVERSAL
         INTEREST = :INTEREST
         INTEREST_REVERSAL = :INTEREST_REVERSAL
+        INSTALLMENT_FEE = :INSTALLMENT_FEE
+        INSTALLMENT_FEE_REVERSAL = :INSTALLMENT_FEE_REVERSAL
         LATE_PAYMENT = :LATE_PAYMENT
         LATE_PAYMENT_REVERSAL = :LATE_PAYMENT_REVERSAL
         BILLING_ERROR = :BILLING_ERROR
@@ -144,6 +146,8 @@ module Lithic
         QUARTERLY_REVERSAL = :QUARTERLY_REVERSAL
         MONTHLY = :MONTHLY
         MONTHLY_REVERSAL = :MONTHLY_REVERSAL
+        FEE = :FEE
+        FEE_REVERSAL = :FEE_REVERSAL
 
         # @!method self.values
         #   @return [Array<Symbol>]

data/lib/lithic/models/management_operation_transaction.rb

@@ -259,6 +259,8 @@ module Lithic
           CURRENCY_CONVERSION_REVERSAL = :CURRENCY_CONVERSION_REVERSAL
           INTEREST = :INTEREST
           INTEREST_REVERSAL = :INTEREST_REVERSAL
+          INSTALLMENT_FEE = :INSTALLMENT_FEE
+          INSTALLMENT_FEE_REVERSAL = :INSTALLMENT_FEE_REVERSAL
           LATE_PAYMENT = :LATE_PAYMENT
           LATE_PAYMENT_REVERSAL = :LATE_PAYMENT_REVERSAL
           BILLING_ERROR = :BILLING_ERROR
@@ -277,6 +279,8 @@ module Lithic
           QUARTERLY_REVERSAL = :QUARTERLY_REVERSAL
           MONTHLY = :MONTHLY
           MONTHLY_REVERSAL = :MONTHLY_REVERSAL
+          FEE = :FEE
+          FEE_REVERSAL = :FEE_REVERSAL
 
           # @!method self.values
           #   @return [Array<Symbol>]

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

@@ -42,6 +42,8 @@ module Lithic
 
       variant -> { Lithic::CardConvertedWebhookEvent }
 
+      variant -> { Lithic::CardPinUpdatedWebhookEvent }
+
       variant -> { Lithic::CardRenewedWebhookEvent }
 
       variant -> { Lithic::CardReissuedWebhookEvent }
@@ -271,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,
@@ -340,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
 
@@ -392,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 }
@@ -469,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
@@ -593,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 }
@@ -664,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
@@ -830,7 +886,7 @@ module Lithic
       end
 
       # @!method self.variants
-      #   @return [Array(Lithic::Models::AccountHolderCreatedWebhookEvent, Lithic::Models::ParsedWebhookEvent::KYBPayload, Lithic::Models::ParsedWebhookEvent::KYCPayload, Lithic::Models::ParsedWebhookEvent::LegacyPayload, Lithic::Models::AccountHolderVerificationWebhookEvent, Lithic::Models::AccountHolderDocumentUpdatedWebhookEvent, Lithic::Models::CardAuthorizationApprovalRequestWebhookEvent, Lithic::Models::CardAuthorizationChallengeWebhookEvent, Lithic::Models::CardAuthorizationChallengeResponseWebhookEvent, Lithic::Models::AuthRulesBacktestReportCreatedWebhookEvent, Lithic::Models::BalanceUpdatedWebhookEvent, Lithic::Models::BookTransferTransactionCreatedWebhookEvent, Lithic::Models::BookTransferTransactionUpdatedWebhookEvent, Lithic::Models::CardCreatedWebhookEvent, Lithic::Models::CardConvertedWebhookEvent, Lithic::Models::CardRenewedWebhookEvent, Lithic::Models::CardReissuedWebhookEvent, Lithic::Models::CardShippedWebhookEvent, Lithic::Models::CardUpdatedWebhookEvent, Lithic::Models::CardTransactionUpdatedWebhookEvent, Lithic::Models::CardTransactionEnhancedDataCreatedWebhookEvent, Lithic::Models::CardTransactionEnhancedDataUpdatedWebhookEvent, Lithic::Models::ClaimCreatedWebhookEvent, Lithic::Models::ClaimUpdatedWebhookEvent, Lithic::Models::ClaimDocumentUploadedWebhookEvent, Lithic::Models::ClaimDocumentAcceptedWebhookEvent, Lithic::Models::ClaimDocumentRejectedWebhookEvent, Lithic::Models::DigitalWalletTokenizationApprovalRequestWebhookEvent, Lithic::Models::DigitalWalletTokenizationResultWebhookEvent, Lithic::Models::DigitalWalletTokenizationTwoFactorAuthenticationCodeWebhookEvent, Lithic::Models::DigitalWalletTokenizationTwoFactorAuthenticationCodeSentWebhookEvent, Lithic::Models::DigitalWalletTokenizationUpdatedWebhookEvent, Lithic::Models::DisputeUpdatedWebhookEvent, Lithic::Models::DisputeEvidenceUploadFailedWebhookEvent, Lithic::Models::EmbedSessionGeneratedWebhookEvent, Lithic::Models::EmbedViewedWebhookEvent, Lithic::Models::ExternalBankAccountCreatedWebhookEvent, Lithic::Models::ExternalBankAccountUpdatedWebhookEvent, Lithic::Models::ExternalPaymentCreatedWebhookEvent, Lithic::Models::ExternalPaymentUpdatedWebhookEvent, Lithic::Models::FinancialAccountCreatedWebhookEvent, Lithic::Models::FinancialAccountUpdatedWebhookEvent, Lithic::Models::FundingEventCreatedWebhookEvent, Lithic::Models::LoanTapeCreatedWebhookEvent, Lithic::Models::LoanTapeUpdatedWebhookEvent, Lithic::Models::ManagementOperationCreatedWebhookEvent, Lithic::Models::ManagementOperationUpdatedWebhookEvent, Lithic::Models::InternalTransactionCreatedWebhookEvent, Lithic::Models::InternalTransactionUpdatedWebhookEvent, Lithic::Models::NetworkTotalCreatedWebhookEvent, Lithic::Models::NetworkTotalUpdatedWebhookEvent, Lithic::Models::PaymentTransactionCreatedWebhookEvent, Lithic::Models::PaymentTransactionUpdatedWebhookEvent, Lithic::Models::SettlementReportUpdatedWebhookEvent, Lithic::Models::StatementsCreatedWebhookEvent, Lithic::Models::ThreeDSAuthenticationCreatedWebhookEvent, Lithic::Models::ThreeDSAuthenticationUpdatedWebhookEvent, Lithic::Models::ThreeDSAuthenticationChallengeWebhookEvent, Lithic::Models::TokenizationApprovalRequestWebhookEvent, Lithic::Models::TokenizationResultWebhookEvent, Lithic::Models::TokenizationTwoFactorAuthenticationCodeWebhookEvent, Lithic::Models::TokenizationTwoFactorAuthenticationCodeSentWebhookEvent, Lithic::Models::TokenizationUpdatedWebhookEvent, Lithic::Models::ThreeDSAuthenticationApprovalRequestWebhookEvent, Lithic::Models::DisputeTransactionCreatedWebhookEvent, Lithic::Models::DisputeTransactionUpdatedWebhookEvent)]
+      #   @return [Array(Lithic::Models::AccountHolderCreatedWebhookEvent, Lithic::Models::ParsedWebhookEvent::KYBPayload, Lithic::Models::ParsedWebhookEvent::KYCPayload, Lithic::Models::ParsedWebhookEvent::LegacyPayload, Lithic::Models::AccountHolderVerificationWebhookEvent, Lithic::Models::AccountHolderDocumentUpdatedWebhookEvent, Lithic::Models::CardAuthorizationApprovalRequestWebhookEvent, Lithic::Models::CardAuthorizationChallengeWebhookEvent, Lithic::Models::CardAuthorizationChallengeResponseWebhookEvent, Lithic::Models::AuthRulesBacktestReportCreatedWebhookEvent, Lithic::Models::BalanceUpdatedWebhookEvent, Lithic::Models::BookTransferTransactionCreatedWebhookEvent, Lithic::Models::BookTransferTransactionUpdatedWebhookEvent, Lithic::Models::CardCreatedWebhookEvent, Lithic::Models::CardConvertedWebhookEvent, Lithic::Models::CardPinUpdatedWebhookEvent, Lithic::Models::CardRenewedWebhookEvent, Lithic::Models::CardReissuedWebhookEvent, Lithic::Models::CardShippedWebhookEvent, Lithic::Models::CardUpdatedWebhookEvent, Lithic::Models::CardTransactionUpdatedWebhookEvent, Lithic::Models::CardTransactionEnhancedDataCreatedWebhookEvent, Lithic::Models::CardTransactionEnhancedDataUpdatedWebhookEvent, Lithic::Models::ClaimCreatedWebhookEvent, Lithic::Models::ClaimUpdatedWebhookEvent, Lithic::Models::ClaimDocumentUploadedWebhookEvent, Lithic::Models::ClaimDocumentAcceptedWebhookEvent, Lithic::Models::ClaimDocumentRejectedWebhookEvent, Lithic::Models::DigitalWalletTokenizationApprovalRequestWebhookEvent, Lithic::Models::DigitalWalletTokenizationResultWebhookEvent, Lithic::Models::DigitalWalletTokenizationTwoFactorAuthenticationCodeWebhookEvent, Lithic::Models::DigitalWalletTokenizationTwoFactorAuthenticationCodeSentWebhookEvent, Lithic::Models::DigitalWalletTokenizationUpdatedWebhookEvent, Lithic::Models::DisputeUpdatedWebhookEvent, Lithic::Models::DisputeEvidenceUploadFailedWebhookEvent, Lithic::Models::EmbedSessionGeneratedWebhookEvent, Lithic::Models::EmbedViewedWebhookEvent, Lithic::Models::ExternalBankAccountCreatedWebhookEvent, Lithic::Models::ExternalBankAccountUpdatedWebhookEvent, Lithic::Models::ExternalPaymentCreatedWebhookEvent, Lithic::Models::ExternalPaymentUpdatedWebhookEvent, Lithic::Models::FinancialAccountCreatedWebhookEvent, Lithic::Models::FinancialAccountUpdatedWebhookEvent, Lithic::Models::FundingEventCreatedWebhookEvent, Lithic::Models::LoanTapeCreatedWebhookEvent, Lithic::Models::LoanTapeUpdatedWebhookEvent, Lithic::Models::ManagementOperationCreatedWebhookEvent, Lithic::Models::ManagementOperationUpdatedWebhookEvent, Lithic::Models::InternalTransactionCreatedWebhookEvent, Lithic::Models::InternalTransactionUpdatedWebhookEvent, Lithic::Models::NetworkTotalCreatedWebhookEvent, Lithic::Models::NetworkTotalUpdatedWebhookEvent, Lithic::Models::PaymentTransactionCreatedWebhookEvent, Lithic::Models::PaymentTransactionUpdatedWebhookEvent, Lithic::Models::SettlementReportUpdatedWebhookEvent, Lithic::Models::StatementsCreatedWebhookEvent, Lithic::Models::ThreeDSAuthenticationCreatedWebhookEvent, Lithic::Models::ThreeDSAuthenticationUpdatedWebhookEvent, Lithic::Models::ThreeDSAuthenticationChallengeWebhookEvent, Lithic::Models::TokenizationApprovalRequestWebhookEvent, Lithic::Models::TokenizationResultWebhookEvent, Lithic::Models::TokenizationTwoFactorAuthenticationCodeWebhookEvent, Lithic::Models::TokenizationTwoFactorAuthenticationCodeSentWebhookEvent, Lithic::Models::TokenizationUpdatedWebhookEvent, Lithic::Models::ThreeDSAuthenticationApprovalRequestWebhookEvent, Lithic::Models::DisputeTransactionCreatedWebhookEvent, Lithic::Models::DisputeTransactionUpdatedWebhookEvent)]
     end
   end
 end

data/lib/lithic/models/payment.rb

@@ -132,7 +132,8 @@ module Lithic
 
       # @!attribute tags
       #   Key-value pairs for tagging resources. Tags allow you to associate arbitrary
-      #   metadata with a resource for your own purposes.
+      #   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}, nil]
       optional :tags, Lithic::Internal::Type::HashOf[String]
@@ -222,6 +223,7 @@ module Lithic
         EXTERNAL_CHECK = :EXTERNAL_CHECK
         EXTERNAL_FEDNOW = :EXTERNAL_FEDNOW
         EXTERNAL_RTP = :EXTERNAL_RTP
+        EXTERNAL_STABLECOIN = :EXTERNAL_STABLECOIN
         EXTERNAL_TRANSFER = :EXTERNAL_TRANSFER
         EXTERNAL_WIRE = :EXTERNAL_WIRE
         MANAGEMENT_ADJUSTMENT = :MANAGEMENT_ADJUSTMENT