stripe 13.3.0 → 13.4.0.pre.beta.1

data/lib/stripe/services/webhook_endpoint_service.rb

@@ -3,6 +3,116 @@
 
 module Stripe
   class WebhookEndpointService < StripeService
+    class DeleteParams < Stripe::RequestParams
+    end
+
+    class RetrieveParams < Stripe::RequestParams
+      # Specifies which fields in the response should be expanded.
+      attr_accessor :expand
+
+      def initialize(expand: nil)
+        @expand = expand
+      end
+    end
+
+    class UpdateParams < Stripe::RequestParams
+      # An optional description of what the webhook is used for.
+      attr_accessor :description
+
+      # Disable the webhook endpoint if set to true.
+      attr_accessor :disabled
+
+      # The list of events to enable for this endpoint. You may specify `['*']` to enable all events, except those that require explicit selection.
+      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`.
+      attr_accessor :metadata
+
+      # The URL of the webhook endpoint.
+      attr_accessor :url
+
+      def initialize(
+        description: nil,
+        disabled: nil,
+        enabled_events: nil,
+        expand: nil,
+        metadata: nil,
+        url: nil
+      )
+        @description = description
+        @disabled = disabled
+        @enabled_events = enabled_events
+        @expand = expand
+        @metadata = metadata
+        @url = url
+      end
+    end
+
+    class ListParams < 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.
+      attr_accessor :expand
+
+      # A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
+      attr_accessor :limit
+
+      # A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list.
+      attr_accessor :starting_after
+
+      def initialize(ending_before: nil, expand: nil, limit: nil, starting_after: nil)
+        @ending_before = ending_before
+        @expand = expand
+        @limit = limit
+        @starting_after = starting_after
+      end
+    end
+
+    class CreateParams < Stripe::RequestParams
+      # Events sent to this endpoint will be generated with this Stripe Version instead of your account's default Stripe Version.
+      attr_accessor :api_version
+
+      # Whether this endpoint should receive events from connected accounts (`true`), or from your account (`false`). Defaults to `false`.
+      attr_accessor :connect
+
+      # An optional description of what the webhook is used for.
+      attr_accessor :description
+
+      # The list of events to enable for this endpoint. You may specify `['*']` to enable all events, except those that require explicit selection.
+      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`.
+      attr_accessor :metadata
+
+      # The URL of the webhook endpoint.
+      attr_accessor :url
+
+      def initialize(
+        api_version: nil,
+        connect: nil,
+        description: nil,
+        enabled_events: nil,
+        expand: nil,
+        metadata: nil,
+        url: nil
+      )
+        @api_version = api_version
+        @connect = connect
+        @description = description
+        @enabled_events = enabled_events
+        @expand = expand
+        @metadata = metadata
+        @url = url
+      end
+    end
+
     # A webhook endpoint must have a url and a list of enabled_events. You may optionally specify the Boolean connect parameter. If set to true, then a Connect webhook endpoint that notifies the specified url about events from all connected accounts is created; otherwise an account webhook endpoint that notifies the specified url only about events from your account is created. You can also create webhook endpoints in the [webhooks settings](https://dashboard.stripe.com/account/webhooks) section of the Dashboard.
     def create(params = {}, opts = {})
       request(

data/lib/stripe/services.rb

@@ -5,6 +5,7 @@ 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"
@@ -27,6 +28,10 @@ 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"
@@ -59,37 +64,51 @@ require "stripe/services/event_service"
 require "stripe/services/exchange_rate_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/gift_cards/card_service"
+require "stripe/services/gift_cards/transaction_service"
+require "stripe/services/gift_cards_service"
 require "stripe/services/identity/verification_report_service"
 require "stripe/services/identity/verification_session_service"
 require "stripe/services/identity_service"
 require "stripe/services/invoice_item_service"
 require "stripe/services/invoice_line_item_service"
+require "stripe/services/invoice_payment_service"
 require "stripe/services/invoice_rendering_template_service"
 require "stripe/services/invoice_service"
 require "stripe/services/invoice_upcoming_lines_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_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"
@@ -98,6 +117,9 @@ 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"
@@ -120,8 +142,10 @@ require "stripe/services/subscription_item_usage_record_service"
 require "stripe/services/subscription_item_usage_record_summary_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"
@@ -133,6 +157,7 @@ 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/reader_collected_data_service"
 require "stripe/services/terminal/reader_service"
 require "stripe/services/terminal_service"
 require "stripe/services/test_helpers/confirmation_token_service"

data/lib/stripe/stripe_client.rb

@@ -11,7 +11,7 @@ module Stripe
     # attr_readers: The end of the section generated from our OpenAPI spec
 
     # Initializes a new StripeClient
-    def initialize(api_key, # rubocop:todo Metrics/ParameterLists
+    def initialize(api_key,
                    stripe_account: nil,
                    stripe_context: nil,
                    stripe_version: nil,
@@ -76,7 +76,7 @@ module Stripe
 
     def deserialize(data, api_mode: :v1)
       data = JSON.parse(data) if data.is_a?(String)
-      Util.convert_to_stripe_object(data, {}, api_mode: api_mode, requestor: @requestor)
+      Util.convert_to_stripe_object(data, {}, api_mode: api_mode)
     end
   end
 end

data/lib/stripe/stripe_configuration.rb

@@ -25,7 +25,8 @@ 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, :client_id, :enable_telemetry, :logger, :stripe_account, :stripe_context
+    attr_accessor :api_key, :api_version, :authenticator, :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,
@@ -52,6 +53,7 @@ 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_object.rb

@@ -83,6 +83,7 @@ module Stripe
       @unsaved_values = Set.new
       @transient_values = Set.new
       @values[:id] = id if id
+      @id = id
       @last_response = nil
       @requestor = requestor || APIRequestor.active_requestor
     end
@@ -153,7 +154,7 @@ 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] = Util.convert_to_stripe_object(v, opts, api_mode: @api_mode)
         dirty_value!(@values[k]) if dirty
         @unsaved_values.add(k)
       end
@@ -361,7 +362,7 @@ module Stripe
                                    "We interpret empty strings as nil in requests. " \
                                    "You may set (object).#{k} = nil to delete the property."
             end
-            @values[k] = Util.convert_to_stripe_object(v, @opts, api_mode: @api_mode, requestor: @requestor)
+            @values[k] = Util.convert_to_stripe_object(v, @opts, api_mode: @api_mode)
             dirty_value!(@values[k])
             @unsaved_values.add(k)
           end
@@ -369,6 +370,10 @@ module Stripe
           define_method(:"#{k}?") { @values[k] } if [FalseClass, TrueClass].include?(values[k].class)
         end
       end
+
+      keys.each do |k|
+        instance_variable_set(:"@#{k}", values[k])
+      end
     end
 
     # Disabling the cop because it's confused by the fact that the methods are
@@ -534,7 +539,7 @@ module Stripe
       # example by appending a new hash onto `additional_owners` for an
       # account.
       elsif value.is_a?(Hash)
-        Util.convert_to_stripe_object(value, @opts, api_mode: @api_mode, requestor: @requestor).serialize_params
+        Util.convert_to_stripe_object(value, @opts).serialize_params
 
       elsif value.is_a?(StripeObject)
         update = value.serialize_params(force: force)

data/lib/stripe/util.rb

@@ -127,7 +127,7 @@ module Stripe
 
       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) }
       when Hash
         # TODO: This is a terrible hack.
         # Waiting on https://jira.corp.stripe.com/browse/API_SERVICES-3167 to add
