dodopayments 2.31.0 → 2.32.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b84caccdcf2ae495a3104820015c83363b0ca9ed6d0454ed2dc7b660405741be
-  data.tar.gz: 7083c71ad3de46a2477962c45f2113231035b6574381fa6aeb6d4c8ae1c6197f
+  metadata.gz: 2dd4dba4996639f045859e32a5187ada5f7725cc5c7c0055f800cb2c49935c3f
+  data.tar.gz: a2e9ce7d63c520af95f73a8a4b26318f903973402375e2b7e212e29a11233030
 SHA512:
-  metadata.gz: f0da4567068ad0098087e6fd29467ebe1d2a3fc9ab5ea5f40acc7c26e3041ebc938056dd61e6b932417c30048d377cd1d5edf6f79843f9c958ed290660495db3
-  data.tar.gz: 6330325f9b0552f28ca67baede7caddbd43f0507a2d3b02ce308b0efbd6c7c0b67de14e194056baba3cc86c8109b664fce3aae9dbedcc6c4583de8e0e03b9d9b
+  metadata.gz: 262e8aacde3b258e041f3d9b1ad3b6f34d16ef71a5e0c18153c2c2f15248ce381f5c04ff64aa3ee298a94790e93167e3758c7866f0f5c5ea35717243cea20901
+  data.tar.gz: babe2e389f26d85e678383f0a89457a38acd7d5222e29313a1a1117916fc5f9647bef1eb36dc0839f3f38e51b7fd06dbfe2ce69410ee3e8deb303541c9a47789

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [2.32.0](https://github.com/dodopayments/dodopayments-ruby/compare/v2.31.0...v2.32.0) (2026-10-06)
+
+
+### Features
+
+* **api:** change-plan cancel_older_payment_link and return_url ([ab42639](https://github.com/dodopayments/dodopayments-ruby/commit/ab42639341e3c3a4595df8792c706ac6cf13d9ce))
+* **api:** change-plan cancel_older_payment_link and return_url ([2b46789](https://github.com/dodopayments/dodopayments-ruby/commit/2b46789c533195890369df6a54daf324b9c689f7))
+
 ## [2.31.0](https://github.com/dodopayments/dodopayments-ruby/compare/v2.30.0...v2.31.0) (2026-10-05)
 
 

data/README.md

@@ -23,7 +23,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "dodopayments", "~> 2.31.0"
+gem "dodopayments", "~> 2.32.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/dodopayments/models/refund.rb

@@ -73,7 +73,7 @@ module Dodopayments
       # @!attribute network_reference
       #   The reference number that the card network or the bank gives to the refund. The
       #   customer can give this number to their bank to trace the refund. It is null
-      #   until the payment processor sends it.
+      #   until the reference is available.
       #
       #   @return [String, nil]
       optional :network_reference, String, nil?: true

data/lib/dodopayments/models/refund_list_item.rb

@@ -54,7 +54,7 @@ module Dodopayments
       # @!attribute network_reference
       #   The reference number that the card network or the bank gives to the refund. The
       #   customer can give this number to their bank to trace the refund. It is null
-      #   until the payment processor sends it.
+      #   until the reference is available.
       #
       #   @return [String, nil]
       optional :network_reference, String, nil?: true

data/lib/dodopayments/models/update_subscription_plan_req.rb

@@ -36,6 +36,23 @@ module Dodopayments
       #   @return [Array<Dodopayments::Models::AttachAddon>, nil]
       optional :addons, -> { Dodopayments::Internal::Type::ArrayOf[Dodopayments::AttachAddon] }, nil?: true
 
+      # @!attribute cancel_older_payment_link
+      #   Cancel the payment link of a pending plan change, so that this change can
+      #   replace it.
+      #
+      #   The link is cancelled only if the customer has not started to pay. A paid or
+      #   in-progress payment gives a `409`. A failed cancel gives a `503`, and a retry is
+      #   safe.
+      #
+      #   The request is validated before the cancel. A later failure, for example an
+      #   amount below the minimum, leaves the subscription on its current plan with no
+      #   open link. A retry is safe.
+      #
+      #   The preview route shares this request body and ignores this field.
+      #
+      #   @return [Boolean, nil]
+      optional :cancel_older_payment_link, Dodopayments::Internal::Type::Boolean
+
       # @!attribute cancel_scheduled_change_plan
       #   Replace a scheduled plan change with this one.
       #
@@ -116,7 +133,22 @@ module Dodopayments
                enum: -> { Dodopayments::UpdateSubscriptionPlanReq::OnPaymentFailure },
                nil?: true
 
-      # @!method initialize(product_id:, proration_billing_mode:, quantity:, adaptive_currency_fees_inclusive: nil, addons: nil, cancel_scheduled_change_plan: nil, collect_via_payment_link: nil, discount_code: nil, discount_codes: nil, effective_at: nil, metadata: nil, on_payment_failure: nil)
+      # @!attribute return_url
+      #   The URL that receives the customer after they pay the payment link. Needs
+      #   `collect_via_payment_link: true`. Without it, the request gets a `422`. A change
+      #   that collects no money issues no link and does not use the URL. The preview
+      #   route validates this field but does not use it.
+      #
+      #   The redirect adds `subscription_id`, `payment_id` and `status`. The `status`
+      #   value is the status of the plan-change payment. It is not the status of the
+      #   subscription. When that payment fails, the subscription stays active on its
+      #   current plan. To try again, call this endpoint again to get a new link. The new
+      #   plan can apply after the redirect, when the payment webhook arrives.
+      #
+      #   @return [String, nil]
+      optional :return_url, String, nil?: true
+
+      # @!method initialize(product_id:, proration_billing_mode:, quantity:, adaptive_currency_fees_inclusive: nil, addons: nil, cancel_older_payment_link: nil, cancel_scheduled_change_plan: nil, collect_via_payment_link: nil, discount_code: nil, discount_codes: nil, effective_at: nil, metadata: nil, on_payment_failure: nil, return_url: nil)
       #   Some parameter documentations has been truncated, see
       #   {Dodopayments::Models::UpdateSubscriptionPlanReq} for more details.
       #
@@ -130,6 +162,8 @@ module Dodopayments
       #
       #   @param addons [Array<Dodopayments::Models::AttachAddon>, nil] Addons for the new plan.
       #
+      #   @param cancel_older_payment_link [Boolean] Cancel the payment link of a pending plan change, so that this change
+      #
       #   @param cancel_scheduled_change_plan [Boolean] Replace a scheduled plan change with this one.
       #
       #   @param collect_via_payment_link [Boolean] Collect the plan-change amount with a payment link. The customer then
@@ -143,6 +177,8 @@ module Dodopayments
       #   @param metadata [Hash{Symbol=>String, Float, Boolean}, nil] Metadata for the payment. If not passed, the metadata of the subscription will b
       #
       #   @param on_payment_failure [Symbol, Dodopayments::Models::UpdateSubscriptionPlanReq::OnPaymentFailure, nil] Controls behavior when the plan change payment fails.
+      #
+      #   @param return_url [String, nil] The URL that receives the customer after they pay the payment link.
 
       # Proration Billing Mode
       #

data/lib/dodopayments/resources/subscriptions.rb

@@ -209,7 +209,7 @@ module Dodopayments
       # Some parameter documentations has been truncated, see
       # {Dodopayments::Models::SubscriptionChangePlanParams} for more details.
       #
-      # @overload change_plan(subscription_id, product_id:, proration_billing_mode:, quantity:, adaptive_currency_fees_inclusive: nil, addons: nil, cancel_scheduled_change_plan: nil, collect_via_payment_link: nil, discount_code: nil, discount_codes: nil, effective_at: nil, metadata: nil, on_payment_failure: nil, request_options: {})
+      # @overload change_plan(subscription_id, product_id:, proration_billing_mode:, quantity:, adaptive_currency_fees_inclusive: nil, addons: nil, cancel_older_payment_link: nil, cancel_scheduled_change_plan: nil, collect_via_payment_link: nil, discount_code: nil, discount_codes: nil, effective_at: nil, metadata: nil, on_payment_failure: nil, return_url: nil, request_options: {})
       #
       # @param subscription_id [String] Subscription Id
       #
@@ -223,6 +223,8 @@ module Dodopayments
       #
       # @param addons [Array<Dodopayments::Models::AttachAddon>, nil] Addons for the new plan.
       #
+      # @param cancel_older_payment_link [Boolean] Cancel the payment link of a pending plan change, so that this change
+      #
       # @param cancel_scheduled_change_plan [Boolean] Replace a scheduled plan change with this one.
       #
       # @param collect_via_payment_link [Boolean] Collect the plan-change amount with a payment link. The customer then
@@ -237,6 +239,8 @@ module Dodopayments
       #
       # @param on_payment_failure [Symbol, Dodopayments::Models::UpdateSubscriptionPlanReq::OnPaymentFailure, nil] Controls behavior when the plan change payment fails.
       #
+      # @param return_url [String, nil] The URL that receives the customer after they pay the payment link.
+      #
       # @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Dodopayments::Models::SubscriptionChangePlanResponse]
@@ -291,7 +295,7 @@ module Dodopayments
       # Some parameter documentations has been truncated, see
       # {Dodopayments::Models::SubscriptionPreviewChangePlanParams} for more details.
       #
-      # @overload preview_change_plan(subscription_id, product_id:, proration_billing_mode:, quantity:, adaptive_currency_fees_inclusive: nil, addons: nil, cancel_scheduled_change_plan: nil, collect_via_payment_link: nil, discount_code: nil, discount_codes: nil, effective_at: nil, metadata: nil, on_payment_failure: nil, request_options: {})
+      # @overload preview_change_plan(subscription_id, product_id:, proration_billing_mode:, quantity:, adaptive_currency_fees_inclusive: nil, addons: nil, cancel_older_payment_link: nil, cancel_scheduled_change_plan: nil, collect_via_payment_link: nil, discount_code: nil, discount_codes: nil, effective_at: nil, metadata: nil, on_payment_failure: nil, return_url: nil, request_options: {})
       #
       # @param subscription_id [String] Subscription Id
       #
@@ -305,6 +309,8 @@ module Dodopayments
       #
       # @param addons [Array<Dodopayments::Models::AttachAddon>, nil] Addons for the new plan.
       #
+      # @param cancel_older_payment_link [Boolean] Cancel the payment link of a pending plan change, so that this change
+      #
       # @param cancel_scheduled_change_plan [Boolean] Replace a scheduled plan change with this one.
       #
       # @param collect_via_payment_link [Boolean] Collect the plan-change amount with a payment link. The customer then
@@ -319,6 +325,8 @@ module Dodopayments
       #
       # @param on_payment_failure [Symbol, Dodopayments::Models::UpdateSubscriptionPlanReq::OnPaymentFailure, nil] Controls behavior when the plan change payment fails.
       #
+      # @param return_url [String, nil] The URL that receives the customer after they pay the payment link.
+      #
       # @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Dodopayments::Models::SubscriptionPreviewChangePlanResponse]

data/lib/dodopayments/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Dodopayments
-  VERSION = "2.31.0"
+  VERSION = "2.32.0"
 end

data/rbi/dodopayments/models/refund.rbi

@@ -59,7 +59,7 @@ module Dodopayments
 
       # The reference number that the card network or the bank gives to the refund. The
       # customer can give this number to their bank to trace the refund. It is null
-      # until the payment processor sends it.
+      # until the reference is available.
       sig { returns(T.nilable(String)) }
       attr_accessor :network_reference
 
@@ -119,7 +119,7 @@ module Dodopayments
         currency: nil,
         # The reference number that the card network or the bank gives to the refund. The
         # customer can give this number to their bank to trace the refund. It is null
-        # until the payment processor sends it.
+        # until the reference is available.
         network_reference: nil,
         # The kind of `network_reference`: ARN, STAN or RRN.
         network_reference_type: nil,

data/rbi/dodopayments/models/refund_list_item.rbi

@@ -42,7 +42,7 @@ module Dodopayments
 
       # The reference number that the card network or the bank gives to the refund. The
       # customer can give this number to their bank to trace the refund. It is null
-      # until the payment processor sends it.
+      # until the reference is available.
       sig { returns(T.nilable(String)) }
       attr_accessor :network_reference
 
@@ -93,7 +93,7 @@ module Dodopayments
         currency: nil,
         # The reference number that the card network or the bank gives to the refund. The
         # customer can give this number to their bank to trace the refund. It is null
-        # until the payment processor sends it.
+        # until the reference is available.
         network_reference: nil,
         # The kind of `network_reference`: ARN, STAN or RRN.
         network_reference_type: nil,

data/rbi/dodopayments/models/update_subscription_plan_req.rbi

@@ -37,6 +37,24 @@ module Dodopayments
       sig { returns(T.nilable(T::Array[Dodopayments::AttachAddon])) }
       attr_accessor :addons
 
+      # Cancel the payment link of a pending plan change, so that this change can
+      # replace it.
+      #
+      # The link is cancelled only if the customer has not started to pay. A paid or
+      # in-progress payment gives a `409`. A failed cancel gives a `503`, and a retry is
+      # safe.
+      #
+      # The request is validated before the cancel. A later failure, for example an
+      # amount below the minimum, leaves the subscription on its current plan with no
+      # open link. A retry is safe.
+      #
+      # The preview route shares this request body and ignores this field.
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :cancel_older_payment_link
+
+      sig { params(cancel_older_payment_link: T::Boolean).void }
+      attr_writer :cancel_older_payment_link
+
       # Replace a scheduled plan change with this one.
       #
       # The scheduled change is cancelled by the transaction that applies this change. A
@@ -127,6 +145,19 @@ module Dodopayments
       end
       attr_accessor :on_payment_failure
 
+      # The URL that receives the customer after they pay the payment link. Needs
+      # `collect_via_payment_link: true`. Without it, the request gets a `422`. A change
+      # that collects no money issues no link and does not use the URL. The preview
+      # route validates this field but does not use it.
+      #
+      # The redirect adds `subscription_id`, `payment_id` and `status`. The `status`
+      # value is the status of the plan-change payment. It is not the status of the
+      # subscription. When that payment fails, the subscription stays active on its
+      # current plan. To try again, call this endpoint again to get a new link. The new
+      # plan can apply after the redirect, when the payment webhook arrives.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :return_url
+
       sig do
         params(
           product_id: String,
@@ -135,6 +166,7 @@ module Dodopayments
           quantity: Integer,
           adaptive_currency_fees_inclusive: T.nilable(T::Boolean),
           addons: T.nilable(T::Array[Dodopayments::AttachAddon::OrHash]),
+          cancel_older_payment_link: T::Boolean,
           cancel_scheduled_change_plan: T::Boolean,
           collect_via_payment_link: T::Boolean,
           discount_code: T.nilable(String),
@@ -146,7 +178,8 @@ module Dodopayments
           on_payment_failure:
             T.nilable(
               Dodopayments::UpdateSubscriptionPlanReq::OnPaymentFailure::OrSymbol
-            )
+            ),
+          return_url: T.nilable(String)
         ).returns(T.attached_class)
       end
       def self.new(
@@ -162,6 +195,19 @@ module Dodopayments
         # Addons for the new plan. Note : Leaving this empty would remove any existing
         # addons
         addons: nil,
+        # Cancel the payment link of a pending plan change, so that this change can
+        # replace it.
+        #
+        # The link is cancelled only if the customer has not started to pay. A paid or
+        # in-progress payment gives a `409`. A failed cancel gives a `503`, and a retry is
+        # safe.
+        #
+        # The request is validated before the cancel. A later failure, for example an
+        # amount below the minimum, leaves the subscription on its current plan with no
+        # open link. A retry is safe.
+        #
+        # The preview route shares this request body and ignores this field.
+        cancel_older_payment_link: nil,
         # Replace a scheduled plan change with this one.
         #
         # The scheduled change is cancelled by the transaction that applies this change. A
@@ -207,7 +253,18 @@ module Dodopayments
         #   outcome
         #
         # If not specified, uses the business-level default setting.
-        on_payment_failure: nil
+        on_payment_failure: nil,
+        # The URL that receives the customer after they pay the payment link. Needs
+        # `collect_via_payment_link: true`. Without it, the request gets a `422`. A change
+        # that collects no money issues no link and does not use the URL. The preview
+        # route validates this field but does not use it.
+        #
+        # The redirect adds `subscription_id`, `payment_id` and `status`. The `status`
+        # value is the status of the plan-change payment. It is not the status of the
+        # subscription. When that payment fails, the subscription stays active on its
+        # current plan. To try again, call this endpoint again to get a new link. The new
+        # plan can apply after the redirect, when the payment webhook arrives.
+        return_url: nil
       )
       end
 
@@ -220,6 +277,7 @@ module Dodopayments
             quantity: Integer,
             adaptive_currency_fees_inclusive: T.nilable(T::Boolean),
             addons: T.nilable(T::Array[Dodopayments::AttachAddon]),
+            cancel_older_payment_link: T::Boolean,
             cancel_scheduled_change_plan: T::Boolean,
             collect_via_payment_link: T::Boolean,
             discount_code: T.nilable(String),
@@ -231,7 +289,8 @@ module Dodopayments
             on_payment_failure:
               T.nilable(
                 Dodopayments::UpdateSubscriptionPlanReq::OnPaymentFailure::OrSymbol
-              )
+              ),
+            return_url: T.nilable(String)
           }
         )
       end

data/rbi/dodopayments/resources/subscriptions.rbi

@@ -280,6 +280,7 @@ module Dodopayments
           quantity: Integer,
           adaptive_currency_fees_inclusive: T.nilable(T::Boolean),
           addons: T.nilable(T::Array[Dodopayments::AttachAddon::OrHash]),
+          cancel_older_payment_link: T::Boolean,
           cancel_scheduled_change_plan: T::Boolean,
           collect_via_payment_link: T::Boolean,
           discount_code: T.nilable(String),
@@ -292,6 +293,7 @@ module Dodopayments
             T.nilable(
               Dodopayments::UpdateSubscriptionPlanReq::OnPaymentFailure::OrSymbol
             ),
+          return_url: T.nilable(String),
           request_options: Dodopayments::RequestOptions::OrHash
         ).returns(Dodopayments::Models::SubscriptionChangePlanResponse)
       end
