stripe 15.6.0.pre.beta.1 → 16.0.0

data/lib/stripe/services.rb

@@ -5,7 +5,6 @@ require "stripe/services/account_capability_service"
 require "stripe/services/account_external_account_service"
 require "stripe/services/account_link_service"
 require "stripe/services/account_login_link_service"
-require "stripe/services/account_notice_service"
 require "stripe/services/account_person_service"
 require "stripe/services/account_service"
 require "stripe/services/account_session_service"
@@ -25,15 +24,10 @@ require "stripe/services/billing/meter_event_adjustment_service"
 require "stripe/services/billing/meter_event_service"
 require "stripe/services/billing/meter_event_summary_service"
 require "stripe/services/billing/meter_service"
-require "stripe/services/billing/meter_usage_service"
 require "stripe/services/billing_portal/configuration_service"
 require "stripe/services/billing_portal/session_service"
 require "stripe/services/billing_portal_service"
 require "stripe/services/billing_service"
-require "stripe/services/capital/financing_offer_service"
-require "stripe/services/capital/financing_summary_service"
-require "stripe/services/capital/financing_transaction_service"
-require "stripe/services/capital_service"
 require "stripe/services/charge_service"
 require "stripe/services/checkout/session_line_item_service"
 require "stripe/services/checkout/session_service"
@@ -64,19 +58,15 @@ require "stripe/services/entitlements_service"
 require "stripe/services/ephemeral_key_service"
 require "stripe/services/event_service"
 require "stripe/services/exchange_rate_service"
-require "stripe/services/external_account_service"
 require "stripe/services/file_link_service"
 require "stripe/services/file_service"
-require "stripe/services/financial_connections/account_inferred_balance_service"
 require "stripe/services/financial_connections/account_owner_service"
 require "stripe/services/financial_connections/account_service"
-require "stripe/services/financial_connections/institution_service"
 require "stripe/services/financial_connections/session_service"
 require "stripe/services/financial_connections/transaction_service"
 require "stripe/services/financial_connections_service"
 require "stripe/services/forwarding/request_service"
 require "stripe/services/forwarding_service"
-require "stripe/services/fx_quote_service"
 require "stripe/services/identity/verification_report_service"
 require "stripe/services/identity/verification_session_service"
 require "stripe/services/identity_service"
@@ -88,42 +78,27 @@ require "stripe/services/invoice_service"
 require "stripe/services/issuing/authorization_service"
 require "stripe/services/issuing/card_service"
 require "stripe/services/issuing/cardholder_service"
-require "stripe/services/issuing/credit_underwriting_record_service"
 require "stripe/services/issuing/dispute_service"
-require "stripe/services/issuing/dispute_settlement_detail_service"
-require "stripe/services/issuing/fraud_liability_debit_service"
 require "stripe/services/issuing/personalization_design_service"
 require "stripe/services/issuing/physical_bundle_service"
 require "stripe/services/issuing/token_service"
 require "stripe/services/issuing/transaction_service"
 require "stripe/services/issuing_service"
 require "stripe/services/mandate_service"
-require "stripe/services/margin_service"
-require "stripe/services/order_line_item_service"
-require "stripe/services/order_service"
-require "stripe/services/payment_attempt_record_service"
-require "stripe/services/payment_intent_amount_details_line_item_service"
 require "stripe/services/payment_intent_service"
 require "stripe/services/payment_link_line_item_service"
 require "stripe/services/payment_link_service"
 require "stripe/services/payment_method_configuration_service"
 require "stripe/services/payment_method_domain_service"
 require "stripe/services/payment_method_service"
-require "stripe/services/payment_record_service"
 require "stripe/services/payout_service"
 require "stripe/services/plan_service"
 require "stripe/services/price_service"
-require "stripe/services/privacy/redaction_job_service"
-require "stripe/services/privacy/redaction_job_validation_error_service"
-require "stripe/services/privacy_service"
 require "stripe/services/product_feature_service"
 require "stripe/services/product_service"
 require "stripe/services/promotion_code_service"
 require "stripe/services/quote_computed_upfront_line_items_service"
 require "stripe/services/quote_line_item_service"
-require "stripe/services/quote_line_service"
-require "stripe/services/quote_preview_invoice_service"
-require "stripe/services/quote_preview_subscription_schedule_service"
 require "stripe/services/quote_service"
 require "stripe/services/radar/early_fraud_warning_service"
 require "stripe/services/radar/value_list_item_service"
