dodopayments 2.20.1 → 2.21.0

data/lib/dodopayments/models/payment.rb

@@ -189,6 +189,16 @@ module Dodopayments
       #   @return [String, nil]
       optional :error_message, String, nil?: true
 
+      # @!attribute failure_details
+      #   Purpose-built failure messaging for the merchant and the customer, derived from
+      #   `error_code`. Present whenever `error_code` is set, regardless of payment
+      #   status; unrecognised codes still resolve via a generic fallback rather than
+      #   being omitted. The customer copy is always generic for fraud-sensitive declines
+      #   (lost/stolen/pickup/fraudulent) so the true reason is never leaked.
+      #
+      #   @return [Dodopayments::Models::Payment::FailureDetails, nil]
+      optional :failure_details, -> { Dodopayments::Payment::FailureDetails }, nil?: true
+
       # @!attribute invoice_id
       #   Invoice ID for this payment. Uses India-specific invoice ID if available.
       #
@@ -273,7 +283,7 @@ module Dodopayments
       #   @return [Time, nil]
       optional :updated_at, Time, nil?: true
 
-      # @!method initialize(billing:, brand_id:, business_id:, created_at:, currency:, customer:, digital_products_delivered:, disputes:, is_update_payment_method:, metadata:, payment_id:, payment_provider:, refunds:, retry_attempt:, settlement_amount:, settlement_currency:, total_amount:, card_holder_name: nil, card_issuing_country: nil, card_last_four: nil, card_network: nil, card_type: nil, checkout_session_id: nil, custom_field_responses: nil, discount_id: nil, discounts: nil, error_code: nil, error_message: nil, invoice_id: nil, invoice_url: nil, payment_link: nil, payment_method: nil, payment_method_id: nil, payment_method_type: nil, product_cart: nil, refund_status: nil, settlement_tax: nil, status: nil, subscription_id: nil, tax: nil, updated_at: nil)
+      # @!method initialize(billing:, brand_id:, business_id:, created_at:, currency:, customer:, digital_products_delivered:, disputes:, is_update_payment_method:, metadata:, payment_id:, payment_provider:, refunds:, retry_attempt:, settlement_amount:, settlement_currency:, total_amount:, card_holder_name: nil, card_issuing_country: nil, card_last_four: nil, card_network: nil, card_type: nil, checkout_session_id: nil, custom_field_responses: nil, discount_id: nil, discounts: nil, error_code: nil, error_message: nil, failure_details: nil, invoice_id: nil, invoice_url: nil, payment_link: nil, payment_method: nil, payment_method_id: nil, payment_method_type: nil, product_cart: nil, refund_status: nil, settlement_tax: nil, status: nil, subscription_id: nil, tax: nil, updated_at: nil)
       #   Some parameter documentations has been truncated, see
       #   {Dodopayments::Models::Payment} for more details.
       #
@@ -333,6 +343,8 @@ module Dodopayments
       #
       #   @param error_message [String, nil] An error message if the payment failed
       #
+      #   @param failure_details [Dodopayments::Models::Payment::FailureDetails, nil] Purpose-built failure messaging for the merchant and the customer, derived
+      #
       #   @param invoice_id [String, nil] Invoice ID for this payment. Uses India-specific invoice ID if available.
       #
       #   @param invoice_url [String, nil] URL to download the invoice PDF for this payment.
@@ -374,6 +386,138 @@ module Dodopayments
         #   @return [Array<Symbol>]
       end
 
