orb-billing 0.6.0 → 0.8.0

data/lib/orb/models/price_evaluate_response.rb

@@ -6,46 +6,11 @@ module Orb
     class PriceEvaluateResponse < Orb::Internal::Type::BaseModel
       # @!attribute data
       #
-      #   @return [Array<Orb::Models::PriceEvaluateResponse::Data>]
-      required :data, -> { Orb::Internal::Type::ArrayOf[Orb::Models::PriceEvaluateResponse::Data] }
+      #   @return [Array<Orb::Models::EvaluatePriceGroup>]
+      required :data, -> { Orb::Internal::Type::ArrayOf[Orb::EvaluatePriceGroup] }
 
       # @!method initialize(data:)
-      #   @param data [Array<Orb::Models::PriceEvaluateResponse::Data>]
-
-      class Data < Orb::Internal::Type::BaseModel
-        # @!attribute currency
-        #   The currency of the price
-        #
-        #   @return [String]
-        required :currency, String
-
-        # @!attribute price_groups
-        #   The computed price groups associated with input price.
-        #
-        #   @return [Array<Orb::Models::EvaluatePriceGroup>]
-        required :price_groups, -> { Orb::Internal::Type::ArrayOf[Orb::EvaluatePriceGroup] }
-
-        # @!attribute inline_price_index
-        #   The index of the inline price
-        #
-        #   @return [Integer, nil]
-        optional :inline_price_index, Integer, nil?: true
-
-        # @!attribute price_id
-        #   The ID of the price
-        #
-        #   @return [String, nil]
-        optional :price_id, String, nil?: true
-
-        # @!method initialize(currency:, price_groups:, inline_price_index: nil, price_id: nil)
-        #   @param currency [String] The currency of the price
-        #
-        #   @param price_groups [Array<Orb::Models::EvaluatePriceGroup>] The computed price groups associated with input price.
-        #
-        #   @param inline_price_index [Integer, nil] The index of the inline price
-        #
-        #   @param price_id [String, nil] The ID of the price
-      end
+      #   @param data [Array<Orb::Models::EvaluatePriceGroup>]
     end
   end
 end

data/lib/orb/models/subscription_create_params.rb

@@ -715,14 +715,22 @@ module Orb
           #   @return [String]
           required :currency, String
 
+          # @!attribute custom_expiration
+          #   The custom expiration for the allocation.
+          #
+          #   @return [Orb::Models::SubscriptionCreateParams::AddPrice::AllocationPrice::CustomExpiration, nil]
+          optional :custom_expiration,
+                   -> { Orb::SubscriptionCreateParams::AddPrice::AllocationPrice::CustomExpiration },
+                   nil?: true
+
           # @!attribute expires_at_end_of_cadence
           #   Whether the allocated amount should expire at the end of the cadence or roll
-          #   over to the next period.
+          #   over to the next period. Set to null if using custom_expiration.
           #
-          #   @return [Boolean]
-          required :expires_at_end_of_cadence, Orb::Internal::Type::Boolean
+          #   @return [Boolean, nil]
+          optional :expires_at_end_of_cadence, Orb::Internal::Type::Boolean, nil?: true
 
-          # @!method initialize(amount:, cadence:, currency:, expires_at_end_of_cadence:)
+          # @!method initialize(amount:, cadence:, currency:, custom_expiration: nil, expires_at_end_of_cadence: nil)
           #   Some parameter documentations has been truncated, see
           #   {Orb::Models::SubscriptionCreateParams::AddPrice::AllocationPrice} for more
           #   details.
@@ -735,7 +743,9 @@ module Orb
           #
           #   @param currency [String] An ISO 4217 currency string or a custom pricing unit identifier in which to bill
           #
-          #   @param expires_at_end_of_cadence [Boolean] Whether the allocated amount should expire at the end of the cadence or roll ove
+          #   @param custom_expiration [Orb::Models::SubscriptionCreateParams::AddPrice::AllocationPrice::CustomExpiration, nil] The custom expiration for the allocation.
+          #
+          #   @param expires_at_end_of_cadence [Boolean, nil] Whether the allocated amount should expire at the end of the cadence or roll ove
 
           # The cadence at which to allocate the amount to the customer.
           #
@@ -753,6 +763,39 @@ module Orb
             # @!method self.values
             #   @return [Array<Symbol>]
           end