@@ -144,10 +119,8 @@ require "stripe/services/source_transaction_service"
 require "stripe/services/subscription_item_service"
 require "stripe/services/subscription_schedule_service"
 require "stripe/services/subscription_service"
-require "stripe/services/tax/association_service"
 require "stripe/services/tax/calculation_line_item_service"
 require "stripe/services/tax/calculation_service"
-require "stripe/services/tax/form_service"
 require "stripe/services/tax/registration_service"
 require "stripe/services/tax/settings_service"
 require "stripe/services/tax/transaction_line_item_service"
@@ -159,8 +132,6 @@ require "stripe/services/tax_service"
 require "stripe/services/terminal/configuration_service"
 require "stripe/services/terminal/connection_token_service"
 require "stripe/services/terminal/location_service"
-require "stripe/services/terminal/onboarding_link_service"
-require "stripe/services/terminal/reader_collected_data_service"
 require "stripe/services/terminal/reader_service"
 require "stripe/services/terminal_service"
 require "stripe/services/test_helpers/confirmation_token_service"
@@ -203,33 +174,8 @@ require "stripe/services/v2/billing/meter_event_service"
 require "stripe/services/v2/billing/meter_event_session_service"
 require "stripe/services/v2/billing/meter_event_stream_service"
 require "stripe/services/v2/billing_service"
-require "stripe/services/v2/core/account_link_service"
-require "stripe/services/v2/core/account_service"
-require "stripe/services/v2/core/accounts/person_service"
 require "stripe/services/v2/core/event_destination_service"
 require "stripe/services/v2/core/event_service"
-require "stripe/services/v2/core/vault/gb_bank_account_service"
-require "stripe/services/v2/core/vault/us_bank_account_service"
-require "stripe/services/v2/core/vault_service"
 require "stripe/services/v2/core_service"
-require "stripe/services/v2/money_management/adjustment_service"
-require "stripe/services/v2/money_management/financial_account_service"
-require "stripe/services/v2/money_management/financial_address_service"
-require "stripe/services/v2/money_management/inbound_transfer_service"
-require "stripe/services/v2/money_management/outbound_payment_quote_service"
-require "stripe/services/v2/money_management/outbound_payment_service"
-require "stripe/services/v2/money_management/outbound_setup_intent_service"
-require "stripe/services/v2/money_management/outbound_transfer_service"
-require "stripe/services/v2/money_management/payout_method_service"
-require "stripe/services/v2/money_management/payout_methods_bank_account_spec_service"
-require "stripe/services/v2/money_management/received_credit_service"
-require "stripe/services/v2/money_management/received_debit_service"
-require "stripe/services/v2/money_management/transaction_entry_service"
-require "stripe/services/v2/money_management/transaction_service"
-require "stripe/services/v2/money_management_service"
-require "stripe/services/v2/payment_service"
-require "stripe/services/v2/payments/off_session_payment_service"
-require "stripe/services/v2/test_helper_service"
-require "stripe/services/v2/test_helpers/financial_address_service"
 require "stripe/services/v2_services"
 require "stripe/services/webhook_endpoint_service"

data/lib/stripe/stripe_client.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "json"
+require "stripe/events/unknown_event_notification"
 
 module Stripe
   class StripeClient
@@ -42,7 +43,7 @@ module Stripe
         connect_base: connect_base,
         meter_events_base: meter_events_base,
         client_id: client_id,
-      }.reject { |_k, v| v.nil? }
+      }.compact
 
       config = StripeConfiguration.client_init(config_opts)
       @requestor = APIRequestor.new(config)
@@ -59,7 +60,7 @@ module Stripe
     extend Gem::Deprecate
     deprecate :request, :raw_request, 2024, 9
 
-    def parse_thin_event(payload, sig_header, secret, tolerance: Webhook::DEFAULT_TOLERANCE)
+    def parse_event_notification(payload, sig_header, secret, tolerance: Webhook::DEFAULT_TOLERANCE)
       payload = payload.force_encoding("UTF-8") if payload.respond_to?(:force_encoding)
 
       # v2 events use the same signing mechanism as v1 events
@@ -67,15 +68,17 @@ module Stripe
 
       parsed = JSON.parse(payload, symbolize_names: true)
 
