dodopayments 2.0.0 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ef4f6bb46a70196370c107262ab0ded8e7f5e8b7ce5c1a89bdee16c40b0571fe
-  data.tar.gz: 72faeedd0e7957b2416123e1f8550b75afdc75849c20164dc096b9070e0c3799
+  metadata.gz: 0c8a1a7552dbf00a74ffe8f37ac2511e453f65ff038ec7aa37805abfe6d5c84c
+  data.tar.gz: 23c2069b2faaadec6ae986dc781bf173751d306cd26f3c065658ccc733a5a297
 SHA512:
-  metadata.gz: 151f688026db3ec5d43def5a74a4548f8871e2cce8316c5579fbee135f981e3fac81ca36ba127e955902da8dc1b93bd520b3a3a208726d3699002fc93a866eca
-  data.tar.gz: d54158f03297e86772203969b0ef8cc74aefd628979dc10ed0160ea382b6b685435f3df6be9bd8064d8c153be8930ef62130f39ecc373c03eb261c18fc123ed2
+  metadata.gz: 74a022cc640152d922283897557440a4176700635040f3f3943fe61448b7134d21f80ad83247e50943dcfabe0fafcf83543159166de6bbb5dfcc814cd2dc4772
+  data.tar.gz: 4e82edb5899c4178ac6d2b50a2c2214ddde00849fa715ccf85d68b18a74d151673f8c7025db373e966cb549d0bf5e1376a74d4ec2afa7347f290942b3e5a294e

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 2.1.0 (2026-03-05)
+
+Full Changelog: [v2.0.0...v2.1.0](https://github.com/dodopayments/dodopayments-ruby/compare/v2.0.0...v2.1.0)
+
+### Features
+
+* **api:** updated openapi spec to v1.87.0 ([80979e6](https://github.com/dodopayments/dodopayments-ruby/commit/80979e652cba6b1ff1a3efaea1ff42b45ec26f41))
+
 ## 2.0.0 (2026-03-03)
 
 Full Changelog: [v1.85.0...v2.0.0](https://github.com/dodopayments/dodopayments-ruby/compare/v1.85.0...v2.0.0)

data/README.md

@@ -8,8 +8,8 @@ It is generated with [Stainless](https://www.stainless.com/).
 
 Use the Dodo Payments MCP Server to enable AI assistants to interact with this API, allowing them to explore endpoints, make test requests, and use documentation to help integrate this SDK into your application.
 
-[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=dodopayments-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImRvZG9wYXltZW50cy1tY3AiXSwiZW52Ijp7IkRPRE9fUEFZTUVOVFNfQVBJX0tFWSI6Ik15IEJlYXJlciBUb2tlbiIsIkRPRE9fUEFZTUVOVFNfV0VCSE9PS19LRVkiOiJNeSBXZWJob29rIEtleSJ9fQ)
-[![Install in VS Code](https://img.shields.io/badge/_-Add_to_VS_Code-blue?style=for-the-badge&logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIGZpbGw9Im5vbmUiIHZpZXdCb3g9IjAgMCA0MCA0MCI+PHBhdGggZmlsbD0iI0VFRSIgZmlsbC1ydWxlPSJldmVub2RkIiBkPSJNMzAuMjM1IDM5Ljg4NGEyLjQ5MSAyLjQ5MSAwIDAgMS0xLjc4MS0uNzNMMTIuNyAyNC43OGwtMy40NiAyLjYyNC0zLjQwNiAyLjU4MmExLjY2NSAxLjY2NSAwIDAgMS0xLjA4Mi4zMzggMS42NjQgMS42NjQgMCAwIDEtMS4wNDYtLjQzMWwtMi4yLTJhMS42NjYgMS42NjYgMCAwIDEgMC0yLjQ2M0w3LjQ1OCAyMCA0LjY3IDE3LjQ1MyAxLjUwNyAxNC41N2ExLjY2NSAxLjY2NSAwIDAgMSAwLTIuNDYzbDIuMi0yYTEuNjY1IDEuNjY1IDAgMCAxIDIuMTMtLjA5N2w2Ljg2MyA1LjIwOUwyOC40NTIuODQ0YTIuNDg4IDIuNDg4IDAgMCAxIDEuODQxLS43MjljLjM1MS4wMDkuNjk5LjA5MSAxLjAxOS4yNDVsOC4yMzYgMy45NjFhMi41IDIuNSAwIDAgMSAxLjQxNSAyLjI1M3YuMDk5LS4wNDVWMzMuMzd2LS4wNDUuMDk1YTIuNTAxIDIuNTAxIDAgMCAxLTEuNDE2IDIuMjU3bC04LjIzNSAzLjk2MWEyLjQ5MiAyLjQ5MiAwIDAgMS0xLjA3Ny4yNDZabS43MTYtMjguOTQ3LTExLjk0OCA5LjA2MiAxMS45NTIgOS4wNjUtLjAwNC0xOC4xMjdaIi8+PC9zdmc+)](https://vscode.stainless.com/mcp/%7B%22name%22%3A%22dodopayments-mcp%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22dodopayments-mcp%22%5D%2C%22env%22%3A%7B%22DODO_PAYMENTS_API_KEY%22%3A%22My%20Bearer%20Token%22%2C%22DODO_PAYMENTS_WEBHOOK_KEY%22%3A%22My%20Webhook%20Key%22%7D%7D)
+[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=dodopayments-mcp&config=eyJuYW1lIjoiZG9kb3BheW1lbnRzLW1jcCIsInRyYW5zcG9ydCI6Imh0dHAiLCJ1cmwiOiJodHRwczovL2RvZG8tcGF5bWVudHMuc3RsbWNwLmNvbSIsImhlYWRlcnMiOnsieC1kb2RvLXBheW1lbnRzLWFwaS1rZXkiOiJNeSBCZWFyZXIgVG9rZW4ifX0)
+[![Install in VS Code](https://img.shields.io/badge/_-Add_to_VS_Code-blue?style=for-the-badge&logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIGZpbGw9Im5vbmUiIHZpZXdCb3g9IjAgMCA0MCA0MCI+PHBhdGggZmlsbD0iI0VFRSIgZmlsbC1ydWxlPSJldmVub2RkIiBkPSJNMzAuMjM1IDM5Ljg4NGEyLjQ5MSAyLjQ5MSAwIDAgMS0xLjc4MS0uNzNMMTIuNyAyNC43OGwtMy40NiAyLjYyNC0zLjQwNiAyLjU4MmExLjY2NSAxLjY2NSAwIDAgMS0xLjA4Mi4zMzggMS42NjQgMS42NjQgMCAwIDEtMS4wNDYtLjQzMWwtMi4yLTJhMS42NjYgMS42NjYgMCAwIDEgMC0yLjQ2M0w3LjQ1OCAyMCA0LjY3IDE3LjQ1MyAxLjUwNyAxNC41N2ExLjY2NSAxLjY2NSAwIDAgMSAwLTIuNDYzbDIuMi0yYTEuNjY1IDEuNjY1IDAgMCAxIDIuMTMtLjA5N2w2Ljg2MyA1LjIwOUwyOC40NTIuODQ0YTIuNDg4IDIuNDg4IDAgMCAxIDEuODQxLS43MjljLjM1MS4wMDkuNjk5LjA5MSAxLjAxOS4yNDVsOC4yMzYgMy45NjFhMi41IDIuNSAwIDAgMSAxLjQxNSAyLjI1M3YuMDk5LS4wNDVWMzMuMzd2LS4wNDUuMDk1YTIuNTAxIDIuNTAxIDAgMCAxLTEuNDE2IDIuMjU3bC04LjIzNSAzLjk2MWEyLjQ5MiAyLjQ5MiAwIDAgMS0xLjA3Ny4yNDZabS43MTYtMjguOTQ3LTExLjk0OCA5LjA2MiAxMS45NTIgOS4wNjUtLjAwNC0xOC4xMjdaIi8+PC9zdmc+)](https://vscode.stainless.com/mcp/%7B%22name%22%3A%22dodopayments-mcp%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fdodo-payments.stlmcp.com%22%2C%22headers%22%3A%7B%22x-dodo-payments-api-key%22%3A%22My%20Bearer%20Token%22%7D%7D)
 
 > Note: You may need to set environment variables in your MCP client.
 
@@ -26,7 +26,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "dodopayments", "~> 2.0.0"
+gem "dodopayments", "~> 2.1.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/dodopayments/models/discount.rb

@@ -38,6 +38,13 @@ module Dodopayments
       #   @return [String]
       required :discount_id, String
 
+      # @!attribute preserve_on_plan_change
+      #   Whether this discount should be preserved when a subscription changes plans.
+      #   Default: false (discount is removed on plan change)
+      #
+      #   @return [Boolean]
+      required :preserve_on_plan_change, Dodopayments::Internal::Type::Boolean
+
       # @!attribute restricted_to
       #   List of product IDs to which this discount is restricted.
       #
@@ -82,7 +89,7 @@ module Dodopayments
       #   @return [Integer, nil]
       optional :usage_limit, Integer, nil?: true
 
-      # @!method initialize(amount:, business_id:, code:, created_at:, discount_id:, restricted_to:, times_used:, type:, expires_at: nil, name: nil, subscription_cycles: nil, usage_limit: nil)
+      # @!method initialize(amount:, business_id:, code:, created_at:, discount_id:, preserve_on_plan_change:, restricted_to:, times_used:, type:, expires_at: nil, name: nil, subscription_cycles: nil, usage_limit: nil)
       #   Some parameter documentations has been truncated, see
       #   {Dodopayments::Models::Discount} for more details.
       #
@@ -96,6 +103,8 @@ module Dodopayments
       #
       #   @param discount_id [String] The unique discount ID
       #
+      #   @param preserve_on_plan_change [Boolean] Whether this discount should be preserved when a subscription changes plans.
+      #
       #   @param restricted_to [Array<String>] List of product IDs to which this discount is restricted.
       #
       #   @param times_used [Integer] How many times this discount has been used.

data/lib/dodopayments/models/discount_create_params.rb

@@ -46,6 +46,13 @@ module Dodopayments
       #   @return [String, nil]
       optional :name, String, nil?: true
 
+      # @!attribute preserve_on_plan_change
+      #   Whether this discount should be preserved when a subscription changes plans.
+      #   Default: false (discount is removed on plan change)
+      #
+      #   @return [Boolean, nil]
+      optional :preserve_on_plan_change, Dodopayments::Internal::Type::Boolean
+
       # @!attribute restricted_to
       #   List of product IDs to restrict usage (if any).
       #
@@ -66,7 +73,7 @@ module Dodopayments
       #   @return [Integer, nil]
       optional :usage_limit, Integer, nil?: true
 
-      # @!method initialize(amount:, type:, code: nil, expires_at: nil, name: nil, restricted_to: nil, subscription_cycles: nil, usage_limit: nil, request_options: {})
+      # @!method initialize(amount:, type:, code: nil, expires_at: nil, name: nil, preserve_on_plan_change: nil, restricted_to: nil, subscription_cycles: nil, usage_limit: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Dodopayments::Models::DiscountCreateParams} for more details.
       #
@@ -80,6 +87,8 @@ module Dodopayments
       #
       #   @param name [String, nil]
       #
+      #   @param preserve_on_plan_change [Boolean] Whether this discount should be preserved when a subscription changes plans.
+      #
       #   @param restricted_to [Array<String>, nil] List of product IDs to restrict usage (if any).
       #
       #   @param subscription_cycles [Integer, nil] Number of subscription billing cycles this discount is valid for.

data/lib/dodopayments/models/discount_update_params.rb

@@ -35,6 +35,13 @@ module Dodopayments
       #   @return [String, nil]
       optional :name, String, nil?: true
 
+      # @!attribute preserve_on_plan_change
+      #   Whether this discount should be preserved when a subscription changes plans. If
+      #   not provided, the existing value is kept.
+      #
+      #   @return [Boolean, nil]
+      optional :preserve_on_plan_change, Dodopayments::Internal::Type::Boolean, nil?: true
+
       # @!attribute restricted_to
       #   If present, replaces all restricted product IDs with this new set. To remove all
       #   restrictions, send empty array
@@ -61,7 +68,7 @@ module Dodopayments
       #   @return [Integer, nil]
       optional :usage_limit, Integer, nil?: true
 
-      # @!method initialize(amount: nil, code: nil, expires_at: nil, name: nil, restricted_to: nil, subscription_cycles: nil, type: nil, usage_limit: nil, request_options: {})
+      # @!method initialize(amount: nil, code: nil, expires_at: nil, name: nil, preserve_on_plan_change: nil, restricted_to: nil, subscription_cycles: nil, type: nil, usage_limit: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Dodopayments::Models::DiscountUpdateParams} for more details.
       #
@@ -73,6 +80,8 @@ module Dodopayments
       #
       #   @param name [String, nil]
       #
+      #   @param preserve_on_plan_change [Boolean, nil] Whether this discount should be preserved when a subscription changes plans.
+      #
       #   @param restricted_to [Array<String>, nil] If present, replaces all restricted product IDs with this new set.
       #
       #   @param subscription_cycles [Integer, nil] Number of subscription billing cycles this discount is valid for.

data/lib/dodopayments/models/update_subscription_plan_req.rb

@@ -29,6 +29,15 @@ module Dodopayments
       #   @return [Array<Dodopayments::Models::AttachAddon>, nil]
       optional :addons, -> { Dodopayments::Internal::Type::ArrayOf[Dodopayments::AttachAddon] }, nil?: true
 
+      # @!attribute discount_code
+      #   Optional discount code to apply to the new plan. If provided, validates and
+      #   applies the discount to the plan change. If not provided and the subscription
+      #   has an existing discount with `preserve_on_plan_change=true`, the existing
+      #   discount will be preserved (if applicable to the new product).
+      #
+      #   @return [String, nil]
+      optional :discount_code, String, nil?: true
+
       # @!attribute metadata
       #   Metadata for the payment. If not passed, the metadata of the subscription will
       #   be taken
@@ -50,7 +59,7 @@ module Dodopayments
                enum: -> { Dodopayments::UpdateSubscriptionPlanReq::OnPaymentFailure },
                nil?: true
 
-      # @!method initialize(product_id:, proration_billing_mode:, quantity:, addons: nil, metadata: nil, on_payment_failure: nil)
+      # @!method initialize(product_id:, proration_billing_mode:, quantity:, addons: nil, discount_code: nil, metadata: nil, on_payment_failure: nil)
       #   Some parameter documentations has been truncated, see
       #   {Dodopayments::Models::UpdateSubscriptionPlanReq} for more details.
       #
@@ -62,6 +71,8 @@ module Dodopayments
       #
       #   @param addons [Array<Dodopayments::Models::AttachAddon>, nil] Addons for the new plan.
       #
+      #   @param discount_code [String, nil] Optional discount code to apply to the new plan.
+      #
       #   @param metadata [Hash{Symbol=>String}, 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.

data/lib/dodopayments/resources/discounts.rb

@@ -9,7 +9,7 @@ module Dodopayments
       # POST /discounts If `code` is omitted or empty, a random 16-char uppercase code
       # is generated.
       #
-      # @overload create(amount:, type:, code: nil, expires_at: nil, name: nil, restricted_to: nil, subscription_cycles: nil, usage_limit: nil, request_options: {})
+      # @overload create(amount:, type:, code: nil, expires_at: nil, name: nil, preserve_on_plan_change: nil, restricted_to: nil, subscription_cycles: nil, usage_limit: nil, request_options: {})
       #
       # @param amount [Integer] The discount amount.
       #
@@ -21,6 +21,8 @@ module Dodopayments
       #
       # @param name [String, nil]
       #
+      # @param preserve_on_plan_change [Boolean] Whether this discount should be preserved when a subscription changes plans.
+      #
       # @param restricted_to [Array<String>, nil] List of product IDs to restrict usage (if any).
       #
       # @param subscription_cycles [Integer, nil] Number of subscription billing cycles this discount is valid for.
@@ -68,7 +70,7 @@ module Dodopayments
       #
       # PATCH /discounts/{discount_id}
       #
-      # @overload update(discount_id, amount: nil, code: nil, expires_at: nil, name: nil, restricted_to: nil, subscription_cycles: nil, type: nil, usage_limit: nil, request_options: {})
+      # @overload update(discount_id, amount: nil, code: nil, expires_at: nil, name: nil, preserve_on_plan_change: nil, restricted_to: nil, subscription_cycles: nil, type: nil, usage_limit: nil, request_options: {})
       #
       # @param discount_id [String] Discount Id
       #
@@ -80,6 +82,8 @@ module Dodopayments
       #
       # @param name [String, nil]
       #
+      # @param preserve_on_plan_change [Boolean, nil] Whether this discount should be preserved when a subscription changes plans.
+      #
       # @param restricted_to [Array<String>, nil] If present, replaces all restricted product IDs with this new set.
       #
       # @param subscription_cycles [Integer, nil] Number of subscription billing cycles this discount is valid for.

data/lib/dodopayments/resources/subscriptions.rb

@@ -161,7 +161,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:, addons: nil, metadata: nil, on_payment_failure: nil, request_options: {})
+      # @overload change_plan(subscription_id, product_id:, proration_billing_mode:, quantity:, addons: nil, discount_code: nil, metadata: nil, on_payment_failure: nil, request_options: {})
       #
       # @param subscription_id [String] Subscription Id
       #
@@ -173,6 +173,8 @@ module Dodopayments
       #
       # @param addons [Array<Dodopayments::Models::AttachAddon>, nil] Addons for the new plan.
       #
+      # @param discount_code [String, nil] Optional discount code to apply to the new plan.
+      #
       # @param metadata [Hash{Symbol=>String}, 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.
@@ -231,7 +233,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:, addons: nil, metadata: nil, on_payment_failure: nil, request_options: {})
+      # @overload preview_change_plan(subscription_id, product_id:, proration_billing_mode:, quantity:, addons: nil, discount_code: nil, metadata: nil, on_payment_failure: nil, request_options: {})
       #
       # @param subscription_id [String] Subscription Id
       #
@@ -243,6 +245,8 @@ module Dodopayments
       #
       # @param addons [Array<Dodopayments::Models::AttachAddon>, nil] Addons for the new plan.
       #
+      # @param discount_code [String, nil] Optional discount code to apply to the new plan.
+      #
       # @param metadata [Hash{Symbol=>String}, 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.

data/lib/dodopayments/version.rb

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

data/rbi/dodopayments/models/discount.rbi

@@ -32,6 +32,11 @@ module Dodopayments
       sig { returns(String) }
       attr_accessor :discount_id
 
+      # Whether this discount should be preserved when a subscription changes plans.
+      # Default: false (discount is removed on plan change)
+      sig { returns(T::Boolean) }
+      attr_accessor :preserve_on_plan_change
+
       # List of product IDs to which this discount is restricted.
       sig { returns(T::Array[String]) }
       attr_accessor :restricted_to
@@ -69,6 +74,7 @@ module Dodopayments
           code: String,
           created_at: Time,
           discount_id: String,
+          preserve_on_plan_change: T::Boolean,
           restricted_to: T::Array[String],
           times_used: Integer,
           type: Dodopayments::DiscountType::OrSymbol,
@@ -93,6 +99,9 @@ module Dodopayments
         created_at:,
         # The unique discount ID
         discount_id:,
+        # Whether this discount should be preserved when a subscription changes plans.
+        # Default: false (discount is removed on plan change)
+        preserve_on_plan_change:,
         # List of product IDs to which this discount is restricted.
         restricted_to:,
         # How many times this discount has been used.
@@ -120,6 +129,7 @@ module Dodopayments
             code: String,
             created_at: Time,
             discount_id: String,
+            preserve_on_plan_change: T::Boolean,
             restricted_to: T::Array[String],
             times_used: Integer,
             type: Dodopayments::DiscountType::TaggedSymbol,

data/rbi/dodopayments/models/discount_create_params.rbi

@@ -43,6 +43,14 @@ module Dodopayments
       sig { returns(T.nilable(String)) }
       attr_accessor :name
 
+      # Whether this discount should be preserved when a subscription changes plans.
+      # Default: false (discount is removed on plan change)
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :preserve_on_plan_change
+
+      sig { params(preserve_on_plan_change: T::Boolean).void }
+      attr_writer :preserve_on_plan_change
+
       # List of product IDs to restrict usage (if any).
       sig { returns(T.nilable(T::Array[String])) }
       attr_accessor :restricted_to
@@ -64,6 +72,7 @@ module Dodopayments
           code: T.nilable(String),
           expires_at: T.nilable(Time),
           name: T.nilable(String),
+          preserve_on_plan_change: T::Boolean,
           restricted_to: T.nilable(T::Array[String]),
           subscription_cycles: T.nilable(Integer),
           usage_limit: T.nilable(Integer),
@@ -90,6 +99,9 @@ module Dodopayments
         # When the discount expires, if ever.
         expires_at: nil,
         name: nil,
+        # Whether this discount should be preserved when a subscription changes plans.
+        # Default: false (discount is removed on plan change)
+        preserve_on_plan_change: nil,
         # List of product IDs to restrict usage (if any).
         restricted_to: nil,
         # Number of subscription billing cycles this discount is valid for. If not
@@ -110,6 +122,7 @@ module Dodopayments
             code: T.nilable(String),
             expires_at: T.nilable(Time),
             name: T.nilable(String),
+            preserve_on_plan_change: T::Boolean,
             restricted_to: T.nilable(T::Array[String]),
             subscription_cycles: T.nilable(Integer),
             usage_limit: T.nilable(Integer),

data/rbi/dodopayments/models/discount_update_params.rbi

@@ -34,6 +34,11 @@ module Dodopayments
       sig { returns(T.nilable(String)) }
       attr_accessor :name
 
+      # Whether this discount should be preserved when a subscription changes plans. If
+      # not provided, the existing value is kept.
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_accessor :preserve_on_plan_change
+
       # If present, replaces all restricted product IDs with this new set. To remove all
       # restrictions, send empty array
       sig { returns(T.nilable(T::Array[String])) }
@@ -58,6 +63,7 @@ module Dodopayments
           code: T.nilable(String),
           expires_at: T.nilable(Time),
           name: T.nilable(String),
+          preserve_on_plan_change: T.nilable(T::Boolean),
           restricted_to: T.nilable(T::Array[String]),
           subscription_cycles: T.nilable(Integer),
           type: T.nilable(Dodopayments::DiscountType::OrSymbol),
@@ -78,6 +84,9 @@ module Dodopayments
         code: nil,
         expires_at: nil,
         name: nil,
+        # Whether this discount should be preserved when a subscription changes plans. If
+        # not provided, the existing value is kept.
+        preserve_on_plan_change: nil,
         # If present, replaces all restricted product IDs with this new set. To remove all
         # restrictions, send empty array
         restricted_to: nil,
@@ -99,6 +108,7 @@ module Dodopayments
             code: T.nilable(String),
             expires_at: T.nilable(Time),
             name: T.nilable(String),
+            preserve_on_plan_change: T.nilable(T::Boolean),
             restricted_to: T.nilable(T::Array[String]),
             subscription_cycles: T.nilable(Integer),
             type: T.nilable(Dodopayments::DiscountType::OrSymbol),

data/rbi/dodopayments/models/update_subscription_plan_req.rbi

@@ -32,6 +32,13 @@ module Dodopayments
       sig { returns(T.nilable(T::Array[Dodopayments::AttachAddon])) }
       attr_accessor :addons
 
+      # Optional discount code to apply to the new plan. If provided, validates and
+      # applies the discount to the plan change. If not provided and the subscription
+      # has an existing discount with `preserve_on_plan_change=true`, the existing
+      # discount will be preserved (if applicable to the new product).
+      sig { returns(T.nilable(String)) }
+      attr_accessor :discount_code
+
       # Metadata for the payment. If not passed, the metadata of the subscription will
       # be taken
       sig { returns(T.nilable(T::Hash[Symbol, String])) }
@@ -60,6 +67,7 @@ module Dodopayments
             Dodopayments::UpdateSubscriptionPlanReq::ProrationBillingMode::OrSymbol,
           quantity: Integer,
           addons: T.nilable(T::Array[Dodopayments::AttachAddon::OrHash]),
+          discount_code: T.nilable(String),
           metadata: T.nilable(T::Hash[Symbol, String]),
           on_payment_failure:
             T.nilable(
@@ -77,6 +85,11 @@ module Dodopayments
         # Addons for the new plan. Note : Leaving this empty would remove any existing
         # addons
         addons: nil,
+        # Optional discount code to apply to the new plan. If provided, validates and
+        # applies the discount to the plan change. If not provided and the subscription
+        # has an existing discount with `preserve_on_plan_change=true`, the existing
+        # discount will be preserved (if applicable to the new product).
+        discount_code: nil,
         # Metadata for the payment. If not passed, the metadata of the subscription will
         # be taken
         metadata: nil,
@@ -99,6 +112,7 @@ module Dodopayments
               Dodopayments::UpdateSubscriptionPlanReq::ProrationBillingMode::OrSymbol,
             quantity: Integer,
             addons: T.nilable(T::Array[Dodopayments::AttachAddon]),
+            discount_code: T.nilable(String),
             metadata: T.nilable(T::Hash[Symbol, String]),
             on_payment_failure:
               T.nilable(

data/rbi/dodopayments/resources/discounts.rbi

@@ -12,6 +12,7 @@ module Dodopayments
           code: T.nilable(String),
           expires_at: T.nilable(Time),
           name: T.nilable(String),
+          preserve_on_plan_change: T::Boolean,
           restricted_to: T.nilable(T::Array[String]),
           subscription_cycles: T.nilable(Integer),
           usage_limit: T.nilable(Integer),
@@ -38,6 +39,9 @@ module Dodopayments
         # When the discount expires, if ever.
         expires_at: nil,
         name: nil,
+        # Whether this discount should be preserved when a subscription changes plans.
+        # Default: false (discount is removed on plan change)
+        preserve_on_plan_change: nil,
         # List of product IDs to restrict usage (if any).
         restricted_to: nil,
         # Number of subscription billing cycles this discount is valid for. If not
@@ -72,6 +76,7 @@ module Dodopayments
           code: T.nilable(String),
           expires_at: T.nilable(Time),
           name: T.nilable(String),
+          preserve_on_plan_change: T.nilable(T::Boolean),
           restricted_to: T.nilable(T::Array[String]),
           subscription_cycles: T.nilable(Integer),
           type: T.nilable(Dodopayments::DiscountType::OrSymbol),
@@ -94,6 +99,9 @@ module Dodopayments
         code: nil,
         expires_at: nil,
         name: nil,
+        # Whether this discount should be preserved when a subscription changes plans. If
+        # not provided, the existing value is kept.
+        preserve_on_plan_change: nil,
         # If present, replaces all restricted product IDs with this new set. To remove all
         # restrictions, send empty array
         restricted_to: nil,

data/rbi/dodopayments/resources/subscriptions.rbi

@@ -194,6 +194,7 @@ module Dodopayments
             Dodopayments::UpdateSubscriptionPlanReq::ProrationBillingMode::OrSymbol,
           quantity: Integer,
           addons: T.nilable(T::Array[Dodopayments::AttachAddon::OrHash]),
+          discount_code: T.nilable(String),
           metadata: T.nilable(T::Hash[Symbol, String]),
           on_payment_failure:
             T.nilable(
@@ -214,6 +215,11 @@ module Dodopayments
         # Addons for the new plan. Note : Leaving this empty would remove any existing
         # addons
         addons: nil,
+        # Optional discount code to apply to the new plan. If provided, validates and
+        # applies the discount to the plan change. If not provided and the subscription
+        # has an existing discount with `preserve_on_plan_change=true`, the existing
+        # discount will be preserved (if applicable to the new product).
+        discount_code: nil,
         # Metadata for the payment. If not passed, the metadata of the subscription will
         # be taken
         metadata: nil,
@@ -277,6 +283,7 @@ module Dodopayments
             Dodopayments::UpdateSubscriptionPlanReq::ProrationBillingMode::OrSymbol,
           quantity: Integer,
           addons: T.nilable(T::Array[Dodopayments::AttachAddon::OrHash]),
+          discount_code: T.nilable(String),
           metadata: T.nilable(T::Hash[Symbol, String]),
           on_payment_failure:
             T.nilable(
@@ -297,6 +304,11 @@ module Dodopayments
         # Addons for the new plan. Note : Leaving this empty would remove any existing
         # addons
         addons: nil,
+        # Optional discount code to apply to the new plan. If provided, validates and
+        # applies the discount to the plan change. If not provided and the subscription
+        # has an existing discount with `preserve_on_plan_change=true`, the existing
+        # discount will be preserved (if applicable to the new product).
+        discount_code: nil,
         # Metadata for the payment. If not passed, the metadata of the subscription will
         # be taken
         metadata: nil,

data/sig/dodopayments/models/discount.rbs

@@ -7,6 +7,7 @@ module Dodopayments
         code: String,
         created_at: Time,
         discount_id: String,
+        preserve_on_plan_change: bool,
         restricted_to: ::Array[String],
         times_used: Integer,
         type: Dodopayments::Models::discount_type,
@@ -27,6 +28,8 @@ module Dodopayments
 
       attr_accessor discount_id: String
 
+      attr_accessor preserve_on_plan_change: bool
+
       attr_accessor restricted_to: ::Array[String]
 
       attr_accessor times_used: Integer
@@ -47,6 +50,7 @@ module Dodopayments
         code: String,
         created_at: Time,
         discount_id: String,
+        preserve_on_plan_change: bool,
         restricted_to: ::Array[String],
         times_used: Integer,
         type: Dodopayments::Models::discount_type,
@@ -62,6 +66,7 @@ module Dodopayments
         code: String,
         created_at: Time,
         discount_id: String,
+        preserve_on_plan_change: bool,
         restricted_to: ::Array[String],
         times_used: Integer,
         type: Dodopayments::Models::discount_type,

data/sig/dodopayments/models/discount_create_params.rbs

@@ -7,6 +7,7 @@ module Dodopayments
         code: String?,
         expires_at: Time?,
         name: String?,
+        preserve_on_plan_change: bool,
         restricted_to: ::Array[String]?,
         subscription_cycles: Integer?,
         usage_limit: Integer?
@@ -27,6 +28,10 @@ module Dodopayments
 
       attr_accessor name: String?
 
+      attr_reader preserve_on_plan_change: bool?
+
+      def preserve_on_plan_change=: (bool) -> bool
+
       attr_accessor restricted_to: ::Array[String]?
 
       attr_accessor subscription_cycles: Integer?
@@ -39,6 +44,7 @@ module Dodopayments
         ?code: String?,
         ?expires_at: Time?,
         ?name: String?,
+        ?preserve_on_plan_change: bool,
         ?restricted_to: ::Array[String]?,
         ?subscription_cycles: Integer?,
         ?usage_limit: Integer?,
@@ -51,6 +57,7 @@ module Dodopayments
         code: String?,
         expires_at: Time?,
         name: String?,
+        preserve_on_plan_change: bool,
         restricted_to: ::Array[String]?,
         subscription_cycles: Integer?,
         usage_limit: Integer?,

data/sig/dodopayments/models/discount_update_params.rbs

@@ -6,6 +6,7 @@ module Dodopayments
         code: String?,
         expires_at: Time?,
         name: String?,
+        preserve_on_plan_change: bool?,
         restricted_to: ::Array[String]?,
         subscription_cycles: Integer?,
         type: Dodopayments::Models::discount_type?,
@@ -25,6 +26,8 @@ module Dodopayments
 
       attr_accessor name: String?
 
+      attr_accessor preserve_on_plan_change: bool?
+
       attr_accessor restricted_to: ::Array[String]?
 
       attr_accessor subscription_cycles: Integer?
@@ -38,6 +41,7 @@ module Dodopayments
         ?code: String?,
         ?expires_at: Time?,
         ?name: String?,
+        ?preserve_on_plan_change: bool?,
         ?restricted_to: ::Array[String]?,
         ?subscription_cycles: Integer?,
         ?type: Dodopayments::Models::discount_type?,
@@ -50,6 +54,7 @@ module Dodopayments
         code: String?,
         expires_at: Time?,
         name: String?,
+        preserve_on_plan_change: bool?,
         restricted_to: ::Array[String]?,
         subscription_cycles: Integer?,
         type: Dodopayments::Models::discount_type?,

data/sig/dodopayments/models/update_subscription_plan_req.rbs

@@ -6,6 +6,7 @@ module Dodopayments
         proration_billing_mode: Dodopayments::Models::UpdateSubscriptionPlanReq::proration_billing_mode,
         quantity: Integer,
         addons: ::Array[Dodopayments::AttachAddon]?,
+        discount_code: String?,
         metadata: ::Hash[Symbol, String]?,
         on_payment_failure: Dodopayments::Models::UpdateSubscriptionPlanReq::on_payment_failure?
       }
@@ -19,6 +20,8 @@ module Dodopayments
 
       attr_accessor addons: ::Array[Dodopayments::AttachAddon]?
 
+      attr_accessor discount_code: String?
+
       attr_accessor metadata: ::Hash[Symbol, String]?
 
       attr_accessor on_payment_failure: Dodopayments::Models::UpdateSubscriptionPlanReq::on_payment_failure?
@@ -28,6 +31,7 @@ module Dodopayments
         proration_billing_mode: Dodopayments::Models::UpdateSubscriptionPlanReq::proration_billing_mode,
         quantity: Integer,
         ?addons: ::Array[Dodopayments::AttachAddon]?,
+        ?discount_code: String?,
         ?metadata: ::Hash[Symbol, String]?,
         ?on_payment_failure: Dodopayments::Models::UpdateSubscriptionPlanReq::on_payment_failure?
       ) -> void
@@ -37,6 +41,7 @@ module Dodopayments
         proration_billing_mode: Dodopayments::Models::UpdateSubscriptionPlanReq::proration_billing_mode,
         quantity: Integer,
         addons: ::Array[Dodopayments::AttachAddon]?,
+        discount_code: String?,
         metadata: ::Hash[Symbol, String]?,
         on_payment_failure: Dodopayments::Models::UpdateSubscriptionPlanReq::on_payment_failure?
       }

data/sig/dodopayments/resources/discounts.rbs

@@ -7,6 +7,7 @@ module Dodopayments
         ?code: String?,
         ?expires_at: Time?,
         ?name: String?,
+        ?preserve_on_plan_change: bool,
         ?restricted_to: ::Array[String]?,
         ?subscription_cycles: Integer?,
         ?usage_limit: Integer?,
@@ -24,6 +25,7 @@ module Dodopayments
         ?code: String?,
         ?expires_at: Time?,
         ?name: String?,
+        ?preserve_on_plan_change: bool?,
         ?restricted_to: ::Array[String]?,
         ?subscription_cycles: Integer?,
         ?type: Dodopayments::Models::discount_type?,

data/sig/dodopayments/resources/subscriptions.rbs

@@ -62,6 +62,7 @@ module Dodopayments
         proration_billing_mode: Dodopayments::Models::UpdateSubscriptionPlanReq::proration_billing_mode,
         quantity: Integer,
         ?addons: ::Array[Dodopayments::AttachAddon]?,
+        ?discount_code: String?,
         ?metadata: ::Hash[Symbol, String]?,
         ?on_payment_failure: Dodopayments::Models::UpdateSubscriptionPlanReq::on_payment_failure?,
         ?request_options: Dodopayments::request_opts
@@ -84,6 +85,7 @@ module Dodopayments
         proration_billing_mode: Dodopayments::Models::UpdateSubscriptionPlanReq::proration_billing_mode,
         quantity: Integer,
         ?addons: ::Array[Dodopayments::AttachAddon]?,
+        ?discount_code: String?,
         ?metadata: ::Hash[Symbol, String]?,
         ?on_payment_failure: Dodopayments::Models::UpdateSubscriptionPlanReq::on_payment_failure?,
         ?request_options: Dodopayments::request_opts

metadata

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