stripe 18.5.0.pre.alpha.1 → 18.5.0.pre.alpha.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: efd842c062e6b8f24cac7eecf528d528026332a8a41499a3a52765adf25c23a7
-  data.tar.gz: cd3116248b44274d463cd9b8cc66c73bb838afa78757469a95db742e904fd696
+  metadata.gz: 889bcc035b68b5aab0a3a6fefc81a2161d397b8c54796f03491b296253d8999b
+  data.tar.gz: 808eb12a8acbed40ea9f0b89155d11026a4a963a0ed8b928eb3becbaae28a222
 SHA512:
-  metadata.gz: 03d38ebf9f5650e66ecd352a22c3a38f18ecca129559940099f43760c1825726dd8923ab31d1892c8df7147a30b122e9ed3c30e946662772f09b24e5e0fc068b
-  data.tar.gz: f509a4e4c63c6273df5c15960f347ad02abd464763c231594ed114ccb33156dd1829249e053d7da9ce32751788cba96e05bb59d3f2df79499fd17022acd857af
+  metadata.gz: f57e3de39673830952d0864947ee06525c9ad4b34cb395e56f3019eb4be8819ecb75f96a71f038a5683a929324abbd95d0e8555d1dc1e52edabb2fc75ed34a67
+  data.tar.gz: 69dbf016c00f9d1594e63f82e7d0d0cb26950d0b565d0f08e953082df54feb88e5bcf814613cd2cb61464f0ffbf0ec85939283a0387fa10c3db4ae0c2bf4d9d5

data/lib/stripe/api_requestor.rb

@@ -964,6 +964,9 @@ module Stripe
       user_agent = "Stripe/#{api_mode} RubyBindings/#{Stripe::VERSION}"
       user_agent += " " + format_app_info(Stripe.app_info) unless Stripe.app_info.nil?
 
