dodopayments 2.9.1 → 2.10.0

data/rbi/dodopayments/models/subscription.rbi

@@ -134,14 +134,18 @@ module Dodopayments
       sig { returns(T.nilable(T::Array[Dodopayments::CustomFieldResponse])) }
       attr_accessor :custom_field_responses
 
-      # Number of remaining discount cycles if discount is applied
+      # DEPRECATED: Use discounts[].cycles_remaining instead.
       sig { returns(T.nilable(Integer)) }
       attr_accessor :discount_cycles_remaining
 
-      # The discount id if discount is applied
+      # DEPRECATED: Use discounts instead. Returns the first discount's ID if present.
       sig { returns(T.nilable(String)) }
       attr_accessor :discount_id
 
+      # All stacked discounts applied, ordered by position
+      sig { returns(T.nilable(T::Array[Dodopayments::Subscription::Discount])) }
+      attr_accessor :discounts
+
       # Timestamp when the subscription will expire
       sig { returns(T.nilable(Time)) }
       attr_accessor :expires_at
@@ -202,6 +206,8 @@ module Dodopayments
             T.nilable(T::Array[Dodopayments::CustomFieldResponse::OrHash]),
           discount_cycles_remaining: T.nilable(Integer),
           discount_id: T.nilable(String),
+          discounts:
+            T.nilable(T::Array[Dodopayments::Subscription::Discount::OrHash]),
           expires_at: T.nilable(Time),
           payment_method_id: T.nilable(String),
           scheduled_change:
@@ -268,10 +274,12 @@ module Dodopayments
         cancelled_at: nil,
         # Customer's responses to custom fields collected during checkout
         custom_field_responses: nil,
-        # Number of remaining discount cycles if discount is applied
+        # DEPRECATED: Use discounts[].cycles_remaining instead.
         discount_cycles_remaining: nil,
-        # The discount id if discount is applied
+        # DEPRECATED: Use discounts instead. Returns the first discount's ID if present.
         discount_id: nil,
+        # All stacked discounts applied, ordered by position
+        discounts: nil,
         # Timestamp when the subscription will expire
         expires_at: nil,
         # Saved payment method id used for recurring charges
@@ -322,6 +330,8 @@ module Dodopayments
               T.nilable(T::Array[Dodopayments::CustomFieldResponse]),
             discount_cycles_remaining: T.nilable(Integer),
             discount_id: T.nilable(String),
+            discounts:
+              T.nilable(T::Array[Dodopayments::Subscription::Discount]),
             expires_at: T.nilable(Time),
             payment_method_id: T.nilable(String),
             scheduled_change: T.nilable(Dodopayments::ScheduledPlanChange),
@@ -331,6 +341,165 @@ module Dodopayments
       end
       def to_hash
       end
