sentdm 0.26.0 → 0.28.0

data/rbi/sentdm/models/profile_update_params.rbi

@@ -14,7 +14,16 @@ module Sentdm
       sig { returns(String) }
       attr_accessor :profile_id
 
-      # Whether contacts are shared across profiles (optional)
+      # Deprecated. Accepted and ignored. Contact and template sharing between sender
+      # profiles is gone — a profile sees only what it owns, and the organization still
+      # sees all of its profiles' contacts and templates through read-time widening. The
+      # four columns behind these flags were dropped by M260720120000.
+      #
+      # Retired the same way as SendingPhoneNumberProfileId, and for the same reason:
+      # the properties stay bound so an SDK that assigns them keeps compiling, and a 400
+      # would break a working integration over a capability that is gone regardless.
+      # Every profile reports all four as false, so a caller that checks its own write
+      # can see it did not take.
       sig { returns(T.nilable(T::Boolean)) }
       attr_accessor :allow_contact_sharing
 
@@ -22,18 +31,18 @@ module Sentdm
       sig { returns(T.nilable(T::Boolean)) }
       attr_accessor :allow_number_change_during_onboarding
 
-      # Whether templates are shared across profiles (optional)
       sig { returns(T.nilable(T::Boolean)) }
       attr_accessor :allow_template_sharing
 
       # Billing contact information for a profile. Required when billing_model is
       # "profile" or "profile_and_organization".
-      sig { returns(T.nilable(Sentdm::BillingContactInfo)) }
+      sig { returns(T.nilable(Sentdm::ProfileUpdateParams::BillingContact)) }
       attr_reader :billing_contact
 
       sig do
         params(
-          billing_contact: T.nilable(Sentdm::BillingContactInfo::OrHash)
+          billing_contact:
+            T.nilable(Sentdm::ProfileUpdateParams::BillingContact::OrHash)
         ).void
       end
       attr_writer :billing_contact
@@ -49,10 +58,14 @@ module Sentdm
       attr_accessor :billing_model
 
       # Brand and KYC data grouped into contact, business, and compliance sections
-      sig { returns(T.nilable(Sentdm::BrandsBrandData)) }
+      sig { returns(T.nilable(Sentdm::ProfileUpdateParams::Brand)) }
       attr_reader :brand
 
-      sig { params(brand: T.nilable(Sentdm::BrandsBrandData::OrHash)).void }
+      sig do
+        params(
+          brand: T.nilable(Sentdm::ProfileUpdateParams::Brand::OrHash)
+        ).void
+      end
       attr_writer :brand
 
       # Profile description (optional)
@@ -63,7 +76,6 @@ module Sentdm
       sig { returns(T.nilable(String)) }
       attr_accessor :icon
 
-      # Whether this profile inherits contacts from organization (optional)
       sig { returns(T.nilable(T::Boolean)) }
       attr_accessor :inherit_contacts
 
@@ -75,7 +87,6 @@ module Sentdm
       sig { returns(T.nilable(T::Boolean)) }
       attr_accessor :inherit_tcr_campaign
 
-      # Whether this profile inherits templates from organization (optional)
       sig { returns(T.nilable(T::Boolean)) }
       attr_accessor :inherit_templates
 
@@ -83,14 +94,17 @@ module Sentdm
       sig { returns(T.nilable(String)) }
       attr_accessor :name
 
-      # Payment card details for a profile. Accepted when billing_model is "profile" or
-      # "profile_and_organization". These details are not stored on our servers and will
-      # be forwarded to the payment processor.
-      sig { returns(T.nilable(Sentdm::PaymentDetails)) }
+      # Payment card details for this profile (optional). Accepted when billing_model is
+      # "profile" or "profile_and_organization". Not persisted on our servers —
+      # forwarded to the payment processor.
+      sig { returns(T.nilable(Sentdm::ProfileUpdateParams::PaymentDetails)) }
       attr_reader :payment_details
 
       sig do
-        params(payment_details: T.nilable(Sentdm::PaymentDetails::OrHash)).void
+        params(
+          payment_details:
+            T.nilable(Sentdm::ProfileUpdateParams::PaymentDetails::OrHash)
+        ).void
       end
       attr_writer :payment_details
 
