modern_treasury 0.28.0 → 0.29.0

data/rbi/modern_treasury/models/address_request.rbi

@@ -21,7 +21,8 @@ module ModernTreasury
       sig { returns(T.nilable(String)) }
       attr_accessor :line2
 
-      # Locality or City.
+      # Locality or City. Use the full city name rather than an abbreviation (e.g. San
+      # Francisco).
       sig { returns(T.nilable(String)) }
       attr_accessor :locality
 
@@ -29,7 +30,8 @@ module ModernTreasury
       sig { returns(T.nilable(String)) }
       attr_accessor :postal_code
 
-      # Region or State.
+      # Region or State. This field is free-form; for US states, we recommend a
+      # two-letter code (e.g. CA). Full state names are also accepted.
       sig { returns(T.nilable(String)) }
       attr_accessor :region
 
@@ -48,11 +50,13 @@ module ModernTreasury
         country: nil,
         line1: nil,
         line2: nil,
-        # Locality or City.
+        # Locality or City. Use the full city name rather than an abbreviation (e.g. San
+        # Francisco).
         locality: nil,
         # The postal code of the address.
         postal_code: nil,
-        # Region or State.
+        # Region or State. This field is free-form; for US states, we recommend a
+        # two-letter code (e.g. CA). Full state names are also accepted.
         region: nil
       )
       end

data/rbi/modern_treasury/models/bulk_request_create_params.rbi

@@ -36,7 +36,7 @@ module ModernTreasury
               ModernTreasury::BulkRequestCreateParams::Resource::ExpectedPaymentCreateRequest,
               ModernTreasury::LedgerTransactionCreateRequest,
               ModernTreasury::LedgerAccountCreateRequest,
-              T.anything,
+              ModernTreasury::BulkRequestCreateParams::Resource::TransactionCreateRequest,
               ModernTreasury::BulkRequestCreateParams::Resource::ID,
               ModernTreasury::BulkRequestCreateParams::Resource::PaymentOrderUpdateRequestWithID,
               ModernTreasury::BulkRequestCreateParams::Resource::ExpectedPaymentUpdateRequestWithID,
@@ -70,7 +70,7 @@ module ModernTreasury
                 ModernTreasury::BulkRequestCreateParams::Resource::ExpectedPaymentCreateRequest::OrHash,
                 ModernTreasury::LedgerTransactionCreateRequest::OrHash,
                 ModernTreasury::LedgerAccountCreateRequest::OrHash,
-                T.anything,
+                ModernTreasury::BulkRequestCreateParams::Resource::TransactionCreateRequest::OrHash,
                 ModernTreasury::BulkRequestCreateParams::Resource::ID::OrHash,
                 ModernTreasury::BulkRequestCreateParams::Resource::PaymentOrderUpdateRequestWithID::OrHash,
                 ModernTreasury::BulkRequestCreateParams::Resource::ExpectedPaymentUpdateRequestWithID::OrHash,
@@ -112,7 +112,7 @@ module ModernTreasury
                   ModernTreasury::BulkRequestCreateParams::Resource::ExpectedPaymentCreateRequest,
                   ModernTreasury::LedgerTransactionCreateRequest,
                   ModernTreasury::LedgerAccountCreateRequest,
-                  T.anything,
+                  ModernTreasury::BulkRequestCreateParams::Resource::TransactionCreateRequest,
                   ModernTreasury::BulkRequestCreateParams::Resource::ID,
                   ModernTreasury::BulkRequestCreateParams::Resource::PaymentOrderUpdateRequestWithID,
                   ModernTreasury::BulkRequestCreateParams::Resource::ExpectedPaymentUpdateRequestWithID,
@@ -223,6 +223,7 @@ module ModernTreasury
         end
       end
 
+      # At least one of "amount" or "amount_string" is required.
       module Resource
         extend ModernTreasury::Internal::Type::Union
 
@@ -233,7 +234,7 @@ module ModernTreasury
               ModernTreasury::BulkRequestCreateParams::Resource::ExpectedPaymentCreateRequest,
               ModernTreasury::LedgerTransactionCreateRequest,
               ModernTreasury::LedgerAccountCreateRequest,
