dodopayments 2.9.1 → 2.11.0

data/rbi/dodopayments/models/product_collections/product_collection_group_response.rbi

@@ -0,0 +1,68 @@
+# typed: strong
+
+module Dodopayments
+  module Models
+    ProductCollectionGroupResponse =
+      ProductCollections::ProductCollectionGroupResponse
+
+    module ProductCollections
+      class ProductCollectionGroupResponse < Dodopayments::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Dodopayments::ProductCollections::ProductCollectionGroupResponse,
+              Dodopayments::Internal::AnyHash
+            )
+          end
+
+        sig { returns(String) }
+        attr_accessor :group_id
+
+        sig do
+          returns(
+            T::Array[
+              Dodopayments::ProductCollections::Groups::ProductCollectionProduct
+            ]
+          )
+        end
+        attr_accessor :products
+
+        sig { returns(T::Boolean) }
+        attr_accessor :status
+
+        sig { returns(T.nilable(String)) }
+        attr_accessor :group_name
+
+        sig do
+          params(
+            group_id: String,
+            products:
+              T::Array[
+                Dodopayments::ProductCollections::Groups::ProductCollectionProduct::OrHash
+              ],
+            status: T::Boolean,
+            group_name: T.nilable(String)
+          ).returns(T.attached_class)
+        end
+        def self.new(group_id:, products:, status:, group_name: nil)
+        end
+
+        sig do
+          override.returns(
+            {
+              group_id: String,
+              products:
+                T::Array[
+                  Dodopayments::ProductCollections::Groups::ProductCollectionProduct
+                ],
+              status: T::Boolean,
+              group_name: T.nilable(String)
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/dodopayments/models/product_item_req.rbi

@@ -29,12 +29,27 @@ module Dodopayments
       sig { returns(T.nilable(Integer)) }
       attr_accessor :amount
 
+      # Per-checkout-session overrides for credit entitlements already attached to this
+      # product. Each entry overrides the `credits_amount` granted by the referenced
+      # credit entitlement when this checkout session is fulfilled. The
+      # credit_entitlement_id must already be attached to the product.
+      sig do
+        returns(
+          T.nilable(T::Array[Dodopayments::ProductItemReq::CreditEntitlement])
+        )
+      end
+      attr_accessor :credit_entitlements
+
       sig do
         params(
           product_id: String,
           quantity: Integer,
           addons: T.nilable(T::Array[Dodopayments::AttachAddon::OrHash]),
-          amount: T.nilable(Integer)
+          amount: T.nilable(Integer),
+          credit_entitlements:
+            T.nilable(
+              T::Array[Dodopayments::ProductItemReq::CreditEntitlement::OrHash]
+            )
         ).returns(T.attached_class)
       end
       def self.new(
@@ -50,7 +65,12 @@ module Dodopayments
         #
         # If amount is not set for pay_what_you_want product, customer is allowed to
         # select the amount.
-        amount: nil
+        amount: nil,
+        # Per-checkout-session overrides for credit entitlements already attached to this
+        # product. Each entry overrides the `credits_amount` granted by the referenced
+        # credit entitlement when this checkout session is fulfilled. The
+        # credit_entitlement_id must already be attached to the product.
+        credit_entitlements: nil
       )
       end
 
@@ -60,12 +80,63 @@ module Dodopayments
             product_id: String,
             quantity: Integer,
             addons: T.nilable(T::Array[Dodopayments::AttachAddon]),
-            amount: T.nilable(Integer)
+            amount: T.nilable(Integer),
+            credit_entitlements:
+              T.nilable(
+                T::Array[Dodopayments::ProductItemReq::CreditEntitlement]
+              )
           }
         )
       end
       def to_hash
       end
