dodopayments 2.20.1 → 2.21.0

data/rbi/dodopayments/models/payment_list_params.rbi

@@ -35,6 +35,19 @@ module Dodopayments
       sig { params(created_at_lte: Time).void }
       attr_writer :created_at_lte
 
+      # Filter by currency
+      sig do
+        returns(T.nilable(Dodopayments::PaymentListParams::Currency::OrSymbol))
+      end
+      attr_reader :currency
+
+      sig do
+        params(
+          currency: Dodopayments::PaymentListParams::Currency::OrSymbol
+        ).void
+      end
+      attr_writer :currency
+
       # Filter by customer id
       sig { returns(T.nilable(String)) }
       attr_reader :customer_id
@@ -86,6 +99,7 @@ module Dodopayments
           brand_id: String,
           created_at_gte: Time,
           created_at_lte: Time,
+          currency: Dodopayments::PaymentListParams::Currency::OrSymbol,
           customer_id: String,
           page_number: Integer,
           page_size: Integer,
@@ -102,6 +116,8 @@ module Dodopayments
         created_at_gte: nil,
         # Get events created before this time
         created_at_lte: nil,
+        # Filter by currency
+        currency: nil,
         # Filter by customer id
         customer_id: nil,
         # Page number default is 0
@@ -124,6 +140,7 @@ module Dodopayments
             brand_id: String,
             created_at_gte: Time,
             created_at_lte: Time,
+            currency: Dodopayments::PaymentListParams::Currency::OrSymbol,
             customer_id: String,
             page_number: Integer,
             page_size: Integer,
@@ -137,6 +154,316 @@ module Dodopayments
       def to_hash
       end
 
+      # Filter by currency
+      module Currency
+        extend Dodopayments::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Dodopayments::PaymentListParams::Currency)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        AED =
+          T.let(:AED, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        ALL =
+          T.let(:ALL, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        AMD =
+          T.let(:AMD, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        ANG =
+          T.let(:ANG, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        AOA =
+          T.let(:AOA, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        ARS =
+          T.let(:ARS, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        AUD =
+          T.let(:AUD, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        AWG =
+          T.let(:AWG, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        AZN =
+          T.let(:AZN, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        BAM =
+          T.let(:BAM, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        BBD =
+          T.let(:BBD, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        BDT =
+          T.let(:BDT, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        BGN =
+          T.let(:BGN, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        BHD =
+          T.let(:BHD, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        BIF =
+          T.let(:BIF, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        BMD =
+          T.let(:BMD, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        BND =
+          T.let(:BND, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        BOB =
+          T.let(:BOB, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        BRL =
+          T.let(:BRL, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        BSD =
+          T.let(:BSD, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        BWP =
+          T.let(:BWP, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        BYN =
+          T.let(:BYN, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        BZD =
+          T.let(:BZD, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        CAD =
+          T.let(:CAD, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        CHF =
+          T.let(:CHF, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        CLP =
+          T.let(:CLP, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        CNY =
+          T.let(:CNY, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        COP =
+          T.let(:COP, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        CRC =
+          T.let(:CRC, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        CUP =
+          T.let(:CUP, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        CVE =
+          T.let(:CVE, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        CZK =
+          T.let(:CZK, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        DJF =
+          T.let(:DJF, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        DKK =
+          T.let(:DKK, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        DOP =
+          T.let(:DOP, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        DZD =
+          T.let(:DZD, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        EGP =
+          T.let(:EGP, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        ETB =
+          T.let(:ETB, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        EUR =
+          T.let(:EUR, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        FJD =
+          T.let(:FJD, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        FKP =
+          T.let(:FKP, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        GBP =
+          T.let(:GBP, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        GEL =
+          T.let(:GEL, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        GHS =
+          T.let(:GHS, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        GIP =
+          T.let(:GIP, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        GMD =
+          T.let(:GMD, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        GNF =
+          T.let(:GNF, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        GTQ =
+          T.let(:GTQ, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        GYD =
+          T.let(:GYD, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        HKD =
+          T.let(:HKD, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        HNL =
+          T.let(:HNL, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        HRK =
+          T.let(:HRK, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        HTG =
+          T.let(:HTG, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        HUF =
+          T.let(:HUF, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        IDR =
+          T.let(:IDR, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        ILS =
+          T.let(:ILS, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        INR =
+          T.let(:INR, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        IQD =
+          T.let(:IQD, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        JMD =
+          T.let(:JMD, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        JOD =
+          T.let(:JOD, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        JPY =
+          T.let(:JPY, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        KES =
+          T.let(:KES, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        KGS =
+          T.let(:KGS, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        KHR =
+          T.let(:KHR, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        KMF =
+          T.let(:KMF, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        KRW =
+          T.let(:KRW, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        KWD =
+          T.let(:KWD, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        KYD =
+          T.let(:KYD, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        KZT =
+          T.let(:KZT, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        LAK =
+          T.let(:LAK, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        LBP =
+          T.let(:LBP, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        LKR =
+          T.let(:LKR, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        LRD =
+          T.let(:LRD, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        LSL =
+          T.let(:LSL, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        LYD =
+          T.let(:LYD, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        MAD =
+          T.let(:MAD, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        MDL =
+          T.let(:MDL, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        MGA =
+          T.let(:MGA, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        MKD =
+          T.let(:MKD, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        MMK =
+          T.let(:MMK, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        MNT =
+          T.let(:MNT, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        MOP =
+          T.let(:MOP, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        MRU =
+          T.let(:MRU, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        MUR =
+          T.let(:MUR, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        MVR =
+          T.let(:MVR, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        MWK =
+          T.let(:MWK, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        MXN =
+          T.let(:MXN, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        MYR =
+          T.let(:MYR, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        MZN =
+          T.let(:MZN, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        NAD =
+          T.let(:NAD, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        NGN =
+          T.let(:NGN, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        NIO =
+          T.let(:NIO, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        NOK =
+          T.let(:NOK, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        NPR =
+          T.let(:NPR, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        NZD =
+          T.let(:NZD, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        OMR =
+          T.let(:OMR, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        PAB =
+          T.let(:PAB, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        PEN =
+          T.let(:PEN, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        PGK =
+          T.let(:PGK, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        PHP =
+          T.let(:PHP, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        PKR =
+          T.let(:PKR, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        PLN =
+          T.let(:PLN, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        PYG =
+          T.let(:PYG, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        QAR =
+          T.let(:QAR, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        RON =
+          T.let(:RON, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        RSD =
+          T.let(:RSD, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        RUB =
+          T.let(:RUB, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        RWF =
+          T.let(:RWF, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        SAR =
+          T.let(:SAR, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        SBD =
+          T.let(:SBD, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        SCR =
+          T.let(:SCR, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        SEK =
+          T.let(:SEK, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        SGD =
+          T.let(:SGD, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        SHP =
+          T.let(:SHP, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        SLE =
+          T.let(:SLE, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        SLL =
+          T.let(:SLL, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        SOS =
+          T.let(:SOS, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        SRD =
+          T.let(:SRD, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        SSP =
+          T.let(:SSP, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        STN =
+          T.let(:STN, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        SVC =
+          T.let(:SVC, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        SZL =
+          T.let(:SZL, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        THB =
+          T.let(:THB, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        TND =
+          T.let(:TND, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        TOP =
+          T.let(:TOP, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        TRY =
+          T.let(:TRY, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        TTD =
+          T.let(:TTD, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        TWD =
+          T.let(:TWD, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        TZS =
+          T.let(:TZS, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        UAH =
+          T.let(:UAH, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        UGX =
+          T.let(:UGX, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        USD =
+          T.let(:USD, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        UYU =
+          T.let(:UYU, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        UZS =
+          T.let(:UZS, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        VES =
+          T.let(:VES, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        VND =
+          T.let(:VND, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        VUV =
+          T.let(:VUV, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        WST =
+          T.let(:WST, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        XAF =
+          T.let(:XAF, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        XCD =
+          T.let(:XCD, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        XOF =
+          T.let(:XOF, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        XPF =
+          T.let(:XPF, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        YER =
+          T.let(:YER, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        ZAR =
+          T.let(:ZAR, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+        ZMW =
+          T.let(:ZMW, Dodopayments::PaymentListParams::Currency::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[Dodopayments::PaymentListParams::Currency::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+
       # Filter by status
       module Status
         extend Dodopayments::Internal::Type::Enum

data/rbi/dodopayments/models/payment_method_types.rbi

@@ -159,7 +159,6 @@ module Dodopayments
           Dodopayments::PaymentMethodTypes::TaggedSymbol
         )
       SOFORT = T.let(:sofort, Dodopayments::PaymentMethodTypes::TaggedSymbol)
-      SUNBIT = T.let(:sunbit, Dodopayments::PaymentMethodTypes::TaggedSymbol)
       SWISH = T.let(:swish, Dodopayments::PaymentMethodTypes::TaggedSymbol)
       TOUCH_N_GO =
         T.let(:touch_n_go, Dodopayments::PaymentMethodTypes::TaggedSymbol)

data/rbi/dodopayments/models/price.rbi

@@ -176,6 +176,16 @@ module Dodopayments
         sig { returns(T.nilable(T::Boolean)) }
         attr_accessor :tax_inclusive
 
+        # 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).
+        sig { returns(T.nilable(Integer)) }
+        attr_accessor :trial_amount
+
+        # Whether discount codes reduce the trial charge. Defaults to false. Only
+        # meaningful when a paid trial is configured.
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_accessor :trial_apply_discounts
+
         # Number of days for the trial period. A value of `0` indicates no trial period.
         sig { returns(T.nilable(Integer)) }
         attr_reader :trial_period_days
@@ -195,6 +205,8 @@ module Dodopayments
             subscription_period_count: Integer,
             subscription_period_interval: Dodopayments::TimeInterval::OrSymbol,
             tax_inclusive: T.nilable(T::Boolean),
+            trial_amount: T.nilable(Integer),
+            trial_apply_discounts: T.nilable(T::Boolean),
             trial_period_days: Integer,
             type: Symbol
           ).returns(T.attached_class)
@@ -222,6 +234,12 @@ module Dodopayments
           subscription_period_interval:,
           # Indicates if the price is tax inclusive
           tax_inclusive: nil,
+          # 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).
+          trial_amount: nil,
+          # Whether discount codes reduce the trial charge. Defaults to false. Only
+          # meaningful when a paid trial is configured.
+          trial_apply_discounts: nil,
           # Number of days for the trial period. A value of `0` indicates no trial period.
           trial_period_days: nil,
           type: :recurring_price
@@ -242,6 +260,8 @@ module Dodopayments
                 Dodopayments::TimeInterval::OrSymbol,
               type: Symbol,
               tax_inclusive: T.nilable(T::Boolean),
+              trial_amount: T.nilable(Integer),
+              trial_apply_discounts: T.nilable(T::Boolean),
               trial_period_days: Integer
             }
           )

data/rbi/dodopayments/models/subscription.rbi

@@ -178,6 +178,12 @@ module Dodopayments
       sig { returns(T.nilable(String)) }
       attr_accessor :tax_id
 
+      # 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.
+      sig { returns(T.nilable(Integer)) }
+      attr_accessor :trial_amount
+
       # Response struct representing subscription details
       sig do
         params(
@@ -222,7 +228,8 @@ module Dodopayments
           payment_method_id: T.nilable(String),
           scheduled_change:
             T.nilable(Dodopayments::ScheduledPlanChange::OrHash),
-          tax_id: T.nilable(String)
+          tax_id: T.nilable(String),
+          trial_amount: T.nilable(Integer)
         ).returns(T.attached_class)
       end
       def self.new(
@@ -302,7 +309,11 @@ module Dodopayments
         # Scheduled plan change details, if any
         scheduled_change: nil,
         # Tax identifier provided for this subscription (if applicable)
-        tax_id: nil
+        tax_id: nil,
+        # 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.
+        trial_amount: nil
       )
       end
 
@@ -351,7 +362,8 @@ module Dodopayments
             expires_at: T.nilable(Time),
             payment_method_id: T.nilable(String),
             scheduled_change: T.nilable(Dodopayments::ScheduledPlanChange),
-            tax_id: T.nilable(String)
+            tax_id: T.nilable(String),
+            trial_amount: T.nilable(Integer)
           }
         )
       end

data/rbi/dodopayments/models/subscription_create_response.rbi

@@ -75,6 +75,11 @@ module Dodopayments
       sig { returns(T.nilable(String)) }
       attr_accessor :payment_link
 
+      # 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.
+      sig { returns(T.nilable(Integer)) }
+      attr_accessor :trial_amount
+
       sig do
         params(
           addons: T::Array[Dodopayments::AddonCartResponseItem::OrHash],
@@ -93,7 +98,8 @@ module Dodopayments
                 Dodopayments::Models::SubscriptionCreateResponse::OneTimeProductCart::OrHash
               ]
             ),
-          payment_link: T.nilable(String)
+          payment_link: T.nilable(String),
+          trial_amount: T.nilable(Integer)
         ).returns(T.attached_class)
       end
       def self.new(
@@ -123,7 +129,10 @@ module Dodopayments
         # One time products associated with the purchase of subscription
         one_time_product_cart: nil,
         # URL to checkout page
-        payment_link: nil
+        payment_link: nil,
+        # 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.
+        trial_amount: nil
       )
       end
 
@@ -146,7 +155,8 @@ module Dodopayments
                   Dodopayments::Models::SubscriptionCreateResponse::OneTimeProductCart
                 ]
               ),
-            payment_link: T.nilable(String)
+            payment_link: T.nilable(String),
+            trial_amount: T.nilable(Integer)
           }
         )
       end

data/rbi/dodopayments/models/subscription_list_response.rbi

@@ -149,6 +149,12 @@ module Dodopayments
       sig { returns(T.nilable(String)) }
       attr_accessor :tax_id
 
+      # 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.
+      sig { returns(T.nilable(Integer)) }
+      attr_accessor :trial_amount
+
       # Response struct representing subscription details
       sig do
         params(
@@ -184,7 +190,8 @@ module Dodopayments
           product_name: T.nilable(String),
           scheduled_change:
             T.nilable(Dodopayments::ScheduledPlanChange::OrHash),
-          tax_id: T.nilable(String)
+          tax_id: T.nilable(String),
+          trial_amount: T.nilable(Integer)
         ).returns(T.attached_class)
       end
       def self.new(
@@ -248,7 +255,11 @@ module Dodopayments
         # Scheduled plan change details, if any
         scheduled_change: nil,
         # Tax identifier provided for this subscription (if applicable)
-        tax_id: nil
+        tax_id: nil,
+        # 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.
+        trial_amount: nil
       )
       end
 
@@ -288,7 +299,8 @@ module Dodopayments
             payment_method_id: T.nilable(String),
             product_name: T.nilable(String),
             scheduled_change: T.nilable(Dodopayments::ScheduledPlanChange),
-            tax_id: T.nilable(String)
+            tax_id: T.nilable(String),
+            trial_amount: T.nilable(Integer)
           }
         )
       end

data/rbi/dodopayments/resources/credit_entitlements/balances.rbi

@@ -134,7 +134,9 @@ module Dodopayments
           customer_id,
           # Path param: Credit Entitlement ID
           credit_entitlement_id:,
-          # Body param: Amount to credit or debit
+          # Body param: 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.
           amount:,
           # Body param: Entry type: credit or debit
           entry_type:,