dodopayments 2.14.0 → 2.15.0

data/rbi/dodopayments/models/payouts/breakup/detail_list_response.rbi

@@ -26,8 +26,8 @@ module Dodopayments
           sig { returns(String) }
           attr_accessor :event_type
 
-          # Original amount in the original currency (in smallest currency unit, e.g.,
-          # cents).
+          # Original amount in the original currency, in that currency's smallest unit
+          # (cents for USD, yen for JPY, fils for KWD).
           sig { returns(Integer) }
           attr_accessor :original_amount
 
@@ -35,8 +35,9 @@ module Dodopayments
           sig { returns(String) }
           attr_accessor :original_currency
 
-          # Amount in the payout's currency (in smallest currency unit). Uses cumulative
-          # rounding to ensure sum matches payout total exactly.
+          # Amount in the payout's currency, in that currency's smallest unit (cents for
+          # USD, yen for JPY, fils for KWD). Uses cumulative rounding to ensure sum matches
+          # payout total exactly.
           sig { returns(Integer) }
           attr_accessor :payout_currency_amount
 
@@ -75,13 +76,14 @@ module Dodopayments
             # The type of balance ledger event (e.g., "payment", "refund", "dispute",
             # "payment_fees").
             event_type:,
-            # Original amount in the original currency (in smallest currency unit, e.g.,
-            # cents).
+            # Original amount in the original currency, in that currency's smallest unit
+            # (cents for USD, yen for JPY, fils for KWD).
             original_amount:,
             # Original currency as ISO 4217 code (e.g., "USD", "EUR").
             original_currency:,
-            # Amount in the payout's currency (in smallest currency unit). Uses cumulative
-            # rounding to ensure sum matches payout total exactly.
+            # Amount in the payout's currency, in that currency's smallest unit (cents for
+            # USD, yen for JPY, fils for KWD). Uses cumulative rounding to ensure sum matches
+            # payout total exactly.
             payout_currency_amount:,
             # USD equivalent of the original amount (in cents).
             usd_equivalent_amount:,

data/rbi/dodopayments/models/payouts/breakup_retrieve_response.rbi

@@ -17,8 +17,8 @@ module Dodopayments
         sig { returns(String) }
         attr_accessor :event_type
 
-        # Total amount for this event type in the payout's currency (in smallest currency
-        # unit, e.g., cents).
+        # Total amount for this event type in the payout's currency, in that currency's
+        # smallest unit (cents for USD, yen for JPY, fils for KWD).
         sig { returns(Integer) }
         attr_accessor :total
 
@@ -30,8 +30,8 @@ module Dodopayments
           # The type of balance ledger event (e.g., "payment", "refund", "dispute",
           # "payment_fees").
           event_type:,
-          # Total amount for this event type in the payout's currency (in smallest currency
-          # unit, e.g., cents).
+          # Total amount for this event type in the payout's currency, in that currency's
+          # smallest unit (cents for USD, yen for JPY, fils for KWD).
           total:
         )
         end

data/rbi/dodopayments/models/product.rbi

@@ -104,6 +104,13 @@ module Dodopayments
       sig { returns(T.nilable(String)) }
       attr_accessor :name
 
+      # Pricing mode for localized pricing. NULL means base-only (no localized rules
+      # apply).
+      sig do
+        returns(T.nilable(Dodopayments::Product::PricingMode::TaggedSymbol))
+      end
+      attr_accessor :pricing_mode
+
       # The product collection ID this product belongs to, if any
       sig { returns(T.nilable(String)) }
       attr_accessor :product_collection_id
@@ -139,6 +146,7 @@ module Dodopayments
           license_key_duration:
             T.nilable(Dodopayments::LicenseKeyDuration::OrHash),
           name: T.nilable(String),
+          pricing_mode: T.nilable(Dodopayments::Product::PricingMode::OrSymbol),
           product_collection_id: T.nilable(String)
         ).returns(T.attached_class)
       end
@@ -183,6 +191,9 @@ module Dodopayments
         license_key_duration: nil,
         # Name of the product, optional.
         name: nil,
+        # Pricing mode for localized pricing. NULL means base-only (no localized rules
+        # apply).
+        pricing_mode: nil,
         # The product collection ID this product belongs to, if any
         product_collection_id: nil
       )
@@ -213,12 +224,37 @@ module Dodopayments
             license_key_activations_limit: T.nilable(Integer),
             license_key_duration: T.nilable(Dodopayments::LicenseKeyDuration),
             name: T.nilable(String),