+
+      class CreditEntitlement < Dodopayments::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Dodopayments::ProductItemReq::CreditEntitlement,
+              Dodopayments::Internal::AnyHash
+            )
+          end
+
+        # ID of the credit entitlement to override. Must already be attached to the
+        # product.
+        sig { returns(String) }
+        attr_accessor :credit_entitlement_id
+
+        # Number of credits to grant for this checkout session, overriding the
+        # product-level `credits_amount` set on the credit entitlement mapping. Must be
+        # greater than zero.
+        sig { returns(String) }
+        attr_accessor :credits_amount
+
+        # Per-checkout-session override for a single credit entitlement attached to a
+        # product.
+        sig do
+          params(credit_entitlement_id: String, credits_amount: String).returns(
+            T.attached_class
+          )
+        end
+        def self.new(
+          # ID of the credit entitlement to override. Must already be attached to the
+          # product.
+          credit_entitlement_id:,
+          # Number of credits to grant for this checkout session, overriding the
+          # product-level `credits_amount` set on the credit entitlement mapping. Must be
+          # greater than zero.
+          credits_amount:
+        )
+        end
+
+        sig do
+          override.returns(
+            { credit_entitlement_id: String, credits_amount: String }
+          )
+        end
+        def to_hash
+        end
+      end
     end
   end
 end

data/rbi/dodopayments/models/refund_failed_webhook_event.rbi

@@ -26,9 +26,7 @@ module Dodopayments
       attr_accessor :timestamp
 
       # The event type
-      sig do
-        returns(Dodopayments::RefundFailedWebhookEvent::Type::TaggedSymbol)
-      end
+      sig { returns(Symbol) }
       attr_accessor :type
 
       sig do
@@ -36,7 +34,7 @@ module Dodopayments
           business_id: String,
           data: Dodopayments::Refund::OrHash,
           timestamp: Time,
-          type: Dodopayments::RefundFailedWebhookEvent::Type::OrSymbol
+          type: Symbol
         ).returns(T.attached_class)
       end
       def self.new(
@@ -46,7 +44,7 @@ module Dodopayments
         # The timestamp of when the event occurred
         timestamp:,
         # The event type
-        type:
+        type: :"refund.failed"
       )
       end
 
@@ -56,37 +54,12 @@ module Dodopayments
             business_id: String,
             data: Dodopayments::Refund,
             timestamp: Time,
-            type: Dodopayments::RefundFailedWebhookEvent::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::RefundFailedWebhookEvent::Type)
-          end
-        OrSymbol = T.type_alias { T.any(Symbol, String) }
-
-        REFUND_FAILED =
-          T.let(
-            :"refund.failed",
-            Dodopayments::RefundFailedWebhookEvent::Type::TaggedSymbol
-          )
-
-        sig do
-          override.returns(
-            T::Array[Dodopayments::RefundFailedWebhookEvent::Type::TaggedSymbol]
-          )
-        end
-        def self.values
-        end
-      end
     end
   end
 end

data/rbi/dodopayments/models/refund_succeeded_webhook_event.rbi

@@ -26,9 +26,7 @@ module Dodopayments
       attr_accessor :timestamp
 
       # The event type
-      sig do
-        returns(Dodopayments::RefundSucceededWebhookEvent::Type::TaggedSymbol)
-      end
+      sig { returns(Symbol) }
       attr_accessor :type
 
       sig do
@@ -36,7 +34,7 @@ module Dodopayments
           business_id: String,
           data: Dodopayments::Refund::OrHash,
           timestamp: Time,
-          type: Dodopayments::RefundSucceededWebhookEvent::Type::OrSymbol
+          type: Symbol
         ).returns(T.attached_class)
       end
       def self.new(
@@ -46,7 +44,7 @@ module Dodopayments
         # The timestamp of when the event occurred
         timestamp:,
         # The event type
-        type:
+        type: :"refund.succeeded"
       )
       end
 
@@ -56,39 +54,12 @@ module Dodopayments
             business_id: String,
             data: Dodopayments::Refund,
             timestamp: Time,