+
+      class Discount < Dodopayments::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Dodopayments::Subscription::Discount,
+              Dodopayments::Internal::AnyHash
+            )
+          end
+
+        # The discount amount (basis points for percentage, USD cents for flat)
+        sig { returns(Integer) }
+        attr_accessor :amount
+
+        # The business this discount belongs to
+        sig { returns(String) }
+        attr_accessor :business_id
+
+        # The discount code
+        sig { returns(String) }
+        attr_accessor :code
+
+        # Timestamp when the discount was created
+        sig { returns(Time) }
+        attr_accessor :created_at
+
+        # The unique discount ID
+        sig { returns(String) }
+        attr_accessor :discount_id
+
+        # Additional metadata
+        sig { returns(T::Hash[Symbol, String]) }
+        attr_accessor :metadata
+
+        # Position of this discount in the stack (0-based)
+        sig { returns(Integer) }
+        attr_accessor :position
+
+        # Whether this discount should be preserved when a subscription changes plans
+        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
+
+        # How many times this discount has been used
+        sig { returns(Integer) }
+        attr_accessor :times_used
+
+        # The type of discount
+        sig { returns(Dodopayments::DiscountType::TaggedSymbol) }
+        attr_accessor :type
+
+        # Remaining billing cycles for this discount on this subscription (None for
+        # one-time payments)
+        sig { returns(T.nilable(Integer)) }
+        attr_accessor :cycles_remaining
+
+        # Optional date/time after which discount is expired
+        sig { returns(T.nilable(Time)) }
+        attr_accessor :expires_at
+
+        # Name for the Discount
+        sig { returns(T.nilable(String)) }
+        attr_accessor :name
+
+        # Number of subscription billing cycles this discount is valid for
+        sig { returns(T.nilable(Integer)) }
+        attr_accessor :subscription_cycles
+
+        # Usage limit for this discount, if any
+        sig { returns(T.nilable(Integer)) }
+        attr_accessor :usage_limit
+
+        # Response struct for a discount with its position in a stack and optional
+        # cycle-tracking information (for subscriptions).
+        sig do
+          params(
+            amount: Integer,
+            business_id: String,
+            code: String,
+            created_at: Time,
+            discount_id: String,
+            metadata: T::Hash[Symbol, String],
+            position: Integer,
+            preserve_on_plan_change: T::Boolean,
+            restricted_to: T::Array[String],
+            times_used: Integer,
+            type: Dodopayments::DiscountType::OrSymbol,
+            cycles_remaining: T.nilable(Integer),
+            expires_at: T.nilable(Time),
+            name: T.nilable(String),
+            subscription_cycles: T.nilable(Integer),
+            usage_limit: T.nilable(Integer)
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # The discount amount (basis points for percentage, USD cents for flat)
+          amount:,
+          # The business this discount belongs to
+          business_id:,
+          # The discount code
+          code:,
+          # Timestamp when the discount was created
+          created_at:,
+          # The unique discount ID
+          discount_id:,
+          # Additional metadata
+          metadata:,
+          # Position of this discount in the stack (0-based)
+          position:,
+          # Whether this discount should be preserved when a subscription changes plans
+          preserve_on_plan_change:,
+          # List of product IDs to which this discount is restricted
+          restricted_to:,
+          # How many times this discount has been used
+          times_used:,
+          # The type of discount
+          type:,
+          # Remaining billing cycles for this discount on this subscription (None for
+          # one-time payments)
+          cycles_remaining: nil,
+          # Optional date/time after which discount is expired
+          expires_at: nil,
+          # Name for the Discount
+          name: nil,
+          # Number of subscription billing cycles this discount is valid for
+          subscription_cycles: nil,
+          # Usage limit for this discount, if any
+          usage_limit: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              amount: Integer,
+              business_id: String,
+              code: String,
+              created_at: Time,
+              discount_id: String,
+              metadata: T::Hash[Symbol, String],
+              position: Integer,
+              preserve_on_plan_change: T::Boolean,
+              restricted_to: T::Array[String],
+              times_used: Integer,
+              type: Dodopayments::DiscountType::TaggedSymbol,
+              cycles_remaining: T.nilable(Integer),
+              expires_at: T.nilable(Time),
+              name: T.nilable(String),
+              subscription_cycles: T.nilable(Integer),
+              usage_limit: T.nilable(Integer)
+            }
+          )
+        end
+        def to_hash
+        end
+      end
     end
   end
 end

data/rbi/dodopayments/models/subscription_active_webhook_event.rbi

@@ -27,11 +27,7 @@ module Dodopayments
       attr_accessor :timestamp
 
       # The event type
-      sig do
-        returns(
-          Dodopayments::SubscriptionActiveWebhookEvent::Type::TaggedSymbol
-        )
-      end
+      sig { returns(Symbol) }
       attr_accessor :type
 
       sig do
@@ -39,7 +35,7 @@ module Dodopayments
           business_id: String,
           data: Dodopayments::Subscription::OrHash,
           timestamp: Time,
-          type: Dodopayments::SubscriptionActiveWebhookEvent::Type::OrSymbol
+          type: Symbol
         ).returns(T.attached_class)
       end
       def self.new(
@@ -50,7 +46,7 @@ module Dodopayments
         # The timestamp of when the event occurred
         timestamp:,
         # The event type
-        type:
+        type: :"subscription.active"
       )
       end
 
