stripe 20.1.0 → 20.2.0.pre.beta.1

data/lib/stripe/services/shared_payment/issued_token_service.rb

@@ -0,0 +1,41 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module SharedPayment
+    class IssuedTokenService < StripeService
+      # Creates a new SharedPaymentIssuedToken object
+      def create(params = {}, opts = {})
+        request(
+          method: :post,
+          path: "/v1/shared_payment/issued_tokens",
+          params: params,
+          opts: opts,
+          base_address: :api
+        )
+      end
+
+      # Retrieves an existing SharedPaymentIssuedToken object
+      def retrieve(shared_payment_issued_token, params = {}, opts = {})
+        request(
+          method: :get,
+          path: format("/v1/shared_payment/issued_tokens/%<shared_payment_issued_token>s", { shared_payment_issued_token: CGI.escape(shared_payment_issued_token) }),
+          params: params,
+          opts: opts,
+          base_address: :api
+        )
+      end
+
+      # Revokes a SharedPaymentIssuedToken
+      def revoke(shared_payment_issued_token, params = {}, opts = {})
+        request(
+          method: :post,
+          path: format("/v1/shared_payment/issued_tokens/%<shared_payment_issued_token>s/revoke", { shared_payment_issued_token: CGI.escape(shared_payment_issued_token) }),
+          params: params,
+          opts: opts,
+          base_address: :api
+        )
+      end
+    end
+  end
+end

data/lib/stripe/services/shared_payment_service.rb

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

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

@@ -117,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_service.rb

@@ -3,12 +3,13 @@
 
 module Stripe
   class TaxService < StripeService
-    attr_reader :associations, :calculations, :locations, :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)

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 test helper 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 test helper 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, :product_catalog, :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, :three_d_secure, :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_plans, :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, :three_d_secure, :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,16 +53,20 @@ 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)
       @payment_methods = Stripe::PaymentMethodService.new(@requestor)
       @payment_method_configurations = Stripe::PaymentMethodConfigurationService.new(@requestor)
       @payment_method_domains = Stripe::PaymentMethodDomainService.new(@requestor)
+      @payment_plans = Stripe::PaymentPlanService.new(@requestor)
       @payment_records = Stripe::PaymentRecordService.new(@requestor)
       @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)
@@ -66,9 +74,11 @@ module Stripe
       @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