@@ -300,7 +300,13 @@ module Stripe
       when String
         { api_key: opts }
       when Hash
-        check_api_key!(opts.fetch(:api_key)) if opts.key?(:api_key)
+        # 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
         # Explicitly use dup here instead of clone to avoid preserving freeze
         # state on input params.
         opts.dup

data/lib/stripe/version.rb

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

data/lib/stripe.rb

@@ -13,6 +13,7 @@ require "set"
 require "socket"
 require "uri"
 require "forwardable"
+require "base64"
 
 # Version
 require "stripe/api_version"
@@ -33,6 +34,7 @@ require "stripe/errors"
 require "stripe/object_types"
 require "stripe/event_types"
 require "stripe/request_options"
+require "stripe/request_params"
 require "stripe/util"
 require "stripe/connection_manager"
 require "stripe/multipart_encoder"
@@ -50,6 +52,7 @@ require "stripe/api_resource_test_helpers"
 require "stripe/singleton_api_resource"
 require "stripe/webhook"
 require "stripe/stripe_configuration"
+require "stripe/request_signing_authenticator"
 require "stripe/thin_event"
 
 # Named API resources
@@ -85,6 +88,7 @@ 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=
@@ -132,6 +136,48 @@ module Stripe
       version: version,
     }
   end
+
+  def self.add_beta_version(beta_name, version)
+    if api_version.include?("; #{beta_name}=")
+      raise "Stripe version header #{api_version} already contains entry for beta #{beta_name}"
+    end
+
+    self.api_version = "#{api_version}; #{beta_name}=#{version}"
+  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?