-              T.anything,
+              ModernTreasury::BulkRequestCreateParams::Resource::TransactionCreateRequest,
               ModernTreasury::BulkRequestCreateParams::Resource::ID,
               ModernTreasury::BulkRequestCreateParams::Resource::PaymentOrderUpdateRequestWithID,
               ModernTreasury::BulkRequestCreateParams::Resource::ExpectedPaymentUpdateRequestWithID,
@@ -617,10 +618,10 @@ module ModernTreasury
 
           # Additional vendor specific fields for this payment. Data must be represented as
           # key-value pairs.
-          sig { returns(T.nilable(T.anything)) }
+          sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
           attr_reader :vendor_attributes
 
-          sig { params(vendor_attributes: T.anything).void }
+          sig { params(vendor_attributes: T::Hash[Symbol, T.anything]).void }
           attr_writer :vendor_attributes
 
           sig do
@@ -683,7 +684,7 @@ module ModernTreasury
               ultimate_originating_party_name: T.nilable(String),
               ultimate_receiving_party_identifier: T.nilable(String),
               ultimate_receiving_party_name: T.nilable(String),
-              vendor_attributes: T.anything
+              vendor_attributes: T::Hash[Symbol, T.anything]
             ).returns(T.attached_class)
           end
           def self.new(
@@ -884,7 +885,7 @@ module ModernTreasury
                 ultimate_originating_party_name: T.nilable(String),
                 ultimate_receiving_party_identifier: T.nilable(String),
                 ultimate_receiving_party_name: T.nilable(String),
-                vendor_attributes: T.anything
+                vendor_attributes: T::Hash[Symbol, T.anything]
               }
             )
           end
@@ -2036,7 +2037,8 @@ module ModernTreasury
             sig { params(line2: String).void }
             attr_writer :line2
 
-            # Locality or City.
+            # Locality or City. Use the full city name rather than an abbreviation (e.g. San
+            # Francisco).
             sig { returns(T.nilable(String)) }
             attr_reader :locality
 
@@ -2050,7 +2052,8 @@ module ModernTreasury
             sig { params(postal_code: String).void }
             attr_writer :postal_code
 
-            # Region or State.
+            # Region or State. This field is free-form; for US states, we recommend a
+            # two-letter code (e.g. CA). Full state names are also accepted.
             sig { returns(T.nilable(String)) }
             attr_reader :region
 
@@ -2073,11 +2076,13 @@ module ModernTreasury
               country: nil,
               line1: nil,
               line2: nil,
-              # Locality or City.
+              # Locality or City. Use the full city name rather than an abbreviation (e.g. San
+              # Francisco).
               locality: nil,
               # The postal code of the address.
               postal_code: nil,
-              # Region or State.
+              # Region or State. This field is free-form; for US states, we recommend a
+              # two-letter code (e.g. CA). Full state names are also accepted.
               region: nil
             )
             end
@@ -2614,6 +2619,328 @@ module ModernTreasury
           end
         end
 