@@ -310,6 +312,19 @@ module Dodopayments
         # Addons for the new plan. Note : Leaving this empty would remove any existing
         # addons
         addons: nil,
+        # Cancel the payment link of a pending plan change, so that this change can
+        # replace it.
+        #
+        # The link is cancelled only if the customer has not started to pay. A paid or
+        # in-progress payment gives a `409`. A failed cancel gives a `503`, and a retry is
+        # safe.
+        #
+        # The request is validated before the cancel. A later failure, for example an
+        # amount below the minimum, leaves the subscription on its current plan with no
+        # open link. A retry is safe.
+        #
+        # The preview route shares this request body and ignores this field.
+        cancel_older_payment_link: nil,
         # Replace a scheduled plan change with this one.
         #
         # The scheduled change is cancelled by the transaction that applies this change. A
@@ -356,6 +371,17 @@ module Dodopayments
         #
         # If not specified, uses the business-level default setting.
         on_payment_failure: nil,
+        # The URL that receives the customer after they pay the payment link. Needs
+        # `collect_via_payment_link: true`. Without it, the request gets a `422`. A change
+        # that collects no money issues no link and does not use the URL. The preview
+        # route validates this field but does not use it.
+        #
+        # The redirect adds `subscription_id`, `payment_id` and `status`. The `status`
+        # value is the status of the plan-change payment. It is not the status of the
+        # subscription. When that payment fails, the subscription stays active on its
+        # current plan. To try again, call this endpoint again to get a new link. The new
+        # plan can apply after the redirect, when the payment webhook arrives.
+        return_url: nil,
         request_options: {}
       )
       end
