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

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 879231bfb98e614089fcc0b8e6fbddee638db1685a67bcf3ce81d79bda4ef45e
-  data.tar.gz: f26fce2d4a29dcec44a0c233dfcf8c8e30377b0100822d881a341b96014e6693
+  metadata.gz: d85e877767374dc3d8dc123a6b8230f1c224d607777f0482d94c67a8f73c0404
+  data.tar.gz: 0153a6e8aa6b824af826f32abfb49df296b0015a3042e18df90f248d32ff2682
 SHA512:
-  metadata.gz: 9e1bc8048a4d2932f7e8bec211b41ddb84c2665c14ec0a22b1457295872432ef2d11161657d5a5d1accbd2cefa27048b7a05a6f6c24ad0c3b9dabf77e765d941
-  data.tar.gz: 60bcfe117d64bca6fae80649fd2b7f028914509f79d9414b56eef1c58fac149e2d2563619a2a85e625ae9e0cacb666c78d80ef51e32158ed6886571e29944c47
+  metadata.gz: ca243816421e74616e11960c1bd36c88af3822978b26df2a88b19c0431695df23f4b66e9de910b3569deac668250528a383486f622158e583294c718ea0b998e
+  data.tar.gz: 17710f432e71c83536b38e72a10bbbd0a1fda9abb622b4bd65f27c793f73ddbe6ffc149c6f4f6923b1479ba831c3482387ab42ff16b8848c026c16a8a2c796dc

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,12 +881,14 @@ 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"
         FinancialAccountNotOpenError.new(error_data[:message], **opts)
+      when "fx_quote_expired"
+        FxQuoteExpiredError.new(error_data[:message], **opts)
+      when "fx_quote_needs_refresh"
+        FxQuoteNeedsRefreshError.new(error_data[:message], **opts)
       when "insufficient_funds"
         InsufficientFundsError.new(error_data[:message], **opts)
       when "invalid_payment_method"
@@ -885,6 +901,16 @@ 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 "merchant_not_gated"
+        MerchantNotGatedError.new(error_data[:message], **opts)
       when "non_zero_balance"
         NonZeroBalanceError.new(error_data[:message], **opts)
       when "not_cancelable"
@@ -895,8 +921,34 @@ module Stripe
         RateLimitError.new(error_data[:message], **opts)
       when "recipient_not_notifiable"
         RecipientNotNotifiableError.new(error_data[:message], **opts)
+      when "service_unavailable"
+        ServiceUnavailableError.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 +1166,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
@@ -37,6 +37,11 @@ module Stripe
       @values[:doc_url]
     end
 
+    # The GiftCardOperation object for errors returned on a request involving a GiftCardOperation.
+    def gift_card_operation
+      @values[:gift_card_operation]
+    end
+
     # A human-readable message providing more details about the error. For card errors, these messages can be shown to your users.
     def message
       @values[:message]

data/lib/stripe/errors.rb

@@ -198,15 +198,18 @@ module Stripe
   class ControlledByAlternateResourceError < StripeError
   end
 
-  class ControlledByDashboardError < StripeError
-  end
-
   class FeatureNotEnabledError < StripeError
   end
 
   class FinancialAccountNotOpenError < StripeError
   end
 
+  class FxQuoteExpiredError < StripeError
+  end
+
+  class FxQuoteNeedsRefreshError < StripeError
+  end
+
   class InsufficientFundsError < StripeError
   end
 
@@ -237,6 +240,33 @@ 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 MerchantNotGatedError < StripeError
+  end
+
   class NonZeroBalanceError < StripeError
   end
 
@@ -252,7 +282,82 @@ module Stripe
   class RecipientNotNotifiableError < StripeError
   end
 
+  class ServiceUnavailableError < StripeError
+  end
+
   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