+            pricing_mode:
+              T.nilable(Dodopayments::Product::PricingMode::TaggedSymbol),
             product_collection_id: T.nilable(String)
           }
         )
       end
       def to_hash
       end
+
+      # Pricing mode for localized pricing. NULL means base-only (no localized rules
+      # apply).
+      module PricingMode
+        extend Dodopayments::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, Dodopayments::Product::PricingMode) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        BY_CURRENCY =
+          T.let(:by_currency, Dodopayments::Product::PricingMode::TaggedSymbol)
+        BY_COUNTRY =
+          T.let(:by_country, Dodopayments::Product::PricingMode::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[Dodopayments::Product::PricingMode::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
     end
   end
 end

data/rbi/dodopayments/models/product_create_params.rbi

@@ -42,7 +42,7 @@ module Dodopayments
       sig { returns(T.nilable(String)) }
       attr_accessor :brand_id
 
-      # Optional credit entitlements to attach (max 3)
+      # Optional credit entitlements to attach (max 5)
       sig do
         returns(T.nilable(T::Array[Dodopayments::AttachCreditEntitlement]))
       end
@@ -72,7 +72,7 @@ module Dodopayments
       end
       attr_writer :digital_product_delivery
 
-      # Optional entitlements to attach to this product (max 20)
+      # Optional entitlements to attach to this product (max 50)
       sig do
         returns(T.nilable(T::Array[Dodopayments::AttachProductEntitlement]))
       end
@@ -124,6 +124,16 @@ module Dodopayments
       sig { params(metadata: T::Hash[Symbol, String]).void }
       attr_writer :metadata
 
+      # Pricing mode for localized pricing. When set, rules from
+      # /products/{id}/localized-prices apply at checkout. NULL means base-only
+      # (existing behavior).
+      sig do
+        returns(
+          T.nilable(Dodopayments::ProductCreateParams::PricingMode::OrSymbol)
+        )
+      end
+      attr_accessor :pricing_mode
+
       sig do
         params(
           name: String,
@@ -151,6 +161,8 @@ module Dodopayments
             T.nilable(Dodopayments::LicenseKeyDuration::OrHash),
           license_key_enabled: T.nilable(T::Boolean),
           metadata: T::Hash[Symbol, String],
+          pricing_mode:
+            T.nilable(Dodopayments::ProductCreateParams::PricingMode::OrSymbol),
           request_options: Dodopayments::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
@@ -165,7 +177,7 @@ module Dodopayments
         addons: nil,
         # Brand id for the product, if not provided will default to primary brand
         brand_id: nil,
-        # Optional credit entitlements to attach (max 3)
+        # Optional credit entitlements to attach (max 5)
         credit_entitlements: nil,
         # Optional description of the product
         description: nil,
@@ -173,7 +185,7 @@ module Dodopayments
         #
         # deprecated: use entitlements instead
         digital_product_delivery: nil,
-        # Optional entitlements to attach to this product (max 20)
+        # Optional entitlements to attach to this product (max 50)
         entitlements: nil,
         # Optional message displayed during license key activation
         #
@@ -200,6 +212,10 @@ module Dodopayments
         license_key_enabled: nil,
         # Additional metadata for the product
         metadata: nil,
+        # Pricing mode for localized pricing. When set, rules from
+        # /products/{id}/localized-prices apply at checkout. NULL means base-only
+        # (existing behavior).
+        pricing_mode: nil,
         request_options: {}
       )
       end
@@ -231,6 +247,10 @@ module Dodopayments
             license_key_duration: T.nilable(Dodopayments::LicenseKeyDuration),
             license_key_enabled: T.nilable(T::Boolean),
             metadata: T::Hash[Symbol, String],
+            pricing_mode:
+              T.nilable(
+                Dodopayments::ProductCreateParams::PricingMode::OrSymbol
+              ),
             request_options: Dodopayments::RequestOptions
           }
         )
@@ -280,6 +300,40 @@ module Dodopayments
         def to_hash
         end
       end