+      ai_agent = SystemProfiler.detect_ai_agent
+      user_agent += " AIAgent/#{ai_agent}" unless ai_agent.empty?
+
       headers = {
         "User-Agent" => user_agent,
         "Authorization" => "Bearer #{req_opts[:api_key]}",
@@ -1125,6 +1128,23 @@ module Stripe
         "uname lookup failed"
       end
 
+      AI_AGENTS = [
+        %w[ANTIGRAVITY_CLI_ALIAS antigravity],
+        %w[CLAUDECODE claude_code],
+        %w[CLINE_ACTIVE cline],
+        %w[CODEX_SANDBOX codex_cli],
+        %w[CURSOR_AGENT cursor],
+        %w[GEMINI_CLI gemini_cli],
+        %w[OPENCODE open_code],
+      ].freeze
+
+      def self.detect_ai_agent(env = ENV)
+        AI_AGENTS.each do |env_var, agent_name|
+          return agent_name if env[env_var] && !env[env_var].empty?
+        end
+        ""
+      end
+
       def initialize
         @uname = self.class.uname
       end
@@ -1133,7 +1153,7 @@ module Stripe
         lang_version = "#{RUBY_VERSION} p#{RUBY_PATCHLEVEL} " \
                        "(#{RUBY_RELEASE_DATE})"
 
-        {
+        ua = {
           application: Stripe.app_info,
           bindings_version: Stripe::VERSION,
           lang: "ruby",
@@ -1144,6 +1164,11 @@ module Stripe
           uname: @uname,
           hostname: Socket.gethostname,
         }.delete_if { |_k, v| v.nil? }
+
+        ai_agent = self.class.detect_ai_agent
+        ua[:ai_agent] = ai_agent unless ai_agent.empty?
+
+        ua
       end
     end
 

data/lib/stripe/api_version.rb

@@ -3,6 +3,6 @@
 
 module Stripe
   module ApiVersion
-    CURRENT = "2026-01-28.preview"
+    CURRENT = "2026-03-04.preview"
   end
 end

data/lib/stripe/event_types.rb

@@ -44,6 +44,8 @@ module Stripe
         Events::V2BillingPricingPlanVersionCreatedEvent.lookup_type =>
         Events::V2BillingPricingPlanVersionCreatedEvent,
         Events::V2BillingRateCardCreatedEvent.lookup_type => Events::V2BillingRateCardCreatedEvent,
+        Events::V2BillingRateCardCustomPricingUnitOverageRateCreatedEvent.lookup_type =>
+        Events::V2BillingRateCardCustomPricingUnitOverageRateCreatedEvent,
         Events::V2BillingRateCardRateCreatedEvent.lookup_type => Events::V2BillingRateCardRateCreatedEvent,
         Events::V2BillingRateCardSubscriptionActivatedEvent.lookup_type =>
         Events::V2BillingRateCardSubscriptionActivatedEvent,
@@ -159,6 +161,17 @@ module Stripe
         Events::V2IamApiKeyPermissionsUpdatedEvent,
         Events::V2IamApiKeyRotatedEvent.lookup_type => Events::V2IamApiKeyRotatedEvent,
         Events::V2IamApiKeyUpdatedEvent.lookup_type => Events::V2IamApiKeyUpdatedEvent,
+        Events::V2IamStripeAccessGrantApprovedEvent.lookup_type =>
+        Events::V2IamStripeAccessGrantApprovedEvent,
+        Events::V2IamStripeAccessGrantCanceledEvent.lookup_type =>
+        Events::V2IamStripeAccessGrantCanceledEvent,
+        Events::V2IamStripeAccessGrantDeniedEvent.lookup_type => Events::V2IamStripeAccessGrantDeniedEvent,
+        Events::V2IamStripeAccessGrantRemovedEvent.lookup_type =>
+        Events::V2IamStripeAccessGrantRemovedEvent,
+        Events::V2IamStripeAccessGrantRequestedEvent.lookup_type =>
+        Events::V2IamStripeAccessGrantRequestedEvent,
+        Events::V2IamStripeAccessGrantUpdatedEvent.lookup_type =>
+        Events::V2IamStripeAccessGrantUpdatedEvent,
         Events::V2MoneyManagementAdjustmentCreatedEvent.lookup_type =>
         Events::V2MoneyManagementAdjustmentCreatedEvent,
         Events::V2MoneyManagementFinancialAccountCreatedEvent.lookup_type =>
@@ -339,6 +352,8 @@ module Stripe
         Events::V2BillingPricingPlanVersionCreatedEventNotification,
         Events::V2BillingRateCardCreatedEventNotification.lookup_type =>
         Events::V2BillingRateCardCreatedEventNotification,
+        Events::V2BillingRateCardCustomPricingUnitOverageRateCreatedEventNotification.lookup_type =>
+        Events::V2BillingRateCardCustomPricingUnitOverageRateCreatedEventNotification,
         Events::V2BillingRateCardRateCreatedEventNotification.lookup_type =>
         Events::V2BillingRateCardRateCreatedEventNotification,
         Events::V2BillingRateCardSubscriptionActivatedEventNotification.lookup_type =>
@@ -471,6 +486,18 @@ module Stripe
         Events::V2IamApiKeyRotatedEventNotification,
         Events::V2IamApiKeyUpdatedEventNotification.lookup_type =>
         Events::V2IamApiKeyUpdatedEventNotification,
+        Events::V2IamStripeAccessGrantApprovedEventNotification.lookup_type =>
+        Events::V2IamStripeAccessGrantApprovedEventNotification,
+        Events::V2IamStripeAccessGrantCanceledEventNotification.lookup_type =>
+        Events::V2IamStripeAccessGrantCanceledEventNotification,
+        Events::V2IamStripeAccessGrantDeniedEventNotification.lookup_type =>
+        Events::V2IamStripeAccessGrantDeniedEventNotification,
+        Events::V2IamStripeAccessGrantRemovedEventNotification.lookup_type =>
+        Events::V2IamStripeAccessGrantRemovedEventNotification,
+        Events::V2IamStripeAccessGrantRequestedEventNotification.lookup_type =>
+        Events::V2IamStripeAccessGrantRequestedEventNotification,
+        Events::V2IamStripeAccessGrantUpdatedEventNotification.lookup_type =>
+        Events::V2IamStripeAccessGrantUpdatedEventNotification,
         Events::V2MoneyManagementAdjustmentCreatedEventNotification.lookup_type =>
         Events::V2MoneyManagementAdjustmentCreatedEventNotification,
         Events::V2MoneyManagementFinancialAccountCreatedEventNotification.lookup_type =>

data/lib/stripe/events/v2_billing_rate_card_custom_pricing_unit_overage_rate_created_event.rb

@@ -0,0 +1,67 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Events
+    # Occurs when a RateCardCustomPricingUnitOverageRate is created.
+    class V2BillingRateCardCustomPricingUnitOverageRateCreatedEvent < Stripe::V2::Core::Event
+      def self.lookup_type
+        "v2.billing.rate_card_custom_pricing_unit_overage_rate.created"
+      end
+
+      class V2BillingRateCardCustomPricingUnitOverageRateCreatedEventData < ::Stripe::StripeObject
+        # Timestamp of when the object was created.
+        attr_reader :created
+        # The ID of the custom pricing unit this overage rate applies to.
+        attr_reader :custom_pricing_unit
+        # The ID of the RateCard Version when the custom pricing unit overage rate was created.
+        attr_reader :rate_card_version
+        # The ID of the RateCard which this custom pricing unit overage rate belongs to.
+        attr_reader :rate_card
+
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
+      def self.inner_class_types
+        @inner_class_types = { data: V2BillingRateCardCustomPricingUnitOverageRateCreatedEventData }
+      end
+      attr_reader :data, :related_object
+
+      # Retrieves the related object from the API. Makes an API request on every call.
+      def fetch_related_object
+        _request(
+          method: :get,
+          path: related_object.url,
+          base_address: :api,
+          opts: { stripe_context: context }
+        )
+      end
+    end
+
+    # Occurs when a RateCardCustomPricingUnitOverageRate is created.
+    class V2BillingRateCardCustomPricingUnitOverageRateCreatedEventNotification < Stripe::V2::Core::EventNotification
+      def self.lookup_type
+        "v2.billing.rate_card_custom_pricing_unit_overage_rate.created"
+      end
+
+      attr_reader :related_object
+
+      # Retrieves the RateCardCustomPricingUnitOverageRate related to this EventNotification from the Stripe API. Makes an API request on every call.
+      def fetch_related_object
+        resp = @client.raw_request(
+          :get,
+          related_object.url,
+          opts: { stripe_context: context },
+          usage: ["fetch_related_object"]
+        )
+        @client.deserialize(resp.http_body, api_mode: Util.get_api_mode(related_object.url))
+      end
+    end
+  end
+end

data/lib/stripe/events/v2_iam_stripe_access_grant_approved_event.rb

@@ -0,0 +1,20 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Events
+    # Occurs when a Stripe Access Grant is approved.
+    class V2IamStripeAccessGrantApprovedEvent < Stripe::V2::Core::Event
+      def self.lookup_type
+        "v2.iam.stripe_access_grant.approved"
+      end
+    end
+
+    # Occurs when a Stripe Access Grant is approved.
+    class V2IamStripeAccessGrantApprovedEventNotification < Stripe::V2::Core::EventNotification
+      def self.lookup_type
+        "v2.iam.stripe_access_grant.approved"
+      end
+    end
+  end
+end

data/lib/stripe/events/v2_iam_stripe_access_grant_canceled_event.rb

@@ -0,0 +1,20 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Events
+    # Occurs when a Stripe Access Grant is canceled by the requesting Stripe.
+    class V2IamStripeAccessGrantCanceledEvent < Stripe::V2::Core::Event
+      def self.lookup_type
+        "v2.iam.stripe_access_grant.canceled"
+      end
+    end
+
+    # Occurs when a Stripe Access Grant is canceled by the requesting Stripe.
+    class V2IamStripeAccessGrantCanceledEventNotification < Stripe::V2::Core::EventNotification
+      def self.lookup_type
+        "v2.iam.stripe_access_grant.canceled"
+      end
+    end
+  end
+end

data/lib/stripe/events/v2_iam_stripe_access_grant_denied_event.rb

@@ -0,0 +1,20 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Events
+    # Occurs when a Stripe Access Grant is denied (was pending, then denied by the customer).
+    class V2IamStripeAccessGrantDeniedEvent < Stripe::V2::Core::Event
+      def self.lookup_type
+        "v2.iam.stripe_access_grant.denied"
+      end
+    end
+
+    # Occurs when a Stripe Access Grant is denied (was pending, then denied by the customer).
+    class V2IamStripeAccessGrantDeniedEventNotification < Stripe::V2::Core::EventNotification
+      def self.lookup_type
+        "v2.iam.stripe_access_grant.denied"
+      end
+    end
+  end
+end

data/lib/stripe/events/v2_iam_stripe_access_grant_removed_event.rb

@@ -0,0 +1,20 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Events
+    # Occurs when a Stripe Access Grant is removed (was approved, and then removed by the customer).
+    class V2IamStripeAccessGrantRemovedEvent < Stripe::V2::Core::Event
+      def self.lookup_type
+        "v2.iam.stripe_access_grant.removed"
+      end
+    end
+
+    # Occurs when a Stripe Access Grant is removed (was approved, and then removed by the customer).
+    class V2IamStripeAccessGrantRemovedEventNotification < Stripe::V2::Core::EventNotification
+      def self.lookup_type
+        "v2.iam.stripe_access_grant.removed"
+      end
+    end
+  end
+end

data/lib/stripe/events/v2_iam_stripe_access_grant_requested_event.rb

@@ -0,0 +1,20 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Events
+    # Occurs when a Stripe Access Grant is requested.
+    class V2IamStripeAccessGrantRequestedEvent < Stripe::V2::Core::Event
+      def self.lookup_type
+        "v2.iam.stripe_access_grant.requested"
+      end
+    end
+
+    # Occurs when a Stripe Access Grant is requested.
+    class V2IamStripeAccessGrantRequestedEventNotification < Stripe::V2::Core::EventNotification
+      def self.lookup_type
+        "v2.iam.stripe_access_grant.requested"
+      end
+    end
+  end
+end

data/lib/stripe/events/v2_iam_stripe_access_grant_updated_event.rb

@@ -0,0 +1,20 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Events
+    # Occurs when a Stripe Access Grant is updated.
+    class V2IamStripeAccessGrantUpdatedEvent < Stripe::V2::Core::Event
+      def self.lookup_type
+        "v2.iam.stripe_access_grant.updated"
+      end
+    end
+
+    # Occurs when a Stripe Access Grant is updated.
+    class V2IamStripeAccessGrantUpdatedEventNotification < Stripe::V2::Core::EventNotification
+      def self.lookup_type
+        "v2.iam.stripe_access_grant.updated"
+      end
+    end
+  end
+end

data/lib/stripe/object_types.rb

@@ -28,6 +28,7 @@ module Stripe
         BalanceTransfer.object_name => BalanceTransfer,
         BankAccount.object_name => BankAccount,
         Billing::Alert.object_name => Billing::Alert,
+        Billing::AlertRecovered.object_name => Billing::AlertRecovered,
         Billing::AlertTriggered.object_name => Billing::AlertTriggered,
         Billing::Analytics::MeterUsage.object_name => Billing::Analytics::MeterUsage,
         Billing::Analytics::MeterUsageRow.object_name => Billing::Analytics::MeterUsageRow,
@@ -129,6 +130,7 @@ module Stripe
         Product.object_name => Product,
         ProductCatalog::TrialOffer.object_name => ProductCatalog::TrialOffer,
         ProductFeature.object_name => ProductFeature,
+        Profile.object_name => Profile,
         PromotionCode.object_name => PromotionCode,
         Quote.object_name => Quote,
         QuoteLine.object_name => QuoteLine,

data/lib/stripe/params/account_create_params.rb

@@ -2207,6 +2207,8 @@ module Stripe
       end
 
       class Payments < ::Stripe::RequestParams
+        # When you enable this parameter, the customer of this Account receives an email receipt when their payment succeeds. If this parameter isn't set, the default value is `false`.
+        attr_accessor :email_customers_on_successful_payment
         # The default text that appears on statements for non-card charges outside of Japan. For card charges, if you don't set a `statement_descriptor_prefix`, this text is also used as the statement descriptor prefix. In that case, if concatenating the statement descriptor suffix causes the combined statement descriptor to exceed 22 characters, we truncate the `statement_descriptor` text to limit the full descriptor to 22 characters. For more information about statement descriptors and their requirements, see the [account settings documentation](https://docs.stripe.com/get-started/account/statement-descriptors).
         attr_accessor :statement_descriptor
         # The Kana variation of `statement_descriptor` used for charges in Japan. Japanese statement descriptors have [special requirements](https://docs.stripe.com/get-started/account/statement-descriptors#set-japanese-statement-descriptors).
@@ -2215,10 +2217,12 @@ module Stripe
         attr_accessor :statement_descriptor_kanji
 
         def initialize(
+          email_customers_on_successful_payment: nil,
           statement_descriptor: nil,
           statement_descriptor_kana: nil,
           statement_descriptor_kanji: nil
         )
+          @email_customers_on_successful_payment = email_customers_on_successful_payment
           @statement_descriptor = statement_descriptor
           @statement_descriptor_kana = statement_descriptor_kana
           @statement_descriptor_kanji = statement_descriptor_kanji
@@ -2324,6 +2328,23 @@ module Stripe
         end
       end
 
+      class SmartDisputes < ::Stripe::RequestParams
+        class AutoRespond < ::Stripe::RequestParams
+          # The preference setting for auto-respond. Can be 'on', 'off', or 'inherit'.
+          attr_accessor :preference
+
+          def initialize(preference: nil)
+            @preference = preference
+          end
+        end
+        # Smart Disputes auto-respond settings for the account.
+        attr_accessor :auto_respond
+
+        def initialize(auto_respond: nil)
+          @auto_respond = auto_respond
+        end
+      end
+
       class TaxForms < ::Stripe::RequestParams
         # Whether the account opted out of receiving their tax forms by postal delivery.
         attr_accessor :consented_to_paperless_delivery
@@ -2375,6 +2396,8 @@ module Stripe
       attr_accessor :payouts
       # Settings specific to the PayPay payments method.
       attr_accessor :paypay_payments
+      # Settings specific to the account's use of Smart Disputes.
+      attr_accessor :smart_disputes
       # Settings specific to the account's tax forms.
       attr_accessor :tax_forms
       # Settings specific to the account's Treasury FinancialAccounts.
@@ -2391,6 +2414,7 @@ module Stripe
         payments: nil,
         payouts: nil,
         paypay_payments: nil,
+        smart_disputes: nil,
         tax_forms: nil,
         treasury: nil
       )
@@ -2404,6 +2428,7 @@ module Stripe
         @payments = payments
         @payouts = payouts
         @paypay_payments = paypay_payments
+        @smart_disputes = smart_disputes
         @tax_forms = tax_forms
         @treasury = treasury
       end

data/lib/stripe/params/account_link_create_params.rb

@@ -4,17 +4,17 @@
 module Stripe
   class AccountLinkCreateParams < ::Stripe::RequestParams
     class CollectionOptions < ::Stripe::RequestParams
+      # Specifies whether the platform collects external account information from connected accounts during Connect Onboarding. When set to `true`, the platform only collects external account information if the connected account has capabilities which require it. Some capabilities, such as `treasury`, don't require external account collection. When set to `false`, external account collection is skipped. Defaults to `true`.
+      attr_accessor :external_account_collection
       # Specifies whether the platform collects only currently_due requirements (`currently_due`) or both currently_due and eventually_due requirements (`eventually_due`). If you don't specify `collection_options`, the default value is `currently_due`.
       attr_accessor :fields
       # Specifies whether the platform collects future_requirements in addition to requirements in Connect Onboarding. The default value is `omit`.
       attr_accessor :future_requirements
-      # Specifies whether the platform collects external account information from connected accounts during Connect Onboarding. When set to `false`, external account collection is skipped. Defaults to `true`.
-      attr_accessor :external_account_collection
 
-      def initialize(fields: nil, future_requirements: nil, external_account_collection: nil)
+      def initialize(external_account_collection: nil, fields: nil, future_requirements: nil)
+        @external_account_collection = external_account_collection
         @fields = fields
         @future_requirements = future_requirements
-        @external_account_collection = external_account_collection
       end
     end
     # The identifier of the account to create an account link for.

data/lib/stripe/params/account_session_create_params.rb

@@ -734,6 +734,8 @@ module Stripe
       attr_accessor :account_management
       # Configuration for the [account onboarding](/connect/supported-embedded-components/account-onboarding/) embedded component.
       attr_accessor :account_onboarding
+      # Configuration for the [agentic commerce settings](/connect/supported-embedded-components/agentic-commerce-settings/) embedded component.
+      attr_accessor :agentic_commerce_settings
       # Configuration for the [app install](/connect/supported-embedded-components/app-install/) embedded component.
       attr_accessor :app_install
       # Configuration for the [app viewport](/connect/supported-embedded-components/app-viewport/) embedded component.
@@ -794,8 +796,6 @@ module Stripe
       attr_accessor :tax_settings
       # Configuration for the [tax threshold monitoring](/connect/supported-embedded-components/tax-threshold-monitoring/) embedded component.
       attr_accessor :tax_threshold_monitoring
-      # Configuration for the [agentic commerce settings](/connect/supported-embedded-components/agentic-commerce-settings/) embedded component.
-      attr_accessor :agentic_commerce_settings
       # Configuration for the [Terminal hardware orders](/connect/supported-embedded-components/terminal-hardware-orders/) embedded component.
       attr_accessor :terminal_hardware_orders
       # Configuration for the [Terminal hardware shop](/connect/supported-embedded-components/terminal-hardware-shop/) embedded component.
@@ -804,6 +804,7 @@ module Stripe
       def initialize(
         account_management: nil,
         account_onboarding: nil,
+        agentic_commerce_settings: nil,
         app_install: nil,
         app_viewport: nil,
         balances: nil,
@@ -834,12 +835,12 @@ module Stripe
         tax_registrations: nil,
         tax_settings: nil,
         tax_threshold_monitoring: nil,
-        agentic_commerce_settings: nil,
         terminal_hardware_orders: nil,
         terminal_hardware_shop: nil
       )
         @account_management = account_management
         @account_onboarding = account_onboarding
+        @agentic_commerce_settings = agentic_commerce_settings
         @app_install = app_install
         @app_viewport = app_viewport
         @balances = balances
@@ -870,7 +871,6 @@ module Stripe
         @tax_registrations = tax_registrations
         @tax_settings = tax_settings
         @tax_threshold_monitoring = tax_threshold_monitoring
-        @agentic_commerce_settings = agentic_commerce_settings
         @terminal_hardware_orders = terminal_hardware_orders
         @terminal_hardware_shop = terminal_hardware_shop
       end

data/lib/stripe/params/account_update_params.rb

@@ -2129,6 +2129,8 @@ module Stripe
       end
 
       class Payments < ::Stripe::RequestParams
+        # When you enable this parameter, the customer of this Account receives an email receipt when their payment succeeds. If this parameter isn't set, the default value is `false`.
+        attr_accessor :email_customers_on_successful_payment
         # The default text that appears on statements for non-card charges outside of Japan. For card charges, if you don't set a `statement_descriptor_prefix`, this text is also used as the statement descriptor prefix. In that case, if concatenating the statement descriptor suffix causes the combined statement descriptor to exceed 22 characters, we truncate the `statement_descriptor` text to limit the full descriptor to 22 characters. For more information about statement descriptors and their requirements, see the [account settings documentation](https://docs.stripe.com/get-started/account/statement-descriptors).
         attr_accessor :statement_descriptor
         # The Kana variation of `statement_descriptor` used for charges in Japan. Japanese statement descriptors have [special requirements](https://docs.stripe.com/get-started/account/statement-descriptors#set-japanese-statement-descriptors).
@@ -2137,10 +2139,12 @@ module Stripe
         attr_accessor :statement_descriptor_kanji
 
         def initialize(
+          email_customers_on_successful_payment: nil,
           statement_descriptor: nil,
           statement_descriptor_kana: nil,
           statement_descriptor_kanji: nil
         )
+          @email_customers_on_successful_payment = email_customers_on_successful_payment
           @statement_descriptor = statement_descriptor
           @statement_descriptor_kana = statement_descriptor_kana
           @statement_descriptor_kanji = statement_descriptor_kanji
@@ -2246,6 +2250,23 @@ module Stripe
         end
       end
 
+      class SmartDisputes < ::Stripe::RequestParams
+        class AutoRespond < ::Stripe::RequestParams
+          # The preference setting for auto-respond. Can be 'on', 'off', or 'inherit'.
+          attr_accessor :preference
+
+          def initialize(preference: nil)
+            @preference = preference
+          end
+        end
+        # Smart Disputes auto-respond settings for the account.
+        attr_accessor :auto_respond
+
+        def initialize(auto_respond: nil)
+          @auto_respond = auto_respond
+        end
+      end
+
       class TaxForms < ::Stripe::RequestParams
         # Whether the account opted out of receiving their tax forms by postal delivery.
         attr_accessor :consented_to_paperless_delivery
@@ -2297,6 +2318,8 @@ module Stripe
       attr_accessor :payouts
       # Settings specific to the PayPay payments method.
       attr_accessor :paypay_payments
+      # Settings specific to the account's use of Smart Disputes.
+      attr_accessor :smart_disputes
       # Settings specific to the account's tax forms.
       attr_accessor :tax_forms
       # Settings specific to the account's Treasury FinancialAccounts.
@@ -2313,6 +2336,7 @@ module Stripe
         payments: nil,
         payouts: nil,
         paypay_payments: nil,
+        smart_disputes: nil,
         tax_forms: nil,
         treasury: nil
       )
