stripe 17.0.1 → 19.0.0

data/lib/stripe/params/webhook_endpoint_delete_params.rb

@@ -2,5 +2,5 @@
 # frozen_string_literal: true
 
 module Stripe
-  class WebhookEndpointDeleteParams < Stripe::RequestParams; end
+  class WebhookEndpointDeleteParams < ::Stripe::RequestParams; end
 end

data/lib/stripe/params/webhook_endpoint_list_params.rb

@@ -2,7 +2,7 @@
 # frozen_string_literal: true
 
 module Stripe
-  class WebhookEndpointListParams < Stripe::RequestParams
+  class WebhookEndpointListParams < ::Stripe::RequestParams
     # A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list.
     attr_accessor :ending_before
     # Specifies which fields in the response should be expanded.

data/lib/stripe/params/webhook_endpoint_retrieve_params.rb

@@ -2,7 +2,7 @@
 # frozen_string_literal: true
 
 module Stripe
-  class WebhookEndpointRetrieveParams < Stripe::RequestParams
+  class WebhookEndpointRetrieveParams < ::Stripe::RequestParams
     # Specifies which fields in the response should be expanded.
     attr_accessor :expand
 

data/lib/stripe/params/webhook_endpoint_update_params.rb

@@ -2,7 +2,7 @@
 # frozen_string_literal: true
 
 module Stripe
-  class WebhookEndpointUpdateParams < Stripe::RequestParams
+  class WebhookEndpointUpdateParams < ::Stripe::RequestParams
     # An optional description of what the webhook is used for.
     attr_accessor :description
     # Disable the webhook endpoint if set to true.
@@ -11,7 +11,7 @@ module Stripe
     attr_accessor :enabled_events
     # Specifies which fields in the response should be expanded.
     attr_accessor :expand
-    # Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+    # Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
     attr_accessor :metadata
     # The URL of the webhook endpoint.
     attr_accessor :url

data/lib/stripe/params.rb

@@ -271,6 +271,9 @@ require "stripe/params/issuing/transaction_refund_params"
 require "stripe/params/issuing/transaction_retrieve_params"
 require "stripe/params/issuing/transaction_update_params"
 require "stripe/params/mandate_retrieve_params"
+require "stripe/params/payment_attempt_record_list_params"
+require "stripe/params/payment_attempt_record_retrieve_params"
+require "stripe/params/payment_intent_amount_details_line_item_list_params"
 require "stripe/params/payment_intent_apply_customer_balance_params"
 require "stripe/params/payment_intent_cancel_params"
 require "stripe/params/payment_intent_capture_params"
@@ -303,6 +306,14 @@ require "stripe/params/payment_method_domain_validate_params"
 require "stripe/params/payment_method_list_params"
 require "stripe/params/payment_method_retrieve_params"
 require "stripe/params/payment_method_update_params"
+require "stripe/params/payment_record_report_payment_attempt_canceled_params"
+require "stripe/params/payment_record_report_payment_attempt_failed_params"
+require "stripe/params/payment_record_report_payment_attempt_guaranteed_params"
+require "stripe/params/payment_record_report_payment_attempt_informational_params"
+require "stripe/params/payment_record_report_payment_attempt_params"
+require "stripe/params/payment_record_report_payment_params"
+require "stripe/params/payment_record_report_refund_params"
+require "stripe/params/payment_record_retrieve_params"
 require "stripe/params/payout_cancel_params"
 require "stripe/params/payout_create_params"
 require "stripe/params/payout_list_params"
@@ -347,6 +358,7 @@ require "stripe/params/quote_retrieve_params"
 require "stripe/params/quote_update_params"
 require "stripe/params/radar/early_fraud_warning_list_params"
 require "stripe/params/radar/early_fraud_warning_retrieve_params"
+require "stripe/params/radar/payment_evaluation_create_params"
 require "stripe/params/radar/value_list_create_params"
 require "stripe/params/radar/value_list_delete_params"
 require "stripe/params/radar/value_list_item_create_params"
@@ -410,6 +422,7 @@ require "stripe/params/subscription_schedule_retrieve_params"
 require "stripe/params/subscription_schedule_update_params"
 require "stripe/params/subscription_search_params"
 require "stripe/params/subscription_update_params"
+require "stripe/params/tax/association_find_params"
 require "stripe/params/tax/calculation_create_params"
 require "stripe/params/tax/calculation_line_item_list_params"
 require "stripe/params/tax/calculation_list_line_items_params"
@@ -446,6 +459,7 @@ require "stripe/params/terminal/location_delete_params"
 require "stripe/params/terminal/location_list_params"
 require "stripe/params/terminal/location_retrieve_params"
 require "stripe/params/terminal/location_update_params"
+require "stripe/params/terminal/onboarding_link_create_params"
 require "stripe/params/terminal/reader_cancel_action_params"
 require "stripe/params/terminal/reader_collect_inputs_params"
 require "stripe/params/terminal/reader_collect_payment_method_params"
@@ -571,6 +585,21 @@ require "stripe/params/v2/billing/meter_event_adjustment_create_params"
 require "stripe/params/v2/billing/meter_event_create_params"
 require "stripe/params/v2/billing/meter_event_session_create_params"
 require "stripe/params/v2/billing/meter_event_stream_create_params"
