stripe 19.3.0 → 19.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 04d6596aa44728702151bf47d822405b1431fd2637b86851aad96358abe2518e
-  data.tar.gz: 780eee38bdc3c7c7013eb7c8b2d60baab1687e2a325418d5b0a3f1d7a5e49c82
+  metadata.gz: 6e4d3bf0319df6872457507dbb136e50fdd9fdf64db539204163da4e17a83f0a
+  data.tar.gz: 0fbb9105f8190a2d30956015a6e249d174872d9ec74cdbe3e231e09cb55f69b0
 SHA512:
-  metadata.gz: ecaf57851c31d8120bd87988a1ea1111177aa079bf41349444f7eb8dedb9761ef4ea09cb021fb7b09c11aafa53e7ab72db539a6efc500f3547fd2fe401f4bf97
-  data.tar.gz: 9fefe0d162b7b69c8224e596ec171cb6aaf231abea3fdf69a2cd543b7410338868a284d62b5e6cdef073cbf0888d1043ff0b10d1e2a777fe13552ba221500c02
+  metadata.gz: 8cfce98f2e4173401387c066922ab34e866c00314442cb2cf4206bed5772d363a42bd22c3bc7f8b109b51bbff5d57608b86fae86536413711bbd57f39eb67ee6
+  data.tar.gz: c4ca73fb4e897bf59b6470df9e50ca1cedd63d343cb2695361d05bb4834e41d3777e8f23fef5ce4d4bc9e581bd9a64827de9bbf8581031d4046fbf893986f525

data/lib/stripe/api_requestor.rb

@@ -1,6 +1,5 @@
 # frozen_string_literal: true
 
-require "digest"
 require "socket"
 require "stripe/instrumentation"
 
@@ -1068,31 +1067,6 @@ module Stripe
     # in so that we can generate a rich user agent header to help debug
     # integrations.
     class SystemProfiler
