stripe 15.5.0 → 16.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4f04fbc113367443375db3dcfeadcdb52defc2ea38ffd147c34d37908ac43339
-  data.tar.gz: d018bfcdd1c87f3bd8dcb3c6c930069c81837effbf34b79ea22ad6d704845ab1
+  metadata.gz: d238eca90d5a382895c2c16182ae3e1533ce92e1a9389eabfd4c2480be799006
+  data.tar.gz: fce1c07115c7468ff7d8d4e8e45da8c89bc56c9c6df0d12560b5980f75928984
 SHA512:
-  metadata.gz: f3f986fd41b327a79cce8222280eeffcee2b4203cb1ee4a537140884f8e2117805d51926d044f772797de1061e31e9a7727bbb4aa2e34b3a1dc5da5cb1d36372
-  data.tar.gz: 20f073040f2701def839ecc3f86c0074c8145fcb32eff4258d718aa5540d9d58896d9de563db13567673fe0f491390ca19161226c4f409bcf606b30afdd32451
+  metadata.gz: fcb1bed464c9c2557f12a709d505f72ee608bd26aef5ba1526911690592f7e237395b3a59cc400161b378a3ae25aa0c3e3674c1d315bfe6730ed28dadad6fafd
+  data.tar.gz: 3aa5184924bb121e02ec7ad1798426329c008b9fbe198a4481a9acaf74a52ab0511ce2f87562f068ea6c3ea38b709445bdf2d67f7d7d143a680bddfdde73d01f

data/lib/stripe/api_requestor.rb

@@ -211,7 +211,8 @@ module Stripe
 
       api_mode = Util.get_api_mode(path)
       Util.convert_to_stripe_object_with_params(resp.data, params, RequestOptions.persistable(req_opts), resp,
-                                                api_mode: api_mode, requestor: self)
+                                                api_mode: api_mode, requestor: self,
+                                                v2_deleted_object: method == :delete && api_mode == :v2)
     end
 
     # Execute request without instantiating a new object if the relevant object's name matches the class
@@ -571,8 +572,10 @@ module Stripe
         headers["Content-Type"] = content_type
 
         # `#to_s` any complex objects like files and the like to build output
-        # that's more condusive to logging.
+        # that's more conducive to logging.
         flattened_params =
+          # https://go/j/RUN_DEVSDK-1956 - this is probably a bug
+          # once fixed, you can remove the exclusions referencing this ticket in .rubocop.yml
           flattened_params.map { |k, v| [k, v.is_a?(String) ? v : v.to_s] }.to_h
 
       elsif api_mode == :v2

data/lib/stripe/api_resource.rb

@@ -111,6 +111,9 @@ module Stripe
       )
     end
 
+    # Retrieve by passing id like `retrieve(id)`
+    # If passing parameters, pass a single map with parameters and the `id` as well.
+    # For example: retrieve({id: some_id, some_param: some_param_value})
     def self.retrieve(id, opts = {})
       if name.include?("Stripe::V2")
         raise NotImplementedError,

data/lib/stripe/api_version.rb

@@ -3,7 +3,7 @@
 
 module Stripe
   module ApiVersion
-    CURRENT = "2025-08-27.basil"
-    CURRENT_MAJOR = "basil"
+    CURRENT = "2025-09-30.clover"
+    CURRENT_MAJOR = "clover"
   end
 end

data/lib/stripe/event_types.rb

@@ -2,13 +2,27 @@
 
 module Stripe
   module EventTypes
-    def self.thin_event_names_to_classes
+    def self.v2_event_types_to_classes
       {
-        # The beginning of the section generated from our OpenAPI spec
-        V1BillingMeterErrorReportTriggeredEvent.lookup_type => V1BillingMeterErrorReportTriggeredEvent,
-        V1BillingMeterNoMeterFoundEvent.lookup_type => V1BillingMeterNoMeterFoundEvent,
-        V2CoreEventDestinationPingEvent.lookup_type => V2CoreEventDestinationPingEvent,
-        # The end of the section generated from our OpenAPI spec
+        # v2 event types: The beginning of the section generated from our OpenAPI spec
+        Events::V1BillingMeterErrorReportTriggeredEvent.lookup_type =>
+        Events::V1BillingMeterErrorReportTriggeredEvent,
+        Events::V1BillingMeterNoMeterFoundEvent.lookup_type => Events::V1BillingMeterNoMeterFoundEvent,
+        Events::V2CoreEventDestinationPingEvent.lookup_type => Events::V2CoreEventDestinationPingEvent,
+        # v2 event types: The end of the section generated from our OpenAPI spec
+      }
+    end
+
+    def self.event_notification_types_to_classes
+      {
+        # event notification types: The beginning of the section generated from our OpenAPI spec
+        Events::V1BillingMeterErrorReportTriggeredEventNotification.lookup_type =>
+        Events::V1BillingMeterErrorReportTriggeredEventNotification,
+        Events::V1BillingMeterNoMeterFoundEventNotification.lookup_type =>
+        Events::V1BillingMeterNoMeterFoundEventNotification,
+        Events::V2CoreEventDestinationPingEventNotification.lookup_type =>
+        Events::V2CoreEventDestinationPingEventNotification,
+        # event notification types: The end of the section generated from our OpenAPI spec
       }
     end
   end