+require "stripe/params/v2/core/account_close_params"
+require "stripe/params/v2/core/account_create_params"
+require "stripe/params/v2/core/account_link_create_params"
+require "stripe/params/v2/core/account_list_params"
+require "stripe/params/v2/core/account_retrieve_params"
+require "stripe/params/v2/core/account_token_create_params"
+require "stripe/params/v2/core/account_token_retrieve_params"
+require "stripe/params/v2/core/account_update_params"
+require "stripe/params/v2/core/accounts/person_create_params"
+require "stripe/params/v2/core/accounts/person_delete_params"
+require "stripe/params/v2/core/accounts/person_list_params"
+require "stripe/params/v2/core/accounts/person_retrieve_params"
+require "stripe/params/v2/core/accounts/person_token_create_params"
+require "stripe/params/v2/core/accounts/person_token_retrieve_params"
+require "stripe/params/v2/core/accounts/person_update_params"
 require "stripe/params/v2/core/event_destination_create_params"
 require "stripe/params/v2/core/event_destination_delete_params"
 require "stripe/params/v2/core/event_destination_disable_params"

data/lib/stripe/request_params.rb

@@ -1,15 +1,50 @@
 # frozen_string_literal: true
 # typed: true
 
+require "bigdecimal"
+
 module Stripe
   # For internal use only. Does not provide a stable API and may be broken
   # with future non-major changes.
   class RequestParams
+    class << self
+      # Override the object instantiation flow in Ruby in order to track explicitly set keys.
+      # We do not want to set a key to nil if the user has not explicitly set it to nil.
+      def new(**kwargs)
+        instance = allocate
+        instance.instance_variable_set(:@_explicitly_set_keys, kwargs.keys.to_set)
+        instance.send(:initialize, **kwargs)
+        instance
+      end
+
+      # Override attr_accessor to create setters that track explicitly set keys
+      def attr_accessor(*names)
+        names.each do |name|
+          # Define getter
+          define_method(name) { instance_variable_get("@#{name}") }
+
+          # Define setter that tracks the key as explicitly set
+          define_method("#{name}=") do |value|
+            @_explicitly_set_keys&.add(name)
+            instance_variable_set("@#{name}", value)
+          end
+        end
+      end
+    end
+
     def to_h
+      encodings = self.class.field_encodings
       instance_variables.each_with_object({}) do |var, hash|
+        # _explicitly_set_keys is set as an instance variable.
+        # Ignore the var if it is _explicitly_set_keys itself.
+        next if var == :@_explicitly_set_keys
+
         key = var.to_s.delete("@").to_sym
         value = instance_variable_get(var)
 
+        # Only include keys that were explicitly set
+        next if @_explicitly_set_keys && !@_explicitly_set_keys.include?(key)
+
         hash[key] = if value.is_a?(RequestParams)
                       value.to_h
                     # Check if value is an array and contains RequestParams objects
@@ -18,6 +53,87 @@ module Stripe
                     else
                       value
                     end
+
+        # Coerce fields based on encoding schema (int64_string, nested objects, arrays)
+        encoding = encodings[key]
+        hash[key] = self.class.coerce_value(hash[key], encoding) if encoding
+      end
+    end
+
+    def self.field_encodings
+      @field_encodings ||= {}
+    end
+
+    # Recursively coerce a value based on its field encoding schema.
+    # Handles :int64_string leaves, { kind: :object, fields: ... } nesting,
+    # and { kind: :array, element: ... } for arrays.
+    def self.coerce_value(value, encoding)
+      return value if value.nil?
+
+      case encoding
+      when :int64_string
+        coerce_int64_string(value)
+      when :decimal_string
+        coerce_decimal_string(value)
+      when Hash
+        coerce_composite(value, encoding)
+      else
+        value
+      end
+    end
+
+    private_class_method def self.coerce_int64_string(value)
+      case value
+      when Integer then value.to_s
+      when Array then value.map { |v| v.is_a?(Integer) ? v.to_s : v }
+      else value
+      end
+    end
+
+    private_class_method def self.coerce_decimal_string(value)
+      case value
+      when BigDecimal then value.to_s("F")
+      when Integer, Float then value.to_s
+      when Array then value.map { |v| coerce_decimal_string(v) }
+      else value
+      end
+    end
+
+    private_class_method def self.coerce_composite(value, encoding)
+      case encoding[:kind]
+      when :object
+        coerce_object(value, encoding[:fields] || {})
+      when :array
+        return value unless value.is_a?(Array)
+
+        value.map { |v| coerce_value(v, encoding[:element]) }
+      else
+        value
+      end
+    end
+
+    private_class_method def self.coerce_object(value, fields_schema)
+      return value unless value.is_a?(Hash)
+
+      value.each_with_object({}) do |(k, v), result|
+        field_encoding = fields_schema[k.to_sym]
+        result[k] = field_encoding ? coerce_value(v, field_encoding) : v
+      end
+    end
+
+    # Coerce a plain Hash using this class's field_encodings.
+    # Called from generated service methods when params is a Hash
+    # (not a RequestParams instance) to ensure int64_string fields
+    # are serialized as strings on the wire.
+    def self.coerce_params(params)
+      return params unless params.is_a?(Hash)
+
+      encodings = field_encodings
+      return params if encodings.empty?
+
+      params.each_with_object({}) do |(k, v), result|
+        encoding = encodings[k.to_sym]
+        result[k] = encoding ? coerce_value(v, encoding) : v
       end
     end
   end