@@ -2326,6 +2350,7 @@ module Stripe
         @payments = payments
         @payouts = payouts
         @paypay_payments = paypay_payments
+        @smart_disputes = smart_disputes
         @tax_forms = tax_forms
         @treasury = treasury
       end

data/lib/stripe/params/billing/alert_create_params.rb

@@ -163,7 +163,7 @@ module Stripe
               @value = value
             end
           end
-          # The monetary amount. Required when type is `amount`.
+          # The monetary amount. Required when type is `amount`. The threshold is the total_before_tax, the amount consumed after all credits and discounts are applied, but before tax is applied.
           attr_accessor :amount
           # The custom pricing unit amount. Required when type is `custom_pricing_unit`.
           attr_accessor :custom_pricing_unit
@@ -207,7 +207,7 @@ module Stripe
         end
         # The filters allows limiting the scope of this usage alert. You can only specify up to one filter at this time.
         attr_accessor :filters
-        # Defines at which value the alert will fire.
+        # Defines the threshold value that triggers the alert.
         attr_accessor :gte
         # The [Billing Meter](/api/billing/meter) ID whose usage is monitored.
         attr_accessor :meter
@@ -227,27 +227,27 @@ module Stripe
       attr_accessor :credit_balance_threshold
       # Specifies which fields in the response should be expanded.
       attr_accessor :expand
