dodopayments 2.14.0 → 2.16.0

data/rbi/dodopayments/models/get_dispute.rbi

@@ -13,6 +13,10 @@ module Dodopayments
       sig { returns(String) }
       attr_accessor :amount
 
+      # Brand id this dispute belongs to
+      sig { returns(String) }
+      attr_accessor :brand_id
+
       # The unique identifier of the business involved in the dispute.
       sig { returns(String) }
       attr_accessor :business_id
@@ -50,6 +54,12 @@ module Dodopayments
       sig { returns(String) }
       attr_accessor :payment_id
 
+      # Which processor handled the underlying payment. `stripe` / `adyen` for BYOP
+      # routes (the merchant's own payment connector); `dodo` for everything Dodo
+      # processed itself.
+      sig { returns(Dodopayments::GetDispute::PaymentProvider::TaggedSymbol) }
+      attr_accessor :payment_provider
+
       # Whether the dispute was resolved by Rapid Dispute Resolution
       sig { returns(T.nilable(T::Boolean)) }
       attr_accessor :is_resolved_by_rdr
@@ -65,6 +75,7 @@ module Dodopayments
       sig do
         params(
           amount: String,
+          brand_id: String,
           business_id: String,
           created_at: Time,
           currency: String,
@@ -73,6 +84,7 @@ module Dodopayments
           dispute_stage: Dodopayments::DisputeStage::OrSymbol,
           dispute_status: Dodopayments::DisputeStatus::OrSymbol,
           payment_id: String,
+          payment_provider: Dodopayments::GetDispute::PaymentProvider::OrSymbol,
           is_resolved_by_rdr: T.nilable(T::Boolean),
           reason: T.nilable(String),
           remarks: T.nilable(String)
@@ -82,6 +94,8 @@ module Dodopayments
         # The amount involved in the dispute, represented as a string to accommodate
         # precision.
         amount:,
+        # Brand id this dispute belongs to
+        brand_id:,
         # The unique identifier of the business involved in the dispute.
         business_id:,
         # The timestamp of when the dispute was created, in UTC.
@@ -98,6 +112,10 @@ module Dodopayments
         dispute_status:,
         # The unique identifier of the payment associated with the dispute.
         payment_id:,
+        # Which processor handled the underlying payment. `stripe` / `adyen` for BYOP
+        # routes (the merchant's own payment connector); `dodo` for everything Dodo
+        # processed itself.
+        payment_provider:,
         # Whether the dispute was resolved by Rapid Dispute Resolution
         is_resolved_by_rdr: nil,
         # Reason for the dispute
@@ -111,6 +129,7 @@ module Dodopayments
         override.returns(
           {
             amount: String,
+            brand_id: String,
             business_id: String,
             created_at: Time,
             currency: String,
@@ -119,6 +138,8 @@ module Dodopayments
             dispute_stage: Dodopayments::DisputeStage::TaggedSymbol,
             dispute_status: Dodopayments::DisputeStatus::TaggedSymbol,
             payment_id: String,
+            payment_provider:
+              Dodopayments::GetDispute::PaymentProvider::TaggedSymbol,
             is_resolved_by_rdr: T.nilable(T::Boolean),
             reason: T.nilable(String),
             remarks: T.nilable(String)
@@ -127,6 +148,37 @@ module Dodopayments
       end
       def to_hash
       end
+
+      # Which processor handled the underlying payment. `stripe` / `adyen` for BYOP
+      # routes (the merchant's own payment connector); `dodo` for everything Dodo
+      # processed itself.
+      module PaymentProvider
+        extend Dodopayments::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Dodopayments::GetDispute::PaymentProvider)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        STRIPE =
+          T.let(
+            :stripe,
+            Dodopayments::GetDispute::PaymentProvider::TaggedSymbol
+          )
+        ADYEN =
+          T.let(:adyen, Dodopayments::GetDispute::PaymentProvider::TaggedSymbol)
+        DODO =
+          T.let(:dodo, Dodopayments::GetDispute::PaymentProvider::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[Dodopayments::GetDispute::PaymentProvider::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
     end
   end
 end

data/rbi/dodopayments/models/integration_config.rbi

@@ -308,9 +308,9 @@ module Dodopayments
         sig { returns(T.nilable(Dodopayments::TimeInterval::OrSymbol)) }
         attr_accessor :duration_interval
 
-        # Fulfillment mode: `auto` (default) generates keys automatically; `manual`
-        # creates pending grants the merchant fulfills via the
-        # `POST /grants/{id}/license-key` endpoint.
+        # How license keys are fulfilled. `auto` (default) generates and delivers keys to
+        # customers automatically; `manual` creates pending grants that you fulfill with
+        # the supplied key via `POST /grants/{grant_id}/license-key`.
         sig do
           returns(
             T.nilable(
@@ -344,9 +344,9 @@ module Dodopayments
           duration_count: nil,
           # Unit of `duration_count`.
           duration_interval: nil,
-          # Fulfillment mode: `auto` (default) generates keys automatically; `manual`
-          # creates pending grants the merchant fulfills via the
-          # `POST /grants/{id}/license-key` endpoint.
+          # How license keys are fulfilled. `auto` (default) generates and delivers keys to
+          # customers automatically; `manual` creates pending grants that you fulfill with
+          # the supplied key via `POST /grants/{grant_id}/license-key`.
           fulfillment_mode: nil
         )
         end
@@ -369,9 +369,9 @@ module Dodopayments
         def to_hash
         end
 
-        # Fulfillment mode: `auto` (default) generates keys automatically; `manual`
-        # creates pending grants the merchant fulfills via the
-        # `POST /grants/{id}/license-key` endpoint.
+        # How license keys are fulfilled. `auto` (default) generates and delivers keys to
+        # customers automatically; `manual` creates pending grants that you fulfill with
+        # the supplied key via `POST /grants/{grant_id}/license-key`.
         module FulfillmentMode
           extend Dodopayments::Internal::Type::Enum
 

data/rbi/dodopayments/models/integration_config_response.rbi

@@ -425,11 +425,9 @@ module Dodopayments
         sig { returns(T.nilable(Dodopayments::TimeInterval::TaggedSymbol)) }
         attr_accessor :duration_interval
 
-        # Fulfillment mode:
-        #
-        # `auto` (default) generate and delivery license keys to customers automatically.
-        # `manual` creates pending grants, actual key is provided via the fulfillment API
-        # and delivered to the customer when fulfilled.
+        # How license keys are fulfilled. `auto` (default) generates and delivers keys to
+        # customers automatically; `manual` creates pending grants that you fulfill with
+        # the supplied key via `POST /grants/{grant_id}/license-key`.
         sig do
           returns(
             T.nilable(
@@ -463,11 +461,9 @@ module Dodopayments
           duration_count: nil,
           # Unit of `duration_count`.
           duration_interval: nil,
-          # Fulfillment mode:
-          #
-          # `auto` (default) generate and delivery license keys to customers automatically.
-          # `manual` creates pending grants, actual key is provided via the fulfillment API
-          # and delivered to the customer when fulfilled.
+          # How license keys are fulfilled. `auto` (default) generates and delivers keys to
+          # customers automatically; `manual` creates pending grants that you fulfill with
+          # the supplied key via `POST /grants/{grant_id}/license-key`.
           fulfillment_mode: nil
         )
         end
@@ -490,11 +486,9 @@ module Dodopayments
         def to_hash
         end
 
-        # Fulfillment mode:
-        #
-        # `auto` (default) generate and delivery license keys to customers automatically.
-        # `manual` creates pending grants, actual key is provided via the fulfillment API
-        # and delivered to the customer when fulfilled.
+        # How license keys are fulfilled. `auto` (default) generates and delivers keys to
+        # customers automatically; `manual` creates pending grants that you fulfill with
+        # the supplied key via `POST /grants/{grant_id}/license-key`.
         module FulfillmentMode
           extend Dodopayments::Internal::Type::Enum
 

data/rbi/dodopayments/models/license_key.rbi

@@ -12,6 +12,10 @@ module Dodopayments
       sig { returns(String) }
       attr_accessor :id
 
+      # Brand id this license key belongs to
+      sig { returns(String) }
+      attr_accessor :brand_id
+
       # The unique identifier of the business associated with the license key.
       sig { returns(String) }
       attr_accessor :business_id
@@ -65,6 +69,7 @@ module Dodopayments
       sig do
         params(
           id: String,
+          brand_id: String,
           business_id: String,
           created_at: Time,
           customer_id: String,
@@ -82,6 +87,8 @@ module Dodopayments
       def self.new(
         # The unique identifier of the license key.
         id:,
+        # Brand id this license key belongs to
+        brand_id:,
         # The unique identifier of the business associated with the license key.
         business_id:,
         # The timestamp indicating when the license key was created, in UTC.
@@ -115,6 +122,7 @@ module Dodopayments
         override.returns(
           {
             id: String,
+            brand_id: String,
             business_id: String,
             created_at: Time,
             customer_id: String,

data/rbi/dodopayments/models/payment.rbi

@@ -57,8 +57,7 @@ module Dodopayments
       attr_accessor :payment_id
 
       # Which processor handled this payment. `stripe` / `adyen` for BYOP routes (the
-      # merchant's own Hyperswitch connector); `dodo` for everything Dodo processed
-      # itself.
+      # merchant's own payment connector); `dodo` for everything Dodo processed itself.
       sig { returns(Dodopayments::Payment::PaymentProvider::TaggedSymbol) }
       attr_accessor :payment_provider
 
@@ -84,8 +83,9 @@ module Dodopayments
       sig { returns(Dodopayments::Currency::TaggedSymbol) }
       attr_accessor :settlement_currency
 
-      # Total amount charged to the customer including tax, in smallest currency unit
-      # (e.g. cents)
+      # Total amount charged to the customer including tax, in the currency's smallest
+      # unit (e.g. cents for USD, yen for JPY, fils for KWD — see the currency's decimal
+      # places)
       sig { returns(Integer) }
       attr_accessor :total_amount
 
@@ -179,7 +179,8 @@ module Dodopayments
       sig { returns(T.nilable(String)) }
       attr_accessor :subscription_id
 
-      # Amount of tax collected in smallest currency unit (e.g. cents)
+      # Amount of tax collected in the currency's smallest unit (e.g. cents for USD, yen
+      # for JPY, fils for KWD)
       sig { returns(T.nilable(Integer)) }
       attr_accessor :tax
 
@@ -254,8 +255,7 @@ module Dodopayments
         # Unique identifier for the payment
         payment_id:,
         # Which processor handled this payment. `stripe` / `adyen` for BYOP routes (the
-        # merchant's own Hyperswitch connector); `dodo` for everything Dodo processed
-        # itself.
+        # merchant's own payment connector); `dodo` for everything Dodo processed itself.
         payment_provider:,
         # List of refunds issued for this payment
         refunds:,
@@ -271,8 +271,9 @@ module Dodopayments
         # balance. This may differ from the customer's payment currency in adaptive
         # pricing scenarios.
         settlement_currency:,
-        # Total amount charged to the customer including tax, in smallest currency unit
-        # (e.g. cents)
+        # Total amount charged to the customer including tax, in the currency's smallest
+        # unit (e.g. cents for USD, yen for JPY, fils for KWD — see the currency's decimal
+        # places)
         total_amount:,
         # Cardholder name
         card_holder_name: nil,
@@ -320,7 +321,8 @@ module Dodopayments
         status: nil,
         # Identifier of the subscription if payment is part of a subscription
         subscription_id: nil,
-        # Amount of tax collected in smallest currency unit (e.g. cents)
+        # Amount of tax collected in the currency's smallest unit (e.g. cents for USD, yen
+        # for JPY, fils for KWD)
         tax: nil,
         # Timestamp when the payment was last updated
         updated_at: nil
@@ -381,8 +383,7 @@ module Dodopayments
       end
 
       # Which processor handled this payment. `stripe` / `adyen` for BYOP routes (the
-      # merchant's own Hyperswitch connector); `dodo` for everything Dodo processed
-      # itself.
+      # merchant's own payment connector); `dodo` for everything Dodo processed itself.
       module PaymentProvider
         extend Dodopayments::Internal::Type::Enum
 

data/rbi/dodopayments/models/payment_create_response.rbi

@@ -33,7 +33,8 @@ module Dodopayments
       sig { returns(String) }
       attr_accessor :payment_id
 
-      # Total amount of the payment in smallest currency unit (e.g. cents)
+      # Total amount of the payment in the currency's smallest unit (cents for USD, yen
+      # for JPY, fils for KWD)
       sig { returns(Integer) }
       attr_accessor :total_amount
 
@@ -83,7 +84,8 @@ module Dodopayments
         metadata:,
         # Unique identifier for the payment
         payment_id:,
-        # Total amount of the payment in smallest currency unit (e.g. cents)
+        # Total amount of the payment in the currency's smallest unit (cents for USD, yen
+        # for JPY, fils for KWD)
         total_amount:,
         # DEPRECATED: Use discount_ids instead. Returns the first discount's ID if
         # present.

data/rbi/dodopayments/models/payment_list_response.rbi

@@ -41,8 +41,7 @@ module Dodopayments
       attr_accessor :payment_id
 
       # Which processor handled this payment. `stripe` / `adyen` for BYOP routes (the
-      # merchant's own Hyperswitch connector); `dodo` for everything Dodo processed
-      # itself.
+      # merchant's own payment connector); `dodo` for everything Dodo processed itself.
       sig do
         returns(
           Dodopayments::Models::PaymentListResponse::PaymentProvider::TaggedSymbol
@@ -127,8 +126,7 @@ module Dodopayments
         metadata:,
         payment_id:,
         # Which processor handled this payment. `stripe` / `adyen` for BYOP routes (the
-        # merchant's own Hyperswitch connector); `dodo` for everything Dodo processed
-        # itself.
+        # merchant's own payment connector); `dodo` for everything Dodo processed itself.
         payment_provider:,
         total_amount:,
         # The last four digits of the card
@@ -184,8 +182,7 @@ module Dodopayments
       end
 
       # Which processor handled this payment. `stripe` / `adyen` for BYOP routes (the
-      # merchant's own Hyperswitch connector); `dodo` for everything Dodo processed
-      # itself.
+      # merchant's own payment connector); `dodo` for everything Dodo processed itself.
       module PaymentProvider
         extend Dodopayments::Internal::Type::Enum
 

data/rbi/dodopayments/models/payment_method_types.rbi

@@ -2,7 +2,7 @@
 
 module Dodopayments
   module Models
-    # All supported payment method types (from Hyperswitch).
+    # All supported payment method types.
     #
     # Used for disabled-payment-methods filtering and validation.
     module PaymentMethodTypes

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