+
+          # @see Orb::Models::SubscriptionCreateParams::AddPrice::AllocationPrice#custom_expiration
+          class CustomExpiration < Orb::Internal::Type::BaseModel
+            # @!attribute duration
+            #
+            #   @return [Integer]
+            required :duration, Integer
+
+            # @!attribute duration_unit
+            #
+            #   @return [Symbol, Orb::Models::SubscriptionCreateParams::AddPrice::AllocationPrice::CustomExpiration::DurationUnit]
+            required :duration_unit,
+                     enum: -> {
+                       Orb::SubscriptionCreateParams::AddPrice::AllocationPrice::CustomExpiration::DurationUnit
+                     }
+
+            # @!method initialize(duration:, duration_unit:)
+            #   The custom expiration for the allocation.
+            #
+            #   @param duration [Integer]
+            #   @param duration_unit [Symbol, Orb::Models::SubscriptionCreateParams::AddPrice::AllocationPrice::CustomExpiration::DurationUnit]
+
+            # @see Orb::Models::SubscriptionCreateParams::AddPrice::AllocationPrice::CustomExpiration#duration_unit
+            module DurationUnit
+              extend Orb::Internal::Type::Enum
+
+              DAY = :day
+              MONTH = :month
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+          end
         end
 
         class Discount < Orb::Internal::Type::BaseModel
@@ -9937,14 +9980,22 @@ module Orb
           #   @return [String]
           required :currency, String
 
+          # @!attribute custom_expiration
+          #   The custom expiration for the allocation.
+          #
+          #   @return [Orb::Models::SubscriptionCreateParams::ReplacePrice::AllocationPrice::CustomExpiration, nil]
+          optional :custom_expiration,
+                   -> { Orb::SubscriptionCreateParams::ReplacePrice::AllocationPrice::CustomExpiration },
+                   nil?: true
+
           # @!attribute expires_at_end_of_cadence
           #   Whether the allocated amount should expire at the end of the cadence or roll
-          #   over to the next period.
+          #   over to the next period. Set to null if using custom_expiration.
           #
-          #   @return [Boolean]
-          required :expires_at_end_of_cadence, Orb::Internal::Type::Boolean
+          #   @return [Boolean, nil]
+          optional :expires_at_end_of_cadence, Orb::Internal::Type::Boolean, nil?: true
 
-          # @!method initialize(amount:, cadence:, currency:, expires_at_end_of_cadence:)
+          # @!method initialize(amount:, cadence:, currency:, custom_expiration: nil, expires_at_end_of_cadence: nil)
           #   Some parameter documentations has been truncated, see
           #   {Orb::Models::SubscriptionCreateParams::ReplacePrice::AllocationPrice} for more
           #   details.
@@ -9957,7 +10008,9 @@ module Orb
           #
           #   @param currency [String] An ISO 4217 currency string or a custom pricing unit identifier in which to bill
           #
-          #   @param expires_at_end_of_cadence [Boolean] Whether the allocated amount should expire at the end of the cadence or roll ove
+          #   @param custom_expiration [Orb::Models::SubscriptionCreateParams::ReplacePrice::AllocationPrice::CustomExpiration, nil] The custom expiration for the allocation.
+          #
+          #   @param expires_at_end_of_cadence [Boolean, nil] Whether the allocated amount should expire at the end of the cadence or roll ove
 
           # The cadence at which to allocate the amount to the customer.
           #
@@ -9975,6 +10028,39 @@ module Orb
             # @!method self.values
             #   @return [Array<Symbol>]
           end
+
+          # @see Orb::Models::SubscriptionCreateParams::ReplacePrice::AllocationPrice#custom_expiration
+          class CustomExpiration < Orb::Internal::Type::BaseModel
+            # @!attribute duration
+            #
+            #   @return [Integer]
+            required :duration, Integer
+
+            # @!attribute duration_unit
+            #
+            #   @return [Symbol, Orb::Models::SubscriptionCreateParams::ReplacePrice::AllocationPrice::CustomExpiration::DurationUnit]
+            required :duration_unit,
+                     enum: -> {
+                       Orb::SubscriptionCreateParams::ReplacePrice::AllocationPrice::CustomExpiration::DurationUnit
+                     }
+
+            # @!method initialize(duration:, duration_unit:)
+            #   The custom expiration for the allocation.
+            #
+            #   @param duration [Integer]
+            #   @param duration_unit [Symbol, Orb::Models::SubscriptionCreateParams::ReplacePrice::AllocationPrice::CustomExpiration::DurationUnit]
+
+            # @see Orb::Models::SubscriptionCreateParams::ReplacePrice::AllocationPrice::CustomExpiration#duration_unit
+            module DurationUnit
+              extend Orb::Internal::Type::Enum
+
+              DAY = :day
+              MONTH = :month
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+          end
         end
 
         class Discount < Orb::Internal::Type::BaseModel