+        class TransactionCreateRequest < ModernTreasury::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                ModernTreasury::BulkRequestCreateParams::Resource::TransactionCreateRequest,
+                ModernTreasury::Internal::AnyHash
+              )
+            end
+
+          # The date on which the transaction occurred.
+          sig { returns(T.nilable(Date)) }
+          attr_accessor :as_of_date
+
+          # Either `credit` or `debit`.
+          sig { returns(String) }
+          attr_accessor :direction
+
+          # The ID of the relevant Internal Account.
+          sig { returns(String) }
+          attr_accessor :internal_account_id
+
+          # When applicable, the bank-given code that determines the transaction's category.
+          # For most banks this is the BAI2/BTRS transaction code.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :vendor_code
+
+          # The type of `vendor_code` being reported. Can be one of `bai2`, `bankprov`,
+          # `bnk_dev`, `cleartouch`, `currencycloud`, `cross_river`, `dc_bank`, `dwolla`,
+          # `evolve`, `goldman_sachs`, `iso20022`, `jpmc`, `mx`, `silvergate`, `swift`,
+          # `us_bank`, or others.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :vendor_code_type
+
+          # Value in specified currency's smallest unit. e.g. $10 would be represented
+          # as 1000.
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :amount
+
+          sig { params(amount: Integer).void }
+          attr_writer :amount
+
+          # The transaction amount as a string, preserving full precision for values that
+          # may exceed safe integer limits in some languages.
+          sig { returns(T.nilable(String)) }
+          attr_reader :amount_string
+
+          sig { params(amount_string: String).void }
+          attr_writer :amount_string
+
+          # Additional data represented as key-value pairs. Both the key and value must be
+          # strings.
+          sig { returns(T.nilable(T::Hash[Symbol, String])) }
+          attr_reader :metadata
+
+          sig { params(metadata: T::Hash[Symbol, String]).void }
+          attr_writer :metadata
+
+          # This field will be `true` if the transaction has posted to the account.
+          sig { returns(T.nilable(T::Boolean)) }
+          attr_reader :posted
+
+          sig { params(posted: T::Boolean).void }
+          attr_writer :posted
+
+          # The type of the transaction. Examples could be
+          # `card, `ach`, `wire`, `check`, `rtp`, or `book`.
+          sig do
+            returns(
+              T.nilable(
+                ModernTreasury::BulkRequestCreateParams::Resource::TransactionCreateRequest::Type::OrSymbol
+              )
+            )
+          end
+          attr_accessor :type
+
+          # An identifier given to this transaction by the bank, often `null`.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :vendor_customer_id
+
+          # The transaction detail text that often appears in on your bank statement and in
+          # your banking portal.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :vendor_description
+
+          # At least one of "amount" or "amount_string" is required.
+          sig do
+            params(
+              as_of_date: T.nilable(Date),
+              direction: String,
+              internal_account_id: String,
+              vendor_code: T.nilable(String),
+              vendor_code_type: T.nilable(String),
+              amount: Integer,
+              amount_string: String,
+              metadata: T::Hash[Symbol, String],
+              posted: T::Boolean,
+              type:
+                T.nilable(
+                  ModernTreasury::BulkRequestCreateParams::Resource::TransactionCreateRequest::Type::OrSymbol
+                ),
+              vendor_customer_id: T.nilable(String),
+              vendor_description: T.nilable(String)
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # The date on which the transaction occurred.
+            as_of_date:,
+            # Either `credit` or `debit`.
+            direction:,
+            # The ID of the relevant Internal Account.
+            internal_account_id:,
+            # When applicable, the bank-given code that determines the transaction's category.
+            # For most banks this is the BAI2/BTRS transaction code.
+            vendor_code:,
+            # The type of `vendor_code` being reported. Can be one of `bai2`, `bankprov`,
+            # `bnk_dev`, `cleartouch`, `currencycloud`, `cross_river`, `dc_bank`, `dwolla`,
+            # `evolve`, `goldman_sachs`, `iso20022`, `jpmc`, `mx`, `silvergate`, `swift`,
+            # `us_bank`, or others.
+            vendor_code_type:,
+            # Value in specified currency's smallest unit. e.g. $10 would be represented
+            # as 1000.
+            amount: nil,
+            # The transaction amount as a string, preserving full precision for values that
+            # may exceed safe integer limits in some languages.
+            amount_string: nil,
+            # Additional data represented as key-value pairs. Both the key and value must be
+            # strings.
+            metadata: nil,
+            # This field will be `true` if the transaction has posted to the account.
+            posted: nil,
+            # The type of the transaction. Examples could be
+            # `card, `ach`, `wire`, `check`, `rtp`, or `book`.
+            type: nil,
+            # An identifier given to this transaction by the bank, often `null`.
+            vendor_customer_id: nil,
+            # The transaction detail text that often appears in on your bank statement and in
+            # your banking portal.
+            vendor_description: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                as_of_date: T.nilable(Date),
+                direction: String,
+                internal_account_id: String,
+                vendor_code: T.nilable(String),
+                vendor_code_type: T.nilable(String),
+                amount: Integer,
+                amount_string: String,
+                metadata: T::Hash[Symbol, String],
+                posted: T::Boolean,
+                type:
+                  T.nilable(
+                    ModernTreasury::BulkRequestCreateParams::Resource::TransactionCreateRequest::Type::OrSymbol
+                  ),
+                vendor_customer_id: T.nilable(String),
+                vendor_description: T.nilable(String)
+              }
+            )
+          end
+          def to_hash
+          end
+
+          # The type of the transaction. Examples could be
+          # `card, `ach`, `wire`, `check`, `rtp`, or `book`.
+          module Type
+            extend ModernTreasury::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  ModernTreasury::BulkRequestCreateParams::Resource::TransactionCreateRequest::Type
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            ACH =
+              T.let(
+                :ach,
+                ModernTreasury::BulkRequestCreateParams::Resource::TransactionCreateRequest::Type::TaggedSymbol
+              )
+            AU_BECS =
+              T.let(
+                :au_becs,
+                ModernTreasury::BulkRequestCreateParams::Resource::TransactionCreateRequest::Type::TaggedSymbol
+              )
+            BACS =
+              T.let(
+                :bacs,
+                ModernTreasury::BulkRequestCreateParams::Resource::TransactionCreateRequest::Type::TaggedSymbol
+              )
+            BOOK =
+              T.let(
+                :book,
+                ModernTreasury::BulkRequestCreateParams::Resource::TransactionCreateRequest::Type::TaggedSymbol
+              )
+            CARD =
+              T.let(
+                :card,
+                ModernTreasury::BulkRequestCreateParams::Resource::TransactionCreateRequest::Type::TaggedSymbol
+              )
+            CHATS =
+              T.let(
+                :chats,
+                ModernTreasury::BulkRequestCreateParams::Resource::TransactionCreateRequest::Type::TaggedSymbol
+              )
+            CHECK =
+              T.let(
+                :check,
+                ModernTreasury::BulkRequestCreateParams::Resource::TransactionCreateRequest::Type::TaggedSymbol
+              )
+            CROSS_BORDER =
+              T.let(
+                :cross_border,
+                ModernTreasury::BulkRequestCreateParams::Resource::TransactionCreateRequest::Type::TaggedSymbol
+              )
+            DK_NETS =
+              T.let(
+                :dk_nets,
+                ModernTreasury::BulkRequestCreateParams::Resource::TransactionCreateRequest::Type::TaggedSymbol
+              )
+            EFT =
+              T.let(
+                :eft,
+                ModernTreasury::BulkRequestCreateParams::Resource::TransactionCreateRequest::Type::TaggedSymbol
+              )
+            GB_FPS =
+              T.let(
+                :gb_fps,
+                ModernTreasury::BulkRequestCreateParams::Resource::TransactionCreateRequest::Type::TaggedSymbol
+              )
+            MASAV =
+              T.let(
+                :masav,
+                ModernTreasury::BulkRequestCreateParams::Resource::TransactionCreateRequest::Type::TaggedSymbol
+              )
+            MX_CCEN =
+              T.let(
+                :mx_ccen,
+                ModernTreasury::BulkRequestCreateParams::Resource::TransactionCreateRequest::Type::TaggedSymbol
+              )
+            NEFT =
+              T.let(
+                :neft,
+                ModernTreasury::BulkRequestCreateParams::Resource::TransactionCreateRequest::Type::TaggedSymbol
+              )
+            NICS =
+              T.let(
+                :nics,
+                ModernTreasury::BulkRequestCreateParams::Resource::TransactionCreateRequest::Type::TaggedSymbol
+              )
+            NZ_BECS =
+              T.let(
+                :nz_becs,
+                ModernTreasury::BulkRequestCreateParams::Resource::TransactionCreateRequest::Type::TaggedSymbol
+              )
+            PL_ELIXIR =
+              T.let(
+                :pl_elixir,
+                ModernTreasury::BulkRequestCreateParams::Resource::TransactionCreateRequest::Type::TaggedSymbol
+              )
+            RTP =
+              T.let(
+                :rtp,
+                ModernTreasury::BulkRequestCreateParams::Resource::TransactionCreateRequest::Type::TaggedSymbol
+              )
+            SE_BANKGIROT =
+              T.let(
+                :se_bankgirot,
+                ModernTreasury::BulkRequestCreateParams::Resource::TransactionCreateRequest::Type::TaggedSymbol
+              )
+            SEPA =
+              T.let(
+                :sepa,
+                ModernTreasury::BulkRequestCreateParams::Resource::TransactionCreateRequest::Type::TaggedSymbol
+              )
+            SG_GIRO =
+              T.let(
+                :sg_giro,
+                ModernTreasury::BulkRequestCreateParams::Resource::TransactionCreateRequest::Type::TaggedSymbol
+              )
+            SIC =
+              T.let(
+                :sic,
+                ModernTreasury::BulkRequestCreateParams::Resource::TransactionCreateRequest::Type::TaggedSymbol
+              )
+            STABLECOIN =
+              T.let(
+                :stablecoin,
+                ModernTreasury::BulkRequestCreateParams::Resource::TransactionCreateRequest::Type::TaggedSymbol
+              )
+            WIRE =
+              T.let(
+                :wire,
+                ModernTreasury::BulkRequestCreateParams::Resource::TransactionCreateRequest::Type::TaggedSymbol
+              )
+            ZENGIN =
+              T.let(
+                :zengin,
+                ModernTreasury::BulkRequestCreateParams::Resource::TransactionCreateRequest::Type::TaggedSymbol
+              )
+            OTHER =
+              T.let(
+                :other,
+                ModernTreasury::BulkRequestCreateParams::Resource::TransactionCreateRequest::Type::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  ModernTreasury::BulkRequestCreateParams::Resource::TransactionCreateRequest::Type::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+        end
+
         class ID < ModernTreasury::Internal::Type::BaseModel
           OrHash =
             T.type_alias do

data/rbi/modern_treasury/models/child_legal_entity.rbi

@@ -44,8 +44,8 @@ module ModernTreasury
       sig { returns(T.nilable(T.anything)) }
       attr_accessor :compliance_details
 
-      # The country code where the business is incorporated in the ISO 3166-1 alpha-2 or
-      # alpha-3 formats.
+      # The country where the business is incorporated, as an ISO 3166-1 alpha-2 country
+      # code (e.g. US).
       sig { returns(T.nilable(String)) }
       attr_accessor :country_of_incorporation
 
@@ -148,8 +148,8 @@ module ModernTreasury
       sig { returns(String) }
       attr_accessor :object
 
-      # A list of countries where the business operates (ISO 3166-1 alpha-2 or alpha-3
-      # codes).
+      # A list of countries where the business operates, as ISO 3166-1 alpha-2 country
+      # codes (e.g. ["US", "CA"]).
       sig { returns(T::Array[String]) }
       attr_accessor :operating_jurisdictions
 
@@ -341,8 +341,8 @@ module ModernTreasury
         # The country of citizenship for an individual.
         citizenship_country:,
         compliance_details:,
-        # The country code where the business is incorporated in the ISO 3166-1 alpha-2 or
-        # alpha-3 formats.
+        # The country where the business is incorporated, as an ISO 3166-1 alpha-2 country
+        # code (e.g. US).
         country_of_incorporation:,
         created_at:,
         # A business's formation date (YYYY-MM-DD).
@@ -385,8 +385,8 @@ module ModernTreasury
         # An individual's middle name.
         middle_name:,
         object:,
-        # A list of countries where the business operates (ISO 3166-1 alpha-2 or alpha-3
-        # codes).
+        # A list of countries where the business operates, as ISO 3166-1 alpha-2 country
+        # codes (e.g. ["US", "CA"]).
         operating_jurisdictions:,
         phone_numbers:,
         # Whether the individual is a politically exposed person.
@@ -540,7 +540,8 @@ module ModernTreasury
         sig { returns(T::Boolean) }
         attr_accessor :live_mode
 
-        # Locality or City.
+        # Locality or City. Use the full city name rather than an abbreviation (e.g. San
+        # Francisco).
         sig { returns(T.nilable(String)) }
         attr_accessor :locality
 
@@ -556,7 +557,8 @@ module ModernTreasury
         sig { returns(T.nilable(T::Boolean)) }
         attr_accessor :primary
 
-        # Region or State.
+        # Region or State. This field is free-form; for US states, we recommend a
+        # two-letter code (e.g. CA). Full state names are also accepted.
         sig { returns(T.nilable(String)) }
         attr_accessor :region
 
@@ -597,7 +599,8 @@ module ModernTreasury
           # This field will be true if this object exists in the live environment or false
           # if it exists in the test environment.
           live_mode:,
-          # Locality or City.
+          # Locality or City. Use the full city name rather than an abbreviation (e.g. San
+          # Francisco).
           locality:,
           object:,
           # The postal code of the address.
@@ -605,7 +608,8 @@ module ModernTreasury
           # Whether this address is the primary address for the legal entity. Optional; when
           # omitted it is inferred from the address types.
           primary:,
-          # Region or State.
+          # Region or State. This field is free-form; for US states, we recommend a
+          # two-letter code (e.g. CA). Full state names are also accepted.
           region:,
           updated_at:
         )