data/lib/stripe/events/unknown_event_notification.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require "stripe/resources/v2/core/event_notification"
+
+module Stripe
+  module Events
+    class UnknownEventNotification < Stripe::V2::Core::EventNotification
+      attr_reader :related_object
+
+      def fetch_related_object
+        return nil if @related_object.nil?
+
+        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/v1_billing_meter_error_report_triggered_event.rb

@@ -2,22 +2,122 @@
 # frozen_string_literal: true
 
 module Stripe
-  # Occurs when a Meter has invalid async usage events.
-  class V1BillingMeterErrorReportTriggeredEvent < Stripe::V2::Event
-    def self.lookup_type
-      "v1.billing.meter.error_report_triggered"
+  module Events
+    # Occurs when a Meter has invalid async usage events.
+    class V1BillingMeterErrorReportTriggeredEvent < Stripe::V2::Core::Event
+      def self.lookup_type
+        "v1.billing.meter.error_report_triggered"
+      end
+
+      class V1BillingMeterErrorReportTriggeredEventData < Stripe::StripeObject
+        class Reason < Stripe::StripeObject
+          class ErrorType < Stripe::StripeObject
+            class SampleError < Stripe::StripeObject
+              class Request < Stripe::StripeObject
+                # The request idempotency key.
+                attr_reader :identifier
+
+                def self.inner_class_types
+                  @inner_class_types = {}
+                end
+
+                def self.field_remappings
+                  @field_remappings = {}
+                end
+              end
+              # The error message.
+              attr_reader :error_message
+              # The request causes the error.
+              attr_reader :request
+
+              def self.inner_class_types
+                @inner_class_types = { request: Request }
+              end
+
+              def self.field_remappings
+                @field_remappings = {}
+              end
+            end
+            # Open Enum.
+            attr_reader :code
+            # The number of errors of this type.
+            attr_reader :error_count
+            # A list of sample errors of this type.
+            attr_reader :sample_errors
+
+            def self.inner_class_types
+              @inner_class_types = { sample_errors: SampleError }
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+          # The total error count within this window.
+          attr_reader :error_count
+          # The error details.
+          attr_reader :error_types
+
+          def self.inner_class_types
+            @inner_class_types = { error_types: ErrorType }
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # This contains information about why meter error happens.
+        attr_reader :reason
+        # Extra field included in the event's `data` when fetched from /v2/events.
+        attr_reader :developer_message_summary
+        # The start of the window that is encapsulated by this summary.
+        attr_reader :validation_start
+        # The end of the window that is encapsulated by this summary.
+        attr_reader :validation_end
+
+        def self.inner_class_types
+          @inner_class_types = { reason: Reason }
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
+      def self.inner_class_types
+        @inner_class_types = { data: V1BillingMeterErrorReportTriggeredEventData }
+      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
-    # There is additional data present for this event, accessible with the `data` property.
-    # See the Stripe API docs for more information.
-
-    # Retrieves the related object from the API. Make an API request on every call.
-    def fetch_related_object
-      _request(
-        method: :get,
-        path: related_object.url,
-        base_address: :api,
-        opts: { stripe_account: context }
-      )
+
+    # Occurs when a Meter has invalid async usage events.
+    class V1BillingMeterErrorReportTriggeredEventNotification < Stripe::V2::Core::EventNotification
+      def self.lookup_type
+        "v1.billing.meter.error_report_triggered"
+      end
+
+      attr_reader :related_object
+
+      # Retrieves the Meter 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/v1_billing_meter_no_meter_found_event.rb

@@ -2,12 +2,99 @@
 # frozen_string_literal: true
 
 module Stripe
-  # Occurs when a Meter's id is missing or invalid in async usage events.
-  class V1BillingMeterNoMeterFoundEvent < Stripe::V2::Event
-    def self.lookup_type
-      "v1.billing.meter.no_meter_found"
+  module Events
+    # Occurs when a Meter's id is missing or invalid in async usage events.
+    class V1BillingMeterNoMeterFoundEvent < Stripe::V2::Core::Event
+      def self.lookup_type
+        "v1.billing.meter.no_meter_found"
+      end
+
+      class V1BillingMeterNoMeterFoundEventData < Stripe::StripeObject
+        class Reason < Stripe::StripeObject
+          class ErrorType < Stripe::StripeObject
+            class SampleError < Stripe::StripeObject
+              class Request < Stripe::StripeObject
+                # The request idempotency key.
+                attr_reader :identifier
+
+                def self.inner_class_types
+                  @inner_class_types = {}
+                end
+
+                def self.field_remappings
+                  @field_remappings = {}
+                end
+              end
+              # The error message.
+              attr_reader :error_message
+              # The request causes the error.
+              attr_reader :request
+
+              def self.inner_class_types
+                @inner_class_types = { request: Request }
+              end
+
+              def self.field_remappings
+                @field_remappings = {}
+              end
+            end
+            # Open Enum.
+            attr_reader :code
+            # The number of errors of this type.
+            attr_reader :error_count
+            # A list of sample errors of this type.
+            attr_reader :sample_errors
+
+            def self.inner_class_types
+              @inner_class_types = { sample_errors: SampleError }
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+          # The total error count within this window.
+          attr_reader :error_count
+          # The error details.
+          attr_reader :error_types
+
+          def self.inner_class_types
+            @inner_class_types = { error_types: ErrorType }
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # This contains information about why meter error happens.
+        attr_reader :reason
+        # Extra field included in the event's `data` when fetched from /v2/events.
+        attr_reader :developer_message_summary
+        # The start of the window that is encapsulated by this summary.
+        attr_reader :validation_start
+        # The end of the window that is encapsulated by this summary.
+        attr_reader :validation_end
+
+        def self.inner_class_types
+          @inner_class_types = { reason: Reason }
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
+      def self.inner_class_types
+        @inner_class_types = { data: V1BillingMeterNoMeterFoundEventData }
+      end
+      attr_reader :data
+    end
+
+    # Occurs when a Meter's id is missing or invalid in async usage events.
+    class V1BillingMeterNoMeterFoundEventNotification < Stripe::V2::Core::EventNotification
+      def self.lookup_type
+        "v1.billing.meter.no_meter_found"
+      end
     end