-      Stripe::ThinEvent.new(parsed)
+      cls = Util.event_notification_classes.fetch(parsed[:type], Stripe::Events::UnknownEventNotification)
+
+      cls.new(parsed, self)
     end
 
-    def raw_request(method, url, base_address: :api, params: {}, opts: {})
+    def raw_request(method, url, base_address: :api, params: {}, opts: {}, usage: nil)
       opts = Util.normalize_opts(opts)
       req_opts = RequestOptions.extract_opts_from_hash(opts)
 
       params = params.to_h if params.is_a?(Stripe::RequestParams)
-      resp, = @requestor.send(:execute_request_internal, method, url, base_address, params, req_opts, usage: ["raw_request"])
+      resp, = @requestor.send(:execute_request_internal, method, url, base_address, params, req_opts, usage: usage || ["raw_request"])
 
       @requestor.interpret_response(resp)
     end

data/lib/stripe/stripe_configuration.rb

@@ -25,8 +25,7 @@ module Stripe
   # If `.logger` is set, the value of `.log_level` is ignored. The decision on
   # what levels to print is entirely deferred to the logger.
   class StripeConfiguration
-    attr_accessor :api_key, :api_version, :authenticator, :client_id, :enable_telemetry, :logger,
-                  :stripe_account, :stripe_context
+    attr_accessor :api_key, :api_version, :client_id, :enable_telemetry, :logger, :stripe_account, :stripe_context
 
     attr_reader :api_base, :uploads_base, :connect_base, :meter_events_base, :base_addresses, :ca_bundle_path,
                 :log_level, :initial_network_retry_delay, :max_network_retries, :max_network_retry_delay,
@@ -46,12 +45,7 @@ module Stripe
       imported_options = USER_CONFIGURABLE_GLOBAL_OPTIONS - StripeClient::CLIENT_OPTIONS
       client_config = StripeConfiguration.setup do |instance|
         imported_options.each do |key|
-          begin
-            instance.public_send("#{key}=", global_config.public_send(key)) if global_config.respond_to?(key)
-          rescue NotImplementedError => e
-            # In Ruby <= 2.5, we can't set write_timeout on Net::HTTP, log an error and continue
-            Util.log_error("Failed to set #{key} on client configuration: #{e}")
-          end
+          instance.public_send("#{key}=", global_config.public_send(key)) if global_config.respond_to?(key)
         end
       end
       client_config.reverse_duplicate_merge(config_opts)
@@ -72,7 +66,6 @@ module Stripe
 
     def initialize
       @api_version = ApiVersion::CURRENT
-
       @ca_bundle_path = Stripe::DEFAULT_CA_BUNDLE_PATH
       @enable_telemetry = true
       @verify_ssl_certs = true

data/lib/stripe/stripe_context.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+module Stripe
+  # Represents hierarchical context for Stripe API operations.
+  #
+  # This class is immutable - all methods return new instances rather than
+  # modifying the existing instance. It provides utilities for building
+  # context hierarchies and converting to/from string representations.
+  class StripeContext
+    include Comparable
+
+    attr_reader :segments
+
+    # Creates a new StripeContext with the given segments.
+    def initialize(segments = nil)
+      @segments = (segments || []).map(&:to_s).freeze
+    end
+
+    # Parses a context string into a StripeContext instance.
+    def self.parse(context_str)
+      return new if context_str.nil? || context_str.empty?
+
+      new(context_str.split("/"))
+    end
+
+    # Creates a new StripeContext with an additional segment appended.
+    def push(segment)
+      segment_str = segment.to_s.strip
+      raise ArgumentError, "Segment cannot be empty or whitespace" if segment_str.empty?
+
+      new_segments = @segments + [segment_str]
+      self.class.new(new_segments)
+    end
+
+    # Creates a new StripeContext with the last segment removed.
+    # If there are no segments, returns a new empty StripeContext.
+    def pop
+      raise IndexError, "No segments to pop" if @segments.empty?
+
+      new_segments = @segments[0...-1]
+      self.class.new(new_segments)
+    end
+
+    # Converts this context to its string representation.
+    def to_s
+      @segments.join("/")
+    end
+
+    # Checks equality with another StripeContext.
+    def ==(other)
+      other.is_a?(StripeContext) && @segments == other.segments
+    end
+
+    # Alias for == to support eql? method
+    alias eql? ==
+
+    # Returns a human-readable representation for debugging.
+    def inspect
+      "#<#{self.class}:0x#{object_id.to_s(16)} segments=#{@segments.inspect}>"
+    end
+
+    # Returns true if the context has no segments.
+    # @return [Boolean] true if empty, false otherwise
+    def empty?
+      @segments.empty?
+    end
+  end
+end