@@ -1029,6 +1033,16 @@ module ModernTreasury
               :gr_vat,
               ModernTreasury::ChildLegalEntity::Identification::IDType::TaggedSymbol
             )
+          HK_BRN =
+            T.let(
+              :hk_brn,
+              ModernTreasury::ChildLegalEntity::Identification::IDType::TaggedSymbol
+            )
+          HK_HKID =
+            T.let(
+              :hk_hkid,
+              ModernTreasury::ChildLegalEntity::Identification::IDType::TaggedSymbol
+            )
           HN_ID =
             T.let(
               :hn_id,
@@ -1425,6 +1439,9 @@ module ModernTreasury
             )
           end
 
+        # A phone number in E.164 format. This format is strictly validated: include a
+        # leading + and country code, followed by digits only (no spaces or dashes), e.g.
+        # +12025551234.
         sig { returns(T.nilable(String)) }
         attr_reader :phone_number
 
@@ -1433,7 +1450,12 @@ module ModernTreasury
 
         # A list of phone numbers in E.164 format.
         sig { params(phone_number: String).returns(T.attached_class) }
-        def self.new(phone_number: nil)
+        def self.new(
+          # A phone number in E.164 format. This format is strictly validated: include a
+          # leading + and country code, followed by digits only (no spaces or dashes), e.g.
+          # +12025551234.
+          phone_number: nil
+        )
         end
 
         sig { override.returns({ phone_number: String }) }