+
+      # Pricing mode for localized pricing. When set, rules from
+      # /products/{id}/localized-prices apply at checkout. NULL means base-only
+      # (existing behavior).
+      module PricingMode
+        extend Dodopayments::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Dodopayments::ProductCreateParams::PricingMode)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        BY_CURRENCY =
+          T.let(
+            :by_currency,
+            Dodopayments::ProductCreateParams::PricingMode::TaggedSymbol
+          )
+        BY_COUNTRY =
+          T.let(
+            :by_country,
+            Dodopayments::ProductCreateParams::PricingMode::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Dodopayments::ProductCreateParams::PricingMode::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
     end
   end
 end

data/rbi/dodopayments/models/product_update_params.rbi

@@ -132,6 +132,16 @@ module Dodopayments
       end
       attr_accessor :price
 
+      # Update the pricing mode. Omit to leave unchanged; set to null to clear (which
+      # archives all active localized rules for this product). Changing to a different
+      # non-null mode also archives any rules whose mode doesn't match the new mode.
+      sig do
+        returns(
+          T.nilable(Dodopayments::ProductUpdateParams::PricingMode::OrSymbol)
+        )
+      end
+      attr_accessor :pricing_mode
+
       # Tax category of the product.
       sig { returns(T.nilable(Dodopayments::TaxCategory::OrSymbol)) }
       attr_accessor :tax_category
@@ -166,6 +176,8 @@ module Dodopayments
                 Dodopayments::Price::UsageBasedPrice::OrHash
               )
             ),
+          pricing_mode:
+            T.nilable(Dodopayments::ProductUpdateParams::PricingMode::OrSymbol),
           tax_category: T.nilable(Dodopayments::TaxCategory::OrSymbol),
           request_options: Dodopayments::RequestOptions::OrHash
         ).returns(T.attached_class)
@@ -223,6 +235,10 @@ module Dodopayments
         name: nil,
         # Price details of the product.
         price: nil,
+        # Update the pricing mode. Omit to leave unchanged; set to null to clear (which
+        # archives all active localized rules for this product). Changing to a different
+        # non-null mode also archives any rules whose mode doesn't match the new mode.
+        pricing_mode: nil,
         # Tax category of the product.
         tax_category: nil,
         request_options: {}
@@ -259,6 +275,10 @@ module Dodopayments
                   Dodopayments::Price::UsageBasedPrice
                 )
               ),
+            pricing_mode:
+              T.nilable(
+                Dodopayments::ProductUpdateParams::PricingMode::OrSymbol
+              ),
             tax_category: T.nilable(Dodopayments::TaxCategory::OrSymbol),
             request_options: Dodopayments::RequestOptions
           }
@@ -320,6 +340,40 @@ module Dodopayments
         def to_hash
         end
       end