@@ -60,40 +56,12 @@ module Dodopayments
             business_id: String,
             data: Dodopayments::Subscription,
             timestamp: Time,
-            type:
-              Dodopayments::SubscriptionActiveWebhookEvent::Type::TaggedSymbol
+            type: Symbol
           }
         )
       end
       def to_hash
       end
-
-      # The event type
-      module Type
-        extend Dodopayments::Internal::Type::Enum
-
-        TaggedSymbol =
-          T.type_alias do
-            T.all(Symbol, Dodopayments::SubscriptionActiveWebhookEvent::Type)
-          end
-        OrSymbol = T.type_alias { T.any(Symbol, String) }
-
-        SUBSCRIPTION_ACTIVE =
-          T.let(
-            :"subscription.active",
-            Dodopayments::SubscriptionActiveWebhookEvent::Type::TaggedSymbol
-          )
-
-        sig do
-          override.returns(
-            T::Array[
-              Dodopayments::SubscriptionActiveWebhookEvent::Type::TaggedSymbol
-            ]
-          )
-        end
-        def self.values
-        end
-      end
     end
   end
 end

data/rbi/dodopayments/models/subscription_cancelled_webhook_event.rbi

@@ -27,11 +27,7 @@ module Dodopayments
       attr_accessor :timestamp
 
       # The event type
-      sig do
-        returns(
-          Dodopayments::SubscriptionCancelledWebhookEvent::Type::TaggedSymbol
-        )
-      end
+      sig { returns(Symbol) }
       attr_accessor :type
 
       sig do
@@ -39,7 +35,7 @@ module Dodopayments
           business_id: String,
           data: Dodopayments::Subscription::OrHash,
           timestamp: Time,
-          type: Dodopayments::SubscriptionCancelledWebhookEvent::Type::OrSymbol
+          type: Symbol
         ).returns(T.attached_class)
       end
       def self.new(
@@ -50,7 +46,7 @@ module Dodopayments
         # The timestamp of when the event occurred
         timestamp:,
         # The event type
-        type:
+        type: :"subscription.cancelled"
       )
       end
 
@@ -60,40 +56,12 @@ module Dodopayments
             business_id: String,
             data: Dodopayments::Subscription,
             timestamp: Time,
-            type:
-              Dodopayments::SubscriptionCancelledWebhookEvent::Type::TaggedSymbol
+            type: Symbol
           }
         )
       end
       def to_hash
       end
-
-      # The event type
-      module Type
-        extend Dodopayments::Internal::Type::Enum
-
-        TaggedSymbol =
-          T.type_alias do
-            T.all(Symbol, Dodopayments::SubscriptionCancelledWebhookEvent::Type)
-          end
-        OrSymbol = T.type_alias { T.any(Symbol, String) }
-
-        SUBSCRIPTION_CANCELLED =
-          T.let(
-            :"subscription.cancelled",
-            Dodopayments::SubscriptionCancelledWebhookEvent::Type::TaggedSymbol
-          )
-
-        sig do
-          override.returns(
-            T::Array[
-              Dodopayments::SubscriptionCancelledWebhookEvent::Type::TaggedSymbol
-            ]
-          )
-        end
-        def self.values
-        end
-      end
     end
   end
 end

data/rbi/dodopayments/models/subscription_create_params.rbi

@@ -57,10 +57,16 @@ module Dodopayments
       sig { returns(T.nilable(Dodopayments::Currency::OrSymbol)) }
       attr_accessor :billing_currency
 
-      # Discount Code to apply to the subscription
+      # DEPRECATED: Use discount_codes instead. Cannot be used together with
+      # discount_codes.
       sig { returns(T.nilable(String)) }
       attr_accessor :discount_code
 