@@ -410,6 +436,7 @@ module Dodopayments
           quantity: Integer,
           adaptive_currency_fees_inclusive: T.nilable(T::Boolean),
           addons: T.nilable(T::Array[Dodopayments::AttachAddon::OrHash]),
+          cancel_older_payment_link: T::Boolean,
           cancel_scheduled_change_plan: T::Boolean,
           collect_via_payment_link: T::Boolean,
           discount_code: T.nilable(String),
@@ -422,6 +449,7 @@ module Dodopayments
             T.nilable(
               Dodopayments::UpdateSubscriptionPlanReq::OnPaymentFailure::OrSymbol
             ),
+          return_url: T.nilable(String),
           request_options: Dodopayments::RequestOptions::OrHash
         ).returns(Dodopayments::Models::SubscriptionPreviewChangePlanResponse)
       end
@@ -440,6 +468,19 @@ module Dodopayments
         # Addons for the new plan. Note : Leaving this empty would remove any existing
         # addons
         addons: nil,
+        # Cancel the payment link of a pending plan change, so that this change can
+        # replace it.
+        #
+        # The link is cancelled only if the customer has not started to pay. A paid or
+        # in-progress payment gives a `409`. A failed cancel gives a `503`, and a retry is
+        # safe.
+        #
+        # The request is validated before the cancel. A later failure, for example an
+        # amount below the minimum, leaves the subscription on its current plan with no
+        # open link. A retry is safe.
+        #
+        # The preview route shares this request body and ignores this field.
+        cancel_older_payment_link: nil,
         # Replace a scheduled plan change with this one.
         #
         # The scheduled change is cancelled by the transaction that applies this change. A
