stripe 18.2.0.pre.alpha.2 → 18.2.0.pre.beta.1

data/lib/stripe/services.rb

@@ -17,7 +17,6 @@ require "stripe/services/apps_service"
 require "stripe/services/balance_service"
 require "stripe/services/balance_settings_service"
 require "stripe/services/balance_transaction_service"
-require "stripe/services/balance_transfer_service"
 require "stripe/services/billing/alert_service"
 require "stripe/services/billing/analytics/meter_usage_service"
 require "stripe/services/billing/analytics_service"
@@ -59,8 +58,6 @@ require "stripe/services/customer_payment_source_service"
 require "stripe/services/customer_service"
 require "stripe/services/customer_session_service"
 require "stripe/services/customer_tax_id_service"
-require "stripe/services/delegated_checkout/requested_session_service"
-require "stripe/services/delegated_checkout_service"
 require "stripe/services/dispute_service"
 require "stripe/services/entitlements/active_entitlement_service"
 require "stripe/services/entitlements/feature_service"
@@ -81,7 +78,6 @@ 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/blocklist_entry_service"
 require "stripe/services/identity/verification_report_service"
 require "stripe/services/identity/verification_session_service"
 require "stripe/services/identity_service"
@@ -99,7 +95,6 @@ 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/program_service"
 require "stripe/services/issuing/token_service"
 require "stripe/services/issuing/transaction_service"
 require "stripe/services/issuing_service"
@@ -122,8 +117,6 @@ 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_catalog/trial_offer_service"
-require "stripe/services/product_catalog_service"
 require "stripe/services/product_feature_service"
 require "stripe/services/product_service"
 require "stripe/services/promotion_code_service"
@@ -133,7 +126,6 @@ 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/account_evaluation_service"
 require "stripe/services/radar/early_fraud_warning_service"
 require "stripe/services/radar/value_list_item_service"
 require "stripe/services/radar/value_list_service"
@@ -142,11 +134,13 @@ require "stripe/services/refund_service"
 require "stripe/services/reporting/report_run_service"
 require "stripe/services/reporting/report_type_service"
 require "stripe/services/reporting_service"
+require "stripe/services/reserve/hold_service"
+require "stripe/services/reserve/plan_service"
+require "stripe/services/reserve/release_service"
+require "stripe/services/reserve_service"
 require "stripe/services/review_service"
 require "stripe/services/setup_attempt_service"
 require "stripe/services/setup_intent_service"
-require "stripe/services/shared_payment/granted_token_service"
-require "stripe/services/shared_payment_service"
 require "stripe/services/shipping_rate_service"
 require "stripe/services/sigma/scheduled_query_run_service"
 require "stripe/services/sigma_service"
@@ -159,7 +153,6 @@ 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/location_service"
 require "stripe/services/tax/registration_service"
 require "stripe/services/tax/settings_service"
 require "stripe/services/tax/transaction_line_item_service"
@@ -175,8 +168,6 @@ 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/capital/financing_offer_service"
-require "stripe/services/test_helpers/capital_service"
 require "stripe/services/test_helpers/confirmation_token_service"
 require "stripe/services/test_helpers/customer_service"
 require "stripe/services/test_helpers/issuing/authorization_service"
@@ -185,8 +176,6 @@ require "stripe/services/test_helpers/issuing/personalization_design_service"
 require "stripe/services/test_helpers/issuing/transaction_service"
 require "stripe/services/test_helpers/issuing_service"
 require "stripe/services/test_helpers/refund_service"
-require "stripe/services/test_helpers/shared_payment/granted_token_service"
-require "stripe/services/test_helpers/shared_payment_service"
 require "stripe/services/test_helpers/terminal/reader_service"
 require "stripe/services/test_helpers/terminal_service"
 require "stripe/services/test_helpers/test_clock_service"
@@ -219,46 +208,24 @@ 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/custom_pricing_unit_service"
-require "stripe/services/v2/billing/intent_service"
-require "stripe/services/v2/billing/intents/action_service"
-require "stripe/services/v2/billing/license_fee_service"
-require "stripe/services/v2/billing/license_fee_subscription_service"
-require "stripe/services/v2/billing/license_fees/version_service"
-require "stripe/services/v2/billing/licensed_item_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/metered_item_service"
-require "stripe/services/v2/billing/pricing_plan_service"
-require "stripe/services/v2/billing/pricing_plan_subscription_service"
-require "stripe/services/v2/billing/pricing_plan_subscriptions/component_service"
-require "stripe/services/v2/billing/pricing_plans/component_service"
-require "stripe/services/v2/billing/pricing_plans/version_service"
 require "stripe/services/v2/billing/profile_service"
