stripe 18.0.0 → 18.1.0.pre.beta.1

data/lib/stripe/services/v2/test_helpers/financial_address_service.rb

@@ -0,0 +1,36 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module TestHelpers
+      class FinancialAddressService < StripeService
+        # Simulate crediting a FinancialAddress in a Sandbox environment. This can be used to add virtual funds and increase your balance for testing.
+        #
+        # ** raises FeatureNotEnabledError
+        def credit(id, params = {}, opts = {})
+          request(
+            method: :post,
+            path: format("/v2/test_helpers/financial_addresses/%<id>s/credit", { id: CGI.escape(id) }),
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+
+        # Generates microdeposits for a FinancialAddress in a Sandbox environment.
+        #
+        # ** raises FeatureNotEnabledError
+        def generate_microdeposits(id, params = {}, opts = {})
+          request(
+            method: :post,
+            path: format("/v2/test_helpers/financial_addresses/%<id>s/generate_microdeposits", { id: CGI.escape(id) }),
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+      end
+    end
+  end
+end

data/lib/stripe/services/v2_services.rb

@@ -3,12 +3,14 @@
 
 module Stripe
   class V2Services < StripeService
-    attr_reader :billing, :core
+    attr_reader :billing, :core, :money_management, :test_helpers
 
     def initialize(requestor)
       super
       @billing = Stripe::V2::BillingService.new(@requestor)
       @core = Stripe::V2::CoreService.new(@requestor)
+      @money_management = Stripe::V2::MoneyManagementService.new(@requestor)
+      @test_helpers = Stripe::V2::TestHelperService.new(@requestor)
     end
   end
 end

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"
@@ -17,6 +18,8 @@ require "stripe/services/balance_service"
 require "stripe/services/balance_settings_service"
 require "stripe/services/balance_transaction_service"
 require "stripe/services/billing/alert_service"
+require "stripe/services/billing/analytics/meter_usage_service"
+require "stripe/services/billing/analytics_service"
 require "stripe/services/billing/credit_balance_summary_service"
 require "stripe/services/billing/credit_balance_transaction_service"
 require "stripe/services/billing/credit_grant_service"
@@ -28,6 +31,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"
@@ -58,15 +65,19 @@ require "stripe/services/entitlements_service"
 require "stripe/services/ephemeral_key_service"
 require "stripe/services/event_service"
 require "stripe/services/exchange_rate_service"
+require "stripe/services/external_account_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/fx_quote_service"
 require "stripe/services/identity/verification_report_service"
 require "stripe/services/identity/verification_session_service"
 require "stripe/services/identity_service"
@@ -78,13 +89,19 @@ require "stripe/services/invoice_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_amount_details_line_item_service"
 require "stripe/services/payment_intent_service"
@@ -97,11 +114,17 @@ require "stripe/services/payment_record_service"
 require "stripe/services/payout_service"
 require "stripe/services/plan_service"
 require "stripe/services/price_service"
+require "stripe/services/privacy/redaction_job_service"
+require "stripe/services/privacy/redaction_job_validation_error_service"
+require "stripe/services/privacy_service"
 require "stripe/services/product_feature_service"
 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"
@@ -125,6 +148,7 @@ 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"
@@ -137,6 +161,7 @@ require "stripe/services/terminal/configuration_service"
 require "stripe/services/terminal/connection_token_service"
 require "stripe/services/terminal/location_service"
 require "stripe/services/terminal/onboarding_link_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"
@@ -174,13 +199,44 @@ require "stripe/services/treasury/transaction_entry_service"
 require "stripe/services/treasury/transaction_service"
 require "stripe/services/treasury_service"
 require "stripe/services/v1_services"
+require "stripe/services/v2/billing/bill_setting_service"
+require "stripe/services/v2/billing/bill_settings/version_service"
+require "stripe/services/v2/billing/cadence_service"
+require "stripe/services/v2/billing/collection_setting_service"
+require "stripe/services/v2/billing/collection_settings/version_service"
 require "stripe/services/v2/billing/meter_event_adjustment_service"
 require "stripe/services/v2/billing/meter_event_service"
 require "stripe/services/v2/billing/meter_event_session_service"
 require "stripe/services/v2/billing/meter_event_stream_service"
+require "stripe/services/v2/billing/profile_service"
 require "stripe/services/v2/billing_service"
+require "stripe/services/v2/core/account_link_service"
+require "stripe/services/v2/core/account_service"
+require "stripe/services/v2/core/account_token_service"
+require "stripe/services/v2/core/accounts/person_service"
+require "stripe/services/v2/core/accounts/person_token_service"
 require "stripe/services/v2/core/event_destination_service"
 require "stripe/services/v2/core/event_service"
+require "stripe/services/v2/core/vault/gb_bank_account_service"
+require "stripe/services/v2/core/vault/us_bank_account_service"
+require "stripe/services/v2/core/vault_service"
 require "stripe/services/v2/core_service"
+require "stripe/services/v2/money_management/adjustment_service"
+require "stripe/services/v2/money_management/financial_account_service"
+require "stripe/services/v2/money_management/financial_address_service"
+require "stripe/services/v2/money_management/inbound_transfer_service"
+require "stripe/services/v2/money_management/outbound_payment_quote_service"
+require "stripe/services/v2/money_management/outbound_payment_service"
+require "stripe/services/v2/money_management/outbound_setup_intent_service"
+require "stripe/services/v2/money_management/outbound_transfer_service"
+require "stripe/services/v2/money_management/payout_method_service"
+require "stripe/services/v2/money_management/payout_methods_bank_account_spec_service"
+require "stripe/services/v2/money_management/received_credit_service"
+require "stripe/services/v2/money_management/received_debit_service"
+require "stripe/services/v2/money_management/transaction_entry_service"
+require "stripe/services/v2/money_management/transaction_service"
+require "stripe/services/v2/money_management_service"
+require "stripe/services/v2/test_helper_service"
+require "stripe/services/v2/test_helpers/financial_address_service"
 require "stripe/services/v2_services"
 require "stripe/services/webhook_endpoint_service"

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,
@@ -66,6 +67,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

@@ -352,7 +352,7 @@ module Stripe
       end
     end
 
-    protected def add_accessors(keys, values) # rubocop:todo Metrics/PerceivedComplexity
+    protected def add_accessors(keys, values)
       # not available in the #instance_eval below
       protected_fields = self.class.protected_fields
 

data/lib/stripe/util.rb

@@ -311,7 +311,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 = "18.0.0"
+  VERSION = "18.1.0-beta.1"
 end

data/lib/stripe.rb

@@ -112,6 +112,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=
@@ -159,6 +160,58 @@ module Stripe
       version: version,
     }
   end
+
+  def self.add_beta_version(beta_name, version)
+    unless version.start_with?("v") && version[1..].to_i.to_s == version[1..]
+      raise ArgumentError, "Version must be in the format 'v' followed by a number (e.g., 'v3')"
+    end
+
+    if (index = api_version.index("; #{beta_name}="))
+      start_index = index + "; #{beta_name}=".length
+      end_index = api_version.index(";", start_index) || api_version.length
+      current_version = api_version[start_index...end_index][1..].to_i
+      new_version = version[1..].to_i
+      return if new_version <= current_version # Keep the higher version, no update needed
+
+      self.api_version = api_version[0...index] + "; #{beta_name}=#{version}" + api_version[end_index..]
+    else
+      self.api_version = "#{api_version}; #{beta_name}=#{version}"
+    end
+  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?