@@ -486,6 +527,17 @@ module Dodopayments
         #
         # If not specified, uses the business-level default setting.
         on_payment_failure: nil,
+        # The URL that receives the customer after they pay the payment link. Needs
+        # `collect_via_payment_link: true`. Without it, the request gets a `422`. A change
+        # that collects no money issues no link and does not use the URL. The preview
+        # route validates this field but does not use it.
+        #
+        # The redirect adds `subscription_id`, `payment_id` and `status`. The `status`
+        # value is the status of the plan-change payment. It is not the status of the
+        # subscription. When that payment fails, the subscription stays active on its
+        # current plan. To try again, call this endpoint again to get a new link. The new
+        # plan can apply after the redirect, when the payment webhook arrives.
+        return_url: nil,
         request_options: {}
       )
       end

data/sig/dodopayments/models/update_subscription_plan_req.rbs

@@ -7,13 +7,15 @@ module Dodopayments
         quantity: Integer,
         adaptive_currency_fees_inclusive: bool?,
         addons: ::Array[Dodopayments::AttachAddon]?,
+        cancel_older_payment_link: bool,
         cancel_scheduled_change_plan: bool,
         collect_via_payment_link: bool,
         discount_code: String?,
         discount_codes: ::Array[String]?,
         effective_at: Dodopayments::Models::UpdateSubscriptionPlanReq::effective_at,
         metadata: Dodopayments::Models::metadata?,