data/lib/stripe/stripe_object.rb

@@ -154,12 +154,22 @@ module Stripe
     def update_attributes(values, opts = {}, dirty: true)
       values.each do |k, v|
         add_accessors([k], values) unless metaclass.method_defined?(k.to_sym)
-        @values[k] = Util.convert_to_stripe_object(v, opts, api_mode: @api_mode, requestor: @requestor)
+        @values[k] = convert_value_with_inner_types(k, v, opts)
         dirty_value!(@values[k]) if dirty
         @unsaved_values.add(k)
       end
     end
 
+    private def convert_value_with_inner_types(key, value, opts)
+      inner_class = _get_inner_class_type(key)
+
+      if inner_class
+        Util.convert_to_stripe_object(value, opts, api_mode: @api_mode, requestor: @requestor, klass: inner_class)
+      else
+        Util.convert_to_stripe_object(value, opts, api_mode: @api_mode, requestor: @requestor)
+      end
+    end
+
     def [](key)
       @values[key.to_sym]
     end
@@ -192,13 +202,13 @@ module Stripe
         value.respond_to?(:to_hash) ? value.to_hash : value
       end
 
-      @values.each_with_object({}) do |(key, value), acc|
-        acc[key] = case value
-                   when Array
-                     value.map(&maybe_to_hash)
-                   else
-                     maybe_to_hash.call(value)
-                   end
+      @values.transform_values do |value|
+        case value
+        when Array
+          value.map(&maybe_to_hash)
+        else
+          maybe_to_hash.call(value)
+        end
       end
     end
 
@@ -263,7 +273,7 @@ module Stripe
 
       # a `nil` that makes it out of `#serialize_params_value` signals an empty
       # value that we shouldn't appear in the serialized form of the object
-      update_hash.reject! { |_, v| v.nil? }
+      update_hash.compact!
 
       update_hash
     end
@@ -336,7 +346,7 @@ module Stripe
       end
     end
 
-    protected def add_accessors(keys, values)
+    protected def add_accessors(keys, values) # rubocop:todo Metrics/PerceivedComplexity
       # not available in the #instance_eval below
       protected_fields = self.class.protected_fields
 
@@ -620,5 +630,19 @@ module Stripe
         update[k] = ""
       end
     end
+
+    # Instance methods to get inner class types
+    def _get_inner_class_type(field_name)
+      self.class.inner_class_types[field_name.to_sym]
+    end
+
+    # Class methods for inner class types, similar to Python's implementation
+    def self.inner_class_types
+      @inner_class_types ||= {}
+    end
+
+    def self.field_remappings
+      @field_remappings ||= {}
+    end
   end
 end

data/lib/stripe/util.rb

@@ -30,8 +30,12 @@ module Stripe
       @v2_object_classes ||= Stripe::ObjectTypes.v2_object_names_to_classes
     end
 
-    def self.thin_event_classes
-      @thin_event_classes ||= Stripe::EventTypes.thin_event_names_to_classes
+    def self.v2_event_classes
+      @v2_event_classes ||= Stripe::EventTypes.v2_event_types_to_classes
+    end
+
+    def self.event_notification_classes
+      @event_notification_classes ||= Stripe::EventTypes.event_notification_types_to_classes
     end
 
     def self.object_name_matches_class?(object_name, klass)
@@ -99,8 +103,8 @@ module Stripe
     #   will be reused on subsequent API calls.
     # * +opts+ - Options for +StripeObject+ like an API key that will be reused
     #   on subsequent API calls.
-    def self.convert_to_stripe_object(data, opts = {}, api_mode: :v1, requestor: nil)
-      convert_to_stripe_object_with_params(data, {}, opts, api_mode: api_mode, requestor: requestor)
+    def self.convert_to_stripe_object(data, opts = {}, api_mode: :v1, requestor: nil, klass: nil)
+      convert_to_stripe_object_with_params(data, {}, opts, api_mode: api_mode, requestor: requestor, klass: klass)
     end
 
     # Converts a hash of fields or an array of hashes into a +StripeObject+ or