+      # The configuration of the spend threshold. An event fires when the amount consumed exceeds the threshold, after all credits and discounts are applied but before tax is applied.
+      attr_accessor :spend_threshold
       # The title of the alert.
       attr_accessor :title
       # The configuration of the usage threshold.
       attr_accessor :usage_threshold
-      # The configuration of the spend threshold.
-      attr_accessor :spend_threshold
 
       def initialize(
         alert_type: nil,
         credit_balance_threshold: nil,
         expand: nil,
+        spend_threshold: nil,
         title: nil,
-        usage_threshold: nil,
-        spend_threshold: nil
+        usage_threshold: nil
       )
         @alert_type = alert_type
         @credit_balance_threshold = credit_balance_threshold
         @expand = expand
+        @spend_threshold = spend_threshold
         @title = title
         @usage_threshold = usage_threshold
-        @spend_threshold = spend_threshold
       end
     end
   end

data/lib/stripe/params/billing_portal/session_create_params.rb

@@ -142,7 +142,7 @@ module Stripe
           @type = type
         end
       end
-      # The ID of an existing [configuration](https://docs.stripe.com/api/customer_portal/configuration) to use for this session, describing its functionality and features. If not specified, the session uses the default configuration.
+      # The ID of an existing [configuration](https://docs.stripe.com/api/customer_portal/configurations) to use for this session, describing its functionality and features. If not specified, the session uses the default configuration.
       attr_accessor :configuration
       # The ID of an existing customer.
       attr_accessor :customer