+      # Stacked discount codes to apply, in order of application. Max 20. Cannot be used
+      # together with discount_code.
+      sig { returns(T.nilable(T::Array[String])) }
+      attr_accessor :discount_codes
+
       # Override merchant default 3DS behaviour for this subscription
       sig { returns(T.nilable(T::Boolean)) }
       attr_accessor :force_3ds
@@ -163,6 +169,7 @@ module Dodopayments
             T.nilable(T::Array[Dodopayments::PaymentMethodTypes::OrSymbol]),
           billing_currency: T.nilable(Dodopayments::Currency::OrSymbol),
           discount_code: T.nilable(String),
+          discount_codes: T.nilable(T::Array[String]),
           force_3ds: T.nilable(T::Boolean),
           mandate_min_amount_inr_paise: T.nilable(Integer),
           metadata: T::Hash[Symbol, String],
@@ -202,8 +209,12 @@ module Dodopayments
         # Fix the currency in which the end customer is billed. If Dodo Payments cannot
         # support that currency for this transaction, it will not proceed
         billing_currency: nil,
-        # Discount Code to apply to the subscription
+        # DEPRECATED: Use discount_codes instead. Cannot be used together with
+        # discount_codes.
         discount_code: nil,
+        # Stacked discount codes to apply, in order of application. Max 20. Cannot be used
+        # together with discount_code.
+        discount_codes: nil,
         # Override merchant default 3DS behaviour for this subscription
         force_3ds: nil,
         # Override the merchant-level mandate floor (in INR paise) for INR e-mandates on
@@ -264,6 +275,7 @@ module Dodopayments
               T.nilable(T::Array[Dodopayments::PaymentMethodTypes::OrSymbol]),
             billing_currency: T.nilable(Dodopayments::Currency::OrSymbol),
             discount_code: T.nilable(String),
+            discount_codes: T.nilable(T::Array[String]),
             force_3ds: T.nilable(T::Boolean),
             mandate_min_amount_inr_paise: T.nilable(Integer),
             metadata: T::Hash[Symbol, String],

data/rbi/dodopayments/models/subscription_create_response.rbi

@@ -46,10 +46,15 @@ module Dodopayments
       sig { returns(T.nilable(String)) }
       attr_accessor :client_secret
 
-      # The discount id if discount is applied
+      # DEPRECATED: Use discount_ids instead. Returns the first discount's ID if
+      # present.
       sig { returns(T.nilable(String)) }
       attr_accessor :discount_id
 
+      # All stacked discount IDs applied, in order of application
+      sig { returns(T.nilable(T::Array[String])) }
+      attr_accessor :discount_ids
+
       # Expiry timestamp of the payment link
       sig { returns(T.nilable(Time)) }
       attr_accessor :expires_on
@@ -80,6 +85,7 @@ module Dodopayments
           subscription_id: String,
           client_secret: T.nilable(String),
           discount_id: T.nilable(String),
+          discount_ids: T.nilable(T::Array[String]),
           expires_on: T.nilable(Time),
           one_time_product_cart:
             T.nilable(
@@ -107,8 +113,11 @@ module Dodopayments
         # Client secret used to load Dodo checkout SDK NOTE : Dodo checkout SDK will be
         # coming soon
         client_secret: nil,
-        # The discount id if discount is applied
+        # DEPRECATED: Use discount_ids instead. Returns the first discount's ID if
+        # present.
         discount_id: nil,
+        # All stacked discount IDs applied, in order of application
+        discount_ids: nil,
         # Expiry timestamp of the payment link
         expires_on: nil,
         # One time products associated with the purchase of subscription
@@ -129,6 +138,7 @@ module Dodopayments
             subscription_id: String,
             client_secret: T.nilable(String),
             discount_id: T.nilable(String),
+            discount_ids: T.nilable(T::Array[String]),
             expires_on: T.nilable(Time),
             one_time_product_cart:
               T.nilable(

data/rbi/dodopayments/models/subscription_expired_webhook_event.rbi

@@ -27,11 +27,7 @@ module Dodopayments
       attr_accessor :timestamp
 
       # The event type
-      sig do
-        returns(
-          Dodopayments::SubscriptionExpiredWebhookEvent::Type::TaggedSymbol
-        )
-      end
+      sig { returns(Symbol) }
       attr_accessor :type
 
       sig do
@@ -39,7 +35,7 @@ module Dodopayments
           business_id: String,
           data: Dodopayments::Subscription::OrHash,
           timestamp: Time,
-          type: Dodopayments::SubscriptionExpiredWebhookEvent::Type::OrSymbol
+          type: Symbol
         ).returns(T.attached_class)
       end
       def self.new(
@@ -50,7 +46,7 @@ module Dodopayments
         # The timestamp of when the event occurred
         timestamp:,
         # The event type
-        type:
+        type: :"subscription.expired"
       )
       end
 
@@ -60,40 +56,12 @@ module Dodopayments
             business_id: String,
             data: Dodopayments::Subscription,
             timestamp: Time,
-            type:
-              Dodopayments::SubscriptionExpiredWebhookEvent::Type::TaggedSymbol
+            type: Symbol
           }
         )
       end
       def to_hash
       end
