stripe 19.2.0 → 19.3.0.pre.beta.1

data/lib/stripe/services/subscription_schedule_service.rb

@@ -3,6 +3,17 @@
 
 module Stripe
   class SubscriptionScheduleService < StripeService
+    # Amends an existing subscription schedule.
+    def amend(schedule, params = {}, opts = {})
+      request(
+        method: :post,
+        path: format("/v1/subscription_schedules/%<schedule>s/amend", { schedule: CGI.escape(schedule) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+
     # Cancels a subscription schedule and its associated subscription immediately (if the subscription schedule has an active subscription). A subscription schedule can only be canceled if its status is not_started or active.
     def cancel(schedule, params = {}, opts = {})
       request(

data/lib/stripe/services/subscription_service.rb

@@ -70,6 +70,17 @@ module Stripe
       )
     end
 
+    # Pauses a subscription by transitioning it to the paused status. A paused subscription does not generate invoices and will not advance to new billing periods. The subscription can be resumed later using the resume endpoint. Cannot pause subscriptions with attached schedules.
+    def pause(subscription, params = {}, opts = {})
+      request(
+        method: :post,
+        path: format("/v1/subscriptions/%<subscription>s/pause", { subscription: CGI.escape(subscription) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+
     # Initiates resumption of a paused subscription, optionally resetting the billing cycle anchor and creating prorations. Resume is only available for subscriptions that use charge_automatically collection. If Stripe doesn't generate a resumption invoice, the subscription becomes active immediately. When a resumption invoice is generated, Stripe finalizes it immediately. If the invoice is paid or marked uncollectible, the subscription becomes active. If the invoice is manually voided, the subscription stays paused. If there is no payment attempt within 23 hours, Stripe voids the invoice and the subscription stays paused. Learn more about [resuming subscriptions](https://docs.stripe.com/docs/billing/subscriptions/pause#resume-subscriptions).
     def resume(subscription, params = {}, opts = {})
       request(
@@ -106,6 +117,51 @@ module Stripe
       )
     end
 
+    # Serializes a Subscription cancel request into a batch job JSONL line.
+    def serialize_batch_cancel(subscription_exposed_id, params = {}, opts = {})
+      request_id = SecureRandom.uuid
+      stripe_version = opts[:stripe_version] || Stripe.api_version
+
+      request_body = {
+        id: request_id,
+        params: params,
+        stripe_version: stripe_version,
+      }
+      request_body[:path_params] = { subscription_exposed_id: subscription_exposed_id }
+      request_body[:context] = opts[:stripe_context] if opts[:stripe_context]
+      JSON.generate(request_body)
+    end
+
+    # Serializes a Subscription migrate request into a batch job JSONL line.
+    def serialize_batch_migrate(subscription, params = {}, opts = {})
+      request_id = SecureRandom.uuid
+      stripe_version = opts[:stripe_version] || Stripe.api_version
+
+      request_body = {
+        id: request_id,
+        params: params,
+        stripe_version: stripe_version,
+      }
+      request_body[:path_params] = { subscription: subscription }
+      request_body[:context] = opts[:stripe_context] if opts[:stripe_context]
+      JSON.generate(request_body)
+    end
+
+    # Serializes a Subscription update request into a batch job JSONL line.
+    def serialize_batch_update(subscription_exposed_id, params = {}, opts = {})
+      request_id = SecureRandom.uuid
+      stripe_version = opts[:stripe_version] || Stripe.api_version
+
+      request_body = {
+        id: request_id,
+        params: params,
+        stripe_version: stripe_version,
+      }
+      request_body[:path_params] = { subscription_exposed_id: subscription_exposed_id }
+      request_body[:context] = opts[:stripe_context] if opts[:stripe_context]
+      JSON.generate(request_body)
+    end
+
     # Updates an existing subscription to match the specified parameters.
     # When changing prices or quantities, we optionally prorate the price we charge next month to make up for any price changes.
     # To preview how the proration is calculated, use the [create preview](https://docs.stripe.com/docs/api/invoices/create_preview) endpoint.

data/lib/stripe/services/tax/form_service.rb

@@ -0,0 +1,37 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Tax
+    class FormService < StripeService
+      # Returns a list of tax forms which were previously created. The tax forms are returned in sorted order, with the oldest tax forms appearing first.
+      def list(params = {}, opts = {})
+        request(method: :get, path: "/v1/tax/forms", params: params, opts: opts, base_address: :api)
+      end
+
+      # Download the PDF for a tax form.
+      def pdf(id, params = {}, opts = {}, &read_body_chunk_block)
+        opts = { api_base: APIRequestor.active_requestor.config.uploads_base }.merge(opts)
+        request_stream(
+          method: :get,
+          path: format("/v1/tax/forms/%<id>s/pdf", { id: CGI.escape(id) }),
+          params: params,
+          opts: opts,
+          base_address: :files,
+          &read_body_chunk_block
+        )
+      end
+
+      # Retrieves the details of a tax form that has previously been created. Supply the unique tax form ID that was returned from your previous request, and Stripe will return the corresponding tax form information.
+      def retrieve(id, params = {}, opts = {})
+        request(
+          method: :get,
+          path: format("/v1/tax/forms/%<id>s", { id: CGI.escape(id) }),
+          params: params,
+          opts: opts,
+          base_address: :api
+        )
+      end
+    end
+  end
+end

data/lib/stripe/services/tax/location_service.rb

@@ -0,0 +1,45 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Tax
+    class LocationService < StripeService
+      # Create a tax location to use in calculating taxes for a service, ticket, or other type of product. The resulting object contains the id, address, name, description, and current operational status of the tax location.
+      def create(params = {}, opts = {})
+        request(
+          method: :post,
+          path: "/v1/tax/locations",
+          params: params,
+          opts: opts,
+          base_address: :api
+        )
+      end
+
+      # Retrieve a list of all tax locations. Tax locations can represent the venues for services, tickets, or other product types.
+      #
+      # The response includes detailed information for each tax location, such as its address, name, description, and current operational status.
+      #
+      # You can paginate through the list by using the limit parameter to control the number of results returned in each request.
+      def list(params = {}, opts = {})
+        request(
+          method: :get,
+          path: "/v1/tax/locations",
+          params: params,
+          opts: opts,
+          base_address: :api
+        )
+      end
+
+      # Fetch the details of a specific tax location using its unique identifier. Use a tax location to calculate taxes based on the location of the end product, such as a performance, instead of the customer address. For more details, check the [integration guide](https://docs.stripe.com/tax/tax-for-tickets/integration-guide).
+      def retrieve(location, params = {}, opts = {})
+        request(
+          method: :get,
+          path: format("/v1/tax/locations/%<location>s", { location: CGI.escape(location) }),
+          params: params,
+          opts: opts,
+          base_address: :api
+        )
+      end
+    end
+  end
+end

data/lib/stripe/services/tax_service.rb

@@ -3,12 +3,14 @@
 
 module Stripe
   class TaxService < StripeService
-    attr_reader :associations, :calculations, :registrations, :settings, :transactions
+    attr_reader :associations, :calculations, :forms, :locations, :registrations, :settings, :transactions
 
     def initialize(requestor)
       super
       @associations = Stripe::Tax::AssociationService.new(@requestor)
       @calculations = Stripe::Tax::CalculationService.new(@requestor)
+      @forms = Stripe::Tax::FormService.new(@requestor)
+      @locations = Stripe::Tax::LocationService.new(@requestor)
       @registrations = Stripe::Tax::RegistrationService.new(@requestor)
       @settings = Stripe::Tax::SettingsService.new(@requestor)
       @transactions = Stripe::Tax::TransactionService.new(@requestor)

data/lib/stripe/services/terminal/reader_collected_data_service.rb

@@ -0,0 +1,19 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Terminal
+    class ReaderCollectedDataService < StripeService
+      # Retrieve data collected using Reader hardware.
+      def retrieve(reader_collected_data, params = {}, opts = {})
+        request(
+          method: :get,
+          path: format("/v1/terminal/reader_collected_data/%<reader_collected_data>s", { reader_collected_data: CGI.escape(reader_collected_data) }),
+          params: params,
+          opts: opts,
+          base_address: :api
+        )
+      end
+    end
+  end
+end

data/lib/stripe/services/terminal_service.rb

@@ -3,7 +3,7 @@
 
 module Stripe
   class TerminalService < StripeService
-    attr_reader :configurations, :connection_tokens, :locations, :onboarding_links, :readers
+    attr_reader :configurations, :connection_tokens, :locations, :onboarding_links, :readers, :reader_collected_data
 
     def initialize(requestor)
       super
@@ -12,6 +12,7 @@ module Stripe
       @locations = Stripe::Terminal::LocationService.new(@requestor)
       @onboarding_links = Stripe::Terminal::OnboardingLinkService.new(@requestor)
       @readers = Stripe::Terminal::ReaderService.new(@requestor)
+      @reader_collected_data = Stripe::Terminal::ReaderCollectedDataService.new(@requestor)
     end
   end
 end

data/lib/stripe/services/test_helpers/shared_payment/granted_token_service.rb

@@ -0,0 +1,32 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module TestHelpers
+    module SharedPayment
+      class GrantedTokenService < StripeService
+        # Creates a new test SharedPaymentGrantedToken object. This endpoint is only available in test mode and allows sellers to create SharedPaymentGrantedTokens for testing their integration
+        def create(params = {}, opts = {})
+          request(
+            method: :post,
+            path: "/v1/test_helpers/shared_payment/granted_tokens",
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+
+        # Revokes a test SharedPaymentGrantedToken object. This endpoint is only available in test mode and allows sellers to revoke SharedPaymentGrantedTokens for testing their integration
+        def revoke(shared_payment_granted_token, params = {}, opts = {})
+          request(
+            method: :post,
+            path: format("/v1/test_helpers/shared_payment/granted_tokens/%<shared_payment_granted_token>s/revoke", { shared_payment_granted_token: CGI.escape(shared_payment_granted_token) }),
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+      end
+    end
+  end
+end

data/lib/stripe/services/test_helpers/shared_payment_service.rb

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

data/lib/stripe/services/test_helpers_service.rb

@@ -3,7 +3,7 @@
 
 module Stripe
   class TestHelpersService < StripeService
-    attr_reader :confirmation_tokens, :customers, :issuing, :refunds, :terminal, :test_clocks, :treasury
+    attr_reader :confirmation_tokens, :customers, :issuing, :refunds, :shared_payment, :terminal, :test_clocks, :treasury
 
     def initialize(requestor)
       super
@@ -11,6 +11,7 @@ module Stripe
       @customers = Stripe::TestHelpers::CustomerService.new(@requestor)
       @issuing = Stripe::TestHelpers::IssuingService.new(@requestor)
       @refunds = Stripe::TestHelpers::RefundService.new(@requestor)
+      @shared_payment = Stripe::TestHelpers::SharedPaymentService.new(@requestor)
       @terminal = Stripe::TestHelpers::TerminalService.new(@requestor)
       @test_clocks = Stripe::TestHelpers::TestClockService.new(@requestor)
       @treasury = Stripe::TestHelpers::TreasuryService.new(@requestor)

data/lib/stripe/services/v1_services.rb

@@ -4,7 +4,7 @@ module Stripe
   class V1Services < StripeService
     # v1 accessors: The beginning of the section generated from our OpenAPI spec
     attr_reader :accounts
-    attr_reader :account_links, :account_sessions, :apple_pay_domains, :application_fees, :apps, :balance, :balance_settings, :balance_transactions, :billing, :billing_portal, :charges, :checkout, :climate, :confirmation_tokens, :country_specs, :coupons, :credit_notes, :customers, :customer_sessions, :disputes, :entitlements, :ephemeral_keys, :events, :exchange_rates, :files, :file_links, :financial_connections, :forwarding, :identity, :invoices, :invoice_items, :invoice_payments, :invoice_rendering_templates, :issuing, :mandates, :payment_attempt_records, :payment_intents, :payment_links, :payment_methods, :payment_method_configurations, :payment_method_domains, :payment_records, :payouts, :plans, :prices, :products, :promotion_codes, :quotes, :radar, :refunds, :reporting, :reviews, :setup_attempts, :setup_intents, :shipping_rates, :sigma, :sources, :subscriptions, :subscription_items, :subscription_schedules, :tax, :tax_codes, :tax_ids, :tax_rates, :terminal, :test_helpers, :tokens, :topups, :transfers, :treasury, :webhook_endpoints
+    attr_reader :account_links, :account_notices, :account_sessions, :apple_pay_domains, :application_fees, :apps, :balance, :balance_settings, :balance_transactions, :billing, :billing_portal, :capital, :charges, :checkout, :climate, :confirmation_tokens, :country_specs, :coupons, :credit_notes, :customers, :customer_sessions, :disputes, :entitlements, :ephemeral_keys, :events, :exchange_rates, :external_accounts, :files, :file_links, :financial_connections, :forwarding, :fx_quotes, :identity, :invoices, :invoice_items, :invoice_payments, :invoice_rendering_templates, :issuing, :mandates, :margins, :orders, :payment_attempt_records, :payment_intents, :payment_links, :payment_methods, :payment_method_configurations, :payment_method_domains, :payment_records, :payouts, :plans, :prices, :privacy, :products, :product_catalog, :promotion_codes, :quotes, :radar, :refunds, :reporting, :reserve, :reviews, :setup_attempts, :setup_intents, :shared_payment, :shipping_rates, :sigma, :sources, :subscriptions, :subscription_items, :subscription_schedules, :tax, :tax_codes, :tax_ids, :tax_rates, :terminal, :test_helpers, :tokens, :topups, :transfers, :treasury, :webhook_endpoints
     # v1 accessors: The end of the section generated from our OpenAPI spec
 
     # OAuthService is manually maintained, as it has special behaviors
@@ -15,6 +15,7 @@ module Stripe
       # v1 services: The beginning of the section generated from our OpenAPI spec
       @accounts = Stripe::AccountService.new(@requestor)
       @account_links = Stripe::AccountLinkService.new(@requestor)
+      @account_notices = Stripe::AccountNoticeService.new(@requestor)
       @account_sessions = Stripe::AccountSessionService.new(@requestor)
       @apple_pay_domains = Stripe::ApplePayDomainService.new(@requestor)
       @application_fees = Stripe::ApplicationFeeService.new(@requestor)
@@ -24,6 +25,7 @@ module Stripe
       @balance_transactions = Stripe::BalanceTransactionService.new(@requestor)
       @billing = Stripe::BillingService.new(@requestor)
       @billing_portal = Stripe::BillingPortalService.new(@requestor)
+      @capital = Stripe::CapitalService.new(@requestor)
       @charges = Stripe::ChargeService.new(@requestor)
       @checkout = Stripe::CheckoutService.new(@requestor)
       @climate = Stripe::ClimateService.new(@requestor)
@@ -38,10 +40,12 @@ module Stripe
       @ephemeral_keys = Stripe::EphemeralKeyService.new(@requestor)
       @events = Stripe::EventService.new(@requestor)
       @exchange_rates = Stripe::ExchangeRateService.new(@requestor)
+      @external_accounts = Stripe::ExternalAccountService.new(@requestor)
       @files = Stripe::FileService.new(@requestor)
       @file_links = Stripe::FileLinkService.new(@requestor)
       @financial_connections = Stripe::FinancialConnectionsService.new(@requestor)
       @forwarding = Stripe::ForwardingService.new(@requestor)
+      @fx_quotes = Stripe::FxQuoteService.new(@requestor)
       @identity = Stripe::IdentityService.new(@requestor)
       @invoices = Stripe::InvoiceService.new(@requestor)
       @invoice_items = Stripe::InvoiceItemService.new(@requestor)
@@ -49,6 +53,8 @@ module Stripe
       @invoice_rendering_templates = Stripe::InvoiceRenderingTemplateService.new(@requestor)
       @issuing = Stripe::IssuingService.new(@requestor)
       @mandates = Stripe::MandateService.new(@requestor)
+      @margins = Stripe::MarginService.new(@requestor)
+      @orders = Stripe::OrderService.new(@requestor)
       @payment_attempt_records = Stripe::PaymentAttemptRecordService.new(@requestor)
       @payment_intents = Stripe::PaymentIntentService.new(@requestor)
       @payment_links = Stripe::PaymentLinkService.new(@requestor)
@@ -59,15 +65,19 @@ module Stripe
       @payouts = Stripe::PayoutService.new(@requestor)
       @plans = Stripe::PlanService.new(@requestor)
       @prices = Stripe::PriceService.new(@requestor)
+      @privacy = Stripe::PrivacyService.new(@requestor)
       @products = Stripe::ProductService.new(@requestor)
+      @product_catalog = Stripe::ProductCatalogService.new(@requestor)
       @promotion_codes = Stripe::PromotionCodeService.new(@requestor)
       @quotes = Stripe::QuoteService.new(@requestor)
       @radar = Stripe::RadarService.new(@requestor)
       @refunds = Stripe::RefundService.new(@requestor)
       @reporting = Stripe::ReportingService.new(@requestor)
+      @reserve = Stripe::ReserveService.new(@requestor)
       @reviews = Stripe::ReviewService.new(@requestor)
       @setup_attempts = Stripe::SetupAttemptService.new(@requestor)
       @setup_intents = Stripe::SetupIntentService.new(@requestor)
+      @shared_payment = Stripe::SharedPaymentService.new(@requestor)
       @shipping_rates = Stripe::ShippingRateService.new(@requestor)
       @sigma = Stripe::SigmaService.new(@requestor)
       @sources = Stripe::SourceService.new(@requestor)

data/lib/stripe/services/v2/billing/bill_setting_service.rb

@@ -0,0 +1,61 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module Billing
+      class BillSettingService < StripeService
+        attr_reader :versions
+
+        def initialize(requestor)
+          super
+          @versions = Stripe::V2::Billing::BillSettings::VersionService.new(@requestor)
+        end
+
+        # Create a BillSetting object.
+        def create(params = {}, opts = {})
+          request(
+            method: :post,
+            path: "/v2/billing/bill_settings",
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+
+        # List all BillSetting objects.
+        def list(params = {}, opts = {})
+          request(
+            method: :get,
+            path: "/v2/billing/bill_settings",
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+
+        # Retrieve a BillSetting object by ID.
+        def retrieve(id, params = {}, opts = {})
+          request(
+            method: :get,
+            path: format("/v2/billing/bill_settings/%<id>s", { id: CGI.escape(id) }),
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+
+        # Update fields on an existing BillSetting object.
+        def update(id, params = {}, opts = {})
+          request(
+            method: :post,
+            path: format("/v2/billing/bill_settings/%<id>s", { id: CGI.escape(id) }),
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+      end
+    end
+  end
+end

data/lib/stripe/services/v2/billing/bill_settings/version_service.rb

@@ -0,0 +1,34 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module Billing
+      module BillSettings
+        class VersionService < StripeService
+          # List all BillSettingVersions by BillSetting ID.
+          def list(bill_setting_id, params = {}, opts = {})
+            request(
+              method: :get,
+              path: format("/v2/billing/bill_settings/%<bill_setting_id>s/versions", { bill_setting_id: CGI.escape(bill_setting_id) }),
+              params: params,
+              opts: opts,
+              base_address: :api
+            )
+          end
+
+          # Retrieve a BillSettingVersion by ID.
+          def retrieve(bill_setting_id, id, params = {}, opts = {})
+            request(
+              method: :get,
+              path: format("/v2/billing/bill_settings/%<bill_setting_id>s/versions/%<id>s", { bill_setting_id: CGI.escape(bill_setting_id), id: CGI.escape(id) }),
+              params: params,
+              opts: opts,
+              base_address: :api
+            )
+          end
+        end
+      end
+    end
+  end
+end

data/lib/stripe/services/v2/billing/cadence_service.rb

@@ -0,0 +1,65 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module Billing
+      class CadenceService < StripeService
+        # Cancel the Billing Cadence.
+        def cancel(id, params = {}, opts = {})
+          request(
+            method: :post,
+            path: format("/v2/billing/cadences/%<id>s/cancel", { id: CGI.escape(id) }),
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+
+        # Create a Billing Cadence object.
+        def create(params = {}, opts = {})
+          request(
+            method: :post,
+            path: "/v2/billing/cadences",
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+
+        # List Billing Cadences.
+        def list(params = {}, opts = {})
+          request(
+            method: :get,
+            path: "/v2/billing/cadences",
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+
+        # Retrieve a Billing Cadence object.
+        def retrieve(id, params = {}, opts = {})
+          request(
+            method: :get,
+            path: format("/v2/billing/cadences/%<id>s", { id: CGI.escape(id) }),
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+
+        # Update a Billing Cadence object.
+        def update(id, params = {}, opts = {})
+          request(
+            method: :post,
+            path: format("/v2/billing/cadences/%<id>s", { id: CGI.escape(id) }),
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+      end
+    end
+  end
+end

data/lib/stripe/services/v2/billing/collection_setting_service.rb

@@ -0,0 +1,69 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module Billing
+      class CollectionSettingService < StripeService
+        attr_reader :versions
+
+        def initialize(requestor)
+          super
+          @versions = Stripe::V2::Billing::CollectionSettings::VersionService.new(@requestor)
+        end
+
+        # Create a CollectionSetting object.
+        def create(params = {}, opts = {})
+          unless params.is_a?(Stripe::RequestParams)
+            params = ::Stripe::V2::Billing::CollectionSettingCreateParams.coerce_params(params)
+          end
+
+          request(
+            method: :post,
+            path: "/v2/billing/collection_settings",
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+
+        # List all CollectionSetting objects.
+        def list(params = {}, opts = {})
+          request(
+            method: :get,
+            path: "/v2/billing/collection_settings",
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+
+        # Retrieve a CollectionSetting by ID.
+        def retrieve(id, params = {}, opts = {})
+          request(
+            method: :get,
+            path: format("/v2/billing/collection_settings/%<id>s", { id: CGI.escape(id) }),
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+
+        # Update fields on an existing CollectionSetting.
+        def update(id, params = {}, opts = {})
+          unless params.is_a?(Stripe::RequestParams)
+            params = ::Stripe::V2::Billing::CollectionSettingUpdateParams.coerce_params(params)
+          end
+
+          request(
+            method: :post,
+            path: format("/v2/billing/collection_settings/%<id>s", { id: CGI.escape(id) }),
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+      end
+    end
+  end
+end

data/lib/stripe/services/v2/billing/collection_settings/version_service.rb

@@ -0,0 +1,34 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module Billing
+      module CollectionSettings
+        class VersionService < StripeService
+          # List all CollectionSettingVersions by CollectionSetting ID.
+          def list(collection_setting_id, params = {}, opts = {})
+            request(
+              method: :get,
+              path: format("/v2/billing/collection_settings/%<collection_setting_id>s/versions", { collection_setting_id: CGI.escape(collection_setting_id) }),
+              params: params,
+              opts: opts,
+              base_address: :api
+            )
+          end
+
+          # Retrieve a CollectionSetting Version by ID.
+          def retrieve(collection_setting_id, id, params = {}, opts = {})
+            request(
+              method: :get,
+              path: format("/v2/billing/collection_settings/%<collection_setting_id>s/versions/%<id>s", { collection_setting_id: CGI.escape(collection_setting_id), id: CGI.escape(id) }),
+              params: params,
+              opts: opts,
+              base_address: :api
+            )
+          end
+        end
+      end
+    end
+  end
+end