-            type: Dodopayments::RefundSucceededWebhookEvent::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::RefundSucceededWebhookEvent::Type)
-          end
-        OrSymbol = T.type_alias { T.any(Symbol, String) }
-
-        REFUND_SUCCEEDED =
-          T.let(
-            :"refund.succeeded",
-            Dodopayments::RefundSucceededWebhookEvent::Type::TaggedSymbol
-          )
-
-        sig do
-          override.returns(
-            T::Array[
-              Dodopayments::RefundSucceededWebhookEvent::Type::TaggedSymbol
-            ]
-          )
-        end
-        def self.values
-        end
-      end
     end
   end
 end

data/rbi/dodopayments/models/subscription.rbi

@@ -134,14 +134,23 @@ module Dodopayments
       sig { returns(T.nilable(T::Array[Dodopayments::CustomFieldResponse])) }
       attr_accessor :custom_field_responses
 
-      # Number of remaining discount cycles if discount is applied
+      # Business / legal name associated with the tax id (B2B). When set this is used on
+      # the invoice in place of the customer's personal name.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :customer_business_name
+
+      # 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::DiscountDetail])) }
+      attr_accessor :discounts
+
       # Timestamp when the subscription will expire
       sig { returns(T.nilable(Time)) }
       attr_accessor :expires_at
@@ -200,8 +209,10 @@ module Dodopayments
           cancelled_at: T.nilable(Time),
           custom_field_responses:
             T.nilable(T::Array[Dodopayments::CustomFieldResponse::OrHash]),
+          customer_business_name: T.nilable(String),
           discount_cycles_remaining: T.nilable(Integer),
           discount_id: T.nilable(String),
+          discounts: T.nilable(T::Array[Dodopayments::DiscountDetail::OrHash]),
           expires_at: T.nilable(Time),
           payment_method_id: T.nilable(String),
           scheduled_change:
@@ -268,10 +279,15 @@ 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
+        # Business / legal name associated with the tax id (B2B). When set this is used on
+        # the invoice in place of the customer's personal name.
+        customer_business_name: nil,
+        # 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
@@ -320,8 +336,10 @@ module Dodopayments
             cancelled_at: T.nilable(Time),
             custom_field_responses:
               T.nilable(T::Array[Dodopayments::CustomFieldResponse]),
+            customer_business_name: T.nilable(String),
             discount_cycles_remaining: T.nilable(Integer),
             discount_id: T.nilable(String),
+            discounts: T.nilable(T::Array[Dodopayments::DiscountDetail]),
             expires_at: T.nilable(Time),
             payment_method_id: T.nilable(String),
             scheduled_change: T.nilable(Dodopayments::ScheduledPlanChange),

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,22 @@ module Dodopayments
       sig { returns(T.nilable(Dodopayments::Currency::OrSymbol)) }
       attr_accessor :billing_currency
 
-      # Discount Code to apply to the subscription
+      # Optional business / legal name associated with the tax id. When provided
+      # together with a valid tax id for a B2B purchase, this name is rendered on the
+      # invoice instead of the customer's personal name.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :customer_business_name
+
+      # 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
@@ -162,7 +174,9 @@ module Dodopayments
           allowed_payment_method_types:
             T.nilable(T::Array[Dodopayments::PaymentMethodTypes::OrSymbol]),
           billing_currency: T.nilable(Dodopayments::Currency::OrSymbol),
+          customer_business_name: T.nilable(String),
           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 +216,16 @@ 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
+        # Optional business / legal name associated with the tax id. When provided
+        # together with a valid tax id for a B2B purchase, this name is rendered on the
+        # invoice instead of the customer's personal name.
+        customer_business_name: nil,
+        # 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
@@ -263,7 +285,9 @@ module Dodopayments
             allowed_payment_method_types:
               T.nilable(T::Array[Dodopayments::PaymentMethodTypes::OrSymbol]),
             billing_currency: T.nilable(Dodopayments::Currency::OrSymbol),
+            customer_business_name: T.nilable(String),
             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(