@@ -118,23 +122,26 @@ module Stripe
     # * +last_response+ - The raw response associated with the object.
     # * +api_mode+ - The API mode to use when converting the object, either :v1 or :v2.
     # * +requestor+ - The requestor to use when constructing the object.
+    # * +v2_deleted_object+ - If true, ignore the object tag for casting purposes
+    # * +klass+ - The class to use for inner types
     def self.convert_to_stripe_object_with_params(
       data,
       params,
       opts = {},
       last_response = nil,
       api_mode: :v1,
-      requestor: nil
+      requestor: nil,
+      v2_deleted_object: false,
+      klass: nil
     )
       opts = normalize_opts(opts)
 
       case data
       when Array
-        data.map { |i| convert_to_stripe_object(i, opts, api_mode: api_mode, requestor: requestor) }
+        data.map { |i| convert_to_stripe_object(i, opts, api_mode: api_mode, requestor: requestor, klass: klass) }
       when Hash
         # TODO: This is a terrible hack.
-        # Waiting on https://jira.corp.stripe.com/browse/API_SERVICES-3167 to add
-        # an object in v2 lists
+        # Waiting on https://go/j/API_SERVICES-3167 to add an object in v2 lists
         if api_mode == :v2 && data.include?(:data) && data.include?(:next_page_url)
           return V2::ListObject.construct_from(data, opts, last_response, api_mode, requestor)
         end
@@ -143,9 +150,13 @@ module Stripe
         # to generic StripeObject
         object_type = data[:type] || data["type"]
         object_name = data[:object] || data["object"]