+      # @see Dodopayments::Models::Payment#failure_details
+      class FailureDetails < Dodopayments::Internal::Type::BaseModel
+        # @!attribute code
+        #   The unified error code (echoes `error_code`).
+        #
+        #   @return [String]
+        required :code, String
+
+        # @!attribute customer_cta
+        #   The primary CTA to show the customer.
+        #
+        #   @return [Symbol, Dodopayments::Models::Payment::FailureDetails::CustomerCta]
+        required :customer_cta, enum: -> { Dodopayments::Payment::FailureDetails::CustomerCta }
+
+        # @!attribute customer_fixable
+        #   Whether the customer can resolve this themselves (e.g. fix CVC).
+        #
+        #   @return [Boolean]
+        required :customer_fixable, Dodopayments::Internal::Type::Boolean
+
+        # @!attribute customer_message
+        #   The customer-facing string. Always generic (`C11`) for the fraud-4.
+        #
+        #   @return [String]
+        required :customer_message, String
+
+        # @!attribute customer_template
+        #   The customer message template identifier (C1..C20).
+        #
+        #   @return [Symbol, Dodopayments::Models::Payment::FailureDetails::CustomerTemplate]
+        required :customer_template, enum: -> { Dodopayments::Payment::FailureDetails::CustomerTemplate }
+
+        # @!attribute decline_type
+        #   Soft or hard decline.
+        #
+        #   @return [Symbol, Dodopayments::Models::Payment::FailureDetails::DeclineType]
+        required :decline_type, enum: -> { Dodopayments::Payment::FailureDetails::DeclineType }
+
+        # @!attribute merchant_message
+        #   Merchant-facing headline + recommended action (Payment Details). For the fraud-4
+        #   this includes the operator "do not reveal" warning.
+        #
+        #   @return [String]
+        required :merchant_message, String
+
+        # @!method initialize(code:, customer_cta:, customer_fixable:, customer_message:, customer_template:, decline_type:, merchant_message:)
+        #   Some parameter documentations has been truncated, see
+        #   {Dodopayments::Models::Payment::FailureDetails} for more details.
+        #
+        #   Purpose-built failure messaging for the merchant and the customer, derived from
+        #   `error_code`. Present whenever `error_code` is set, regardless of payment
+        #   status; unrecognised codes still resolve via a generic fallback rather than
+        #   being omitted. The customer copy is always generic for fraud-sensitive declines
+        #   (lost/stolen/pickup/fraudulent) so the true reason is never leaked.
+        #
+        #   @param code [String] The unified error code (echoes `error_code`).
+        #
+        #   @param customer_cta [Symbol, Dodopayments::Models::Payment::FailureDetails::CustomerCta] The primary CTA to show the customer.
+        #
+        #   @param customer_fixable [Boolean] Whether the customer can resolve this themselves (e.g. fix CVC).
+        #
+        #   @param customer_message [String] The customer-facing string. Always generic (`C11`) for the fraud-4.
+        #
+        #   @param customer_template [Symbol, Dodopayments::Models::Payment::FailureDetails::CustomerTemplate] The customer message template identifier (C1..C20).
+        #
+        #   @param decline_type [Symbol, Dodopayments::Models::Payment::FailureDetails::DeclineType] Soft or hard decline.
+        #
+        #   @param merchant_message [String] Merchant-facing headline + recommended action (Payment Details). For the fraud-4
+
+        # The primary CTA to show the customer.
+        #
+        # @see Dodopayments::Models::Payment::FailureDetails#customer_cta
+        module CustomerCta
+          extend Dodopayments::Internal::Type::Enum
+
+          EDIT_AND_RETRY = :edit_and_retry
+          USE_ANOTHER_METHOD = :use_another_method
+          TRY_AGAIN = :try_again
+          TRY_LATER = :try_later
+          RETRY_AND_VERIFY = :retry_and_verify
+          RESTART = :restart
+          UPDATE_METHOD = :update_method
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # The customer message template identifier (C1..C20).
+        #
+        # @see Dodopayments::Models::Payment::FailureDetails#customer_template
+        module CustomerTemplate
+          extend Dodopayments::Internal::Type::Enum
+
+          C1 = :C1
+          C2 = :C2
+          C3 = :C3
+          C4 = :C4
+          C5 = :C5
+          C6 = :C6
+          C7 = :C7
+          C8 = :C8
+          C9 = :C9
+          C10 = :C10
+          C11 = :C11
+          C12 = :C12
+          C13 = :C13
+          C14 = :C14
+          C15 = :C15
+          C16 = :C16
+          C17 = :C17
+          C18 = :C18
+          C19 = :C19
+          C20 = :C20
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # Soft or hard decline.
+        #
+        # @see Dodopayments::Models::Payment::FailureDetails#decline_type
+        module DeclineType
+          extend Dodopayments::Internal::Type::Enum
+
+          SOFT = :soft
+          HARD = :hard
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+
       class ProductCart < Dodopayments::Internal::Type::BaseModel
         # @!attribute product_id
         #

data/lib/dodopayments/models/payment_list_params.rb

@@ -25,6 +25,12 @@ module Dodopayments
       #   @return [Time, nil]
       optional :created_at_lte, Time
 