-    # There is additional data present for this event, accessible with the `data` property.
-    # See the Stripe API docs for more information.
   end
 end

data/lib/stripe/events/v2_core_event_destination_ping_event.rb

@@ -2,20 +2,43 @@
 # frozen_string_literal: true
 
 module Stripe
-  # A ping event used to test the connection to an EventDestination.
-  class V2CoreEventDestinationPingEvent < Stripe::V2::Event
-    def self.lookup_type
-      "v2.core.event_destination.ping"
+  module Events
+    # A ping event used to test the connection to an EventDestination.
+    class V2CoreEventDestinationPingEvent < Stripe::V2::Core::Event
+      def self.lookup_type
+        "v2.core.event_destination.ping"
+      end
+
+      # 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
+      attr_reader :related_object
     end
 
-    # Retrieves the related object from the API. Make an API request on every call.
-    def fetch_related_object
-      _request(
-        method: :get,
-        path: related_object.url,
-        base_address: :api,
-        opts: { stripe_account: context }
-      )
+    # A ping event used to test the connection to an EventDestination.
+    class V2CoreEventDestinationPingEventNotification < Stripe::V2::Core::EventNotification
+      def self.lookup_type
+        "v2.core.event_destination.ping"
+      end
+
+      attr_reader :related_object
+
+      # Retrieves the EventDestination 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/object_types.rb

@@ -21,6 +21,7 @@ module Stripe
         ApplicationFeeRefund.object_name => ApplicationFeeRefund,
         Apps::Secret.object_name => Apps::Secret,
         Balance.object_name => Balance,
+        BalanceSettings.object_name => BalanceSettings,
         BalanceTransaction.object_name => BalanceTransaction,
         BankAccount.object_name => BankAccount,
         Billing::Alert.object_name => Billing::Alert,
@@ -161,8 +162,8 @@ module Stripe
         V2::Billing::MeterEvent.object_name => V2::Billing::MeterEvent,
         V2::Billing::MeterEventAdjustment.object_name => V2::Billing::MeterEventAdjustment,
         V2::Billing::MeterEventSession.object_name => V2::Billing::MeterEventSession,
-        V2::Event.object_name => V2::Event,
-        V2::EventDestination.object_name => V2::EventDestination,
+        V2::Core::Event.object_name => V2::Core::Event,
+        V2::Core::EventDestination.object_name => V2::Core::EventDestination,
         # v2 object classes: The end of the section generated from our OpenAPI spec
       }
     end

data/lib/stripe/params/account_capability_list_params.rb

@@ -0,0 +1,13 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  class AccountCapabilityListParams < Stripe::RequestParams
+    # Specifies which fields in the response should be expanded.
+    attr_accessor :expand
+
+    def initialize(expand: nil)
+      @expand = expand
+    end
+  end
+end

data/lib/stripe/params/account_capability_retrieve_params.rb

@@ -0,0 +1,13 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  class AccountCapabilityRetrieveParams < Stripe::RequestParams
+    # Specifies which fields in the response should be expanded.
+    attr_accessor :expand
+
+    def initialize(expand: nil)
+      @expand = expand
+    end
+  end
+end

data/lib/stripe/params/account_capability_update_params.rb

@@ -0,0 +1,18 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  class AccountCapabilityUpdateParams < Stripe::RequestParams
+    # Specifies which fields in the response should be expanded.
+    attr_accessor :expand
+    # To request a new capability for an account, pass true. There can be a delay before the requested capability becomes active. If the capability has any activation requirements, the response includes them in the `requirements` arrays.
+    #
+    # If a capability isn't permanent, you can remove it from the account by passing false. Some capabilities are permanent after they've been requested. Attempting to remove a permanent capability returns an error.
+    attr_accessor :requested
+
+    def initialize(expand: nil, requested: nil)
+      @expand = expand
+      @requested = requested
+    end
+  end
+end