stripe 13.4.1 → 17.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2638ea0597055a2869c08a1c8ee7048e4cdabf5e5cb38c9f7890d2c9973d75c7
-  data.tar.gz: d8db160ddd21528d73155b979da9435d176fb51d42cbf388d108c67e50228016
+  metadata.gz: 230ecd8e97cb4d5fdef804169275dd58da00fbc50b852672d17457f9600d03b7
+  data.tar.gz: 0d14a4fe942942fb09ac66a105e8edc661cf8424912be11669f4d3fadd795e27
 SHA512:
-  metadata.gz: 4dd0a07340287d574b50102282eeef702dbc20a9a60c3636bc895629d844db1ade530006b66230c2bedfe29582b2e62614d09888273793a8e554106a387ebfef
-  data.tar.gz: f9784d26d9ac9b37141ce5b5d22951d1cd1b61286622da678b3fd3d8511b8f84795ebe85db58f2dcf785995b547073d7ad262e07c8be06b502d1370dcf470878
+  metadata.gz: 8a36ae83f5ed2ea5615fe81c9ae89bb438b144712305d784f59fd206bf65a4415c4df94a4b7271e66ba2af892310ce0832b05c35006034091cf1ad0eda4e9bcf
+  data.tar.gz: 23fac707a9180b04522dc4c030cb1a37c658d06da31fe3e04f21fa8fcf9332dd55d0baaca80b8a1f8b321e69ff560bd9f4717498dea02430e452bd355ec601ba

data/lib/stripe/api_operations/nested_resource.rb

@@ -45,53 +45,53 @@ module Stripe
         when :create
           define_singleton_method(:"create_#{resource}") \
               do |id, params = {}, opts = {}|
-            request_stripe_object(
-              method: :post,
-              path: send(resource_url_method, id),
-              params: params,
-              opts: opts
-            )
-          end
+                request_stripe_object(
+                  method: :post,
+                  path: send(resource_url_method, id),
+                  params: params,
+                  opts: opts
+                )
+              end
         when :retrieve
           define_singleton_method(:"retrieve_#{resource}") \
               do |id, nested_id, params = {}, opts = {}|
-            request_stripe_object(
-              method: :get,
-              path: send(resource_url_method, id, nested_id),
-              params: params,
-              opts: opts
-            )
-          end
+                request_stripe_object(
+                  method: :get,
+                  path: send(resource_url_method, id, nested_id),
+                  params: params,
+                  opts: opts
+                )
+              end
         when :update
           define_singleton_method(:"update_#{resource}") \
               do |id, nested_id, params = {}, opts = {}|
-            request_stripe_object(
-              method: :post,
-              path: send(resource_url_method, id, nested_id),
-              params: params,
-              opts: opts
-            )
-          end
+                request_stripe_object(
+                  method: :post,
+                  path: send(resource_url_method, id, nested_id),
+                  params: params,
+                  opts: opts
+                )
+              end
         when :delete
           define_singleton_method(:"delete_#{resource}") \
               do |id, nested_id, params = {}, opts = {}|
-            request_stripe_object(
-              method: :delete,
-              path: send(resource_url_method, id, nested_id),
-              params: params,
-              opts: opts
-            )
-          end
+                request_stripe_object(
+                  method: :delete,
+                  path: send(resource_url_method, id, nested_id),
+                  params: params,
+                  opts: opts
+                )
+              end
         when :list
           define_singleton_method(:"list_#{resource_plural}") \
               do |id, params = {}, opts = {}|
-            request_stripe_object(
-              method: :get,
-              path: send(resource_url_method, id),
-              params: params,
-              opts: opts
-            )
-          end
+                request_stripe_object(
+                  method: :get,
+                  path: send(resource_url_method, id),
+                  params: params,
+                  opts: opts
+                )
+              end
         else
           raise ArgumentError, "Unknown operation: #{operation.inspect}"
         end

data/lib/stripe/api_operations/request.rb

@@ -34,6 +34,7 @@ module Stripe
                                                       method, url, base_address,
                                                       params, opts, usage,
                                                       &read_body_chunk_block)
+          params = params.to_h if params.is_a?(Stripe::RequestParams)
           params ||= {}
 
           error_on_invalid_params(params)

data/lib/stripe/api_operations/save.rb

@@ -67,7 +67,8 @@ module Stripe
         values.delete(:id)
         opts = Util.normalize_opts(opts)
         APIRequestor.active_requestor.execute_request_initialize_from(:post, save_url, :api, self,
-                                                                      params: values, opts: opts,
+                                                                      params: values,
+                                                                      opts: RequestOptions.extract_opts_from_hash(opts),
                                                                       usage: ["save"])
       end
       extend Gem::Deprecate

data/lib/stripe/api_operations/singleton_save.rb