@@ -106,11 +120,28 @@ module Sentdm
       sig { returns(T.nilable(String)) }
       attr_accessor :sending_phone_number
 
-      # Reference to another profile to use for SMS configuration (optional)
+      # Deprecated. Accepted and ignored. Sender borrowing is gone: a profile cannot
+      # send from another profile's SMS number. Supplying this changes nothing and the
+      # request still succeeds.
+      #
+      # Bound rather than dropped so the property survives on the wire and in a
+      # generated client — an SDK that assigns it keeps compiling, which is the
+      # compatibility this exists for. It is deliberately not refused: a 400 here would
+      # break an integration that is otherwise working, and the capability it asks for
+      # is gone either way.
+      #
+      # The trade-off, stated plainly. A caller asking for borrowing is told it
+      # succeeded when nothing happened. What makes that survivable is the read:
+      # sending_phone_number_profile_id comes back null on every profile, so a caller
+      # that checks its own write can see it did not take. Every request that carries
+      # one is logged, so we can tell when nobody is sending it any more and the field
+      # can go for real.
+      #
+      # Give the profile a sender of its own instead: POST /v3/channels/sms with the
+      # x-profile-id header naming it.
       sig { returns(T.nilable(String)) }
       attr_accessor :sending_phone_number_profile_id
 
-      # Reference to another profile to use for WhatsApp configuration (optional)
       sig { returns(T.nilable(String)) }
       attr_accessor :sending_whatsapp_number_profile_id
 
@@ -142,9 +173,10 @@ module Sentdm
           allow_contact_sharing: T.nilable(T::Boolean),
           allow_number_change_during_onboarding: T.nilable(T::Boolean),
           allow_template_sharing: T.nilable(T::Boolean),
-          billing_contact: T.nilable(Sentdm::BillingContactInfo::OrHash),
+          billing_contact:
+            T.nilable(Sentdm::ProfileUpdateParams::BillingContact::OrHash),
           billing_model: T.nilable(String),
-          brand: T.nilable(Sentdm::BrandsBrandData::OrHash),
+          brand: T.nilable(Sentdm::ProfileUpdateParams::Brand::OrHash),
           description: T.nilable(String),
           icon: T.nilable(String),
           inherit_contacts: T.nilable(T::Boolean),
@@ -152,7 +184,8 @@ module Sentdm
           inherit_tcr_campaign: T.nilable(T::Boolean),
           inherit_templates: T.nilable(T::Boolean),
           name: T.nilable(String),
-          payment_details: T.nilable(Sentdm::PaymentDetails::OrHash),
+          payment_details:
+            T.nilable(Sentdm::ProfileUpdateParams::PaymentDetails::OrHash),
           sandbox: T::Boolean,
           sending_phone_number: T.nilable(String),
           sending_phone_number_profile_id: T.nilable(String),