+      # @!attribute currency
+      #   Filter by currency
+      #
+      #   @return [Symbol, Dodopayments::Models::PaymentListParams::Currency, nil]
+      optional :currency, enum: -> { Dodopayments::PaymentListParams::Currency }
+
       # @!attribute customer_id
       #   Filter by customer id
       #
@@ -61,13 +67,15 @@ module Dodopayments
       #   @return [String, nil]
       optional :subscription_id, String
 
-      # @!method initialize(brand_id: nil, created_at_gte: nil, created_at_lte: nil, customer_id: nil, page_number: nil, page_size: nil, product_id: nil, status: nil, subscription_id: nil, request_options: {})
+      # @!method initialize(brand_id: nil, created_at_gte: nil, created_at_lte: nil, currency: nil, customer_id: nil, page_number: nil, page_size: nil, product_id: nil, status: nil, subscription_id: nil, request_options: {})
       #   @param brand_id [String] filter by Brand id
       #
       #   @param created_at_gte [Time] Get events after this created time
       #
       #   @param created_at_lte [Time] Get events created before this time
       #
+      #   @param currency [Symbol, Dodopayments::Models::PaymentListParams::Currency] Filter by currency
+      #
       #   @param customer_id [String] Filter by customer id
       #
       #   @param page_number [Integer] Page number default is 0
@@ -82,6 +90,160 @@ module Dodopayments
       #
       #   @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]
 
+      # Filter by currency
+      module Currency
+        extend Dodopayments::Internal::Type::Enum
+
+        AED = :AED
+        ALL = :ALL
+        AMD = :AMD
+        ANG = :ANG
+        AOA = :AOA
+        ARS = :ARS
+        AUD = :AUD
+        AWG = :AWG
+        AZN = :AZN
+        BAM = :BAM
+        BBD = :BBD
+        BDT = :BDT
+        BGN = :BGN
+        BHD = :BHD
+        BIF = :BIF
+        BMD = :BMD
+        BND = :BND
+        BOB = :BOB
+        BRL = :BRL
+        BSD = :BSD
+        BWP = :BWP
+        BYN = :BYN
+        BZD = :BZD
+        CAD = :CAD
+        CHF = :CHF
+        CLP = :CLP
+        CNY = :CNY
+        COP = :COP
+        CRC = :CRC
+        CUP = :CUP
+        CVE = :CVE
+        CZK = :CZK
+        DJF = :DJF
+        DKK = :DKK
+        DOP = :DOP
+        DZD = :DZD
+        EGP = :EGP
+        ETB = :ETB
+        EUR = :EUR
+        FJD = :FJD
+        FKP = :FKP
+        GBP = :GBP
+        GEL = :GEL
+        GHS = :GHS
+        GIP = :GIP
+        GMD = :GMD
+        GNF = :GNF
+        GTQ = :GTQ
+        GYD = :GYD
+        HKD = :HKD
+        HNL = :HNL
+        HRK = :HRK
+        HTG = :HTG
+        HUF = :HUF
+        IDR = :IDR
+        ILS = :ILS
+        INR = :INR
+        IQD = :IQD
+        JMD = :JMD
+        JOD = :JOD
+        JPY = :JPY
+        KES = :KES
+        KGS = :KGS
+        KHR = :KHR
+        KMF = :KMF
+        KRW = :KRW
+        KWD = :KWD
+        KYD = :KYD
+        KZT = :KZT
+        LAK = :LAK
+        LBP = :LBP
+        LKR = :LKR
+        LRD = :LRD
+        LSL = :LSL
+        LYD = :LYD
+        MAD = :MAD
+        MDL = :MDL
+        MGA = :MGA
+        MKD = :MKD
+        MMK = :MMK
+        MNT = :MNT
+        MOP = :MOP
+        MRU = :MRU
+        MUR = :MUR
+        MVR = :MVR
+        MWK = :MWK
+        MXN = :MXN
+        MYR = :MYR
+        MZN = :MZN
+        NAD = :NAD
+        NGN = :NGN
+        NIO = :NIO
+        NOK = :NOK
+        NPR = :NPR
+        NZD = :NZD
+        OMR = :OMR
+        PAB = :PAB
+        PEN = :PEN
+        PGK = :PGK
+        PHP = :PHP
+        PKR = :PKR
+        PLN = :PLN
+        PYG = :PYG
+        QAR = :QAR
+        RON = :RON
+        RSD = :RSD
+        RUB = :RUB
+        RWF = :RWF
+        SAR = :SAR
+        SBD = :SBD
+        SCR = :SCR
+        SEK = :SEK
+        SGD = :SGD
+        SHP = :SHP
+        SLE = :SLE
+        SLL = :SLL
+        SOS = :SOS
+        SRD = :SRD
+        SSP = :SSP
+        STN = :STN
+        SVC = :SVC
+        SZL = :SZL
+        THB = :THB
+        TND = :TND
+        TOP = :TOP
+        TRY = :TRY
+        TTD = :TTD
+        TWD = :TWD
+        TZS = :TZS
+        UAH = :UAH
+        UGX = :UGX
+        USD = :USD
+        UYU = :UYU
+        UZS = :UZS
+        VES = :VES
+        VND = :VND
+        VUV = :VUV
+        WST = :WST
+        XAF = :XAF
+        XCD = :XCD
+        XOF = :XOF
+        XPF = :XPF
+        YER = :YER
+        ZAR = :ZAR
+        ZMW = :ZMW
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
       # Filter by status
       module Status
         extend Dodopayments::Internal::Type::Enum