-require "stripe/services/v2/billing/rate_card_service"
-require "stripe/services/v2/billing/rate_card_subscription_service"
-require "stripe/services/v2/billing/rate_cards/rate_service"
-require "stripe/services/v2/billing/rate_cards/version_service"
-require "stripe/services/v2/billing/service_action_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/claimable_sandbox_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/iam/api_key_service"
-require "stripe/services/v2/iam_service"
 require "stripe/services/v2/money_management/adjustment_service"
-require "stripe/services/v2/money_management/currency_conversion_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"
@@ -270,21 +237,10 @@ 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/recipient_verification_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/payment_service"
-require "stripe/services/v2/payments/off_session_payment_service"
-require "stripe/services/v2/payments/settlement_allocation_intent_service"
-require "stripe/services/v2/payments/settlement_allocation_intents/split_service"
-require "stripe/services/v2/reporting/report_run_service"
-require "stripe/services/v2/reporting/report_service"
-require "stripe/services/v2/reporting_service"
-require "stripe/services/v2/tax/manual_rule_service"
-require "stripe/services/v2/tax_service"
 require "stripe/services/v2/test_helper_service"
 require "stripe/services/v2/test_helpers/financial_address_service"
-require "stripe/services/v2/test_helpers/money_management_service"
 require "stripe/services/v2_services"
 require "stripe/services/webhook_endpoint_service"

data/lib/stripe/stripe_client.rb

@@ -8,9 +8,12 @@ module Stripe
     # attr_readers: The beginning of the section generated from our OpenAPI spec
     attr_reader :v1
     attr_reader :v2
-
     # attr_readers: The end of the section generated from our OpenAPI spec
 
+    # For internal use only. Does not provide a stable API and may be broken
+    # with future non-major changes.
+    attr_reader :requestor
+
     # For internal use only. Does not provide a stable API and may be broken
     # with future non-major changes.
     CLIENT_OPTIONS = Set.new(%i[api_key stripe_account stripe_context api_version api_base uploads_base connect_base meter_events_base client_id])
@@ -87,5 +90,9 @@ module Stripe
       data = JSON.parse(data) if data.is_a?(String)
       Util.convert_to_stripe_object(data, {}, api_mode: api_mode, requestor: @requestor)
     end
+
+    def notification_handler(webhook_secret, &fallback_callback)
+      ::Stripe::StripeEventNotificationHandler.new(self, webhook_secret, &fallback_callback)
+    end
   end
 end

data/lib/stripe/stripe_event_notification_handler.rb