-        on_payment_failure: Dodopayments::Models::UpdateSubscriptionPlanReq::on_payment_failure?
+        on_payment_failure: Dodopayments::Models::UpdateSubscriptionPlanReq::on_payment_failure?,
+        return_url: String?
       }
 
     class UpdateSubscriptionPlanReq < Dodopayments::Internal::Type::BaseModel
@@ -27,6 +29,10 @@ module Dodopayments
 
       attr_accessor addons: ::Array[Dodopayments::AttachAddon]?
 
+      attr_reader cancel_older_payment_link: bool?
+
+      def cancel_older_payment_link=: (bool) -> bool
+
       attr_reader cancel_scheduled_change_plan: bool?
 
       def cancel_scheduled_change_plan=: (bool) -> bool
@@ -49,19 +55,23 @@ module Dodopayments
 
       attr_accessor on_payment_failure: Dodopayments::Models::UpdateSubscriptionPlanReq::on_payment_failure?
 
+      attr_accessor return_url: String?
+
       def initialize: (
         product_id: String,
         proration_billing_mode: Dodopayments::Models::UpdateSubscriptionPlanReq::proration_billing_mode,
         quantity: Integer,
         ?adaptive_currency_fees_inclusive: bool?,
         ?addons: ::Array[Dodopayments::AttachAddon]?,
+        ?cancel_older_payment_link: bool,
         ?cancel_scheduled_change_plan: bool,
         ?collect_via_payment_link: bool,
         ?discount_code: String?,
         ?discount_codes: ::Array[String]?,
         ?effective_at: Dodopayments::Models::UpdateSubscriptionPlanReq::effective_at,
         ?metadata: Dodopayments::Models::metadata?,
-        ?on_payment_failure: Dodopayments::Models::UpdateSubscriptionPlanReq::on_payment_failure?
+        ?on_payment_failure: Dodopayments::Models::UpdateSubscriptionPlanReq::on_payment_failure?,
+        ?return_url: String?
       ) -> void
 
       def to_hash: -> {
@@ -70,13 +80,15 @@ module Dodopayments
         quantity: Integer,
         adaptive_currency_fees_inclusive: bool?,
         addons: ::Array[Dodopayments::AttachAddon]?,
+        cancel_older_payment_link: bool,
         cancel_scheduled_change_plan: bool,
         collect_via_payment_link: bool,
         discount_code: String?,
         discount_codes: ::Array[String]?,
         effective_at: Dodopayments::Models::UpdateSubscriptionPlanReq::effective_at,
         metadata: Dodopayments::Models::metadata?,
-        on_payment_failure: Dodopayments::Models::UpdateSubscriptionPlanReq::on_payment_failure?
+        on_payment_failure: Dodopayments::Models::UpdateSubscriptionPlanReq::on_payment_failure?,
+        return_url: String?
       }
 
       type proration_billing_mode =

