dodopayments 2.20.0 → 2.21.0

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

data/lib/dodopayments/models/payment.rb

@@ -52,6 +52,13 @@ module Dodopayments
       #   @return [Array<Dodopayments::Models::Dispute>]
       required :disputes, -> { Dodopayments::Internal::Type::ArrayOf[Dodopayments::Dispute] }
 
+      # @!attribute is_update_payment_method
+      #   Whether this payment was created solely to update a subscription's payment
+      #   method (a zero-/setup-amount charge). `false` for normal charges.
+      #
+      #   @return [Boolean]
+      required :is_update_payment_method, Dodopayments::Internal::Type::Boolean
+
       # @!attribute metadata
       #   Additional custom data associated with the payment
       #
@@ -182,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.
       #
@@ -206,6 +223,12 @@ module Dodopayments
       #   @return [String, nil]
       optional :payment_method, String, nil?: true
 
+      # @!attribute payment_method_id
+      #   Identifier of the saved payment method used for this payment, if any.
+      #
+      #   @return [String, nil]
+      optional :payment_method_id, String, nil?: true
+
       # @!attribute payment_method_type
       #   Specific type of payment method (e.g. "visa", "mastercard")
       #
@@ -260,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:, 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_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.
       #
@@ -280,6 +303,8 @@ module Dodopayments
       #
       #   @param disputes [Array<Dodopayments::Models::Dispute>] List of disputes associated with this payment
       #
+      #   @param is_update_payment_method [Boolean] Whether this payment was created solely to update a subscription's
+      #
       #   @param metadata [Hash{Symbol=>String, Float, Boolean}] Additional custom data associated with the payment
       #
       #   @param payment_id [String] Unique identifier for the payment
@@ -318,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.
@@ -326,6 +353,8 @@ module Dodopayments
       #
       #   @param payment_method [String, nil] Payment method used by customer (e.g. "card", "bank_transfer")
       #
+      #   @param payment_method_id [String, nil] Identifier of the saved payment method used for this payment, if any.
+      #
       #   @param payment_method_type [String, nil] Specific type of payment method (e.g. "visa", "mastercard")
       #
       #   @param product_cart [Array<Dodopayments::Models::Payment::ProductCart>, nil] List of products purchased in a one-time payment
@@ -357,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