-      UNAME_HASH = begin
-        parts = []
-        parts << if RUBY_PLATFORM.match?(/mswin|mingw|cygwin/)
-                   begin
-                     `ver 2>NUL`.strip
-                   rescue StandardError
-                     ""
-                   end
-                 else
-                   begin
-                     `uname -a 2>/dev/null`.strip
-                   rescue StandardError
-                     ""
-                   end
-                 end
-        parts << begin
-          Socket.gethostname
-        rescue StandardError
-          ""
-        end
-        Digest::MD5.hexdigest(parts.join(" "))
-      rescue StandardError
-        ""
-      end
-
       AI_AGENTS = [
         # aiAgents: The beginning of the section generated from our OpenAPI spec
         %w[ANTIGRAVITY_CLI_ALIAS antigravity],
@@ -1130,7 +1104,8 @@ module Stripe
 
         if Stripe.enable_telemetry?
           ua[:platform] = RUBY_PLATFORM
-          ua[:source] = UNAME_HASH unless UNAME_HASH.empty?
+          tid = TelemetryId.get
+          ua[:telemetry_id] = tid if tid
         end
 
         ai_agent = detect_ai_agent

data/lib/stripe/error_object.rb

@@ -11,69 +11,93 @@ module Stripe
     # methods would cause users to run into `NoMethodError` exceptions and
     # 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.
+    def advice_code
+      @values[:advice_code]
+    end
+
     # For card errors, the ID of the failed charge.
     def charge
       @values[:charge]
     end
 
-    # For some errors that could be handled programmatically, a short string
-    # indicating the error code reported.
+    # For some errors that could be handled programmatically, a short string indicating the [error code](https://docs.stripe.com/error-codes) reported.
     def code
       @values[:code]
     end
 
-    # For card errors resulting from a card issuer decline, a short string
-    # indicating the card issuer's reason for the decline if they provide one.
+    # For card errors resulting from a card issuer decline, a short string indicating the [card issuer's reason for the decline](https://docs.stripe.com/declines#issuer-declines) if they provide one.
     def decline_code
       @values[:decline_code]
     end
 
-    # A URL to more information about the error code reported.
+    # A URL to more information about the [error code](https://docs.stripe.com/error-codes) reported.
     def doc_url
       @values[:doc_url]
     end
 
-    # A human-readable message providing more details about the error. For card
-    # errors, these messages can be shown to your users.
+    # 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]
     end
 
-    # If the error is parameter-specific, the parameter related to the error.
-    # For example, you can use this to display a message near the correct form
-    # field.
+    # For card errors resulting from a card issuer decline, a 2 digit code which indicates the advice given to merchant by the card network on how to proceed with an error.
+    def network_advice_code
+      @values[:network_advice_code]
+    end
+
+    # For payments declined by the network, an alphanumeric code which indicates the reason the payment failed.
+    def network_decline_code
+      @values[:network_decline_code]
+    end
+
+    # If the error is parameter-specific, the parameter related to the error. For example, you can use this to display a message near the correct form field.
     def param
       @values[:param]
     end
 
-    # The PaymentIntent object for errors returned on a request involving a
-    # PaymentIntent.
+    # The PaymentIntent object for errors returned on a request involving a PaymentIntent.
     def payment_intent
       @values[:payment_intent]
     end
 
-    # The PaymentMethod object for errors returned on a request involving a
-    # PaymentMethod.
+    # The PaymentMethod object for errors returned on a request involving a PaymentMethod.
     def payment_method
       @values[:payment_method]
     end
 
-    # The SetupIntent object for errors returned on a request involving a
-    # SetupIntent.
+    # If the error is specific to the type of payment method, the payment method type that had a problem. This field is only populated for invoice-related errors.
+    def payment_method_type
+      @values[:payment_method_type]
+    end
+
+    # A URL to the request log entry in your dashboard.
+    def request_log_url
+      @values[:request_log_url]
+    end
+
+    # The SetupIntent object for errors returned on a request involving a SetupIntent.
     def setup_intent
       @values[:setup_intent]
     end
 
-    # The source object for errors returned on a request involving a source.
+    # The PaymentSource object for errors returned on a request involving a PaymentSource.
     def source
       @values[:source]
     end
 
-    # The type of error returned. One of `api_error`, `card_error`,
-    # `idempotency_error`, or `invalid_request_error`.
+    # The type of error returned. One of `api_error`, `card_error`, `idempotency_error`, or `invalid_request_error`
     def type
       @values[:type]
     end
+
+    # The user message associated with the error.
+    def user_message
+      @values[:user_message]
+    end
+
+    # errorFields: The end of the section generated from our OpenAPI spec
   end
 
   # Represents on OAuth error returned by the OAuth API.

data/lib/stripe/telemetry_id.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+module Stripe
+  module TelemetryId
+    @cached_id = nil
+    @loaded = false
+
+    def self.config_dir
+      if Gem.win_platform?
+        appdata = ENV.fetch("APPDATA", nil)
+        return nil unless appdata && !appdata.empty?
+
+        ::File.join(appdata, "Stripe")
+      else
+        xdg = ENV.fetch("XDG_CONFIG_HOME", nil)
+        if xdg && !xdg.empty?
+          ::File.join(xdg, "stripe")
+        else
+          ::File.expand_path("~/.config/stripe")
+        end
+      end
+    rescue ArgumentError
+      nil
+    end
+
+    def self.get
+      return @cached_id if @loaded
+
+      dir = config_dir
+      return nil unless dir
+
+      file_path = ::File.join(dir, "telemetry_id")
+
+      begin
+        content = ::File.read(file_path).strip
+        unless content.empty?
+          @cached_id = content
+          return @cached_id
+        end
+      rescue SystemCallError
+        # File doesn't exist or can't be read
+      end
+
+      new_id = SecureRandom.hex(16)
+
+      begin
+        ::FileUtils.mkdir_p(dir)
+        ::File.write(file_path, new_id)
+      rescue SystemCallError
+        return nil
+      end
+
+      @cached_id = new_id
+      @cached_id
+    ensure
+      @loaded = true
+    end
+
+    # For testing only
+    def self.reset!
+      @cached_id = nil
+      @loaded = false
+    end
+  end
+end

data/lib/stripe/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Stripe
-  VERSION = "19.3.0"
+  VERSION = "19.3.1"
 end

data/lib/stripe.rb

@@ -8,6 +8,7 @@ require "logger"
 require "net/http"
 require "openssl"
 require "rbconfig"
+require "fileutils"
 require "securerandom"
 require "set"
 require "socket"
@@ -36,6 +37,7 @@ require "stripe/request_options"
 require "stripe/request_params"
 require "stripe/stripe_context"
 require "stripe/util"
+require "stripe/telemetry_id"
 require "stripe/connection_manager"
 require "stripe/multipart_encoder"
 require "stripe/api_requestor"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: stripe
 version: !ruby/object:Gem::Version
-  version: 19.3.0
+  version: 19.3.1
 platform: ruby
 authors:
 - Stripe
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-06-24 00:00:00.000000000 Z
+date: 2026-07-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bigdecimal
@@ -1080,6 +1080,7 @@ files:
 - lib/stripe/stripe_object.rb
 - lib/stripe/stripe_response.rb
 - lib/stripe/stripe_service.rb
+- lib/stripe/telemetry_id.rb
 - lib/stripe/util.rb
 - lib/stripe/v2_list_object.rb
 - lib/stripe/version.rb