-
-      # The event type
-      module Type
-        extend Dodopayments::Internal::Type::Enum
-
-        TaggedSymbol =
-          T.type_alias do
-            T.all(Symbol, Dodopayments::SubscriptionExpiredWebhookEvent::Type)
-          end
-        OrSymbol = T.type_alias { T.any(Symbol, String) }
-
-        SUBSCRIPTION_EXPIRED =
-          T.let(
-            :"subscription.expired",
-            Dodopayments::SubscriptionExpiredWebhookEvent::Type::TaggedSymbol
-          )
-
-        sig do
-          override.returns(
-            T::Array[
-              Dodopayments::SubscriptionExpiredWebhookEvent::Type::TaggedSymbol
-            ]
-          )
-        end
-        def self.values
-        end
-      end
     end
   end
 end

data/rbi/dodopayments/models/subscription_failed_webhook_event.rbi

@@ -27,11 +27,7 @@ module Dodopayments
       attr_accessor :timestamp
 
       # The event type
-      sig do
-        returns(
-          Dodopayments::SubscriptionFailedWebhookEvent::Type::TaggedSymbol
-        )
-      end
+      sig { returns(Symbol) }
       attr_accessor :type
 
       sig do
@@ -39,7 +35,7 @@ module Dodopayments
           business_id: String,
           data: Dodopayments::Subscription::OrHash,
           timestamp: Time,
-          type: Dodopayments::SubscriptionFailedWebhookEvent::Type::OrSymbol
+          type: Symbol
         ).returns(T.attached_class)
       end
       def self.new(
@@ -50,7 +46,7 @@ module Dodopayments
         # The timestamp of when the event occurred
         timestamp:,
         # The event type
-        type:
+        type: :"subscription.failed"
       )
       end
 
@@ -60,40 +56,12 @@ module Dodopayments
             business_id: String,
             data: Dodopayments::Subscription,
             timestamp: Time,
-            type:
-              Dodopayments::SubscriptionFailedWebhookEvent::Type::TaggedSymbol
+            type: Symbol
           }
         )
       end
       def to_hash
       end
-
-      # The event type
-      module Type
-        extend Dodopayments::Internal::Type::Enum
-
-        TaggedSymbol =
-          T.type_alias do
-            T.all(Symbol, Dodopayments::SubscriptionFailedWebhookEvent::Type)
-          end
-        OrSymbol = T.type_alias { T.any(Symbol, String) }
-
-        SUBSCRIPTION_FAILED =
-          T.let(
-            :"subscription.failed",
-            Dodopayments::SubscriptionFailedWebhookEvent::Type::TaggedSymbol
-          )
-
-        sig do
-          override.returns(
-            T::Array[
-              Dodopayments::SubscriptionFailedWebhookEvent::Type::TaggedSymbol
-            ]
-          )
-        end
-        def self.values
-        end
-      end
     end
   end
 end