@@ -0,0 +1,425 @@
+# frozen_string_literal: true
+
+module Stripe
+  class UnhandledNotificationDetails
+    attr_reader :is_known_event_type
+
+    def initialize(is_known_event_type)
+      @is_known_event_type = is_known_event_type
+    end
+  end
+
+  class StripeEventNotificationHandler
+    def initialize(client, webhook_secret, &fallback_callback)
+      raise ArgumentError, "You must pass a block to act as a fallback" if fallback_callback.nil?
+
+      @client = client
+      @webhook_secret = webhook_secret
+      @fallback_callback = fallback_callback
+
+      @registered_handlers = {}
+      @has_handled_events = false
+    end
+
+    def handle(webhook_body, sig_header)
+      # we're ok with this not being a thread-safe write since registering
+      # handlers should happen synchronously on startup before any multi-threaded reads happen
+      @has_handled_events = true
+
+      notif = @client.parse_event_notification(
+        webhook_body,
+        sig_header,
+        @webhook_secret
+      )
+
+      # Create a new client with the event's context to ensure thread-safety
+      event_client = new_client_with_context(notif.context)
+
+      handler = @registered_handlers[notif.type]
+      if handler
+        handler.call(notif, event_client)
+      else
+        @fallback_callback.call(notif, event_client,
+                                UnhandledNotificationDetails.new(!notif.is_a?(Stripe::Events::UnknownEventNotification)))
+      end
+    end
+
+    def registered_event_types
+      @registered_handlers.keys.sort
+    end
+
+    private def register(event_type, &handler)
+      raise "Cannot register new event handlers after handling events" if @has_handled_events
+      if @registered_handlers.key?(event_type)
+        raise ArgumentError, "Handler already registered for event type: #{event_type}"
+      end
+
+      @registered_handlers[event_type] = handler
+    end
+
+    private def new_client_with_context(context)
+      config = @client.requestor.config
+      StripeClient.new(
+        config.api_key,
+        stripe_account: config.stripe_account,
+        stripe_context: context,
+        stripe_version: config.api_version,
+        api_base: config.api_base,
+        uploads_base: config.uploads_base,
+        connect_base: config.connect_base,
+        meter_events_base: config.meter_events_base,
+        client_id: config.client_id
+      )
+    end
+
+    # event-handler-methods: The beginning of the section generated from our OpenAPI spec
+    def on_v1_billing_meter_error_report_triggered(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v1.billing.meter.error_report_triggered", &handler)
+    end
+
+    def on_v1_billing_meter_no_meter_found(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v1.billing.meter.no_meter_found", &handler)
+    end
+
+    def on_v2_core_account_closed(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.account.closed", &handler)
+    end
+
+    def on_v2_core_account_created(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.account.created", &handler)
+    end
+
+    def on_v2_core_account_updated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.account.updated", &handler)
+    end
+
+    def on_v2_core_account_including_configuration_customer_capability_status_updated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.account[configuration.customer].capability_status_updated", &handler)
+    end
+
+    def on_v2_core_account_including_configuration_customer_updated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.account[configuration.customer].updated", &handler)
+    end
+
+    def on_v2_core_account_including_configuration_merchant_capability_status_updated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.account[configuration.merchant].capability_status_updated", &handler)
+    end
+
+    def on_v2_core_account_including_configuration_merchant_updated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.account[configuration.merchant].updated", &handler)
+    end
+
+    def on_v2_core_account_including_configuration_recipient_capability_status_updated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.account[configuration.recipient].capability_status_updated", &handler)
+    end
+
+    def on_v2_core_account_including_configuration_recipient_updated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.account[configuration.recipient].updated", &handler)
+    end
+
+    def on_v2_core_account_including_configuration_storer_capability_status_updated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.account[configuration.storer].capability_status_updated", &handler)
+    end
+
+    def on_v2_core_account_including_configuration_storer_updated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.account[configuration.storer].updated", &handler)
+    end
+
+    def on_v2_core_account_including_defaults_updated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.account[defaults].updated", &handler)
+    end
+
+    def on_v2_core_account_including_identity_updated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.account[identity].updated", &handler)
+    end
+
+    def on_v2_core_account_including_requirements_updated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.account[requirements].updated", &handler)
+    end
+
+    def on_v2_core_account_link_returned(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.account_link.returned", &handler)
+    end
+
+    def on_v2_core_account_person_created(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.account_person.created", &handler)
+    end
+
+    def on_v2_core_account_person_deleted(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.account_person.deleted", &handler)
+    end
+
+    def on_v2_core_account_person_updated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.account_person.updated", &handler)
+    end
+
+    def on_v2_core_event_destination_ping(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.event_destination.ping", &handler)
+    end
+
+    def on_v2_core_health_event_generation_failure_resolved(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.core.health.event_generation_failure.resolved", &handler)
+    end
+
+    def on_v2_money_management_adjustment_created(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.adjustment.created", &handler)
+    end
+
+    def on_v2_money_management_financial_account_created(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.financial_account.created", &handler)
+    end
+
+    def on_v2_money_management_financial_account_updated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.financial_account.updated", &handler)
+    end
+
+    def on_v2_money_management_financial_address_activated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.financial_address.activated", &handler)
+    end
+
+    def on_v2_money_management_financial_address_failed(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.financial_address.failed", &handler)
+    end
+
+    def on_v2_money_management_inbound_transfer_available(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.inbound_transfer.available", &handler)
+    end
+
+    def on_v2_money_management_inbound_transfer_bank_debit_failed(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.inbound_transfer.bank_debit_failed", &handler)
+    end
+
+    def on_v2_money_management_inbound_transfer_bank_debit_processing(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.inbound_transfer.bank_debit_processing", &handler)
+    end
+
+    def on_v2_money_management_inbound_transfer_bank_debit_queued(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.inbound_transfer.bank_debit_queued", &handler)
+    end
+
+    def on_v2_money_management_inbound_transfer_bank_debit_returned(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.inbound_transfer.bank_debit_returned", &handler)
+    end
+
+    def on_v2_money_management_inbound_transfer_bank_debit_succeeded(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.inbound_transfer.bank_debit_succeeded", &handler)
+    end
+
+    def on_v2_money_management_outbound_payment_canceled(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.outbound_payment.canceled", &handler)
+    end
+
+    def on_v2_money_management_outbound_payment_created(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.outbound_payment.created", &handler)
+    end
+
+    def on_v2_money_management_outbound_payment_failed(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.outbound_payment.failed", &handler)
+    end
+
+    def on_v2_money_management_outbound_payment_posted(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.outbound_payment.posted", &handler)
+    end
+
+    def on_v2_money_management_outbound_payment_returned(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.outbound_payment.returned", &handler)
+    end
+
+    def on_v2_money_management_outbound_payment_updated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.outbound_payment.updated", &handler)
+    end
+
+    def on_v2_money_management_outbound_transfer_canceled(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.outbound_transfer.canceled", &handler)
+    end
+
+    def on_v2_money_management_outbound_transfer_created(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.outbound_transfer.created", &handler)
+    end
+
+    def on_v2_money_management_outbound_transfer_failed(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.outbound_transfer.failed", &handler)
+    end
+
+    def on_v2_money_management_outbound_transfer_posted(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.outbound_transfer.posted", &handler)
+    end
+
+    def on_v2_money_management_outbound_transfer_returned(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.outbound_transfer.returned", &handler)
+    end
+
+    def on_v2_money_management_outbound_transfer_updated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.outbound_transfer.updated", &handler)
+    end
+
+    def on_v2_money_management_payout_method_created(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.payout_method.created", &handler)
+    end
+
+    def on_v2_money_management_payout_method_updated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.payout_method.updated", &handler)
+    end
+
+    def on_v2_money_management_received_credit_available(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.received_credit.available", &handler)
+    end
+
+    def on_v2_money_management_received_credit_failed(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.received_credit.failed", &handler)
+    end
+
+    def on_v2_money_management_received_credit_returned(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.received_credit.returned", &handler)
+    end
+
+    def on_v2_money_management_received_credit_succeeded(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.received_credit.succeeded", &handler)
+    end
+
+    def on_v2_money_management_received_debit_canceled(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.received_debit.canceled", &handler)
+    end
+
+    def on_v2_money_management_received_debit_failed(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.received_debit.failed", &handler)
+    end
+
+    def on_v2_money_management_received_debit_pending(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.received_debit.pending", &handler)
+    end
+
+    def on_v2_money_management_received_debit_succeeded(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.received_debit.succeeded", &handler)
+    end
+
+    def on_v2_money_management_received_debit_updated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.received_debit.updated", &handler)
+    end
+
+    def on_v2_money_management_transaction_created(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.transaction.created", &handler)
+    end
+
+    def on_v2_money_management_transaction_updated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.money_management.transaction.updated", &handler)
+    end
+    # event-handler-methods: The end of the section generated from our OpenAPI spec
+  end
+end

data/lib/stripe/util.rb

@@ -7,22 +7,16 @@ module Stripe
     LEGAL_FIRST_CHARACTER = /[a-zA-Z_]/.freeze
     LEGAL_VARIABLE_CHARACTER = /[a-zA-Z0-9_]/.freeze
 
-    def self.objects_to_ids(obj, semantics)
+    def self.objects_to_ids(obj)
       case obj
       when APIResource
         obj.id
       when Hash
         res = {}
-        obj.each do |k, v|
-          if !v.nil?
-            res[k] = objects_to_ids(v, semantics)
-          elsif semantics == :v2
-            res[k] = nil
-          end
-        end
+        obj.each { |k, v| res[k] = objects_to_ids(v) unless v.nil? }
         res
       when Array
-        obj.map { |v| objects_to_ids(v, semantics) }
+        obj.map { |v| objects_to_ids(v) }
       else
         obj
       end

data/lib/stripe/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Stripe
-  VERSION = "18.2.0-alpha.2"
+  VERSION = "18.2.0-beta.1"
 end

data/lib/stripe.rb

@@ -51,6 +51,7 @@ require "stripe/api_resource"
 require "stripe/api_resource_test_helpers"
 require "stripe/singleton_api_resource"
 require "stripe/webhook"
+require "stripe/stripe_event_notification_handler"
 require "stripe/stripe_configuration"
 require "stripe/resources/v2/amount"
 require "stripe/resources/v2/deleted_object"

data/rbi/stripe/stripe_client.rbi

@@ -13,5 +13,18 @@ module Stripe
         .returns(::Stripe::V2::Core::EventNotification)
     end
     def parse_event_notification(payload, sig_header, secret, tolerance:); end
+
+    sig do
+      params(
+        webhook_secret: String,
+        blk: T.proc.params(
+          event_notification: ::Stripe::V2::Core::EventNotification,
+          client: ::Stripe::StripeClient,
+          details: ::Stripe::UnhandledNotificationDetails
+        ).void
+      )
+      .returns(::Stripe::StripeEventNotificationHandler)
+    end
+    def notification_handler(webhook_secret, &blk); end
   end
 end