stripe 14.1.0.pre.beta.1 → 15.0.0

data/OPENAPI_VERSION

@@ -1 +1 @@
-v1648
+v1642

data/README.md

@@ -20,8 +20,6 @@ The library also provides other features. For example:
 
 See the [Ruby API docs](https://stripe.com/docs/api?lang=ruby).
 
-See [video demonstrations][youtube-playlist] covering how to use the library.
-
 ## Installation
 
 You don't need this source code unless you want to modify the gem. If you just
@@ -158,6 +156,9 @@ print(customer.last_response.http_status) # to retrieve status code
 print(customer.last_response.http_headers) # to retrieve headers
 ```
 
+If you are accessing a response field with custom hashes provided by you, such as `Customer.metadata`,
+please access your fields with the `[]` accessor.
+
 ### Configuring a proxy
 
 A proxy can be configured with `Stripe.proxy`:
@@ -444,7 +445,6 @@ Update the bundled [stripe-mock] by editing the version number found in
 [idempotency-keys]: https://stripe.com/docs/api/idempotent_requests?lang=ruby
 [stripe-mock]: https://github.com/stripe/stripe-mock
 [versioning]: https://stripe.com/docs/api/versioning?lang=ruby
-[youtube-playlist]: https://www.youtube.com/playlist?list=PLy1nL-pvL2M50RmP6ie-gdcSnfOuQCRYk
 
 <!--
 # vim: set tw=79:

data/VERSION

@@ -1 +1 @@
-14.1.0-beta.1
+15.0.0

data/lib/stripe/api_operations/save.rb

@@ -67,7 +67,8 @@ module Stripe
         values.delete(:id)
         opts = Util.normalize_opts(opts)
         APIRequestor.active_requestor.execute_request_initialize_from(:post, save_url, :api, self,
-                                                                      params: values, opts: opts,
+                                                                      params: values,
+                                                                      opts: RequestOptions.extract_opts_from_hash(opts),
                                                                       usage: ["save"])
       end
       extend Gem::Deprecate

data/lib/stripe/api_operations/singleton_save.rb

@@ -64,7 +64,8 @@ module Stripe
         opts = Util.normalize_opts(opts)
 
         APIRequestor.active_requestor.execute_request_initialize_from(:post, resource_url, :api, self,
-                                                                      params: values, opts: opts,
+                                                                      params: values,
+                                                                      opts: RequestOptions.extract_opts_from_hash(opts),
                                                                       usage: ["save"])
       end
       extend Gem::Deprecate

data/lib/stripe/api_requestor.rb

@@ -220,9 +220,11 @@ module Stripe
     # with future non-major changes.
     def execute_request_initialize_from(method, path, base_address, object,
                                         params: {}, opts: {}, usage: [])
-      opts = RequestOptions.combine_opts(object.instance_variable_get(:@opts), opts)
+      opts = RequestOptions.combine_opts(object.instance_variable_get(:@opts) || {}, opts)
       opts = Util.normalize_opts(opts)
+
       params = params.to_h if params.is_a?(RequestParams)
+
       http_resp, req_opts = execute_request_internal(
         method, path, base_address, params, opts, usage
       )
@@ -850,34 +852,6 @@ module Stripe
       # switch cases: The beginning of the section generated from our OpenAPI spec
       when "temporary_session_expired"
         TemporarySessionExpiredError.new(error_data[:message], **opts)
-      when "financial_account_not_open"
-        FinancialAccountNotOpenError.new(error_data[:message], **opts)
-      when "blocked_by_stripe"
-        BlockedByStripeError.new(error_data[:message], **opts)
-      when "already_canceled"
-        AlreadyCanceledError.new(error_data[:message], **opts)
-      when "not_cancelable"
-        NotCancelableError.new(error_data[:message], **opts)
-      when "insufficient_funds"
-        InsufficientFundsError.new(error_data[:message], **opts)
-      when "quota_exceeded"
-        QuotaExceededError.new(error_data[:message], **opts)
-      when "recipient_not_notifiable"
-        RecipientNotNotifiableError.new(error_data[:message], **opts)
-      when "feature_not_enabled"
-        FeatureNotEnabledError.new(error_data[:message], **opts)
-      when "invalid_payout_method"
-        InvalidPayoutMethodError.new(error_data[:message], **opts)
-      when "controlled_by_dashboard"
-        ControlledByDashboardError.new(error_data[:message], **opts)
-      when "invalid_payment_method"
-
-        InvalidPaymentMethodError.new(
-          error_data[:message],
-          **opts,
-          invalid_param: error_data[:invalid_param]
-        )
-
       # switch cases: The end of the section generated from our OpenAPI spec
       else
         specific_api_error(resp, error_data, context)

data/lib/stripe/api_resource.rb

@@ -98,7 +98,10 @@ module Stripe
               "It is not possible to refresh v2 objects. Please retrieve the object using the StripeClient instead."
       end
 
-      @obj = @requestor.execute_request_initialize_from(:get, resource_url, :api, self, params: @retrieve_params)
+      opts = RequestOptions.extract_opts_from_hash(@retrieve_opts || {})
+      @retrieve_opts = {} # Make sure to clear the retrieve options
+      @obj = @requestor.execute_request_initialize_from(:get, resource_url, :api, self, params: @retrieve_params,
+                                                                                        opts: opts)
       initialize_from(
         @obj.last_response.data,
         @obj.instance_variable_get(:@opts),
@@ -114,8 +117,12 @@ module Stripe
               "It is not possible to retrieve v2 objects on the resource. Please use the StripeClient instead."
       end
 
-      opts = Util.normalize_opts(opts)
-      instance = new(id, opts)
+      instance = new(id)
+      # Explicitly send options for the retrieve call, to preserve custom headers
+      # This is so we can pass custom headers from this static function
+      # to the instance variable method call
+      # The custom headers will be cleaned up with the rest of the RequestOptions
+      instance.instance_variable_set(:@retrieve_opts, Util.normalize_opts(opts))
       instance.refresh
     end
 

data/lib/stripe/api_version.rb

@@ -3,6 +3,6 @@
 
 module Stripe
   module ApiVersion
-    CURRENT = "2025-03-31.preview"
+    CURRENT = "2025-03-31.basil"
   end
 end

data/lib/stripe/errors.rb

@@ -164,59 +164,5 @@ module Stripe
   # class definitions: The beginning of the section generated from our OpenAPI spec
   class TemporarySessionExpiredError < StripeError
   end
-
-  class FinancialAccountNotOpenError < StripeError
-  end
-
-  class BlockedByStripeError < StripeError
-  end
-
-  class AlreadyCanceledError < StripeError
-  end
-
-  class NotCancelableError < StripeError
-  end
-
-  class InsufficientFundsError < StripeError
-  end
-
-  class QuotaExceededError < StripeError
-  end
-
-  class RecipientNotNotifiableError < StripeError
-  end
-
-  class FeatureNotEnabledError < StripeError
-  end
-
-  class InvalidPayoutMethodError < StripeError
-  end
-
-  class ControlledByDashboardError < StripeError
-  end
-
-  class InvalidPaymentMethodError < StripeError
-    attr_reader :invalid_param
-
-    def initialize(
-      message = nil,
-      http_body: nil,
-      http_status: nil,
-      json_body: nil,
-      http_headers: nil,
-      code: nil,
-      invalid_param: nil
-    )
-      super(
-        message,
-        http_body: http_body,
-        http_status: http_status,
-        json_body: json_body,
-        http_headers: http_headers,
-        code: code,
-      )
-      @invalid_param = invalid_param
-    end
-  end
   # class definitions: The end of the section generated from our OpenAPI spec
 end

data/lib/stripe/event_types.rb

@@ -7,81 +7,6 @@ module Stripe
         # The beginning of the section generated from our OpenAPI spec
         V1BillingMeterErrorReportTriggeredEvent.lookup_type => V1BillingMeterErrorReportTriggeredEvent,
         V1BillingMeterNoMeterFoundEvent.lookup_type => V1BillingMeterNoMeterFoundEvent,
-        V2CoreAccountIncludingConfigurationCustomerCapabilityStatusUpdatedEvent.lookup_type =>
-        V2CoreAccountIncludingConfigurationCustomerCapabilityStatusUpdatedEvent,
-        V2CoreAccountIncludingConfigurationCustomerUpdatedEvent.lookup_type =>
-        V2CoreAccountIncludingConfigurationCustomerUpdatedEvent,
-        V2CoreAccountIncludingConfigurationMerchantCapabilityStatusUpdatedEvent.lookup_type =>
-        V2CoreAccountIncludingConfigurationMerchantCapabilityStatusUpdatedEvent,
-        V2CoreAccountIncludingConfigurationMerchantUpdatedEvent.lookup_type =>
-        V2CoreAccountIncludingConfigurationMerchantUpdatedEvent,
-        V2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent.lookup_type =>
-        V2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent,
-        V2CoreAccountIncludingConfigurationRecipientUpdatedEvent.lookup_type =>
-        V2CoreAccountIncludingConfigurationRecipientUpdatedEvent,
-        V2CoreAccountIncludingIdentityUpdatedEvent.lookup_type =>
-        V2CoreAccountIncludingIdentityUpdatedEvent,
-        V2CoreAccountIncludingRequirementsUpdatedEvent.lookup_type =>
-        V2CoreAccountIncludingRequirementsUpdatedEvent,
-        V2CoreAccountLinkCompletedEvent.lookup_type => V2CoreAccountLinkCompletedEvent,
-        V2CoreAccountPersonCreatedEvent.lookup_type => V2CoreAccountPersonCreatedEvent,
-        V2CoreAccountPersonDeletedEvent.lookup_type => V2CoreAccountPersonDeletedEvent,
-        V2CoreAccountPersonUpdatedEvent.lookup_type => V2CoreAccountPersonUpdatedEvent,
-        V2MoneyManagementFinancialAccountCreatedEvent.lookup_type =>
-        V2MoneyManagementFinancialAccountCreatedEvent,
-        V2MoneyManagementFinancialAddressActivatedEvent.lookup_type =>
-        V2MoneyManagementFinancialAddressActivatedEvent,
-        V2MoneyManagementFinancialAddressFailedEvent.lookup_type =>
-        V2MoneyManagementFinancialAddressFailedEvent,
-        V2MoneyManagementInboundTransferAvailableEvent.lookup_type =>
-        V2MoneyManagementInboundTransferAvailableEvent,
-        V2MoneyManagementInboundTransferBankDebitFailedEvent.lookup_type =>
-        V2MoneyManagementInboundTransferBankDebitFailedEvent,
-        V2MoneyManagementInboundTransferBankDebitProcessingEvent.lookup_type =>
-        V2MoneyManagementInboundTransferBankDebitProcessingEvent,
-        V2MoneyManagementInboundTransferBankDebitQueuedEvent.lookup_type =>
-        V2MoneyManagementInboundTransferBankDebitQueuedEvent,
-        V2MoneyManagementInboundTransferBankDebitReturnedEvent.lookup_type =>
-        V2MoneyManagementInboundTransferBankDebitReturnedEvent,
-        V2MoneyManagementInboundTransferBankDebitSucceededEvent.lookup_type =>
-        V2MoneyManagementInboundTransferBankDebitSucceededEvent,
-        V2MoneyManagementOutboundPaymentCanceledEvent.lookup_type =>
-        V2MoneyManagementOutboundPaymentCanceledEvent,
-        V2MoneyManagementOutboundPaymentCreatedEvent.lookup_type =>
-        V2MoneyManagementOutboundPaymentCreatedEvent,
-        V2MoneyManagementOutboundPaymentFailedEvent.lookup_type =>
-        V2MoneyManagementOutboundPaymentFailedEvent,
-        V2MoneyManagementOutboundPaymentPostedEvent.lookup_type =>
-        V2MoneyManagementOutboundPaymentPostedEvent,
-        V2MoneyManagementOutboundPaymentReturnedEvent.lookup_type =>
-        V2MoneyManagementOutboundPaymentReturnedEvent,
-        V2MoneyManagementOutboundTransferCanceledEvent.lookup_type =>
-        V2MoneyManagementOutboundTransferCanceledEvent,
-        V2MoneyManagementOutboundTransferCreatedEvent.lookup_type =>
-        V2MoneyManagementOutboundTransferCreatedEvent,
-        V2MoneyManagementOutboundTransferFailedEvent.lookup_type =>
-        V2MoneyManagementOutboundTransferFailedEvent,
-        V2MoneyManagementOutboundTransferPostedEvent.lookup_type =>
-        V2MoneyManagementOutboundTransferPostedEvent,
-        V2MoneyManagementOutboundTransferReturnedEvent.lookup_type =>
-        V2MoneyManagementOutboundTransferReturnedEvent,
-        V2MoneyManagementReceivedCreditAvailableEvent.lookup_type =>
-        V2MoneyManagementReceivedCreditAvailableEvent,
-        V2MoneyManagementReceivedCreditFailedEvent.lookup_type =>
-        V2MoneyManagementReceivedCreditFailedEvent,
-        V2MoneyManagementReceivedCreditReturnedEvent.lookup_type =>
-        V2MoneyManagementReceivedCreditReturnedEvent,
-        V2MoneyManagementReceivedCreditSucceededEvent.lookup_type =>
-        V2MoneyManagementReceivedCreditSucceededEvent,
-        V2MoneyManagementReceivedDebitCanceledEvent.lookup_type =>
-        V2MoneyManagementReceivedDebitCanceledEvent,
-        V2MoneyManagementReceivedDebitFailedEvent.lookup_type => V2MoneyManagementReceivedDebitFailedEvent,
-        V2MoneyManagementReceivedDebitPendingEvent.lookup_type =>
-        V2MoneyManagementReceivedDebitPendingEvent,
-        V2MoneyManagementReceivedDebitSucceededEvent.lookup_type =>
-        V2MoneyManagementReceivedDebitSucceededEvent,
-        V2MoneyManagementReceivedDebitUpdatedEvent.lookup_type =>
-        V2MoneyManagementReceivedDebitUpdatedEvent,
         # The end of the section generated from our OpenAPI spec
       }
     end

data/lib/stripe/object_types.rb

@@ -14,7 +14,6 @@ module Stripe
         # object classes: The beginning of the section generated from our OpenAPI spec
         Account.object_name => Account,
         AccountLink.object_name => AccountLink,
-        AccountNotice.object_name => AccountNotice,
         AccountSession.object_name => AccountSession,
         ApplePayDomain.object_name => ApplePayDomain,
         Application.object_name => Application,
@@ -22,7 +21,6 @@ module Stripe
         ApplicationFeeRefund.object_name => ApplicationFeeRefund,
         Apps::Secret.object_name => Apps::Secret,
         Balance.object_name => Balance,
-        BalanceSettings.object_name => BalanceSettings,
         BalanceTransaction.object_name => BalanceTransaction,
         BankAccount.object_name => BankAccount,
         Billing::Alert.object_name => Billing::Alert,
@@ -31,16 +29,12 @@ module Stripe
         Billing::CreditBalanceTransaction.object_name => Billing::CreditBalanceTransaction,
         Billing::CreditGrant.object_name => Billing::CreditGrant,
         Billing::Meter.object_name => Billing::Meter,
-        Billing::MeterErrorReport.object_name => Billing::MeterErrorReport,
         Billing::MeterEvent.object_name => Billing::MeterEvent,
         Billing::MeterEventAdjustment.object_name => Billing::MeterEventAdjustment,
         Billing::MeterEventSummary.object_name => Billing::MeterEventSummary,
         BillingPortal::Configuration.object_name => BillingPortal::Configuration,
         BillingPortal::Session.object_name => BillingPortal::Session,
         Capability.object_name => Capability,
-        Capital::FinancingOffer.object_name => Capital::FinancingOffer,
-        Capital::FinancingSummary.object_name => Capital::FinancingSummary,
-        Capital::FinancingTransaction.object_name => Capital::FinancingTransaction,
         Card.object_name => Card,
         CashBalance.object_name => CashBalance,
         Charge.object_name => Charge,
@@ -69,17 +63,12 @@ module Stripe
         File.object_name => File,
         FileLink.object_name => FileLink,
         FinancialConnections::Account.object_name => FinancialConnections::Account,
-        FinancialConnections::AccountInferredBalance.object_name =>
-        FinancialConnections::AccountInferredBalance,
         FinancialConnections::AccountOwner.object_name => FinancialConnections::AccountOwner,
         FinancialConnections::AccountOwnership.object_name => FinancialConnections::AccountOwnership,
-        FinancialConnections::Institution.object_name => FinancialConnections::Institution,
         FinancialConnections::Session.object_name => FinancialConnections::Session,
         FinancialConnections::Transaction.object_name => FinancialConnections::Transaction,
         Forwarding::Request.object_name => Forwarding::Request,
         FundingInstructions.object_name => FundingInstructions,
-        GiftCards::Card.object_name => GiftCards::Card,
-        GiftCards::Transaction.object_name => GiftCards::Transaction,
         Identity::VerificationReport.object_name => Identity::VerificationReport,
         Identity::VerificationSession.object_name => Identity::VerificationSession,
         Invoice.object_name => Invoice,
@@ -90,27 +79,19 @@ module Stripe
         Issuing::Authorization.object_name => Issuing::Authorization,
         Issuing::Card.object_name => Issuing::Card,
         Issuing::Cardholder.object_name => Issuing::Cardholder,
-        Issuing::CreditUnderwritingRecord.object_name => Issuing::CreditUnderwritingRecord,
         Issuing::Dispute.object_name => Issuing::Dispute,
-        Issuing::DisputeSettlementDetail.object_name => Issuing::DisputeSettlementDetail,
-        Issuing::FraudLiabilityDebit.object_name => Issuing::FraudLiabilityDebit,
         Issuing::PersonalizationDesign.object_name => Issuing::PersonalizationDesign,
         Issuing::PhysicalBundle.object_name => Issuing::PhysicalBundle,
-        Issuing::Settlement.object_name => Issuing::Settlement,
         Issuing::Token.object_name => Issuing::Token,
         Issuing::Transaction.object_name => Issuing::Transaction,
         LineItem.object_name => LineItem,
         LoginLink.object_name => LoginLink,
         Mandate.object_name => Mandate,
-        Margin.object_name => Margin,
-        Order.object_name => Order,
-        PaymentAttemptRecord.object_name => PaymentAttemptRecord,
         PaymentIntent.object_name => PaymentIntent,
         PaymentLink.object_name => PaymentLink,
         PaymentMethod.object_name => PaymentMethod,
         PaymentMethodConfiguration.object_name => PaymentMethodConfiguration,
         PaymentMethodDomain.object_name => PaymentMethodDomain,
-        PaymentRecord.object_name => PaymentRecord,
         Payout.object_name => Payout,
         Person.object_name => Person,
         Plan.object_name => Plan,
@@ -119,9 +100,6 @@ module Stripe
         ProductFeature.object_name => ProductFeature,
         PromotionCode.object_name => PromotionCode,
         Quote.object_name => Quote,
-        QuoteLine.object_name => QuoteLine,
-        QuotePreviewInvoice.object_name => QuotePreviewInvoice,
-        QuotePreviewSubscriptionSchedule.object_name => QuotePreviewSubscriptionSchedule,
         Radar::EarlyFraudWarning.object_name => Radar::EarlyFraudWarning,
         Radar::ValueList.object_name => Radar::ValueList,
         Radar::ValueListItem.object_name => Radar::ValueListItem,
@@ -141,10 +119,8 @@ module Stripe
         Subscription.object_name => Subscription,
         SubscriptionItem.object_name => SubscriptionItem,
         SubscriptionSchedule.object_name => SubscriptionSchedule,
-        Tax::Association.object_name => Tax::Association,
         Tax::Calculation.object_name => Tax::Calculation,
         Tax::CalculationLineItem.object_name => Tax::CalculationLineItem,
-        Tax::Form.object_name => Tax::Form,
         Tax::Registration.object_name => Tax::Registration,
         Tax::Settings.object_name => Tax::Settings,
         Tax::Transaction.object_name => Tax::Transaction,
@@ -157,7 +133,6 @@ module Stripe
         Terminal::ConnectionToken.object_name => Terminal::ConnectionToken,
         Terminal::Location.object_name => Terminal::Location,
         Terminal::Reader.object_name => Terminal::Reader,
-        Terminal::ReaderCollectedData.object_name => Terminal::ReaderCollectedData,
         TestHelpers::TestClock.object_name => TestHelpers::TestClock,
         Token.object_name => Token,
         Topup.object_name => Topup,
@@ -186,31 +161,8 @@ module Stripe
         V2::Billing::MeterEvent.object_name => V2::Billing::MeterEvent,
         V2::Billing::MeterEventAdjustment.object_name => V2::Billing::MeterEventAdjustment,
         V2::Billing::MeterEventSession.object_name => V2::Billing::MeterEventSession,
-        V2::Core::Account.object_name => V2::Core::Account,
-        V2::Core::AccountLink.object_name => V2::Core::AccountLink,
-        V2::Core::Person.object_name => V2::Core::Person,
-        V2::Core::Vault::GbBankAccount.object_name => V2::Core::Vault::GbBankAccount,
-        V2::Core::Vault::UsBankAccount.object_name => V2::Core::Vault::UsBankAccount,
         V2::Event.object_name => V2::Event,
         V2::EventDestination.object_name => V2::EventDestination,
-        V2::FinancialAddressCreditSimulation.object_name => V2::FinancialAddressCreditSimulation,
-        V2::FinancialAddressGeneratedMicrodeposits.object_name =>
-        V2::FinancialAddressGeneratedMicrodeposits,
-        V2::MoneyManagement::Adjustment.object_name => V2::MoneyManagement::Adjustment,
-        V2::MoneyManagement::FinancialAccount.object_name => V2::MoneyManagement::FinancialAccount,
-        V2::MoneyManagement::FinancialAddress.object_name => V2::MoneyManagement::FinancialAddress,
-        V2::MoneyManagement::InboundTransfer.object_name => V2::MoneyManagement::InboundTransfer,
-        V2::MoneyManagement::OutboundPayment.object_name => V2::MoneyManagement::OutboundPayment,
-        V2::MoneyManagement::OutboundPaymentQuote.object_name => V2::MoneyManagement::OutboundPaymentQuote,
-        V2::MoneyManagement::OutboundSetupIntent.object_name => V2::MoneyManagement::OutboundSetupIntent,
-        V2::MoneyManagement::OutboundTransfer.object_name => V2::MoneyManagement::OutboundTransfer,
-        V2::MoneyManagement::PayoutMethod.object_name => V2::MoneyManagement::PayoutMethod,
-        V2::MoneyManagement::PayoutMethodsBankAccountSpec.object_name =>
-        V2::MoneyManagement::PayoutMethodsBankAccountSpec,
-        V2::MoneyManagement::ReceivedCredit.object_name => V2::MoneyManagement::ReceivedCredit,
-        V2::MoneyManagement::ReceivedDebit.object_name => V2::MoneyManagement::ReceivedDebit,
-        V2::MoneyManagement::Transaction.object_name => V2::MoneyManagement::Transaction,
-        V2::MoneyManagement::TransactionEntry.object_name => V2::MoneyManagement::TransactionEntry,
         # v2 object classes: The end of the section generated from our OpenAPI spec
       }
     end

data/lib/stripe/request_options.rb

@@ -56,7 +56,7 @@ module Stripe
     # Merges requestor options hash on a StripeObject
     # with a per-request options hash, giving precedence
     # to the per-request options. Returns the merged request options.
-    # Expects two hashes.
+    # Expects two hashes, expects extract_opts_from_hash to be called first!!!
     def self.combine_opts(object_opts, req_opts)
       merged_opts = {
         api_key: req_opts[:api_key] || object_opts[:api_key],
@@ -64,6 +64,7 @@ module Stripe
         stripe_account: req_opts[:stripe_account] || object_opts[:stripe_account],
         stripe_context: req_opts[:stripe_context] || object_opts[:stripe_context],
         stripe_version: req_opts[:stripe_version] || object_opts[:stripe_version],
+        headers: req_opts[:headers] || {},
       }
 
       # Remove nil values from headers