+
+      # Update the pricing mode. Omit to leave unchanged; set to null to clear (which
+      # archives all active localized rules for this product). Changing to a different
+      # non-null mode also archives any rules whose mode doesn't match the new mode.
+      module PricingMode
+        extend Dodopayments::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Dodopayments::ProductUpdateParams::PricingMode)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        BY_CURRENCY =
+          T.let(
+            :by_currency,
+            Dodopayments::ProductUpdateParams::PricingMode::TaggedSymbol
+          )
+        BY_COUNTRY =
+          T.let(
+            :by_country,
+            Dodopayments::ProductUpdateParams::PricingMode::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Dodopayments::ProductUpdateParams::PricingMode::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
     end
   end
 end

data/rbi/dodopayments/models/refund.rbi

@@ -8,6 +8,10 @@ module Dodopayments
           T.any(Dodopayments::Refund, Dodopayments::Internal::AnyHash)
         end
 
+      # Brand id this refund belongs to
+      sig { returns(String) }
+      attr_accessor :brand_id
+
       # The unique identifier of the business issuing the refund.
       sig { returns(String) }
       attr_accessor :business_id
@@ -59,6 +63,7 @@ module Dodopayments
 
       sig do
         params(
+          brand_id: String,
           business_id: String,
           created_at: Time,
           customer: Dodopayments::CustomerLimitedDetails::OrHash,
@@ -73,6 +78,8 @@ module Dodopayments
         ).returns(T.attached_class)
       end
       def self.new(
+        # Brand id this refund belongs to
+        brand_id:,
         # The unique identifier of the business issuing the refund.
         business_id:,
         # The timestamp of when the refund was created in UTC.
@@ -101,6 +108,7 @@ module Dodopayments
       sig do
         override.returns(
           {
+            brand_id: String,
             business_id: String,
             created_at: Time,
             customer: Dodopayments::CustomerLimitedDetails,

data/rbi/dodopayments/models/subscription.rbi

@@ -19,6 +19,10 @@ module Dodopayments
       sig { params(billing: Dodopayments::BillingAddress::OrHash).void }
       attr_writer :billing
 
+      # Brand id this subscription belongs to
+      sig { returns(String) }
+      attr_accessor :brand_id
+
       # Indicates if the subscription will cancel at the next billing date
       sig { returns(T::Boolean) }
       attr_accessor :cancel_at_next_billing_date
@@ -87,8 +91,8 @@ module Dodopayments
       sig { returns(Integer) }
       attr_accessor :quantity
 
-      # Amount charged before tax for each recurring payment in smallest currency unit
-      # (e.g. cents)
+      # Amount charged before tax for each recurring payment in the currency's smallest
+      # unit (cents for USD, yen for JPY, fils for KWD)
       sig { returns(Integer) }
       attr_accessor :recurring_pre_tax_amount
 
@@ -179,6 +183,7 @@ module Dodopayments
         params(
           addons: T::Array[Dodopayments::AddonCartResponseItem::OrHash],
           billing: Dodopayments::BillingAddress::OrHash,
+          brand_id: String,
           cancel_at_next_billing_date: T::Boolean,
           created_at: Time,
           credit_entitlement_cart:
@@ -225,6 +230,8 @@ module Dodopayments
         addons:,
         # Billing address details for payments
         billing:,
+        # Brand id this subscription belongs to
+        brand_id:,
         # Indicates if the subscription will cancel at the next billing date
         cancel_at_next_billing_date:,
         # Timestamp when the subscription was created
@@ -256,8 +263,8 @@ module Dodopayments
         product_id:,
         # Number of units/items included in the subscription
         quantity:,
-        # Amount charged before tax for each recurring payment in smallest currency unit
-        # (e.g. cents)
+        # Amount charged before tax for each recurring payment in the currency's smallest
+        # unit (cents for USD, yen for JPY, fils for KWD)
         recurring_pre_tax_amount:,
         # Current status of the subscription
         status:,
@@ -304,6 +311,7 @@ module Dodopayments
           {
             addons: T::Array[Dodopayments::AddonCartResponseItem],
             billing: Dodopayments::BillingAddress,
+            brand_id: String,
             cancel_at_next_billing_date: T::Boolean,
             created_at: Time,
             credit_entitlement_cart:

data/rbi/dodopayments/models/subscription_list_response.rbi

@@ -80,8 +80,8 @@ module Dodopayments
       sig { returns(Integer) }
       attr_accessor :quantity
 
-      # Amount charged before tax for each recurring payment in smallest currency unit
-      # (e.g. cents)
+      # Amount charged before tax for each recurring payment in the currency's smallest
+      # unit (cents for USD, yen for JPY, fils for KWD)
       sig { returns(Integer) }
       attr_accessor :recurring_pre_tax_amount
 
@@ -217,8 +217,8 @@ module Dodopayments
         product_id:,
         # Number of units/items included in the subscription
         quantity:,
-        # Amount charged before tax for each recurring payment in smallest currency unit
-        # (e.g. cents)
+        # Amount charged before tax for each recurring payment in the currency's smallest
+        # unit (cents for USD, yen for JPY, fils for KWD)
         recurring_pre_tax_amount:,
         # Current status of the subscription
         status:,

data/rbi/dodopayments/models/subscription_preview_change_plan_response.rbi

@@ -477,6 +477,11 @@ module Dodopayments
           sig { returns(Dodopayments::Currency::TaggedSymbol) }
           attr_accessor :currency
 
+          # Net credit movement in the smallest currency unit (e.g. cents). **Negative** –
+          # credits were deducted from the customer's balance to offset the charge (typical
+          # on upgrades). **Positive** – credits were added to the customer's balance,
+          # either from a downgrade proration refund or from topping-up the wallet to meet a
+          # gateway minimum-charge threshold. **Zero** – no credit movement occurred.
           sig { returns(Integer) }
           attr_accessor :customer_credits
 
@@ -508,6 +513,11 @@ module Dodopayments
           end
           def self.new(
             currency:,
+            # Net credit movement in the smallest currency unit (e.g. cents). **Negative** –
+            # credits were deducted from the customer's balance to offset the charge (typical
+            # on upgrades). **Positive** – credits were added to the customer's balance,
+            # either from a downgrade proration refund or from topping-up the wallet to meet a
+            # gateway minimum-charge threshold. **Zero** – no credit movement occurred.
             customer_credits:,
             settlement_amount:,
             settlement_currency:,

data/rbi/dodopayments/models/subscription_retrieve_usage_history_response.rbi

@@ -101,7 +101,8 @@ module Dodopayments
         sig { returns(String) }
         attr_accessor :price_per_unit
 
-        # Total price charged for this meter in smallest currency unit (cents)
+        # Total price charged for this meter in the currency's smallest unit (cents for
+        # USD, yen for JPY, fils for KWD)
         sig { returns(Integer) }
         attr_accessor :total_price
 
@@ -132,7 +133,8 @@ module Dodopayments
           name:,
           # Price per unit in string format for precision
           price_per_unit:,
-          # Total price charged for this meter in smallest currency unit (cents)
+          # Total price charged for this meter in the currency's smallest unit (cents for
+          # USD, yen for JPY, fils for KWD)
           total_price:
         )
         end

data/rbi/dodopayments/models/theme_config.rbi

@@ -121,7 +121,7 @@ module Dodopayments
         MD = T.let(:md, Dodopayments::ThemeConfig::FontSize::TaggedSymbol)
         LG = T.let(:lg, Dodopayments::ThemeConfig::FontSize::TaggedSymbol)
         XL = T.let(:xl, Dodopayments::ThemeConfig::FontSize::TaggedSymbol)
-        SIZE2_XL =
+        FONT_SIZE_2XL =
           T.let(:"2xl", Dodopayments::ThemeConfig::FontSize::TaggedSymbol)
 
         sig do

data/rbi/dodopayments/models/webhook_payload.rbi

@@ -256,6 +256,10 @@ module Dodopayments
           sig { returns(String) }
           attr_accessor :available_balance
 
+          # Brand id this credit entitlement belongs to
+          sig { returns(String) }
+          attr_accessor :brand_id
+
           sig { returns(String) }
           attr_accessor :credit_entitlement_id
 
@@ -283,6 +287,7 @@ module Dodopayments
           sig do
             params(
               available_balance: String,
+              brand_id: String,
               credit_entitlement_id: String,
               credit_entitlement_name: String,
               customer_id: String,
@@ -295,6 +300,8 @@ module Dodopayments
           end
           def self.new(
             available_balance:,
+            # Brand id this credit entitlement belongs to
+            brand_id:,
             credit_entitlement_id:,
             credit_entitlement_name:,
             customer_id:,
@@ -310,6 +317,7 @@ module Dodopayments
             override.returns(
               {
                 available_balance: String,
+                brand_id: String,
                 credit_entitlement_id: String,
                 credit_entitlement_name: String,
                 customer_id: String,
@@ -344,6 +352,10 @@ module Dodopayments
           end
           attr_accessor :abandonment_reason
 
+          # Brand id this abandoned checkout belongs to
+          sig { returns(String) }
+          attr_accessor :brand_id
+
           sig { returns(String) }
           attr_accessor :customer_id
 
@@ -368,6 +380,7 @@ module Dodopayments
               abandoned_at: Time,
               abandonment_reason:
                 Dodopayments::WebhookPayload::Data::AbandonedCheckout::AbandonmentReason::OrSymbol,
+              brand_id: String,
               customer_id: String,
               payment_id: String,
               status:
@@ -379,6 +392,8 @@ module Dodopayments
           def self.new(
             abandoned_at:,
             abandonment_reason:,
+            # Brand id this abandoned checkout belongs to
+            brand_id:,
             customer_id:,
             payment_id:,
             status:,
@@ -393,6 +408,7 @@ module Dodopayments
                 abandoned_at: Time,
                 abandonment_reason:
                   Dodopayments::WebhookPayload::Data::AbandonedCheckout::AbandonmentReason::OrSymbol,
+                brand_id: String,
                 customer_id: String,
                 payload_type: Symbol,
                 payment_id: String,
@@ -498,6 +514,10 @@ module Dodopayments
               )
             end
 
+          # Brand id this dunning attempt belongs to
+          sig { returns(String) }
+          attr_accessor :brand_id
+
           sig { returns(Time) }
           attr_accessor :created_at
 
@@ -529,6 +549,7 @@ module Dodopayments
 
           sig do
             params(
+              brand_id: String,
               created_at: Time,
               customer_id: String,
               status:
@@ -541,6 +562,8 @@ module Dodopayments
             ).returns(T.attached_class)
           end
           def self.new(
+            # Brand id this dunning attempt belongs to
+            brand_id:,
             created_at:,
             customer_id:,
             status:,
@@ -554,6 +577,7 @@ module Dodopayments
           sig do
             override.returns(
               {
+                brand_id: String,
                 created_at: Time,
                 customer_id: String,
                 payload_type: Symbol,

data/rbi/dodopayments/resources/entitlements/grants.rbi

@@ -9,8 +9,6 @@ module Dodopayments
           params(
             id: String,
             customer_id: String,
-            integration_type:
-              Dodopayments::Entitlements::GrantListParams::IntegrationType::OrSymbol,
             page_number: Integer,
             page_size: Integer,
             status:
@@ -27,8 +25,6 @@ module Dodopayments
           id,
           # Filter by customer ID
           customer_id: nil,
-          # Filter by integration type
-          integration_type: nil,
           # Page number (default 0)
           page_number: nil,
           # Page size (default 10, max 100)