data/lib/orb/models/subscription_price_intervals_params.rb

@@ -218,14 +218,22 @@ module Orb
           #   @return [String]
           required :currency, String
 
+          # @!attribute custom_expiration
+          #   The custom expiration for the allocation.
+          #
+          #   @return [Orb::Models::SubscriptionPriceIntervalsParams::Add::AllocationPrice::CustomExpiration, nil]
+          optional :custom_expiration,
+                   -> { Orb::SubscriptionPriceIntervalsParams::Add::AllocationPrice::CustomExpiration },
+                   nil?: true
+
           # @!attribute expires_at_end_of_cadence
           #   Whether the allocated amount should expire at the end of the cadence or roll
-          #   over to the next period.
+          #   over to the next period. Set to null if using custom_expiration.
           #
-          #   @return [Boolean]
-          required :expires_at_end_of_cadence, Orb::Internal::Type::Boolean
+          #   @return [Boolean, nil]
+          optional :expires_at_end_of_cadence, Orb::Internal::Type::Boolean, nil?: true
 
-          # @!method initialize(amount:, cadence:, currency:, expires_at_end_of_cadence:)
+          # @!method initialize(amount:, cadence:, currency:, custom_expiration: nil, expires_at_end_of_cadence: nil)
           #   Some parameter documentations has been truncated, see
           #   {Orb::Models::SubscriptionPriceIntervalsParams::Add::AllocationPrice} for more
           #   details.
@@ -238,7 +246,9 @@ module Orb
           #
           #   @param currency [String] An ISO 4217 currency string or a custom pricing unit identifier in which to bill
           #
-          #   @param expires_at_end_of_cadence [Boolean] Whether the allocated amount should expire at the end of the cadence or roll ove
+          #   @param custom_expiration [Orb::Models::SubscriptionPriceIntervalsParams::Add::AllocationPrice::CustomExpiration, nil] The custom expiration for the allocation.
+          #
+          #   @param expires_at_end_of_cadence [Boolean, nil] Whether the allocated amount should expire at the end of the cadence or roll ove
 
           # The cadence at which to allocate the amount to the customer.
           #
@@ -256,6 +266,39 @@ module Orb
             # @!method self.values
             #   @return [Array<Symbol>]
           end
+
+          # @see Orb::Models::SubscriptionPriceIntervalsParams::Add::AllocationPrice#custom_expiration
+          class CustomExpiration < Orb::Internal::Type::BaseModel
+            # @!attribute duration
+            #
+            #   @return [Integer]
+            required :duration, Integer
+
+            # @!attribute duration_unit
+            #
+            #   @return [Symbol, Orb::Models::SubscriptionPriceIntervalsParams::Add::AllocationPrice::CustomExpiration::DurationUnit]
+            required :duration_unit,
+                     enum: -> {
+                       Orb::SubscriptionPriceIntervalsParams::Add::AllocationPrice::CustomExpiration::DurationUnit
+                     }
+
+            # @!method initialize(duration:, duration_unit:)
+            #   The custom expiration for the allocation.
+            #
+            #   @param duration [Integer]
+            #   @param duration_unit [Symbol, Orb::Models::SubscriptionPriceIntervalsParams::Add::AllocationPrice::CustomExpiration::DurationUnit]
+
+            # @see Orb::Models::SubscriptionPriceIntervalsParams::Add::AllocationPrice::CustomExpiration#duration_unit
+            module DurationUnit
+              extend Orb::Internal::Type::Enum
+
+              DAY = :day
+              MONTH = :month
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+          end
         end
 
         module Discount

data/lib/orb/models/subscription_schedule_plan_change_params.rb

@@ -688,14 +688,24 @@ module Orb
           #   @return [String]
           required :currency, String
 