data/sig/dodopayments/resources/subscriptions.rbs

@@ -80,6 +80,7 @@ module Dodopayments
         quantity: Integer,
         ?adaptive_currency_fees_inclusive: bool?,
         ?addons: ::Array[Dodopayments::AttachAddon]?,
+        ?cancel_older_payment_link: bool,
         ?cancel_scheduled_change_plan: bool,
         ?collect_via_payment_link: bool,
         ?discount_code: String?,
@@ -87,6 +88,7 @@ module Dodopayments
         ?effective_at: Dodopayments::Models::UpdateSubscriptionPlanReq::effective_at,
         ?metadata: Dodopayments::Models::metadata?,
         ?on_payment_failure: Dodopayments::Models::UpdateSubscriptionPlanReq::on_payment_failure?,
+        ?return_url: String?,
         ?request_options: Dodopayments::request_opts
       ) -> Dodopayments::Models::SubscriptionChangePlanResponse
 
@@ -108,6 +110,7 @@ module Dodopayments
         quantity: Integer,
         ?adaptive_currency_fees_inclusive: bool?,
         ?addons: ::Array[Dodopayments::AttachAddon]?,
+        ?cancel_older_payment_link: bool,
         ?cancel_scheduled_change_plan: bool,
         ?collect_via_payment_link: bool,
         ?discount_code: String?,
@@ -115,6 +118,7 @@ module Dodopayments
         ?effective_at: Dodopayments::Models::UpdateSubscriptionPlanReq::effective_at,
         ?metadata: Dodopayments::Models::metadata?,
         ?on_payment_failure: Dodopayments::Models::UpdateSubscriptionPlanReq::on_payment_failure?,
+        ?return_url: String?,
         ?request_options: Dodopayments::request_opts
       ) -> Dodopayments::Models::SubscriptionPreviewChangePlanResponse
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: dodopayments
 version: !ruby/object:Gem::Version
-  version: 2.31.0
+  version: 2.32.0
 platform: ruby
 authors:
 - Dodo Payments
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-10-05 00:00:00.000000000 Z
+date: 2026-10-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi