dodopayments 2.20.1 → 2.21.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e34bae6e8f112347d01747da053dfdfe8c59aee24d21a3fcd819e84d7e97cba3
-  data.tar.gz: 67ee243d3c0073abd94d91493801a629900c62a60c5281a6dcd42716b224f322
+  metadata.gz: cce1a46aa3a586422600889e188f2b401e93246c826b2e96e5dc8c5c0a056014
+  data.tar.gz: 295a9d062709d43a862c5f351231a8cb27febbcb36fd8a1ff78b69de75374634
 SHA512:
-  metadata.gz: 6c541301db330885909821106447abee6878fe8ef0bc53abce8d91ca151906ae609f57e102cb366826a340cb70d445816b856e7e8bc9881512652a0bd5077362
-  data.tar.gz: 8d9ff09789b3e055edf9e19f310e89fe792e8ebe33376d414caadc0093ed443188b3304d2dad999e66e061a43ec15953d5a62fa0f548ce67c2057401a4694982
+  metadata.gz: 2aca745d3761996c176af1668be98cc19496aebddc82b6d6aa2e43b7a2784a410e601a0d81608a0c0d855f8634f4959075455c697d286018a9d2bd4a3e3c8573
+  data.tar.gz: 35d872f10337c040fc7b90d431a0ca011298cf7daaedff9a6a126cb7c05dc0b261edf3caf826d6c39b70fc4524f7264d17a6c9a104b397292ee9e5b44d1c0ea6

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [2.21.0](https://github.com/dodopayments/dodopayments-ruby/compare/v2.20.1...v2.21.0) (2026-07-24)
+
+
+### Features
+
+* **api:** add discount customers endpoints, trial support, currency options, and failure details ([5aaae29](https://github.com/dodopayments/dodopayments-ruby/commit/5aaae29fb5cabc885b193df6eb5de2f4a3613446))
+* **api:** add discount customers endpoints, trial support, currency options, and failure details ([f71fd20](https://github.com/dodopayments/dodopayments-ruby/commit/f71fd20da899aa0f7f8ea7e6d4e892d60064082e))
+
 ## [2.20.1](https://github.com/dodopayments/dodopayments-ruby/compare/v2.20.0...v2.20.1) (2026-07-09)
 
 

data/README.md

@@ -23,7 +23,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "dodopayments", "~> 2.20.1"
+gem "dodopayments", "~> 2.21.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/dodopayments/models/checkout_session_preview_response.rb

@@ -85,7 +85,22 @@ module Dodopayments
       #   @return [Integer, nil]
       optional :total_tax, Integer, nil?: true
 
-      # @!method initialize(billing_country:, currency:, current_breakup:, is_byop:, product_cart:, total_price:, next_billing_date: nil, recurring_breakup: nil, tax_id_business_name: nil, tax_id_err_msg: nil, tax_id_format_name: nil, total_tax: nil)
+      # @!attribute trial_amount
+      #   Per-unit trial amount after discounts, in the price currency's minor units
+      #   (pre-quantity, pre-tax; see `current_breakup` for the taxed total due today).
+      #   Only present for a paid trial; `None` for a free trial or no trial.
+      #
+      #   @return [Integer, nil]
+      optional :trial_amount, Integer, nil?: true
+
+      # @!attribute trial_period_days
+      #   Effective trial duration in days for the subscription line, when there's a trial
+      #   (free or paid). `None` if no subscription or no trial.
+      #
+      #   @return [Integer, nil]
+      optional :trial_period_days, Integer, nil?: true
+
+      # @!method initialize(billing_country:, currency:, current_breakup:, is_byop:, product_cart:, total_price:, next_billing_date: nil, recurring_breakup: nil, tax_id_business_name: nil, tax_id_err_msg: nil, tax_id_format_name: nil, total_tax: nil, trial_amount: nil, trial_period_days: nil)
       #   Some parameter documentations has been truncated, see
       #   {Dodopayments::Models::CheckoutSessionPreviewResponse} for more details.
       #
@@ -114,6 +129,10 @@ module Dodopayments
       #   @param tax_id_format_name [String, nil] The matched tax ID notation (e.g. "VAT Number", "GSTIN") when valid
       #
       #   @param total_tax [Integer, nil] Total tax
+      #
+      #   @param trial_amount [Integer, nil] Per-unit trial amount after discounts, in the price currency's minor units
+      #
+      #   @param trial_period_days [Integer, nil] Effective trial duration in days for the subscription line, when
 
       # @see Dodopayments::Models::CheckoutSessionPreviewResponse#current_breakup
       class CurrentBreakup < Dodopayments::Internal::Type::BaseModel
@@ -245,7 +264,8 @@ module Dodopayments
         optional :description, String, nil?: true
 
         # @!attribute discount_amount
-        #   discount percentage
+        #   Percentage rate (basis points) of the applicable percentage code; null for flat
+        #   codes (their deduction is `og_price - discounted_price`).
         #
         #   @return [Integer, nil]
         optional :discount_amount, Integer, nil?: true
@@ -269,6 +289,10 @@ module Dodopayments
         optional :tax, Integer, nil?: true
 
         # @!method initialize(credit_entitlements:, currency:, discounted_price:, is_subscription:, is_usage_based:, meters:, og_currency:, og_price:, product_id:, quantity:, tax_category:, tax_inclusive:, tax_rate:, addons: nil, description: nil, discount_amount: nil, discount_cycle: nil, name: nil, tax: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Dodopayments::Models::CheckoutSessionPreviewResponse::ProductCart} for more
+        #   details.
+        #
         #   @param credit_entitlements [Array<Dodopayments::Models::CheckoutSessionPreviewResponse::ProductCart::CreditEntitlement>] Credit entitlements that will be granted upon purchase
         #
         #   @param currency [Symbol, Dodopayments::Models::Currency] the currency in which the calculatiosn were made
@@ -299,7 +323,7 @@ module Dodopayments
         #
         #   @param description [String, nil]
         #
-        #   @param discount_amount [Integer, nil] discount percentage
+        #   @param discount_amount [Integer, nil] Percentage rate (basis points) of the applicable percentage code; null
         #
         #   @param discount_cycle [Integer, nil] number of cycles the discount will apply
         #
@@ -438,6 +462,8 @@ module Dodopayments
           optional :description, String, nil?: true
 
           # @!attribute discount_amount
+          #   Percentage rate (basis points) of the applicable percentage code; null for flat
+          #   codes (their deduction is `og_price - discounted_price`).
           #
           #   @return [Integer, nil]
           optional :discount_amount, Integer, nil?: true
@@ -474,7 +500,7 @@ module Dodopayments
           #
           #   @param description [String, nil]
           #
-          #   @param discount_amount [Integer, nil]
+          #   @param discount_amount [Integer, nil] Percentage rate (basis points) of the applicable percentage code; null
           #
           #   @param tax [Integer, nil]
         end

data/lib/dodopayments/models/credit_entitlements/balance_create_ledger_entry_params.rb

@@ -19,7 +19,9 @@ module Dodopayments
         required :customer_id, String
 
         # @!attribute amount
-        #   Amount to credit or debit
+        #   Amount to credit or debit. Bounded to a `NUMERIC(38,28)` column, so the integer
+        #   part must have fewer than 10 digits (< 10^10); larger values previously reached
+        #   the DB and failed with a 22003 overflow surfaced as a 500.
         #
         #   @return [String]
         required :amount, String
@@ -66,7 +68,7 @@ module Dodopayments
         #
         #   @param customer_id [String]
         #
-        #   @param amount [String] Amount to credit or debit
+        #   @param amount [String] Amount to credit or debit. Bounded to a `NUMERIC(38,28)` column, so the
         #
         #   @param entry_type [Symbol, Dodopayments::Models::CreditEntitlements::LedgerEntryType] Entry type: credit or debit
         #

data/lib/dodopayments/models/discount.rb

@@ -28,6 +28,12 @@ module Dodopayments
       #   @return [Time]
       required :created_at, Time
 
+      # @!attribute customer_eligibility
+      #   Who may redeem this discount code.
+      #
+      #   @return [Symbol, Dodopayments::Models::Discount::CustomerEligibility]
+      required :customer_eligibility, enum: -> { Dodopayments::Discount::CustomerEligibility }
+
       # @!attribute discount_id
       #   The unique discount ID
       #
@@ -60,11 +66,19 @@ module Dodopayments
       required :times_used, Integer
 
       # @!attribute type
-      #   The type of discount. Currently only `percentage` is supported.
+      #   The type of discount (`percentage` or `flat`).
       #
       #   @return [Symbol, Dodopayments::Models::DiscountType]
       required :type, enum: -> { Dodopayments::DiscountType }
 
+      # @!attribute currency_options
+      #   Per-currency options (flat deduction / percentage cap + minimum subtotal). Empty
+      #   for discounts without any configured currency options.
+      #
+      #   @return [Array<Dodopayments::Models::Discount::CurrencyOption>, nil]
+      optional :currency_options,
+               -> { Dodopayments::Internal::Type::ArrayOf[Dodopayments::Discount::CurrencyOption] }
+
       # @!attribute expires_at
       #   Optional date/time after which discount is expired.
       #
@@ -77,6 +91,19 @@ module Dodopayments
       #   @return [String, nil]
       optional :name, String, nil?: true
 
+      # @!attribute per_customer_usage_limit
+      #   Maximum number of times a single customer may redeem this discount, if any.
+      #
+      #   @return [Integer, nil]
+      optional :per_customer_usage_limit, Integer, nil?: true
+
+      # @!attribute starts_at
+      #   Optional date/time before which the discount is not yet active. NULL = active
+      #   immediately.
+      #
+      #   @return [Time, nil]
+      optional :starts_at, Time, nil?: true
+
       # @!attribute subscription_cycles
       #   Number of subscription billing cycles this discount is valid for. If not
       #   provided, the discount will be applied indefinitely to all recurring payments
@@ -91,7 +118,7 @@ module Dodopayments
       #   @return [Integer, nil]
       optional :usage_limit, Integer, nil?: true
 
-      # @!method initialize(amount:, business_id:, code:, created_at:, discount_id:, metadata:, preserve_on_plan_change:, restricted_to:, times_used:, type:, expires_at: nil, name: nil, subscription_cycles: nil, usage_limit: nil)
+      # @!method initialize(amount:, business_id:, code:, created_at:, customer_eligibility:, discount_id:, metadata:, preserve_on_plan_change:, restricted_to:, times_used:, type:, currency_options: nil, expires_at: nil, name: nil, per_customer_usage_limit: nil, starts_at: nil, subscription_cycles: nil, usage_limit: nil)
       #   Some parameter documentations has been truncated, see
       #   {Dodopayments::Models::Discount} for more details.
       #
@@ -103,6 +130,8 @@ module Dodopayments
       #
       #   @param created_at [Time] Timestamp when the discount is created
       #
+      #   @param customer_eligibility [Symbol, Dodopayments::Models::Discount::CustomerEligibility] Who may redeem this discount code.
+      #
       #   @param discount_id [String] The unique discount ID
       #
       #   @param metadata [Hash{Symbol=>String, Float, Boolean}] Arbitrary key-value metadata. Values can be string, integer, number, or boolean.
@@ -113,15 +142,78 @@ module Dodopayments
       #
       #   @param times_used [Integer] How many times this discount has been used.
       #
-      #   @param type [Symbol, Dodopayments::Models::DiscountType] The type of discount. Currently only `percentage` is supported.
+      #   @param type [Symbol, Dodopayments::Models::DiscountType] The type of discount (`percentage` or `flat`).
+      #
+      #   @param currency_options [Array<Dodopayments::Models::Discount::CurrencyOption>] Per-currency options (flat deduction / percentage cap + minimum subtotal).
       #
       #   @param expires_at [Time, nil] Optional date/time after which discount is expired.
       #
       #   @param name [String, nil] Name for the Discount
       #
+      #   @param per_customer_usage_limit [Integer, nil] Maximum number of times a single customer may redeem this discount, if any.
+      #
+      #   @param starts_at [Time, nil] Optional date/time before which the discount is not yet active. NULL = active im
+      #
       #   @param subscription_cycles [Integer, nil] Number of subscription billing cycles this discount is valid for.
       #
       #   @param usage_limit [Integer, nil] Usage limit for this discount, if any.
+
+      # Who may redeem this discount code.
+      #
+      # @see Dodopayments::Models::Discount#customer_eligibility
+      module CustomerEligibility
+        extend Dodopayments::Internal::Type::Enum
+
+        ANY = :any
+        FIRST_TIME = :first_time
+        EXISTING = :existing
+        SPECIFIC = :specific
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      class CurrencyOption < Dodopayments::Internal::Type::BaseModel
+        # @!attribute currency
+        #   The currency this option applies to.
+        #
+        #   @return [Symbol, Dodopayments::Models::Currency]
+        required :currency, enum: -> { Dodopayments::Currency }
+
+        # @!attribute is_default
+        #   Whether this is the default row FX conversions pivot from.
+        #
+        #   @return [Boolean]
+        required :is_default, Dodopayments::Internal::Type::Boolean
+
+        # @!attribute minimum_subtotal
+        #   Eligible-cart threshold in this currency's subunits (0 = no minimum).
+        #
+        #   @return [Integer]
+        required :minimum_subtotal, Integer
+
+        # @!attribute max_amount_possible
+        #   The most this code discounts in this currency's subunits (flat deduction or
+        #   percentage cap).
+        #
+        #   @return [Integer, nil]
+        optional :max_amount_possible, Integer, nil?: true
+
+        # @!method initialize(currency:, is_default:, minimum_subtotal:, max_amount_possible: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Dodopayments::Models::Discount::CurrencyOption} for more details.
+        #
+        #   A per-currency discount option (response shape). `max_amount_possible` mirrors
+        #   the DB column of the same name.
+        #
+        #   @param currency [Symbol, Dodopayments::Models::Currency] The currency this option applies to.
+        #
+        #   @param is_default [Boolean] Whether this is the default row FX conversions pivot from.
+        #
+        #   @param minimum_subtotal [Integer] Eligible-cart threshold in this currency's subunits (0 = no minimum).
+        #
+        #   @param max_amount_possible [Integer, nil] The most this code discounts in this currency's subunits (flat deduction
+      end
     end
   end
 end

data/lib/dodopayments/models/discount_create_params.rb

@@ -17,7 +17,7 @@ module Dodopayments
       required :amount, Integer
 
       # @!attribute type
-      #   The discount type. Currently only `percentage` is supported.
+      #   The discount type: `percentage` or `flat` (`flat_per_unit` stays blocked).
       #
       #   @return [Symbol, Dodopayments::Models::DiscountType]
       required :type, enum: -> { Dodopayments::DiscountType }
@@ -31,6 +31,29 @@ module Dodopayments
       #   @return [String, nil]
       optional :code, String, nil?: true
 
+      # @!attribute currency_options
+      #   Per-currency options (flat deduction / percentage cap + minimum subtotal).
+      #   Required for `flat` codes (must include a resolvable default); optional
+      #   per-currency caps for `percentage` codes. Per-row invariants are checked in
+      #   `normalize_currency_options`, not via `#[validate(nested)]`.
+      #
+      #   @return [Array<Dodopayments::Models::DiscountCreateParams::CurrencyOption>, nil]
+      optional :currency_options,
+               -> {
+                 Dodopayments::Internal::Type::ArrayOf[Dodopayments::DiscountCreateParams::CurrencyOption]
+               },
+               nil?: true
+
+      # @!attribute customer_eligibility
+      #   Who may redeem this discount code. Defaults to `any` (unrestricted). `specific`
+      #   starts with zero attached customers (fails closed) until customers are attached
+      #   via `POST /discounts/{id}/customers`.
+      #
+      #   @return [Symbol, Dodopayments::Models::DiscountCreateParams::CustomerEligibility, nil]
+      optional :customer_eligibility,
+               enum: -> { Dodopayments::DiscountCreateParams::CustomerEligibility },
+               nil?: true
+
       # @!attribute expires_at
       #   When the discount expires, if ever.
       #
@@ -48,6 +71,13 @@ module Dodopayments
       #   @return [String, nil]
       optional :name, String, nil?: true
 
+      # @!attribute per_customer_usage_limit
+      #   Maximum number of times a single customer may redeem this discount. Must be
+      #   `<= usage_limit` when both are set.
+      #
+      #   @return [Integer, nil]
+      optional :per_customer_usage_limit, Integer, nil?: true
+
       # @!attribute preserve_on_plan_change
       #   Whether this discount should be preserved when a subscription changes plans.
       #   Default: false (discount is removed on plan change)
@@ -61,6 +91,13 @@ module Dodopayments
       #   @return [Array<String>, nil]
       optional :restricted_to, Dodopayments::Internal::Type::ArrayOf[String], nil?: true
 
+      # @!attribute starts_at
+      #   When the discount becomes active, if scheduled for the future. NULL = active
+      #   immediately. Must be strictly before `expires_at` when both are set.
+      #
+      #   @return [Time, nil]
+      optional :starts_at, Time, nil?: true
+
       # @!attribute subscription_cycles
       #   Number of subscription billing cycles this discount is valid for. If not
       #   provided, the discount will be applied indefinitely to all recurring payments
@@ -75,31 +112,101 @@ module Dodopayments
       #   @return [Integer, nil]
       optional :usage_limit, Integer, nil?: true
 
-      # @!method initialize(amount:, type:, code: nil, expires_at: nil, metadata: nil, name: nil, preserve_on_plan_change: nil, restricted_to: nil, subscription_cycles: nil, usage_limit: nil, request_options: {})
+      # @!method initialize(amount:, type:, code: nil, currency_options: nil, customer_eligibility: nil, expires_at: nil, metadata: nil, name: nil, per_customer_usage_limit: nil, preserve_on_plan_change: nil, restricted_to: nil, starts_at: nil, subscription_cycles: nil, usage_limit: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Dodopayments::Models::DiscountCreateParams} for more details.
       #
       #   @param amount [Integer] The discount amount in **basis points** (e.g. `540` means `5.4%`, `10000` means
       #
-      #   @param type [Symbol, Dodopayments::Models::DiscountType] The discount type. Currently only `percentage` is supported.
+      #   @param type [Symbol, Dodopayments::Models::DiscountType] The discount type: `percentage` or `flat` (`flat_per_unit` stays blocked).
       #
       #   @param code [String, nil] Optionally supply a code (will be uppercased).
       #
+      #   @param currency_options [Array<Dodopayments::Models::DiscountCreateParams::CurrencyOption>, nil] Per-currency options (flat deduction / percentage cap + minimum subtotal).
+      #
+      #   @param customer_eligibility [Symbol, Dodopayments::Models::DiscountCreateParams::CustomerEligibility, nil] Who may redeem this discount code. Defaults to `any` (unrestricted).
+      #
       #   @param expires_at [Time, nil] When the discount expires, if ever.
       #
       #   @param metadata [Hash{Symbol=>String, Float, Boolean}] Additional metadata for the discount
       #
       #   @param name [String, nil]
       #
+      #   @param per_customer_usage_limit [Integer, nil] Maximum number of times a single customer may redeem this discount.
+      #
       #   @param preserve_on_plan_change [Boolean] Whether this discount should be preserved when a subscription changes plans.
       #
       #   @param restricted_to [Array<String>, nil] List of product IDs to restrict usage (if any).
       #
+      #   @param starts_at [Time, nil] When the discount becomes active, if scheduled for the future.
+      #
       #   @param subscription_cycles [Integer, nil] Number of subscription billing cycles this discount is valid for.
       #
       #   @param usage_limit [Integer, nil] How many times this discount can be used (if any).
       #
       #   @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]
+
+      class CurrencyOption < Dodopayments::Internal::Type::BaseModel
+        # @!attribute currency
+        #   The currency this option applies to.
+        #
+        #   @return [Symbol, Dodopayments::Models::Currency]
+        required :currency, enum: -> { Dodopayments::Currency }
+
+        # @!attribute is_default
+        #   Whether this row is the default to convert from for unconfigured currencies. At
+        #   most one row per discount may be default.
+        #
+        #   @return [Boolean, nil]
+        optional :is_default, Dodopayments::Internal::Type::Boolean
+
+        # @!attribute max_amount_possible
+        #   The most this code discounts in this currency's subunits. For `flat` codes this
+        #   is the deduction; for `percentage` codes it is the max-discount cap. Must be > 0
+        #   if provided.
+        #
+        #   @return [Integer, nil]
+        optional :max_amount_possible, Integer, nil?: true
+
+        # @!attribute minimum_subtotal
+        #   Eligible-cart threshold in this currency's subunits (0 = no minimum).
+        #
+        #   @return [Integer, nil]
+        optional :minimum_subtotal, Integer
+
+        # @!method initialize(currency:, is_default: nil, max_amount_possible: nil, minimum_subtotal: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Dodopayments::Models::DiscountCreateParams::CurrencyOption} for more details.
+        #
+        #   A per-currency discount option (request shape).
+        #
+        #   `max_amount_possible` is the most this code discounts in this currency — the
+        #   flat deduction for `flat` codes, or the max-discount cap for `percentage` codes.
+        #   Maps to the DB column of the same name.
+        #
+        #   @param currency [Symbol, Dodopayments::Models::Currency] The currency this option applies to.
+        #
+        #   @param is_default [Boolean] Whether this row is the default to convert from for unconfigured
+        #
+        #   @param max_amount_possible [Integer, nil] The most this code discounts in this currency's subunits. For `flat` codes
+        #
+        #   @param minimum_subtotal [Integer] Eligible-cart threshold in this currency's subunits (0 = no minimum).
+      end
+
+      # Who may redeem this discount code. Defaults to `any` (unrestricted). `specific`
+      # starts with zero attached customers (fails closed) until customers are attached
+      # via `POST /discounts/{id}/customers`.
+      module CustomerEligibility
+        extend Dodopayments::Internal::Type::Enum
+
+        ANY = :any
+        FIRST_TIME = :first_time
+        EXISTING = :existing
+        SPECIFIC = :specific
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
     end
   end
 end

data/lib/dodopayments/models/discount_list_params.rb

@@ -8,7 +8,9 @@ module Dodopayments
       include Dodopayments::Internal::Type::RequestParameters
 
       # @!attribute active
-      #   Filter by active status (true = not expired, false = expired)
+      #   Filter by active status. `true` = currently redeemable (started, not expired,
+      #   not usage-exhausted). `false` = not currently redeemable (expired,
+      #   usage-exhausted, or pending a future `starts_at`).
       #
       #   @return [Boolean, nil]
       optional :active, Dodopayments::Internal::Type::Boolean
@@ -44,7 +46,10 @@ module Dodopayments
       optional :product_id, String
 
       # @!method initialize(active: nil, code: nil, discount_type: nil, page_number: nil, page_size: nil, product_id: nil, request_options: {})
-      #   @param active [Boolean] Filter by active status (true = not expired, false = expired)
+      #   Some parameter documentations has been truncated, see
+      #   {Dodopayments::Models::DiscountListParams} for more details.
+      #
+      #   @param active [Boolean] Filter by active status. `true` = currently redeemable (started, not
       #
       #   @param code [String] Filter by discount code (partial match, case-insensitive)
       #

data/lib/dodopayments/models/discount_type.rb

@@ -5,6 +5,7 @@ module Dodopayments
     module DiscountType
       extend Dodopayments::Internal::Type::Enum
 
+      FLAT = :flat
       PERCENTAGE = :percentage
 
       # @!method self.values

data/lib/dodopayments/models/discount_update_params.rb

@@ -27,6 +27,27 @@ module Dodopayments
       #   @return [String, nil]
       optional :code, String, nil?: true
 
+      # @!attribute currency_options
+      #   If present, fully replaces the discount's currency options (replace-set
+      #   semantics, like `restricted_to`). Send an empty array to clear them.
+      #
+      #   @return [Array<Dodopayments::Models::DiscountUpdateParams::CurrencyOption>, nil]
+      optional :currency_options,
+               -> {
+                 Dodopayments::Internal::Type::ArrayOf[Dodopayments::DiscountUpdateParams::CurrencyOption]
+               },
+               nil?: true
+
+      # @!attribute customer_eligibility
+      #   If present, update who may redeem this discount. Plain field (not
+      #   double-option): the DB column is `NOT NULL`, so it can never be cleared back to
+      #   unset, only changed to another `CustomerEligibility` value.
+      #
+      #   @return [Symbol, Dodopayments::Models::DiscountUpdateParams::CustomerEligibility, nil]
+      optional :customer_eligibility,
+               enum: -> { Dodopayments::DiscountUpdateParams::CustomerEligibility },
+               nil?: true
+
       # @!attribute expires_at
       #
       #   @return [Time, nil]
@@ -45,6 +66,14 @@ module Dodopayments
       #   @return [String, nil]
       optional :name, String, nil?: true
 
+      # @!attribute per_customer_usage_limit
+      #   If present, update the per-customer usage limit (double-option: send `null` to
+      #   clear it back to unlimited). Must be `<= usage_limit` (the value in effect after
+      #   this patch) when both are set.
+      #
+      #   @return [Integer, nil]
+      optional :per_customer_usage_limit, Integer, nil?: true
+
       # @!attribute preserve_on_plan_change
       #   Whether this discount should be preserved when a subscription changes plans. If
       #   not provided, the existing value is kept.
@@ -59,6 +88,12 @@ module Dodopayments
       #   @return [Array<String>, nil]
       optional :restricted_to, Dodopayments::Internal::Type::ArrayOf[String], nil?: true
 
+      # @!attribute starts_at
+      #   If present, update `starts_at` (double-option: send `null` to clear it).
+      #
+      #   @return [Time, nil]
+      optional :starts_at, Time, nil?: true
+
       # @!attribute subscription_cycles
       #   Number of subscription billing cycles this discount is valid for. If not
       #   provided, the discount will be applied indefinitely to all recurring payments
@@ -68,7 +103,7 @@ module Dodopayments
       optional :subscription_cycles, Integer, nil?: true
 
       # @!attribute type
-      #   If present, update the discount type. Currently only `percentage` is supported.
+      #   If present, update the discount type (`percentage` or `flat`).
       #
       #   @return [Symbol, Dodopayments::Models::DiscountType, nil]
       optional :type, enum: -> { Dodopayments::DiscountType }, nil?: true
@@ -78,7 +113,7 @@ module Dodopayments
       #   @return [Integer, nil]
       optional :usage_limit, Integer, nil?: true
 
-      # @!method initialize(discount_id:, amount: nil, code: nil, expires_at: nil, metadata: nil, name: nil, preserve_on_plan_change: nil, restricted_to: nil, subscription_cycles: nil, type: nil, usage_limit: nil, request_options: {})
+      # @!method initialize(discount_id:, amount: nil, code: nil, currency_options: nil, customer_eligibility: nil, expires_at: nil, metadata: nil, name: nil, per_customer_usage_limit: nil, preserve_on_plan_change: nil, restricted_to: nil, starts_at: nil, subscription_cycles: nil, type: nil, usage_limit: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Dodopayments::Models::DiscountUpdateParams} for more details.
       #
@@ -88,23 +123,93 @@ module Dodopayments
       #
       #   @param code [String, nil] If present, update the discount code (uppercase).
       #
+      #   @param currency_options [Array<Dodopayments::Models::DiscountUpdateParams::CurrencyOption>, nil] If present, fully replaces the discount's currency options (replace-set
+      #
+      #   @param customer_eligibility [Symbol, Dodopayments::Models::DiscountUpdateParams::CustomerEligibility, nil] If present, update who may redeem this discount. Plain field (not
+      #
       #   @param expires_at [Time, nil]
       #
       #   @param metadata [Hash{Symbol=>String, Float, Boolean}, nil] Additional metadata for the discount
       #
       #   @param name [String, nil]
       #
+      #   @param per_customer_usage_limit [Integer, nil] If present, update the per-customer usage limit (double-option: send
+      #
       #   @param preserve_on_plan_change [Boolean, nil] Whether this discount should be preserved when a subscription changes plans.
       #
       #   @param restricted_to [Array<String>, nil] If present, replaces all restricted product IDs with this new set.
       #
+      #   @param starts_at [Time, nil] If present, update `starts_at` (double-option: send `null` to clear it).
+      #
       #   @param subscription_cycles [Integer, nil] Number of subscription billing cycles this discount is valid for.
       #
-      #   @param type [Symbol, Dodopayments::Models::DiscountType, nil] If present, update the discount type. Currently only `percentage` is supported.
+      #   @param type [Symbol, Dodopayments::Models::DiscountType, nil] If present, update the discount type (`percentage` or `flat`).
       #
       #   @param usage_limit [Integer, nil]
       #
       #   @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]
+
+      class CurrencyOption < Dodopayments::Internal::Type::BaseModel
+        # @!attribute currency
+        #   The currency this option applies to.
+        #
+        #   @return [Symbol, Dodopayments::Models::Currency]
+        required :currency, enum: -> { Dodopayments::Currency }
+
+        # @!attribute is_default
+        #   Whether this row is the default to convert from for unconfigured currencies. At
+        #   most one row per discount may be default.
+        #
+        #   @return [Boolean, nil]
+        optional :is_default, Dodopayments::Internal::Type::Boolean
+
+        # @!attribute max_amount_possible
+        #   The most this code discounts in this currency's subunits. For `flat` codes this
+        #   is the deduction; for `percentage` codes it is the max-discount cap. Must be > 0
+        #   if provided.
+        #
+        #   @return [Integer, nil]
+        optional :max_amount_possible, Integer, nil?: true
+
+        # @!attribute minimum_subtotal
+        #   Eligible-cart threshold in this currency's subunits (0 = no minimum).
+        #
+        #   @return [Integer, nil]
+        optional :minimum_subtotal, Integer
+
+        # @!method initialize(currency:, is_default: nil, max_amount_possible: nil, minimum_subtotal: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Dodopayments::Models::DiscountUpdateParams::CurrencyOption} for more details.
+        #
+        #   A per-currency discount option (request shape).
+        #
+        #   `max_amount_possible` is the most this code discounts in this currency — the
+        #   flat deduction for `flat` codes, or the max-discount cap for `percentage` codes.
+        #   Maps to the DB column of the same name.
+        #
+        #   @param currency [Symbol, Dodopayments::Models::Currency] The currency this option applies to.
+        #
+        #   @param is_default [Boolean] Whether this row is the default to convert from for unconfigured
+        #
+        #   @param max_amount_possible [Integer, nil] The most this code discounts in this currency's subunits. For `flat` codes
+        #
+        #   @param minimum_subtotal [Integer] Eligible-cart threshold in this currency's subunits (0 = no minimum).
+      end
+
+      # If present, update who may redeem this discount. Plain field (not
+      # double-option): the DB column is `NOT NULL`, so it can never be cleared back to
+      # unset, only changed to another `CustomerEligibility` value.
+      module CustomerEligibility
+        extend Dodopayments::Internal::Type::Enum
+
+        ANY = :any
+        FIRST_TIME = :first_time
+        EXISTING = :existing
+        SPECIFIC = :specific
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
     end
   end
 end