+          # @!attribute custom_expiration
+          #   The custom expiration for the allocation.
+          #
+          #   @return [Orb::Models::SubscriptionSchedulePlanChangeParams::AddPrice::AllocationPrice::CustomExpiration, nil]
+          optional :custom_expiration,
+                   -> {
+                     Orb::SubscriptionSchedulePlanChangeParams::AddPrice::AllocationPrice::CustomExpiration
+                   },
+                   nil?: true
+
           # @!attribute expires_at_end_of_cadence
           #   Whether the allocated amount should expire at the end of the cadence or roll
-          #   over to the next period.
+          #   over to the next period. Set to null if using custom_expiration.
           #
-          #   @return [Boolean]
-          required :expires_at_end_of_cadence, Orb::Internal::Type::Boolean
+          #   @return [Boolean, nil]
+          optional :expires_at_end_of_cadence, Orb::Internal::Type::Boolean, nil?: true
 
-          # @!method initialize(amount:, cadence:, currency:, expires_at_end_of_cadence:)
+          # @!method initialize(amount:, cadence:, currency:, custom_expiration: nil, expires_at_end_of_cadence: nil)
           #   Some parameter documentations has been truncated, see
           #   {Orb::Models::SubscriptionSchedulePlanChangeParams::AddPrice::AllocationPrice}
           #   for more details.
@@ -708,7 +718,9 @@ module Orb
           #
           #   @param currency [String] An ISO 4217 currency string or a custom pricing unit identifier in which to bill
           #
-          #   @param expires_at_end_of_cadence [Boolean] Whether the allocated amount should expire at the end of the cadence or roll ove
+          #   @param custom_expiration [Orb::Models::SubscriptionSchedulePlanChangeParams::AddPrice::AllocationPrice::CustomExpiration, nil] The custom expiration for the allocation.
+          #
+          #   @param expires_at_end_of_cadence [Boolean, nil] Whether the allocated amount should expire at the end of the cadence or roll ove
 
           # The cadence at which to allocate the amount to the customer.
           #
@@ -726,6 +738,39 @@ module Orb
             # @!method self.values
             #   @return [Array<Symbol>]
           end
+
+          # @see Orb::Models::SubscriptionSchedulePlanChangeParams::AddPrice::AllocationPrice#custom_expiration
+          class CustomExpiration < Orb::Internal::Type::BaseModel
+            # @!attribute duration
+            #
+            #   @return [Integer]
+            required :duration, Integer
+
+            # @!attribute duration_unit
+            #
+            #   @return [Symbol, Orb::Models::SubscriptionSchedulePlanChangeParams::AddPrice::AllocationPrice::CustomExpiration::DurationUnit]
+            required :duration_unit,
+                     enum: -> {
+                       Orb::SubscriptionSchedulePlanChangeParams::AddPrice::AllocationPrice::CustomExpiration::DurationUnit
+                     }
+
+            # @!method initialize(duration:, duration_unit:)
+            #   The custom expiration for the allocation.
+            #
+            #   @param duration [Integer]
+            #   @param duration_unit [Symbol, Orb::Models::SubscriptionSchedulePlanChangeParams::AddPrice::AllocationPrice::CustomExpiration::DurationUnit]
+
+            # @see Orb::Models::SubscriptionSchedulePlanChangeParams::AddPrice::AllocationPrice::CustomExpiration#duration_unit
+            module DurationUnit
+              extend Orb::Internal::Type::Enum
+
+              DAY = :day
+              MONTH = :month
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+          end
         end
 
         class Discount < Orb::Internal::Type::BaseModel
@@ -9974,14 +10019,24 @@ module Orb
           #   @return [String]
           required :currency, String
 
+          # @!attribute custom_expiration
+          #   The custom expiration for the allocation.
+          #
+          #   @return [Orb::Models::SubscriptionSchedulePlanChangeParams::ReplacePrice::AllocationPrice::CustomExpiration, nil]
+          optional :custom_expiration,
+                   -> {
+                     Orb::SubscriptionSchedulePlanChangeParams::ReplacePrice::AllocationPrice::CustomExpiration
+                   },
+                   nil?: true
+
           # @!attribute expires_at_end_of_cadence
           #   Whether the allocated amount should expire at the end of the cadence or roll
-          #   over to the next period.
+          #   over to the next period. Set to null if using custom_expiration.
           #
