stripe 19.7.0.pre.beta.1 → 20.1.0.pre.beta.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 879231bfb98e614089fcc0b8e6fbddee638db1685a67bcf3ce81d79bda4ef45e
-  data.tar.gz: f26fce2d4a29dcec44a0c233dfcf8c8e30377b0100822d881a341b96014e6693
+  metadata.gz: b12b9a84ebd09e40d961f50d2a4a6bb618549f8bce3ff70cf0583b6a6f985920
+  data.tar.gz: 97a1fb9a812986977e386cfcf64e6b19f8361f4ea836af0ee2e0d989c0dd6778
 SHA512:
-  metadata.gz: 9e1bc8048a4d2932f7e8bec211b41ddb84c2665c14ec0a22b1457295872432ef2d11161657d5a5d1accbd2cefa27048b7a05a6f6c24ad0c3b9dabf77e765d941
-  data.tar.gz: 60bcfe117d64bca6fae80649fd2b7f028914509f79d9414b56eef1c58fac149e2d2563619a2a85e625ae9e0cacb666c78d80ef51e32158ed6886571e29944c47
+  metadata.gz: b2fd9d616846db506d02b99023a8c7d4d32318750e8b78e885c5afe4a940c11fa3ed7d7176b189ef5b34a303883bd4960ceaaa9a7c8d67cc8a56d8ae478f91f7
+  data.tar.gz: 895728d22c01074375450ae0a0c499819139b9213c243084b9f56f5a50a3b3bc9e712aa3486ce5d0a5c99179af6e6aa1b5119e34f4234489631600d81d1dd252

data/lib/stripe/api_requestor.rb

@@ -203,7 +203,7 @@ module Stripe
       req_opts = RequestOptions.extract_opts_from_hash(req_opts)
 
       notice = http_resp["stripe-notice"]
-      warn("WARNING: #{notice}") if notice
+      maybe_emit_stripe_notice(notice)
 
       resp = interpret_response(http_resp)
 
@@ -218,6 +218,20 @@ module Stripe
                                                 v2_deleted_object: method == :delete && api_mode == :v2)
     end
 
+    private def maybe_emit_stripe_notice(notice, env = ENV)
+      return unless notice
+
+      ai_agent = SystemProfiler.detect_ai_agent(env)
+      return if ai_agent.empty? && env.fetch("STRIPE_SUPPRESS_NOTICES", "").downcase == "true"
+
+      if ai_agent.empty?
+        notice += "\nTo suppress Stripe notices in test and sandbox environments, " \
+                  "set the STRIPE_SUPPRESS_NOTICES environment variable to true."
+      end
+
+      warn("WARNING: #{notice}")
+    end
+
     # Execute request without instantiating a new object if the relevant object's name matches the class
     #
     # For internal use only. Does not provide a stable API and may be broken
@@ -462,13 +476,13 @@ module Stripe
     private def execute_request_internal(method, path,
                                          base_address, params, opts, usage,
                                          &read_body_chunk_block)
+      Util.validate_path!(path)
+
       api_mode = Util.get_api_mode(path)
       opts = RequestOptions.merge_config_and_opts(config, opts)
 
       raise ArgumentError, "method should be a symbol" \
       unless method.is_a?(Symbol)
-      raise ArgumentError, "path should be a string" \
-      unless path.is_a?(String)
 
       base_url ||= config.base_addresses[base_address]
 
@@ -867,8 +881,6 @@ module Stripe
         CannotProceedError.new(error_data[:message], **opts, reason: error_data[:reason])
       when "controlled_by_alternate_resource"
         ControlledByAlternateResourceError.new(error_data[:message], **opts)
-      when "controlled_by_dashboard"
-        ControlledByDashboardError.new(error_data[:message], **opts)
       when "feature_not_enabled"
         FeatureNotEnabledError.new(error_data[:message], **opts)
       when "financial_account_not_open"
@@ -885,6 +897,14 @@ module Stripe
 
       when "invalid_payout_method"
         InvalidPayoutMethodError.new(error_data[:message], **opts)
+      when "invalid_vaulted_credential"
+
+        InvalidVaultedCredentialError.new(
+          error_data[:message],
+          **opts,
+          invalid_param: error_data[:invalid_param]
+        )
+
       when "non_zero_balance"
         NonZeroBalanceError.new(error_data[:message], **opts)
       when "not_cancelable"
@@ -897,6 +917,30 @@ module Stripe
         RecipientNotNotifiableError.new(error_data[:message], **opts)
       when "temporary_session_expired"
         TemporarySessionExpiredError.new(error_data[:message], **opts)
+      when "verification_attempt_failed"
+
+        VerificationAttemptFailedError.new(
+          error_data[:message],
+          **opts,
+          verification_status: error_data[:verification_status]
+        )
+
+      when "verification_expired"
+
+        VerificationExpiredError.new(
+          error_data[:message],
+          **opts,
+          verification_status: error_data[:verification_status]
+        )
+
+      when "verification_not_initiated"
+
+        VerificationNotInitiatedError.new(
+          error_data[:message],
+          **opts,
+          verification_status: error_data[:verification_status]
+        )
+
       # switch cases: The end of the section generated from our OpenAPI spec
       else
         specific_api_error(resp, error_data, context)
@@ -1114,6 +1158,7 @@ module Stripe
         %w[CODEX_CI codex_cli],
         %w[CURSOR_AGENT cursor],
         %w[GEMINI_CLI gemini_cli],
+        %w[HERMES_AGENT hermes],
         %w[OPENCLAW_SHELL openclaw],
         %w[OPENCODE open_code],
         # aiAgents: The end of the section generated from our OpenAPI spec

data/lib/stripe/api_version.rb

@@ -3,7 +3,7 @@
 
 module Stripe
   module ApiVersion
-    CURRENT = "2026-08-26.preview"
+    CURRENT = "2026-09-30.preview"
     CURRENT_MAJOR = ""
   end
 end

data/lib/stripe/error_object.rb

@@ -12,7 +12,7 @@ module Stripe
     # get in the way of generic error handling.
 
     # errorFields: The beginning of the section generated from our OpenAPI spec
-    # For card errors resulting from a card issuer decline, a short string indicating [how to proceed with an error](https://docs.stripe.com/declines#retrying-issuer-declines) if they provide one.
+    # For card errors resulting from a card issuer decline, a short string indicating [how to proceed with an error](https://docs.stripe.com/declines/card#retrying-issuer-declines) if they provide one.
     def advice_code
       @values[:advice_code]
     end

data/lib/stripe/errors.rb

@@ -198,9 +198,6 @@ module Stripe
   class ControlledByAlternateResourceError < StripeError
   end
 
-  class ControlledByDashboardError < StripeError
-  end
-
   class FeatureNotEnabledError < StripeError
   end
 
@@ -237,6 +234,30 @@ module Stripe
   class InvalidPayoutMethodError < StripeError
   end
 
+  class InvalidVaultedCredentialError < StripeError
+    attr_reader :invalid_param
+
+    def initialize(
+      message = nil,
+      http_body: nil,
+      http_status: nil,
+      json_body: nil,
+      http_headers: nil,
+      code: nil,
+      invalid_param: nil
+    )
+      super(
+        message,
+        http_body: http_body,
+        http_status: http_status,
+        json_body: json_body,
+        http_headers: http_headers,
+        code: code,
+      )
+      @invalid_param = invalid_param
+    end
+  end
+
   class NonZeroBalanceError < StripeError
   end
 
@@ -254,5 +275,77 @@ module Stripe
 
   class TemporarySessionExpiredError < StripeError
   end
+
+  class VerificationAttemptFailedError < StripeError
+    attr_reader :verification_status
+
+    def initialize(
+      message = nil,
+      http_body: nil,
+      http_status: nil,
+      json_body: nil,
+      http_headers: nil,
+      code: nil,
+      verification_status: nil
+    )
+      super(
+        message,
+        http_body: http_body,
+        http_status: http_status,
+        json_body: json_body,
+        http_headers: http_headers,
+        code: code,
+      )
+      @verification_status = verification_status
+    end
+  end
+
+  class VerificationExpiredError < StripeError
+    attr_reader :verification_status
+
+    def initialize(
+      message = nil,
+      http_body: nil,
+      http_status: nil,
+      json_body: nil,
+      http_headers: nil,
+      code: nil,
+      verification_status: nil
+    )
+      super(
+        message,
+        http_body: http_body,
+        http_status: http_status,
+        json_body: json_body,
+        http_headers: http_headers,
+        code: code,
+      )
+      @verification_status = verification_status
+    end
+  end
+
+  class VerificationNotInitiatedError < StripeError
+    attr_reader :verification_status
+
+    def initialize(
+      message = nil,
+      http_body: nil,
+      http_status: nil,
+      json_body: nil,
+      http_headers: nil,
+      code: nil,
+      verification_status: nil
+    )
+      super(
+        message,
+        http_body: http_body,
+        http_status: http_status,
+        json_body: json_body,
+        http_headers: http_headers,
+        code: code,
+      )
+      @verification_status = verification_status
+    end
+  end
   # class definitions: The end of the section generated from our OpenAPI spec
 end