-        object_class = if api_mode == :v2
-                         if object_name == "v2.core.event" && thin_event_classes.key?(object_type)
-                           thin_event_classes.fetch(object_type)
+        object_class = if klass
+                         klass
+                       elsif api_mode == :v2
+                         if v2_deleted_object
+                           V2::DeletedObject
+                         elsif object_name == "v2.core.event" && v2_event_classes.key?(object_type)
+                           v2_event_classes.fetch(object_type)
                          else
                            v2_object_classes.fetch(
                              object_name, StripeObject
@@ -303,13 +314,7 @@ module Stripe
       when String
         { api_key: opts }
       when Hash
-        # If the user is using request signing for authentication,
-        # no need to check the api_key per request.
-        if !(opts.key?(:client) &&
-           opts.fetch(:client).config.authenticator) &&
-           opts.key?(:api_key)
-          check_api_key!(opts.fetch(:api_key))
-        end
+        check_api_key!(opts.fetch(:api_key)) if opts.key?(:api_key)
         # Explicitly use dup here instead of clone to avoid preserving freeze
         # state on input params.
         opts.dup
@@ -323,7 +328,7 @@ module Stripe
     def self.valid_variable_name?(key)
       return false if key.empty? || key[0] !~ LEGAL_FIRST_CHARACTER
 
-      key[1..-1].chars.all? { |char| char =~ LEGAL_VARIABLE_CHARACTER }
+      key[1..].chars.all? { |char| char =~ LEGAL_VARIABLE_CHARACTER }
     end
 
     def self.check_string_argument!(key)
@@ -423,7 +428,7 @@ module Stripe
     private_class_method :level_name
 
     def self.log_internal(message, data = {}, color:, level:, logger:, out:)
-      data_str = data.reject { |_k, v| v.nil? }
+      data_str = data.compact
                      .map do |(k, v)|
         format("%<key>s=%<value>s",
                key: colorize(k, color, logger.nil? && !out.nil? && out.isatty),

data/lib/stripe/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Stripe
-  VERSION = "15.6.0-beta.1"
+  VERSION = "16.0.0"
 end

data/lib/stripe.rb

@@ -34,6 +34,7 @@ require "stripe/object_types"
 require "stripe/event_types"
 require "stripe/request_options"
 require "stripe/request_params"
+require "stripe/stripe_context"
 require "stripe/util"
 require "stripe/connection_manager"
 require "stripe/multipart_encoder"
@@ -51,11 +52,12 @@ require "stripe/api_resource_test_helpers"
 require "stripe/singleton_api_resource"
 require "stripe/webhook"
 require "stripe/stripe_configuration"
-require "stripe/thin_event"
+require "stripe/resources/v2/core/event_notification"
 
 # Named API resources
 require "stripe/resources"
 require "stripe/services"
+require "stripe/params"
 
 # OAuth
 require "stripe/oauth"
@@ -108,7 +110,6 @@ module Stripe
 
     # User configurable options
     def_delegators :@config, :api_key, :api_key=
-    def_delegators :@config, :authenticator, :authenticator=
     def_delegators :@config, :api_version, :api_version=
     def_delegators :@config, :stripe_account, :stripe_account=
     def_delegators :@config, :api_base, :api_base=
@@ -156,58 +157,6 @@ module Stripe
       version: version,
     }
   end
-
-  def self.add_beta_version(beta_name, version)
-    unless version.start_with?("v") && version[1..-1].to_i.to_s == version[1..-1]
-      raise ArgumentError, "Version must be in the format 'v' followed by a number (e.g., 'v3')"
-    end
-
-    if (index = api_version.index("; #{beta_name}="))
-      start_index = index + "; #{beta_name}=".length
-      end_index = api_version.index(";", start_index) || api_version.length
-      current_version = api_version[start_index...end_index][1..-1].to_i
-      new_version = version[1..-1].to_i
-      return if new_version <= current_version # Keep the higher version, no update needed
-
-      self.api_version = api_version[0...index] + "; #{beta_name}=#{version}" + api_version[end_index..-1]
-    else
-      self.api_version = "#{api_version}; #{beta_name}=#{version}"
-    end
-  end
-
-  class RawRequest
-    def initialize
-      @opts = {}
-    end
-
-    def execute(method, url, base_address: :api, params: {}, opts: {}, usage: [])
-      opts = Util.normalize_opts(opts)
-      req_opts = RequestOptions.extract_opts_from_hash(opts)
-
-      requestor = APIRequestor.active_requestor
-      resp, = requestor.send(:execute_request_internal, method, url, base_address, params, req_opts,
-                             usage)
-
-      requestor.interpret_response(resp)
-    end
-  end
-
-  # Sends a request to Stripe REST API
-  def self.raw_request(method, url, params = {}, opts = {}, base_address: :api)
-    req = RawRequest.new
-    req.execute(method, url, base_address: base_address, params: params, opts: opts,
-                             usage: ["raw_request"])
-  end
-
-  def self.deserialize(data, api_mode: :v1)
-    data = JSON.parse(data) if data.is_a?(String)
-    Util.convert_to_stripe_object(data, {}, api_mode: api_mode)
-  end
-  class << self
-    extend Gem::Deprecate
-    deprecate :raw_request, "StripeClient#raw_request", 2024, 9
-    deprecate :deserialize, "StripeClient#deserialize", 2024, 9
-  end
 end
 
 Stripe.log_level = ENV["STRIPE_LOG"] unless ENV["STRIPE_LOG"].nil?

data/rbi/stripe/resources/v2/core/event_notification.rbi

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+# typed: true
+
+module Stripe
+  module V2
+    module Core
+      class EventReasonRequest
+        sig { returns(String) }
+        def id; end
+        sig { returns(String) }
+        def idempotency_key; end
+
+        sig { params(event_reason_request_payload: T::Hash[T.untyped, T.untyped]).void }
+        def initialize(event_reason_request_payload = {}); end
+      end
+
+      class EventReason
+        sig { returns(String) }
+        def type; end
+        sig { returns(::Stripe::V2::Core::EventReasonRequest) }
+        def request; end
+
+        sig { params(event_reason_payload: T::Hash[T.untyped, T.untyped]).void }
+        def initialize(event_reason_payload = {}); end
+      end
+
+      class EventNotification
+        sig { returns(String) }
+        def id; end
+        sig { returns(String) }
+        def type; end
+        sig { returns(String) }
+        def created; end
+        sig { returns(T.nilable(String)) }
+        def context; end
+        sig { returns(T::Boolean) }
+        def livemode; end
+        sig { returns(T.nilable(::Stripe::V2::Core::EventReason)) }
+        def reason; end
+      end
+    end
+  end
+end

data/rbi/stripe/stripe_client.rbi

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+# typed: true
+
+module Stripe
+  class StripeClient
+    sig do
+      params(
+        payload: String,
+        sig_header: String,
+        secret: String,
+        tolerance: T.nilable(Integer)
+      )
+        .returns(::Stripe::V2::Core::EventNotification)
+    end
+    def parse_event_notification(payload, sig_header, secret, tolerance:); end
+  end
+end