@@ -166,11 +199,19 @@ module Sentdm
       end
       def self.new(
         profile_id:,
-        # Whether contacts are shared across profiles (optional)
+        # Deprecated. Accepted and ignored. Contact and template sharing between sender
+        # profiles is gone — a profile sees only what it owns, and the organization still
+        # sees all of its profiles' contacts and templates through read-time widening. The
+        # four columns behind these flags were dropped by M260720120000.
+        #
+        # Retired the same way as SendingPhoneNumberProfileId, and for the same reason:
+        # the properties stay bound so an SDK that assigns them keeps compiling, and a 400
+        # would break a working integration over a capability that is gone regardless.
+        # Every profile reports all four as false, so a caller that checks its own write
+        # can see it did not take.
         allow_contact_sharing: nil,
         # Whether number changes are allowed during onboarding (optional)
         allow_number_change_during_onboarding: nil,
-        # Whether templates are shared across profiles (optional)
         allow_template_sharing: nil,
         # Billing contact information for a profile. Required when billing_model is
         # "profile" or "profile_and_organization".
@@ -189,28 +230,43 @@ module Sentdm
         description: nil,
         # Profile icon URL (optional)
         icon: nil,
-        # Whether this profile inherits contacts from organization (optional)
         inherit_contacts: nil,
         # Whether this profile inherits TCR brand from organization (optional)
         inherit_tcr_brand: nil,
         # Whether this profile inherits TCR campaign from organization (optional)
         inherit_tcr_campaign: nil,
-        # Whether this profile inherits templates from organization (optional)
         inherit_templates: nil,
         # Profile name (optional)
         name: nil,
-        # Payment card details for a profile. Accepted when billing_model is "profile" or
-        # "profile_and_organization". These details are not stored on our servers and will
-        # be forwarded to the payment processor.
+        # Payment card details for this profile (optional). Accepted when billing_model is
+        # "profile" or "profile_and_organization". Not persisted on our servers —
+        # forwarded to the payment processor.
         payment_details: nil,
         # Sandbox flag - when true, the operation is simulated without side effects Useful
         # for testing integrations without actual execution
         sandbox: nil,
         # Direct phone number for SMS sending (optional)
         sending_phone_number: nil,
-        # Reference to another profile to use for SMS configuration (optional)
+        # Deprecated. Accepted and ignored. Sender borrowing is gone: a profile cannot
+        # send from another profile's SMS number. Supplying this changes nothing and the
+        # request still succeeds.
+        #
+        # Bound rather than dropped so the property survives on the wire and in a
+        # generated client — an SDK that assigns it keeps compiling, which is the
+        # compatibility this exists for. It is deliberately not refused: a 400 here would
+        # break an integration that is otherwise working, and the capability it asks for
+        # is gone either way.
+        #
+        # The trade-off, stated plainly. A caller asking for borrowing is told it
+        # succeeded when nothing happened. What makes that survivable is the read:
+        # sending_phone_number_profile_id comes back null on every profile, so a caller
+        # that checks its own write can see it did not take. Every request that carries
+        # one is logged, so we can tell when nobody is sending it any more and the field
+        # can go for real.
+        #
+        # Give the profile a sender of its own instead: POST /v3/channels/sms with the
+        # x-profile-id header naming it.
         sending_phone_number_profile_id: nil,
-        # Reference to another profile to use for WhatsApp configuration (optional)
         sending_whatsapp_number_profile_id: nil,
         # Profile short name/abbreviation (optional). Must be 3–11 characters, contain
         # only letters, numbers, and spaces, and include at least one letter. Example:
@@ -231,9 +287,10 @@ module Sentdm
             allow_contact_sharing: T.nilable(T::Boolean),
             allow_number_change_during_onboarding: T.nilable(T::Boolean),
             allow_template_sharing: T.nilable(T::Boolean),
-            billing_contact: T.nilable(Sentdm::BillingContactInfo),
+            billing_contact:
+              T.nilable(Sentdm::ProfileUpdateParams::BillingContact),
             billing_model: T.nilable(String),
-            brand: T.nilable(Sentdm::BrandsBrandData),
+            brand: T.nilable(Sentdm::ProfileUpdateParams::Brand),
             description: T.nilable(String),
             icon: T.nilable(String),
             inherit_contacts: T.nilable(T::Boolean),
@@ -241,7 +298,8 @@ module Sentdm
             inherit_tcr_campaign: T.nilable(T::Boolean),
             inherit_templates: T.nilable(T::Boolean),
             name: T.nilable(String),
-            payment_details: T.nilable(Sentdm::PaymentDetails),
+            payment_details:
+              T.nilable(Sentdm::ProfileUpdateParams::PaymentDetails),
             sandbox: T::Boolean,
             sending_phone_number: T.nilable(String),
             sending_phone_number_profile_id: T.nilable(String),
@@ -256,6 +314,528 @@ module Sentdm
       end
       def to_hash
       end
+
+      class BillingContact < Sentdm::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Sentdm::ProfileUpdateParams::BillingContact,
+              Sentdm::Internal::AnyHash
+            )
+          end
+
+        # Email address where invoices will be sent (required)
+        sig { returns(String) }
+        attr_accessor :email
+
+        # Full name of the billing contact or company (required)
+        sig { returns(String) }
+        attr_accessor :name
+
+        # Billing address (optional). Free-form text including street, city, state, postal
+        # code, and country.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :address
+
+        # Phone number for the billing contact (optional)
+        sig { returns(T.nilable(String)) }
+        attr_accessor :phone
+
+        # Billing contact information for a profile. Required when billing_model is
+        # "profile" or "profile_and_organization".
+        sig do
+          params(
+            email: String,
+            name: String,
+            address: T.nilable(String),
+            phone: T.nilable(String)
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Email address where invoices will be sent (required)
+          email:,
+          # Full name of the billing contact or company (required)
+          name:,
+          # Billing address (optional). Free-form text including street, city, state, postal
+          # code, and country.
+          address: nil,
+          # Phone number for the billing contact (optional)
+          phone: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              email: String,
+              name: String,
+              address: T.nilable(String),
+              phone: T.nilable(String)
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+
+      class Brand < Sentdm::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(Sentdm::ProfileUpdateParams::Brand, Sentdm::Internal::AnyHash)
+          end
+
+        # Compliance and TCR information for brand registration
+        sig { returns(Sentdm::ProfileUpdateParams::Brand::Compliance) }
+        attr_reader :compliance
+
+        sig do
+          params(
+            compliance: Sentdm::ProfileUpdateParams::Brand::Compliance::OrHash
+          ).void
+        end
+        attr_writer :compliance
+
+        # Contact information for brand KYC
+        sig { returns(Sentdm::ProfileUpdateParams::Brand::Contact) }
+        attr_reader :contact
+
+        sig do
+          params(
+            contact: Sentdm::ProfileUpdateParams::Brand::Contact::OrHash
+          ).void
+        end
+        attr_writer :contact
+
+        # Business details and address for brand KYC
+        sig { returns(T.nilable(Sentdm::ProfileUpdateParams::Brand::Business)) }
+        attr_reader :business
+
+        sig do
+          params(
+            business:
+              T.nilable(Sentdm::ProfileUpdateParams::Brand::Business::OrHash)
+          ).void
+        end
+        attr_writer :business
+
+        # Brand and KYC data grouped into contact, business, and compliance sections
+        sig do
+          params(
+            compliance: Sentdm::ProfileUpdateParams::Brand::Compliance::OrHash,
+            contact: Sentdm::ProfileUpdateParams::Brand::Contact::OrHash,
+            business:
+              T.nilable(Sentdm::ProfileUpdateParams::Brand::Business::OrHash)
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Compliance and TCR information for brand registration
+          compliance:,
+          # Contact information for brand KYC
+          contact:,
+          # Business details and address for brand KYC
+          business: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              compliance: Sentdm::ProfileUpdateParams::Brand::Compliance,
+              contact: Sentdm::ProfileUpdateParams::Brand::Contact,
+              business: T.nilable(Sentdm::ProfileUpdateParams::Brand::Business)
+            }
+          )
+        end
+        def to_hash
+        end
+
+        class Compliance < Sentdm::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Sentdm::ProfileUpdateParams::Brand::Compliance,
+                Sentdm::Internal::AnyHash
+              )
+            end
+
+          sig { returns(Sentdm::TcrBrandRelationship::OrSymbol) }
+          attr_accessor :brand_relationship
+
+          sig { returns(Sentdm::TcrVertical::OrSymbol) }
+          attr_accessor :vertical
+
+          # List of destination countries for messaging
+          sig { returns(T.nilable(T::Array[Sentdm::DestinationCountry])) }
+          attr_accessor :destination_countries
+
+          # Whether this is a TCR (Campaign Registry) application
+          sig { returns(T.nilable(T::Boolean)) }
+          attr_accessor :is_tcr_application
+
+          # Additional notes about the business or use case
+          sig { returns(T.nilable(String)) }
+          attr_accessor :notes
+
+          # Phone number prefix for messaging (e.g., "+1")
+          sig { returns(T.nilable(String)) }
+          attr_accessor :phone_number_prefix
+
+          # Compliance and TCR information for brand registration
+          sig do
+            params(
+              brand_relationship: Sentdm::TcrBrandRelationship::OrSymbol,
+              vertical: Sentdm::TcrVertical::OrSymbol,
+              destination_countries:
+                T.nilable(T::Array[Sentdm::DestinationCountry::OrHash]),
+              is_tcr_application: T.nilable(T::Boolean),
+              notes: T.nilable(String),
+              phone_number_prefix: T.nilable(String)
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            brand_relationship:,
+            vertical:,
+            # List of destination countries for messaging
+            destination_countries: nil,
+            # Whether this is a TCR (Campaign Registry) application
+            is_tcr_application: nil,
+            # Additional notes about the business or use case
+            notes: nil,
+            # Phone number prefix for messaging (e.g., "+1")
+            phone_number_prefix: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                brand_relationship: Sentdm::TcrBrandRelationship::OrSymbol,
+                vertical: Sentdm::TcrVertical::OrSymbol,
+                destination_countries:
+                  T.nilable(T::Array[Sentdm::DestinationCountry]),
+                is_tcr_application: T.nilable(T::Boolean),
+                notes: T.nilable(String),
+                phone_number_prefix: T.nilable(String)
+              }
+            )
+          end
+          def to_hash
+          end
+        end
+
+        class Contact < Sentdm::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Sentdm::ProfileUpdateParams::Brand::Contact,
+                Sentdm::Internal::AnyHash
+              )
+            end
+
+          # Primary contact name (required)
+          sig { returns(String) }
+          attr_accessor :name
+
+          # Business/brand name
+          sig { returns(T.nilable(String)) }
+          attr_accessor :business_name
+
+          # Contact email address
+          sig { returns(T.nilable(String)) }
+          attr_accessor :email
+
+          # Contact phone number in E.164 format
+          sig { returns(T.nilable(String)) }
+          attr_accessor :phone
+
+          # Contact phone country code (e.g., "1" for US)
+          sig { returns(T.nilable(String)) }
+          attr_accessor :phone_country_code
+
+          # Contact's role in the business
+          sig { returns(T.nilable(String)) }
+          attr_accessor :role
+
+          # Contact information for brand KYC
+          sig do
+            params(
+              name: String,
+              business_name: T.nilable(String),
+              email: T.nilable(String),
+              phone: T.nilable(String),
+              phone_country_code: T.nilable(String),
+              role: T.nilable(String)
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # Primary contact name (required)
+            name:,
+            # Business/brand name
+            business_name: nil,
+            # Contact email address
+            email: nil,
+            # Contact phone number in E.164 format
+            phone: nil,
+            # Contact phone country code (e.g., "1" for US)
+            phone_country_code: nil,
+            # Contact's role in the business
+            role: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                name: String,
+                business_name: T.nilable(String),
+                email: T.nilable(String),
+                phone: T.nilable(String),
+                phone_country_code: T.nilable(String),
+                role: T.nilable(String)
+              }
+            )
+          end
+          def to_hash
+          end
+        end
+
+        class Business < Sentdm::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Sentdm::ProfileUpdateParams::Brand::Business,
+                Sentdm::Internal::AnyHash
+              )
+            end
+
+          # City
+          sig { returns(T.nilable(String)) }
+          attr_accessor :city
+
+          # Country code (e.g., US, CA)
+          sig { returns(T.nilable(String)) }
+          attr_accessor :country
+
+          # Country where the business is registered
+          sig { returns(T.nilable(String)) }
+          attr_accessor :country_of_registration
+
+          sig do
+            returns(
+              T.nilable(
+                Sentdm::ProfileUpdateParams::Brand::Business::EntityType::OrSymbol
+              )
+            )
+          end
+          attr_accessor :entity_type
+
+          # Legal business name
+          sig { returns(T.nilable(String)) }
+          attr_accessor :legal_name
+
+          # Postal/ZIP code
+          sig { returns(T.nilable(String)) }
+          attr_accessor :postal_code
+
+          # State/province code
+          sig { returns(T.nilable(String)) }
+          attr_accessor :state
+
+          # Street address
+          sig { returns(T.nilable(String)) }
+          attr_accessor :street
+
+          # Tax ID/EIN number
+          sig { returns(T.nilable(String)) }
+          attr_accessor :tax_id
+
+          # Type of tax ID (e.g., us_ein, ca_bn)
+          sig { returns(T.nilable(String)) }
+          attr_accessor :tax_id_type
+
+          # Business website URL
+          sig { returns(T.nilable(String)) }
+          attr_accessor :url
+
+          # Business details and address for brand KYC
+          sig do
+            params(
+              city: T.nilable(String),
+              country: T.nilable(String),
+              country_of_registration: T.nilable(String),
+              entity_type:
+                T.nilable(
+                  Sentdm::ProfileUpdateParams::Brand::Business::EntityType::OrSymbol
+                ),
+              legal_name: T.nilable(String),
+              postal_code: T.nilable(String),
+              state: T.nilable(String),
+              street: T.nilable(String),
+              tax_id: T.nilable(String),
+              tax_id_type: T.nilable(String),
+              url: T.nilable(String)
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # City
+            city: nil,
+            # Country code (e.g., US, CA)
+            country: nil,
+            # Country where the business is registered
+            country_of_registration: nil,
+            entity_type: nil,
+            # Legal business name
+            legal_name: nil,
+            # Postal/ZIP code
+            postal_code: nil,
+            # State/province code
+            state: nil,
+            # Street address
+            street: nil,
+            # Tax ID/EIN number
+            tax_id: nil,
+            # Type of tax ID (e.g., us_ein, ca_bn)
+            tax_id_type: nil,
+            # Business website URL
+            url: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                city: T.nilable(String),
+                country: T.nilable(String),
+                country_of_registration: T.nilable(String),
+                entity_type:
+                  T.nilable(
+                    Sentdm::ProfileUpdateParams::Brand::Business::EntityType::OrSymbol
+                  ),
+                legal_name: T.nilable(String),
+                postal_code: T.nilable(String),
+                state: T.nilable(String),
+                street: T.nilable(String),
+                tax_id: T.nilable(String),
+                tax_id_type: T.nilable(String),
+                url: T.nilable(String)
+              }
+            )
+          end
+          def to_hash
+          end
+
+          module EntityType
+            extend Sentdm::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  Sentdm::ProfileUpdateParams::Brand::Business::EntityType
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            PRIVATE_PROFIT =
+              T.let(
+                :PRIVATE_PROFIT,
+                Sentdm::ProfileUpdateParams::Brand::Business::EntityType::TaggedSymbol
+              )
+            PUBLIC_PROFIT =
+              T.let(
+                :PUBLIC_PROFIT,
+                Sentdm::ProfileUpdateParams::Brand::Business::EntityType::TaggedSymbol
+              )
+            NON_PROFIT =
+              T.let(
+                :NON_PROFIT,
+                Sentdm::ProfileUpdateParams::Brand::Business::EntityType::TaggedSymbol
+              )
+            SOLE_PROPRIETOR =
+              T.let(
+                :SOLE_PROPRIETOR,
+                Sentdm::ProfileUpdateParams::Brand::Business::EntityType::TaggedSymbol
+              )
+            GOVERNMENT =
+              T.let(
+                :GOVERNMENT,
+                Sentdm::ProfileUpdateParams::Brand::Business::EntityType::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  Sentdm::ProfileUpdateParams::Brand::Business::EntityType::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+        end
+      end
+
+      class PaymentDetails < Sentdm::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Sentdm::ProfileUpdateParams::PaymentDetails,
+              Sentdm::Internal::AnyHash
+            )
+          end
+
+        # Card number (digits only, 13–19 characters)
+        sig { returns(String) }
+        attr_accessor :card_number
+
+        # Card security code (3–4 digits)
+        sig { returns(String) }
+        attr_accessor :cvc
+
+        # Card expiry date in MM/YY format (e.g. "09/27")
+        sig { returns(String) }
+        attr_accessor :expiry
+
+        # Billing ZIP / postal code associated with the card
+        sig { returns(String) }
+        attr_accessor :zip_code
+
+        # Payment card details for this profile (optional). Accepted when billing_model is
+        # "profile" or "profile_and_organization". Not persisted on our servers —
+        # forwarded to the payment processor.
+        sig do
+          params(
+            card_number: String,
+            cvc: String,
+            expiry: String,
+            zip_code: String
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Card number (digits only, 13–19 characters)
+          card_number:,
+          # Card security code (3–4 digits)
+          cvc:,
+          # Card expiry date in MM/YY format (e.g. "09/27")
+          expiry:,
+          # Billing ZIP / postal code associated with the card
+          zip_code:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              card_number: String,
+              cvc: String,
+              expiry: String,
+              zip_code: String
+            }
+          )
+        end
+        def to_hash
+        end
+      end
     end
   end
 end