stripe 17.0.0 → 17.1.0.pre.beta.1

data/lib/stripe/services/v2/money_management/outbound_transfer_service.rb

@@ -0,0 +1,60 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module MoneyManagement
+      class OutboundTransferService < StripeService
+        # Cancels an OutboundTransfer. Only processing OutboundTransfers can be canceled.
+        #
+        # ** raises AlreadyCanceledError
+        # ** raises NotCancelableError
+        def cancel(id, params = {}, opts = {})
+          request(
+            method: :post,
+            path: format("/v2/money_management/outbound_transfers/%<id>s/cancel", { id: CGI.escape(id) }),
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+
+        # Creates an OutboundTransfer.
+        #
+        # ** raises InsufficientFundsError
+        # ** raises FeatureNotEnabledError
+        def create(params = {}, opts = {})
+          request(
+            method: :post,
+            path: "/v2/money_management/outbound_transfers",
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+
+        # Returns a list of OutboundTransfers that match the provided filters.
+        def list(params = {}, opts = {})
+          request(
+            method: :get,
+            path: "/v2/money_management/outbound_transfers",
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+
+        # Retrieves the details of an existing OutboundTransfer by passing the unique OutboundTransfer ID from either the OutboundPayment create or list response.
+        def retrieve(id, params = {}, opts = {})
+          request(
+            method: :get,
+            path: format("/v2/money_management/outbound_transfers/%<id>s", { id: CGI.escape(id) }),
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+      end
+    end
+  end
+end

data/lib/stripe/services/v2/money_management/payout_method_service.rb

@@ -0,0 +1,63 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module MoneyManagement
+      class PayoutMethodService < StripeService
+        # Archive a PayoutMethod object. Archived objects cannot be used as payout methods
+        # and will not appear in the payout method list.
+        #
+        # ** raises ControlledByDashboardError
+        # ** raises InvalidPayoutMethodError
+        def archive(id, params = {}, opts = {})
+          request(
+            method: :post,
+            path: format("/v2/money_management/payout_methods/%<id>s/archive", { id: CGI.escape(id) }),
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+
+        # List objects that adhere to the PayoutMethod interface.
+        def list(params = {}, opts = {})
+          request(
+            method: :get,
+            path: "/v2/money_management/payout_methods",
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+
+        # Retrieve a PayoutMethod object.
+        #
+        # ** raises InvalidPayoutMethodError
+        def retrieve(id, params = {}, opts = {})
+          request(
+            method: :get,
+            path: format("/v2/money_management/payout_methods/%<id>s", { id: CGI.escape(id) }),
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+
+        # Unarchive an PayoutMethod object.
+        #
+        # ** raises ControlledByDashboardError
+        # ** raises InvalidPayoutMethodError
+        def unarchive(id, params = {}, opts = {})
+          request(
+            method: :post,
+            path: format("/v2/money_management/payout_methods/%<id>s/unarchive", { id: CGI.escape(id) }),
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+      end
+    end
+  end
+end

data/lib/stripe/services/v2/money_management/payout_methods_bank_account_spec_service.rb

@@ -0,0 +1,23 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module MoneyManagement
+      class PayoutMethodsBankAccountSpecService < StripeService
+        # Fetch the specifications for a set of countries to know which
+        # credential fields are required, the validations for each fields, and how to translate these
+        # country-specific fields to the generic fields in the PayoutMethodBankAccount type.
+        def retrieve(params = {}, opts = {})
+          request(
+            method: :get,
+            path: "/v2/money_management/payout_methods_bank_account_spec",
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+      end
+    end
+  end
+end

data/lib/stripe/services/v2/money_management/received_credit_service.rb

@@ -0,0 +1,32 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module MoneyManagement
+      class ReceivedCreditService < StripeService
+        # Retrieves a list of ReceivedCredits.
+        def list(params = {}, opts = {})
+          request(
+            method: :get,
+            path: "/v2/money_management/received_credits",
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+
+        # Retrieve a ReceivedCredit by ID.
+        def retrieve(id, params = {}, opts = {})
+          request(
+            method: :get,
+            path: format("/v2/money_management/received_credits/%<id>s", { id: CGI.escape(id) }),
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+      end
+    end
+  end
+end

data/lib/stripe/services/v2/money_management/received_debit_service.rb

@@ -0,0 +1,32 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module MoneyManagement
+      class ReceivedDebitService < StripeService
+        # Retrieves a list of ReceivedDebits, given the selected filters.
+        def list(params = {}, opts = {})
+          request(
+            method: :get,
+            path: "/v2/money_management/received_debits",
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+
+        # Retrieves a single ReceivedDebit by ID.
+        def retrieve(id, params = {}, opts = {})
+          request(
+            method: :get,
+            path: format("/v2/money_management/received_debits/%<id>s", { id: CGI.escape(id) }),
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+      end
+    end
+  end
+end

data/lib/stripe/services/v2/money_management/transaction_entry_service.rb

@@ -0,0 +1,32 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module MoneyManagement
+      class TransactionEntryService < StripeService
+        # Returns a list of TransactionEntries that match the provided filters.
+        def list(params = {}, opts = {})
+          request(
+            method: :get,
+            path: "/v2/money_management/transaction_entries",
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+
+        # Retrieves the details of a TransactionEntry by ID.
+        def retrieve(id, params = {}, opts = {})
+          request(
+            method: :get,
+            path: format("/v2/money_management/transaction_entries/%<id>s", { id: CGI.escape(id) }),
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+      end
+    end
+  end
+end

data/lib/stripe/services/v2/money_management/transaction_service.rb

@@ -0,0 +1,32 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module MoneyManagement
+      class TransactionService < StripeService
+        # Returns a list of Transactions that match the provided filters.
+        def list(params = {}, opts = {})
+          request(
+            method: :get,
+            path: "/v2/money_management/transactions",
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+
+        # Retrieves the details of a Transaction by ID.
+        def retrieve(id, params = {}, opts = {})
+          request(
+            method: :get,
+            path: format("/v2/money_management/transactions/%<id>s", { id: CGI.escape(id) }),
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+      end
+    end
+  end
+end

data/lib/stripe/services/v2/money_management_service.rb

@@ -0,0 +1,31 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    class MoneyManagementService < StripeService
+      attr_reader :adjustments, :financial_accounts, :financial_addresses, :inbound_transfers, :outbound_payments, :outbound_payment_quotes, :outbound_setup_intents, :outbound_transfers, :payout_methods, :payout_methods_bank_account_spec, :received_credits, :received_debits, :transactions, :transaction_entries
+
+      def initialize(requestor)
+        super
+        @adjustments = Stripe::V2::MoneyManagement::AdjustmentService.new(@requestor)
+        @financial_accounts = Stripe::V2::MoneyManagement::FinancialAccountService.new(@requestor)
+        @financial_addresses = Stripe::V2::MoneyManagement::FinancialAddressService.new(@requestor)
+        @inbound_transfers = Stripe::V2::MoneyManagement::InboundTransferService.new(@requestor)
+        @outbound_payments = Stripe::V2::MoneyManagement::OutboundPaymentService.new(@requestor)
+        @outbound_payment_quotes = Stripe::V2::MoneyManagement::OutboundPaymentQuoteService
+                                   .new(@requestor)
+        @outbound_setup_intents = Stripe::V2::MoneyManagement::OutboundSetupIntentService
+                                  .new(@requestor)
+        @outbound_transfers = Stripe::V2::MoneyManagement::OutboundTransferService.new(@requestor)
+        @payout_methods = Stripe::V2::MoneyManagement::PayoutMethodService.new(@requestor)
+        @payout_methods_bank_account_spec = Stripe::V2::MoneyManagement::PayoutMethodsBankAccountSpecService
+                                            .new(@requestor)
+        @received_credits = Stripe::V2::MoneyManagement::ReceivedCreditService.new(@requestor)
+        @received_debits = Stripe::V2::MoneyManagement::ReceivedDebitService.new(@requestor)
+        @transactions = Stripe::V2::MoneyManagement::TransactionService.new(@requestor)
+        @transaction_entries = Stripe::V2::MoneyManagement::TransactionEntryService.new(@requestor)
+      end
+    end
+  end
+end

data/lib/stripe/services/v2/payment_service.rb

@@ -0,0 +1,15 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    class PaymentService < StripeService
+      attr_reader :off_session_payments
+
+      def initialize(requestor)
+        super
+        @off_session_payments = Stripe::V2::Payments::OffSessionPaymentService.new(@requestor)
+      end
+    end
+  end
+end

data/lib/stripe/services/v2/payments/off_session_payment_service.rb

@@ -0,0 +1,65 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module Payments
+      class OffSessionPaymentService < StripeService
+        # Cancel an OffSessionPayment that has previously been created.
+        def cancel(id, params = {}, opts = {})
+          request(
+            method: :post,
+            path: format("/v2/payments/off_session_payments/%<id>s/cancel", { id: CGI.escape(id) }),
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+
+        # Captures an OffSessionPayment that has previously been created.
+        def capture(id, params = {}, opts = {})
+          request(
+            method: :post,
+            path: format("/v2/payments/off_session_payments/%<id>s/capture", { id: CGI.escape(id) }),
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+
+        # Creates an OffSessionPayment object.
+        def create(params = {}, opts = {})
+          request(
+            method: :post,
+            path: "/v2/payments/off_session_payments",
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+
+        # Returns a list of OffSessionPayments matching a filter.
+        def list(params = {}, opts = {})
+          request(
+            method: :get,
+            path: "/v2/payments/off_session_payments",
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+
+        # Retrieves the details of an OffSessionPayment that has previously been created.
+        def retrieve(id, params = {}, opts = {})
+          request(
+            method: :get,
+            path: format("/v2/payments/off_session_payments/%<id>s", { id: CGI.escape(id) }),
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+      end
+    end
+  end
+end

data/lib/stripe/services/v2/test_helper_service.rb

@@ -0,0 +1,15 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    class TestHelperService < StripeService
+      attr_reader :financial_addresses
+
+      def initialize(requestor)
+        super
+        @financial_addresses = Stripe::V2::TestHelpers::FinancialAddressService.new(@requestor)
+      end
+    end
+  end
+end

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,15 @@
 
 module Stripe
   class V2Services < StripeService
-    attr_reader :billing, :core
+    attr_reader :billing, :core, :money_management, :payments, :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)
+      @payments = Stripe::V2::PaymentService.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,27 +89,42 @@ 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"
 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"
+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"
@@ -119,8 +145,10 @@ require "stripe/services/source_transaction_service"
 require "stripe/services/subscription_item_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"
@@ -132,6 +160,8 @@ 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/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"
@@ -169,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/accounts/person_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/payment_service"
+require "stripe/services/v2/payments/off_session_payment_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

@@ -314,7 +314,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