-          #   @return [Boolean]
-          required :expires_at_end_of_cadence, Orb::Internal::Type::Boolean
+          #   @return [Boolean, nil]
+          optional :expires_at_end_of_cadence, Orb::Internal::Type::Boolean, nil?: true
 
-          # @!method initialize(amount:, cadence:, currency:, expires_at_end_of_cadence:)
+          # @!method initialize(amount:, cadence:, currency:, custom_expiration: nil, expires_at_end_of_cadence: nil)
           #   Some parameter documentations has been truncated, see
           #   {Orb::Models::SubscriptionSchedulePlanChangeParams::ReplacePrice::AllocationPrice}
           #   for more details.
@@ -9994,7 +10049,9 @@ module Orb
           #
           #   @param currency [String] An ISO 4217 currency string or a custom pricing unit identifier in which to bill
           #
-          #   @param expires_at_end_of_cadence [Boolean] Whether the allocated amount should expire at the end of the cadence or roll ove
+          #   @param custom_expiration [Orb::Models::SubscriptionSchedulePlanChangeParams::ReplacePrice::AllocationPrice::CustomExpiration, nil] The custom expiration for the allocation.
+          #
+          #   @param expires_at_end_of_cadence [Boolean, nil] Whether the allocated amount should expire at the end of the cadence or roll ove
 
           # The cadence at which to allocate the amount to the customer.
           #
@@ -10012,6 +10069,39 @@ module Orb
             # @!method self.values
             #   @return [Array<Symbol>]
           end
+
+          # @see Orb::Models::SubscriptionSchedulePlanChangeParams::ReplacePrice::AllocationPrice#custom_expiration
+          class CustomExpiration < Orb::Internal::Type::BaseModel
+            # @!attribute duration
+            #
+            #   @return [Integer]
+            required :duration, Integer
+
+            # @!attribute duration_unit
+            #
+            #   @return [Symbol, Orb::Models::SubscriptionSchedulePlanChangeParams::ReplacePrice::AllocationPrice::CustomExpiration::DurationUnit]
+            required :duration_unit,
+                     enum: -> {
+                       Orb::SubscriptionSchedulePlanChangeParams::ReplacePrice::AllocationPrice::CustomExpiration::DurationUnit
+                     }
+
+            # @!method initialize(duration:, duration_unit:)
+            #   The custom expiration for the allocation.
+            #
+            #   @param duration [Integer]
+            #   @param duration_unit [Symbol, Orb::Models::SubscriptionSchedulePlanChangeParams::ReplacePrice::AllocationPrice::CustomExpiration::DurationUnit]
+
+            # @see Orb::Models::SubscriptionSchedulePlanChangeParams::ReplacePrice::AllocationPrice::CustomExpiration#duration_unit
+            module DurationUnit
+              extend Orb::Internal::Type::Enum
+
+              DAY = :day
+              MONTH = :month
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+          end
         end
 
         class Discount < Orb::Internal::Type::BaseModel

data/lib/orb/models.rb

@@ -59,6 +59,14 @@ module Orb
 
   AmountDiscount = Orb::Models::AmountDiscount
 
+  Beta = Orb::Models::Beta
+
+  BetaCreatePlanVersionParams = Orb::Models::BetaCreatePlanVersionParams
+
+  BetaFetchPlanVersionParams = Orb::Models::BetaFetchPlanVersionParams
+
+  BetaSetDefaultPlanVersionParams = Orb::Models::BetaSetDefaultPlanVersionParams
+
   BillableMetric = Orb::Models::BillableMetric
 
   BillingCycleRelativeDate = Orb::Models::BillingCycleRelativeDate
@@ -190,14 +198,18 @@ module Orb
 
   Plans = Orb::Models::Plans
 
-  PlanSetDefaultVersionParams = Orb::Models::PlanSetDefaultVersionParams
-
   PlanUpdateParams = Orb::Models::PlanUpdateParams
 
+  PlanVersion = Orb::Models::PlanVersion
+
+  PlanVersionPhase = Orb::Models::PlanVersionPhase
+
   Price = Orb::Models::Price
 
   PriceCreateParams = Orb::Models::PriceCreateParams
 
+  PriceEvaluateMultipleParams = Orb::Models::PriceEvaluateMultipleParams
+
   PriceEvaluateParams = Orb::Models::PriceEvaluateParams
 
   PriceFetchParams = Orb::Models::PriceFetchParams