@@ -64,7 +64,8 @@ module Stripe
         opts = Util.normalize_opts(opts)
 
         APIRequestor.active_requestor.execute_request_initialize_from(:post, resource_url, :api, self,
-                                                                      params: values, opts: opts,
+                                                                      params: values,
+                                                                      opts: RequestOptions.extract_opts_from_hash(opts),
                                                                       usage: ["save"])
       end
       extend Gem::Deprecate

data/lib/stripe/api_requestor.rb

@@ -196,6 +196,7 @@ module Stripe
 
     def execute_request(method, path, base_address,
                         params: {}, opts: {}, usage: [])
+      params = params.to_h if params.is_a?(RequestParams)
       http_resp, req_opts = execute_request_internal(
         method, path, base_address, params, opts, usage
       )
@@ -210,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
@@ -219,8 +221,11 @@ module Stripe
     # with future non-major changes.
     def execute_request_initialize_from(method, path, base_address, object,
                                         params: {}, opts: {}, usage: [])
-      opts = RequestOptions.combine_opts(object.instance_variable_get(:@opts), opts)
+      opts = RequestOptions.combine_opts(object.instance_variable_get(:@opts) || {}, opts)
       opts = Util.normalize_opts(opts)
+
+      params = params.to_h if params.is_a?(RequestParams)
+
       http_resp, req_opts = execute_request_internal(
         method, path, base_address, params, opts, usage
       )
@@ -270,6 +275,7 @@ module Stripe
               "execute_request_stream requires a read_body_chunk_block"
       end
 
+      params = params.to_h if params.is_a?(RequestParams)
       http_resp, api_key = execute_request_internal(
         method, path, base_address, params, opts, usage, &read_body_chunk_block
       )
@@ -566,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
@@ -908,7 +916,7 @@ module Stripe
                   "with Stripe. Please let us know at support@stripe.com."
       end
 
-      message = message % base_url
+      message %= base_url
 
       message += " Request was retried #{num_retries} times." if num_retries > 0
 

data/lib/stripe/api_resource.rb

@@ -98,7 +98,10 @@ module Stripe
               "It is not possible to refresh v2 objects. Please retrieve the object using the StripeClient instead."
       end
 
-      @obj = @requestor.execute_request_initialize_from(:get, resource_url, :api, self, params: @retrieve_params)
+      opts = RequestOptions.extract_opts_from_hash(@retrieve_opts || {})
+      @retrieve_opts = {} # Make sure to clear the retrieve options
+      @obj = @requestor.execute_request_initialize_from(:get, resource_url, :api, self, params: @retrieve_params,
+                                                                                        opts: opts)
       initialize_from(
         @obj.last_response.data,
         @obj.instance_variable_get(:@opts),
@@ -108,14 +111,21 @@ 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,
               "It is not possible to retrieve v2 objects on the resource. Please use the StripeClient instead."
       end
 
-      opts = Util.normalize_opts(opts)
-      instance = new(id, opts)
+      instance = new(id)
+      # Explicitly send options for the retrieve call, to preserve custom headers
+      # This is so we can pass custom headers from this static function
+      # to the instance variable method call
+      # The custom headers will be cleaned up with the rest of the RequestOptions
+      instance.instance_variable_set(:@retrieve_opts, Util.normalize_opts(opts))
       instance.refresh
     end
 

data/lib/stripe/api_version.rb

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

data/lib/stripe/connection_manager.rb

@@ -36,9 +36,7 @@ module Stripe
     # clears them from internal tracking.
     def clear
       @mutex.synchronize do
-        @active_connections.each do |_, connection|
-          connection.finish
-        end
+        @active_connections.each_value(&:finish)
         @active_connections = {}
       end
     end

data/lib/stripe/errors.rb

@@ -31,13 +31,6 @@ module Stripe
       ErrorObject.construct_from(@json_body[:error], {}, nil, :v1)
     end
 
-    # Whether the error was the result of an idempotent replay, meaning that it
-    # originally occurred on a previous request and is being replayed back
-    # because the user sent the same idempotency key for this one.
-    def idempotent_replayed?
-      @idempotent_replayed
-    end
-
     def to_s
       status_string = @http_status.nil? ? "" : "(Status #{@http_status}) "
       id_string = @request_id.nil? ? "" : "(Request #{@request_id}) "

data/lib/stripe/event_types.rb

@@ -2,12 +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,
-        # 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
-  # This event occurs when there are invalid async usage events for a given meter.
-  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
-  # This event occurs when async usage events have missing or invalid meter ids.
-  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

@@ -0,0 +1,44 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  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
+
+    # 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/oauth.rb

@@ -8,7 +8,7 @@ module Stripe
       def self.execute_resource_request(method, url, base_address, params, opts)
         opts = Util.normalize_opts(opts)
 
-        super(method, url, base_address, params, opts)
+        super
       end
     end