data/lib/dodopayments/models/payment_method_types.rb

@@ -85,7 +85,6 @@ module Dodopayments
       SEPA = :sepa
       SEPA_BANK_TRANSFER = :sepa_bank_transfer
       SOFORT = :sofort
-      SUNBIT = :sunbit
       SWISH = :swish
       TOUCH_N_GO = :touch_n_go
       TRUSTLY = :trustly

data/lib/dodopayments/models/price.rb

@@ -160,13 +160,27 @@ module Dodopayments
         #   @return [Boolean, nil]
         optional :tax_inclusive, Dodopayments::Internal::Type::Boolean, nil?: true
 
+        # @!attribute trial_amount
+        #   Amount charged today for a paid trial, in the price currency's minor units.
+        #   Requires `trial_period_days > 0`. Omit or null for a free trial (the default).
+        #
+        #   @return [Integer, nil]
+        optional :trial_amount, Integer, nil?: true
+
+        # @!attribute trial_apply_discounts
+        #   Whether discount codes reduce the trial charge. Defaults to false. Only
+        #   meaningful when a paid trial is configured.
+        #
+        #   @return [Boolean, nil]
+        optional :trial_apply_discounts, Dodopayments::Internal::Type::Boolean, nil?: true
+
         # @!attribute trial_period_days
         #   Number of days for the trial period. A value of `0` indicates no trial period.
         #
         #   @return [Integer, nil]
         optional :trial_period_days, Integer
 
-        # @!method initialize(currency:, discount:, payment_frequency_count:, payment_frequency_interval:, price:, purchasing_power_parity:, subscription_period_count:, subscription_period_interval:, tax_inclusive: nil, trial_period_days: nil, type: :recurring_price)
+        # @!method initialize(currency:, discount:, payment_frequency_count:, payment_frequency_interval:, price:, purchasing_power_parity:, subscription_period_count:, subscription_period_interval:, tax_inclusive: nil, trial_amount: nil, trial_apply_discounts: nil, trial_period_days: nil, type: :recurring_price)
         #   Some parameter documentations has been truncated, see
         #   {Dodopayments::Models::Price::RecurringPrice} for more details.
         #
@@ -190,6 +204,10 @@ module Dodopayments
         #
         #   @param tax_inclusive [Boolean, nil] Indicates if the price is tax inclusive
         #
+        #   @param trial_amount [Integer, nil] Amount charged today for a paid trial, in the price currency's minor units.
+        #
+        #   @param trial_apply_discounts [Boolean, nil] Whether discount codes reduce the trial charge. Defaults to false. Only meaningf
+        #
         #   @param trial_period_days [Integer] Number of days for the trial period. A value of `0` indicates no trial period.
         #
         #   @param type [Symbol, :recurring_price]

data/lib/dodopayments/models/subscription.rb

@@ -235,7 +235,15 @@ module Dodopayments
       #   @return [String, nil]
       optional :tax_id, String, nil?: true
 
-      # @!method initialize(addons:, billing:, brand_id:, cancel_at_next_billing_date:, created_at:, credit_entitlement_cart:, currency:, customer:, metadata:, meter_credit_entitlement_cart:, meters:, next_billing_date:, on_demand:, payment_frequency_count:, payment_frequency_interval:, previous_billing_date:, product_id:, quantity:, recurring_pre_tax_amount:, status:, subscription_id:, subscription_period_count:, subscription_period_interval:, tax_inclusive:, trial_period_days:, cancellation_comment: nil, cancellation_feedback: nil, cancelled_at: nil, custom_field_responses: nil, customer_business_name: nil, discount_cycles_remaining: nil, discount_id: nil, discounts: nil, expires_at: nil, payment_method_id: nil, scheduled_change: nil, tax_id: nil)
+      # @!attribute trial_amount
+      #   Per-unit trial amount after discounts, snapshotted at subscription creation
+      #   (price currency minor units, pre-quantity, pre-tax). Null for a free trial or no
+      #   trial.
+      #
+      #   @return [Integer, nil]
+      optional :trial_amount, Integer, nil?: true
+
+      # @!method initialize(addons:, billing:, brand_id:, cancel_at_next_billing_date:, created_at:, credit_entitlement_cart:, currency:, customer:, metadata:, meter_credit_entitlement_cart:, meters:, next_billing_date:, on_demand:, payment_frequency_count:, payment_frequency_interval:, previous_billing_date:, product_id:, quantity:, recurring_pre_tax_amount:, status:, subscription_id:, subscription_period_count:, subscription_period_interval:, tax_inclusive:, trial_period_days:, cancellation_comment: nil, cancellation_feedback: nil, cancelled_at: nil, custom_field_responses: nil, customer_business_name: nil, discount_cycles_remaining: nil, discount_id: nil, discounts: nil, expires_at: nil, payment_method_id: nil, scheduled_change: nil, tax_id: nil, trial_amount: nil)
       #   Some parameter documentations has been truncated, see
       #   {Dodopayments::Models::Subscription} for more details.
       #
@@ -314,6 +322,8 @@ module Dodopayments
       #   @param scheduled_change [Dodopayments::Models::ScheduledPlanChange, nil] Scheduled plan change details, if any
       #
       #   @param tax_id [String, nil] Tax identifier provided for this subscription (if applicable)
+      #
+      #   @param trial_amount [Integer, nil] Per-unit trial amount after discounts, snapshotted at subscription creation
     end
   end
 end

data/lib/dodopayments/models/subscription_create_response.rb

@@ -83,7 +83,14 @@ module Dodopayments
       #   @return [String, nil]
       optional :payment_link, String, nil?: true
 
-      # @!method initialize(addons:, customer:, metadata:, payment_id:, recurring_pre_tax_amount:, subscription_id:, client_secret: nil, discount_id: nil, discount_ids: nil, expires_on: nil, one_time_product_cart: nil, payment_link: nil)
+      # @!attribute trial_amount
+      #   Per-unit trial amount after discounts, in the price currency's minor units
+      #   (pre-quantity, pre-tax). Null for a free trial or no trial.
+      #
+      #   @return [Integer, nil]
+      optional :trial_amount, Integer, nil?: true
+
+      # @!method initialize(addons:, customer:, metadata:, payment_id:, recurring_pre_tax_amount:, subscription_id:, client_secret: nil, discount_id: nil, discount_ids: nil, expires_on: nil, one_time_product_cart: nil, payment_link: nil, trial_amount: nil)
       #   Some parameter documentations has been truncated, see
       #   {Dodopayments::Models::SubscriptionCreateResponse} for more details.
       #
@@ -110,6 +117,8 @@ module Dodopayments
       #   @param one_time_product_cart [Array<Dodopayments::Models::SubscriptionCreateResponse::OneTimeProductCart>, nil] One time products associated with the purchase of subscription
       #
       #   @param payment_link [String, nil] URL to checkout page
+      #
+      #   @param trial_amount [Integer, nil] Per-unit trial amount after discounts, in the price currency's minor units
 
       class OneTimeProductCart < Dodopayments::Internal::Type::BaseModel
         # @!attribute product_id

data/lib/dodopayments/models/subscription_list_response.rb

@@ -182,7 +182,15 @@ module Dodopayments
       #   @return [String, nil]
       optional :tax_id, String, nil?: true
 