data/rbi/modern_treasury/models/child_legal_entity_create.rbi

@@ -61,8 +61,8 @@ module ModernTreasury
       sig { returns(T.nilable(String)) }
       attr_accessor :connection_id
 
-      # The country code where the business is incorporated in the ISO 3166-1 alpha-2 or
-      # alpha-3 formats.
+      # The country where the business is incorporated, as an ISO 3166-1 alpha-2 country
+      # code (e.g. US).
       sig { returns(T.nilable(String)) }
       attr_accessor :country_of_incorporation
 
@@ -207,8 +207,8 @@ module ModernTreasury
       sig { returns(T.nilable(String)) }
       attr_accessor :middle_name
 
-      # A list of countries where the business operates (ISO 3166-1 alpha-2 or alpha-3
-      # codes).
+      # A list of countries where the business operates, as ISO 3166-1 alpha-2 country
+      # codes (e.g. ["US", "CA"]).
       sig { returns(T.nilable(T::Array[String])) }
       attr_reader :operating_jurisdictions
 
@@ -436,8 +436,8 @@ module ModernTreasury
         # in a value of null to prevent the connection from being associated with the
         # legal entity.
         connection_id: nil,
-        # The country code where the business is incorporated in the ISO 3166-1 alpha-2 or
-        # alpha-3 formats.
+        # The country where the business is incorporated, as an ISO 3166-1 alpha-2 country
+        # code (e.g. US).
         country_of_incorporation: nil,
         # A business's formation date (YYYY-MM-DD).
         date_formed: nil,