data/lib/orb/resources/beta/external_plan_id.rb

@@ -0,0 +1,113 @@
+# frozen_string_literal: true
+
+module Orb
+  module Resources
+    class Beta
+      class ExternalPlanID
+        # This API endpoint is in beta and its interface may change. It is recommended for
+        # use only in test mode.
+        #
+        # This endpoint allows the creation of a new plan version for an existing plan.
+        #
+        # @overload create_plan_version(external_plan_id, version:, add_adjustments: nil, add_prices: nil, remove_adjustments: nil, remove_prices: nil, replace_adjustments: nil, replace_prices: nil, set_as_default: nil, request_options: {})
+        #
+        # @param external_plan_id [String]
+        #
+        # @param version [Integer] New version number.
+        #
+        # @param add_adjustments [Array<Orb::Models::Beta::ExternalPlanIDCreatePlanVersionParams::AddAdjustment>, nil] Additional adjustments to be added to the plan.
+        #
+        # @param add_prices [Array<Orb::Models::Beta::ExternalPlanIDCreatePlanVersionParams::AddPrice>, nil] Additional prices to be added to the plan.
+        #
+        # @param remove_adjustments [Array<Orb::Models::Beta::ExternalPlanIDCreatePlanVersionParams::RemoveAdjustment>, nil] Adjustments to be removed from the plan.
+        #
+        # @param remove_prices [Array<Orb::Models::Beta::ExternalPlanIDCreatePlanVersionParams::RemovePrice>, nil] Prices to be removed from the plan.
+        #
+        # @param replace_adjustments [Array<Orb::Models::Beta::ExternalPlanIDCreatePlanVersionParams::ReplaceAdjustment>, nil] Adjustments to be replaced with additional adjustments on the plan.
+        #
+        # @param replace_prices [Array<Orb::Models::Beta::ExternalPlanIDCreatePlanVersionParams::ReplacePrice>, nil] Prices to be replaced with additional prices on the plan.
+        #
+        # @param set_as_default [Boolean, nil] Set this new plan version as the default
+        #
+        # @param request_options [Orb::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Orb::Models::PlanVersion]
+        #
+        # @see Orb::Models::Beta::ExternalPlanIDCreatePlanVersionParams
+        def create_plan_version(external_plan_id, params)
+          parsed, options = Orb::Beta::ExternalPlanIDCreatePlanVersionParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: ["plans/external_plan_id/%1$s/versions", external_plan_id],
+            body: parsed,
+            model: Orb::PlanVersion,
+            options: options
+          )
+        end
+
+        # This API endpoint is in beta and its interface may change. It is recommended for
+        # use only in test mode.
+        #
+        # This endpoint is used to fetch a plan version. It returns the phases, prices,
+        # and adjustments present on this version of the plan.
+        #
+        # @overload fetch_plan_version(version, external_plan_id:, request_options: {})
+        #
+        # @param version [String]
+        # @param external_plan_id [String]
+        # @param request_options [Orb::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Orb::Models::PlanVersion]
+        #
+        # @see Orb::Models::Beta::ExternalPlanIDFetchPlanVersionParams
+        def fetch_plan_version(version, params)
+          parsed, options = Orb::Beta::ExternalPlanIDFetchPlanVersionParams.dump_request(params)
+          external_plan_id =
+            parsed.delete(:external_plan_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :get,
+            path: ["plans/external_plan_id/%1$s/versions/%2$s", external_plan_id, version],
+            model: Orb::PlanVersion,
+            options: options
+          )
+        end
+
+        # This API endpoint is in beta and its interface may change. It is recommended for
+        # use only in test mode.
+        #
+        # This endpoint allows setting the default version of a plan.
+        #
+        # @overload set_default_plan_version(external_plan_id, version:, request_options: {})
+        #
+        # @param external_plan_id [String]
+        #
+        # @param version [Integer] Plan version to set as the default.
+        #
+        # @param request_options [Orb::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Orb::Models::Plan]
+        #
+        # @see Orb::Models::Beta::ExternalPlanIDSetDefaultPlanVersionParams
+        def set_default_plan_version(external_plan_id, params)
+          parsed, options = Orb::Beta::ExternalPlanIDSetDefaultPlanVersionParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: ["plans/external_plan_id/%1$s/set_default_version", external_plan_id],
+            body: parsed,
+            model: Orb::Plan,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Orb::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end