-      # @!method initialize(billing:, cancel_at_next_billing_date:, created_at:, currency:, customer:, discounts:, metadata:, next_billing_date:, on_demand:, payment_frequency_count:, payment_frequency_interval:, previous_billing_date:, product_id:, quantity:, recurring_pre_tax_amount:, status:, subscription_id:, subscription_period_count:, subscription_period_interval:, tax_inclusive:, trial_period_days:, cancelled_at: nil, customer_business_name: nil, discount_cycles_remaining: nil, discount_id: nil, payment_method_id: nil, product_name: nil, scheduled_change: nil, tax_id: nil)
+      # @!attribute trial_amount
+      #   Per-unit trial amount after discounts, snapshotted at subscription creation
+      #   (price currency minor units, pre-quantity, pre-tax). Null for a free trial or no
+      #   trial.
+      #
+      #   @return [Integer, nil]
+      optional :trial_amount, Integer, nil?: true
+
+      # @!method initialize(billing:, cancel_at_next_billing_date:, created_at:, currency:, customer:, discounts:, metadata:, next_billing_date:, on_demand:, payment_frequency_count:, payment_frequency_interval:, previous_billing_date:, product_id:, quantity:, recurring_pre_tax_amount:, status:, subscription_id:, subscription_period_count:, subscription_period_interval:, tax_inclusive:, trial_period_days:, cancelled_at: nil, customer_business_name: nil, discount_cycles_remaining: nil, discount_id: nil, payment_method_id: nil, product_name: nil, scheduled_change: nil, tax_id: nil, trial_amount: nil)
       #   Some parameter documentations has been truncated, see
       #   {Dodopayments::Models::SubscriptionListResponse} for more details.
       #
@@ -245,6 +253,8 @@ module Dodopayments
       #   @param scheduled_change [Dodopayments::Models::ScheduledPlanChange, nil] Scheduled plan change details, if any
       #
       #   @param tax_id [String, nil] Tax identifier provided for this subscription (if applicable)
+      #
+      #   @param trial_amount [Integer, nil] Per-unit trial amount after discounts, snapshotted at subscription creation
 
       class Discount < Dodopayments::Internal::Type::BaseModel
         # @!attribute discount_id

data/lib/dodopayments/resources/credit_entitlements/balances.rb

@@ -136,7 +136,7 @@ module Dodopayments
         #
         # @param credit_entitlement_id [String] Path param: Credit Entitlement ID
         #
-        # @param amount [String] Body param: Amount to credit or debit
+        # @param amount [String] Body param: Amount to credit or debit. Bounded to a `NUMERIC(38,28)` column, so
         #
         # @param entry_type [Symbol, Dodopayments::Models::CreditEntitlements::LedgerEntryType] Body param: Entry type: credit or debit
         #

data/lib/dodopayments/resources/discounts.rb

@@ -9,24 +9,32 @@ module Dodopayments
       # POST /discounts If `code` is omitted or empty, a random 16-char uppercase code
       # is generated.
       #
-      # @overload create(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: {})
+      # @overload create(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: {})
       #
       # @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).
@@ -72,7 +80,7 @@ module Dodopayments
       #
       # PATCH /discounts/{discount_id}
       #
-      # @overload update(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: {})
+      # @overload update(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: {})
       #
       # @param discount_id [String] Discount Id
       #
@@ -80,19 +88,27 @@ 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]
       #
@@ -112,11 +128,14 @@ module Dodopayments
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Dodopayments::Models::DiscountListParams} for more details.
+      #
       # GET /discounts
       #
       # @overload list(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)
+      # @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/resources/payments.rb

@@ -82,7 +82,7 @@ module Dodopayments
         )
       end
 
-      # @overload list(brand_id: nil, created_at_gte: nil, created_at_lte: nil, customer_id: nil, page_number: nil, page_size: nil, product_id: nil, status: nil, subscription_id: nil, request_options: {})
+      # @overload list(brand_id: nil, created_at_gte: nil, created_at_lte: nil, currency: nil, customer_id: nil, page_number: nil, page_size: nil, product_id: nil, status: nil, subscription_id: nil, request_options: {})
       #
       # @param brand_id [String] filter by Brand id
       #
@@ -90,6 +90,8 @@ module Dodopayments
       #
       # @param created_at_lte [Time] Get events created before this time
       #
+      # @param currency [Symbol, Dodopayments::Models::PaymentListParams::Currency] Filter by currency
+      #
       # @param customer_id [String] Filter by customer id
       #
       # @param page_number [Integer] Page number default is 0

data/lib/dodopayments/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Dodopayments
-  VERSION = "2.20.1"
+  VERSION = "2.21.0"
 end