@@ -476,8 +476,8 @@ module ModernTreasury
         metadata: nil,
         # An individual's middle name.
         middle_name: nil,
-        # A list of countries where the business operates (ISO 3166-1 alpha-2 or alpha-3
-        # codes).
+        # A list of countries where the business operates, as ISO 3166-1 alpha-2 country
+        # codes (e.g. ["US", "CA"]).
         operating_jurisdictions: nil,
         phone_numbers: nil,
         # Whether the individual is a politically exposed person.
@@ -802,6 +802,9 @@ module ModernTreasury
             )
           end
 
+        # A phone number in E.164 format. This format is strictly validated: include a
+        # leading + and country code, followed by digits only (no spaces or dashes), e.g.
+        # +12025551234.
         sig { returns(T.nilable(String)) }
         attr_reader :phone_number
 
@@ -810,7 +813,12 @@ module ModernTreasury
 
         # A list of phone numbers in E.164 format.
         sig { params(phone_number: String).returns(T.attached_class) }
-        def self.new(phone_number: nil)
+        def self.new(
+          # A phone number in E.164 format. This format is strictly validated: include a
+          # leading + and country code, followed by digits only (no spaces or dashes), e.g.
+          # +12025551234.
+          phone_number: nil
+        )
         end
 
         sig { override.returns({ phone_number: String }) }