dodopayments 2.27.0 → 2.28.0

data/lib/dodopayments/models/price.rb

@@ -24,12 +24,6 @@ module Dodopayments
         #   @return [Symbol, Dodopayments::Models::Currency]
         required :currency, enum: -> { Dodopayments::Currency }
 
-        # @!attribute discount
-        #   Discount applied to the price, represented as a percentage (0 to 100).
-        #
-        #   @return [Integer]
-        required :discount, Integer
-
         # @!attribute price
         #   The payment amount, in the smallest denomination of the currency (e.g., cents
         #   for USD). For example, to charge $1.00, pass `100`.
@@ -45,6 +39,27 @@ module Dodopayments
         #   @return [Symbol, :one_time_price]
         required :type, const: :one_time_price
 
+        # @!attribute discount
+        #   @deprecated
+        #
+        #   Deprecated: use `discount_bps` instead.
+        #
+        #   Discount applied to the price, represented as a percentage (0 to 100). A
+        #   response rounds this value to the nearest whole percent. Defaults to `0`.
+        #
+        #   @return [Integer, nil]
+        optional :discount, Integer
+
+        # @!attribute discount_bps
+        #   Discount applied to the price, in basis points. 100 basis points make one
+        #   percent, so `1250` is a discount of 12.5%.
+        #
+        #   Use this field for a discount with a fraction of a percent. A request that sends
+        #   this field ignores `discount`. A value of `0` gives no discount.
+        #
+        #   @return [Integer, nil]
+        optional :discount_bps, Integer, nil?: true
+
         # @!attribute pay_what_you_want
         #   Indicates whether the customer can pay any amount they choose. If set to `true`,
         #   the [`price`](Self::price) field is the minimum amount.
@@ -74,7 +89,7 @@ module Dodopayments
         #   @return [Boolean, nil]
         optional :tax_inclusive, Dodopayments::Internal::Type::Boolean, nil?: true
 
-        # @!method initialize(currency:, discount:, price:, pay_what_you_want: nil, purchasing_power_parity: nil, suggested_price: nil, tax_inclusive: nil, type: :one_time_price)
+        # @!method initialize(currency:, price:, discount: nil, discount_bps: nil, pay_what_you_want: nil, purchasing_power_parity: nil, suggested_price: nil, tax_inclusive: nil, type: :one_time_price)
         #   Some parameter documentations has been truncated, see
         #   {Dodopayments::Models::Price::OneTimePrice} for more details.
         #
@@ -82,10 +97,12 @@ module Dodopayments
         #
         #   @param currency [Symbol, Dodopayments::Models::Currency] The currency in which the payment is made.
         #
-        #   @param discount [Integer] Discount applied to the price, represented as a percentage (0 to 100).
-        #
         #   @param price [Integer] The payment amount, in the smallest denomination of the currency (e.g., cents fo
         #
+        #   @param discount [Integer] Deprecated: use `discount_bps` instead.
+        #
+        #   @param discount_bps [Integer, nil] Discount applied to the price, in basis points. 100 basis points make
+        #
         #   @param pay_what_you_want [Boolean] Indicates whether the customer can pay any amount they choose.
         #
         #   @param purchasing_power_parity [Boolean] Opts this price in to purchasing power parity. The business must also
@@ -104,12 +121,6 @@ module Dodopayments
         #   @return [Symbol, Dodopayments::Models::Currency]
         required :currency, enum: -> { Dodopayments::Currency }
 
-        # @!attribute discount
-        #   Discount applied to the price, represented as a percentage (0 to 100).
-        #
-        #   @return [Integer]
-        required :discount, Integer
-
         # @!attribute payment_frequency_count
         #   Number of units for the payment frequency. For example, a value of `1` with a
         #   `payment_frequency_interval` of `month` represents monthly payments.
@@ -148,6 +159,27 @@ module Dodopayments
         #   @return [Symbol, :recurring_price]
         required :type, const: :recurring_price
 
+        # @!attribute discount
+        #   @deprecated
+        #
+        #   Deprecated: use `discount_bps` instead.
+        #
+        #   Discount applied to the price, represented as a percentage (0 to 100). A
+        #   response rounds this value to the nearest whole percent. Defaults to `0`.
+        #
+        #   @return [Integer, nil]
+        optional :discount, Integer
+
+        # @!attribute discount_bps
+        #   Discount applied to the price, in basis points. 100 basis points make one
+        #   percent, so `1250` is a discount of 12.5%.
+        #
+        #   Use this field for a discount with a fraction of a percent. A request that sends
+        #   this field ignores `discount`. A value of `0` gives no discount.
+        #
+        #   @return [Integer, nil]
+        optional :discount_bps, Integer, nil?: true
+
         # @!attribute purchasing_power_parity
         #   Opts this price in to purchasing power parity. The business must also enable
         #   purchasing power parity. The discount percentage per country is always
@@ -176,13 +208,26 @@ module Dodopayments
         #   @return [Boolean, nil]
         optional :trial_apply_discounts, Dodopayments::Internal::Type::Boolean, nil?: true
 
+        # @!attribute trial_payment_method_optional
+        #   Let a customer start a free trial with no card. Defaults to false.
+        #
+        #   @return [Boolean, nil]
+        optional :trial_payment_method_optional, Dodopayments::Internal::Type::Boolean
+
         # @!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:, subscription_period_count:, subscription_period_interval:, purchasing_power_parity: nil, tax_inclusive: nil, trial_amount: nil, trial_apply_discounts: nil, trial_period_days: nil, type: :recurring_price)
+        # @!attribute zero_amount_payment_method_optional
+        #   Let a customer start a subscription with no card, when the amount due today is
+        #   `0` (a native `0` price, or a 100% discount). Defaults to false.
+        #
+        #   @return [Boolean, nil]
+        optional :zero_amount_payment_method_optional, Dodopayments::Internal::Type::Boolean
+
+        # @!method initialize(currency:, payment_frequency_count:, payment_frequency_interval:, price:, subscription_period_count:, subscription_period_interval:, discount: nil, discount_bps: nil, purchasing_power_parity: nil, tax_inclusive: nil, trial_amount: nil, trial_apply_discounts: nil, trial_payment_method_optional: nil, trial_period_days: nil, zero_amount_payment_method_optional: nil, type: :recurring_price)
         #   Some parameter documentations has been truncated, see
         #   {Dodopayments::Models::Price::RecurringPrice} for more details.
         #
@@ -190,8 +235,6 @@ module Dodopayments
         #
         #   @param currency [Symbol, Dodopayments::Models::Currency] The currency in which the payment is made.
         #
-        #   @param discount [Integer] Discount applied to the price, represented as a percentage (0 to 100).
-        #
         #   @param payment_frequency_count [Integer] Number of units for the payment frequency.
         #
         #   @param payment_frequency_interval [Symbol, Dodopayments::Models::TimeInterval] The time interval for the payment frequency (e.g., day, month, year).
@@ -202,6 +245,10 @@ module Dodopayments
         #
         #   @param subscription_period_interval [Symbol, Dodopayments::Models::TimeInterval] The time interval for the subscription period (e.g., day, month, year).
         #
+        #   @param discount [Integer] Deprecated: use `discount_bps` instead.
+        #
+        #   @param discount_bps [Integer, nil] Discount applied to the price, in basis points. 100 basis points make
+        #
         #   @param purchasing_power_parity [Boolean] Opts this price in to purchasing power parity. The business must also
         #
         #   @param tax_inclusive [Boolean, nil] Indicates if the price is tax inclusive
@@ -210,8 +257,12 @@ module Dodopayments
         #
         #   @param trial_apply_discounts [Boolean, nil] Whether discount codes reduce the trial charge. Defaults to false. Only meaningf
         #
+        #   @param trial_payment_method_optional [Boolean] Let a customer start a free trial with no card. Defaults to false.
+        #
         #   @param trial_period_days [Integer] Number of days for the trial period. A value of `0` indicates no trial period.
         #
+        #   @param zero_amount_payment_method_optional [Boolean] Let a customer start a subscription with no card, when the amount due
+        #
         #   @param type [Symbol, :recurring_price]
       end
 
@@ -222,12 +273,6 @@ module Dodopayments
         #   @return [Symbol, Dodopayments::Models::Currency]
         required :currency, enum: -> { Dodopayments::Currency }
 
-        # @!attribute discount
-        #   Discount applied to the price, represented as a percentage (0 to 100).
-        #
-        #   @return [Integer]
-        required :discount, Integer
-
         # @!attribute fixed_price
         #   The fixed payment amount. Represented in the lowest denomination of the currency
         #   (e.g., cents for USD). For example, to charge $1.00, pass `100`.
@@ -266,6 +311,27 @@ module Dodopayments
         #   @return [Symbol, :usage_based_price]
         required :type, const: :usage_based_price
 
+        # @!attribute discount
+        #   @deprecated
+        #
+        #   Deprecated: use `discount_bps` instead.
+        #
+        #   Discount applied to the price, represented as a percentage (0 to 100). A
+        #   response rounds this value to the nearest whole percent. Defaults to `0`.
+        #
+        #   @return [Integer, nil]
+        optional :discount, Integer
+
+        # @!attribute discount_bps
+        #   Discount applied to the price, in basis points. 100 basis points make one
+        #   percent, so `1250` is a discount of 12.5%.
+        #
+        #   Use this field for a discount with a fraction of a percent. A request that sends
+        #   this field ignores `discount`. A value of `0` gives no discount.
+        #
+        #   @return [Integer, nil]
+        optional :discount_bps, Integer, nil?: true
+
         # @!attribute meters
         #
         #   @return [Array<Dodopayments::Models::AddMeterToPrice>, nil]
@@ -290,7 +356,7 @@ module Dodopayments
         #   @return [Boolean, nil]
         optional :tax_inclusive, Dodopayments::Internal::Type::Boolean, nil?: true
 
-        # @!method initialize(currency:, discount:, fixed_price:, payment_frequency_count:, payment_frequency_interval:, subscription_period_count:, subscription_period_interval:, meters: nil, purchasing_power_parity: nil, tax_inclusive: nil, type: :usage_based_price)
+        # @!method initialize(currency:, fixed_price:, payment_frequency_count:, payment_frequency_interval:, subscription_period_count:, subscription_period_interval:, discount: nil, discount_bps: nil, meters: nil, purchasing_power_parity: nil, tax_inclusive: nil, type: :usage_based_price)
         #   Some parameter documentations has been truncated, see
         #   {Dodopayments::Models::Price::UsageBasedPrice} for more details.
         #
@@ -298,8 +364,6 @@ module Dodopayments
         #
         #   @param currency [Symbol, Dodopayments::Models::Currency] The currency in which the payment is made.
         #
-        #   @param discount [Integer] Discount applied to the price, represented as a percentage (0 to 100).
-        #
         #   @param fixed_price [Integer] The fixed payment amount. Represented in the lowest denomination of the currency
         #
         #   @param payment_frequency_count [Integer] Number of units for the payment frequency.
@@ -310,6 +374,10 @@ module Dodopayments
         #
         #   @param subscription_period_interval [Symbol, Dodopayments::Models::TimeInterval] The time interval for the subscription period (e.g., day, month, year).
         #
+        #   @param discount [Integer] Deprecated: use `discount_bps` instead.
+        #
+        #   @param discount_bps [Integer, nil] Discount applied to the price, in basis points. 100 basis points make
+        #
         #   @param meters [Array<Dodopayments::Models::AddMeterToPrice>, nil]
         #
         #   @param purchasing_power_parity [Boolean] Opts this price in to purchasing power parity. The business must also

data/lib/dodopayments/models/subscription.rb

@@ -53,6 +53,13 @@ module Dodopayments
       #   @return [Dodopayments::Models::CustomerLimitedDetails]
       required :customer, -> { Dodopayments::CustomerLimitedDetails }
 
+      # @!attribute has_payment_method
+      #   Whether a payment method is on file. False while a card-optional subscription
+      #   waits for the customer to add one.
+      #
+      #   @return [Boolean]
+      required :has_payment_method, Dodopayments::Internal::Type::Boolean
+
       # @!attribute metadata
       #   Additional custom data associated with the subscription
       #
@@ -250,7 +257,7 @@ module Dodopayments
       #   @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, paused_at: nil, payment_method_id: nil, scheduled_change: nil, tax_id: nil, trial_amount: nil)
+      # @!method initialize(addons:, billing:, brand_id:, cancel_at_next_billing_date:, created_at:, credit_entitlement_cart:, currency:, customer:, has_payment_method:, 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, paused_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.
       #
@@ -272,6 +279,8 @@ module Dodopayments
       #
       #   @param customer [Dodopayments::Models::CustomerLimitedDetails] Customer details associated with the subscription
       #
+      #   @param has_payment_method [Boolean] Whether a payment method is on file. False while a card-optional
+      #
       #   @param metadata [Hash{Symbol=>String, Float, Boolean}] Additional custom data associated with the subscription
       #
       #   @param meter_credit_entitlement_cart [Array<Dodopayments::Models::MeterCreditEntitlementCartResponse>] Meter credit entitlement cart settings for this subscription

data/lib/dodopayments/models/subscription_create_response.rb

@@ -28,6 +28,13 @@ module Dodopayments
       #   @return [String]
       required :payment_id, String
 
+      # @!attribute payment_method_required
+      #   False when the customer can start this subscription with no card. True for every
+      #   other subscription.
+      #
+      #   @return [Boolean]
+      required :payment_method_required, Dodopayments::Internal::Type::Boolean
+
       # @!attribute recurring_pre_tax_amount
       #   Tax will be added to the amount and charged to the customer on each billing
       #   cycle
@@ -90,7 +97,7 @@ module Dodopayments
       #   @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)
+      # @!method initialize(addons:, customer:, metadata:, payment_id:, payment_method_required:, 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.
       #
@@ -102,6 +109,8 @@ module Dodopayments
       #
       #   @param payment_id [String] First payment id for the subscription
       #
+      #   @param payment_method_required [Boolean] False when the customer can start this subscription with no card.
+      #
       #   @param recurring_pre_tax_amount [Integer] Tax will be added to the amount and charged to the customer on each billing cycl
       #
       #   @param subscription_id [String] Unique identifier for the subscription

data/lib/dodopayments/models/subscription_list_response.rb

@@ -41,6 +41,13 @@ module Dodopayments
       required :discounts,
                -> { Dodopayments::Internal::Type::ArrayOf[Dodopayments::Models::SubscriptionListResponse::Discount] }
 
+      # @!attribute has_payment_method
+      #   Whether a payment method is on file. False while a card-optional subscription
+      #   waits for the customer to add one.
+      #
+      #   @return [Boolean]
+      required :has_payment_method, Dodopayments::Internal::Type::Boolean
+
       # @!attribute metadata
       #   Additional custom data associated with the subscription
       #
@@ -197,7 +204,7 @@ module Dodopayments
       #   @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, paused_at: nil, payment_method_id: nil, product_name: nil, scheduled_change: nil, tax_id: nil, trial_amount: nil)
+      # @!method initialize(billing:, cancel_at_next_billing_date:, created_at:, currency:, customer:, discounts:, has_payment_method:, 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, paused_at: 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.
       #
@@ -215,6 +222,8 @@ module Dodopayments
       #
       #   @param discounts [Array<Dodopayments::Models::SubscriptionListResponse::Discount>] All stacked discounts applied, in order of application
       #
+      #   @param has_payment_method [Boolean] Whether a payment method is on file. False while a card-optional
+      #
       #   @param metadata [Hash{Symbol=>String, Float, Boolean}] Additional custom data associated with the subscription
       #
       #   @param next_billing_date [Time] Timestamp of the next scheduled billing. Indicates the end of current billing pe

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

@@ -121,6 +121,7 @@ module Dodopayments
         # - `reason` - Optional human-readable reason
         # - `expires_at` - Optional expiration for credited amount (only for credit type)
         # - `idempotency_key` - Optional key to prevent duplicate entries
+        # - `metadata` - Optional key-value pairs
         #
         # # Responses
         #

data/lib/dodopayments/resources/customers/emails.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Resources
+    class Customers
+      class Emails
+        # Returns every transactional email sent to this customer in the last 180 days,
+        # newest first, with its delivery outcome. Delivery status comes from the email
+        # provider and is as fresh as replication, typically seconds.
+        #
+        # @overload list(customer_id, page_number: nil, page_size: nil, request_options: {})
+        #
+        # @param customer_id [String] The customer's id
+        #
+        # @param page_number [Integer] Which page to return. The default is 0.
+        #
+        # @param page_size [Integer] How many emails to return. The default is 10 and the maximum is 100.
+        #
+        # @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Dodopayments::Internal::DefaultPageNumberPagination<Dodopayments::Models::Customers::EmailLogItem>]
+        #
+        # @see Dodopayments::Models::Customers::EmailListParams
+        def list(customer_id, params = {})
+          parsed, options = Dodopayments::Customers::EmailListParams.dump_request(params)
+          query = Dodopayments::Internal::Util.encode_query_params(parsed)
+          @client.request(
+            method: :get,
+            path: ["customers/%1$s/emails", customer_id],
+            query: query,
+            page: Dodopayments::Internal::DefaultPageNumberPagination,
+            model: Dodopayments::Customers::EmailLogItem,
+            options: options
+          )
+        end
+
+        # Returns the email exactly as it was sent, plus the reason it failed when it did.
+        # Some emails have no body to show: an authentication email carries a live login
+        # token, a blocked email never reached the provider, and the provider clears
+        # bodies at 180 days.
+        #
+        # @overload retrieve_body(email_log_id, customer_id:, request_options: {})
+        #
+        # @param email_log_id [String] The email log entry's id
+        #
+        # @param customer_id [String] The customer's id
+        #
+        # @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Dodopayments::Models::Customers::EmailBody]
+        #
+        # @see Dodopayments::Models::Customers::EmailRetrieveBodyParams
+        def retrieve_body(email_log_id, params)
+          parsed, options = Dodopayments::Customers::EmailRetrieveBodyParams.dump_request(params)
+          customer_id =
+            parsed.delete(:customer_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :get,
+            path: ["customers/%1$s/emails/%2$s/body", customer_id, email_log_id],
+            model: Dodopayments::Customers::EmailBody,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Dodopayments::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/dodopayments/resources/customers.rb

@@ -9,6 +9,9 @@ module Dodopayments
       # @return [Dodopayments::Resources::Customers::Wallets]
       attr_reader :wallets
 
+      # @return [Dodopayments::Resources::Customers::Emails]
+      attr_reader :emails
+
       # @overload create(email:, name:, metadata: nil, phone_number: nil, request_options: {})
       #
       # @param email [String]
@@ -236,6 +239,7 @@ module Dodopayments
         @client = client
         @customer_portal = Dodopayments::Resources::Customers::CustomerPortal.new(client: client)
         @wallets = Dodopayments::Resources::Customers::Wallets.new(client: client)
+        @emails = Dodopayments::Resources::Customers::Emails.new(client: client)
       end
     end
   end

data/lib/dodopayments/version.rb

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

data/lib/dodopayments.rb

@@ -167,6 +167,13 @@ require_relative "dodopayments/models/customer_retrieve_payment_methods_params"
 require_relative "dodopayments/models/customer_retrieve_payment_methods_response"
 require_relative "dodopayments/models/customers/customer_portal_create_params"
 require_relative "dodopayments/models/customers/customer_wallet"
+require_relative "dodopayments/models/customers/email_body"
+require_relative "dodopayments/models/customers/email_failure_code"
+require_relative "dodopayments/models/customers/email_list_params"
+require_relative "dodopayments/models/customers/email_log_item"
+require_relative "dodopayments/models/customers/email_log_status"
+require_relative "dodopayments/models/customers/email_policies"
+require_relative "dodopayments/models/customers/email_retrieve_body_params"
 require_relative "dodopayments/models/customers/wallet_list_params"
 require_relative "dodopayments/models/customers/wallet_list_response"
 require_relative "dodopayments/models/customers/wallets/customer_wallet_transaction"
@@ -419,6 +426,7 @@ require_relative "dodopayments/resources/credit_entitlements"
 require_relative "dodopayments/resources/credit_entitlements/balances"
 require_relative "dodopayments/resources/customers"
 require_relative "dodopayments/resources/customers/customer_portal"
+require_relative "dodopayments/resources/customers/emails"
 require_relative "dodopayments/resources/customers/wallets"
 require_relative "dodopayments/resources/customers/wallets/ledger_entries"
 require_relative "dodopayments/resources/discounts"

data/rbi/dodopayments/models/balance_ledger_entry.rbi

@@ -223,6 +223,16 @@ module Dodopayments
             :byop_fee,
             Dodopayments::BalanceLedgerEntry::EventType::TaggedSymbol
           )
+        ETHOCA_FEES =
+          T.let(
+            :ethoca_fees,
+            Dodopayments::BalanceLedgerEntry::EventType::TaggedSymbol
+          )
+        ETHOCA_FEES_REVERSAL =
+          T.let(
+            :ethoca_fees_reversal,
+            Dodopayments::BalanceLedgerEntry::EventType::TaggedSymbol
+          )
 
         sig do
           override.returns(

data/rbi/dodopayments/models/balance_retrieve_ledger_params.rbi

@@ -1015,6 +1015,16 @@ module Dodopayments
             :byop_fee,
             Dodopayments::BalanceRetrieveLedgerParams::EventType::TaggedSymbol
           )
+        ETHOCA_FEES =
+          T.let(
+            :ethoca_fees,
+            Dodopayments::BalanceRetrieveLedgerParams::EventType::TaggedSymbol
+          )
+        ETHOCA_FEES_REVERSAL =
+          T.let(
+            :ethoca_fees_reversal,
+            Dodopayments::BalanceRetrieveLedgerParams::EventType::TaggedSymbol
+          )
 
         sig do
           override.returns(

data/rbi/dodopayments/models/checkout_session_preview_response.rbi

@@ -42,6 +42,11 @@ module Dodopayments
       sig { returns(T::Boolean) }
       attr_accessor :is_byop
 
+      # False when the customer can confirm this session with no card. True for every
+      # other cart, including a one-time cart.
+      sig { returns(T::Boolean) }
+      attr_accessor :payment_method_required
+
       # The total product cart
       sig do
         returns(
@@ -118,6 +123,7 @@ module Dodopayments
           current_breakup:
             Dodopayments::Models::CheckoutSessionPreviewResponse::CurrentBreakup::OrHash,
           is_byop: T::Boolean,
+          payment_method_required: T::Boolean,
           product_cart:
             T::Array[
               Dodopayments::Models::CheckoutSessionPreviewResponse::ProductCart::OrHash
@@ -148,6 +154,9 @@ module Dodopayments
         # country; in that case the quoted amounts exclude Dodo-computed tax because the
         # merchant is MoR and owns tax.
         is_byop:,
+        # False when the customer can confirm this session with no card. True for every
+        # other cart, including a one-time cart.
+        payment_method_required:,
         # The total product cart
         product_cart:,
         # Total calculate price of the product cart
@@ -185,6 +194,7 @@ module Dodopayments
             current_breakup:
               Dodopayments::Models::CheckoutSessionPreviewResponse::CurrentBreakup,
             is_byop: T::Boolean,
+            payment_method_required: T::Boolean,
             product_cart:
               T::Array[
                 Dodopayments::Models::CheckoutSessionPreviewResponse::ProductCart

data/rbi/dodopayments/models/credit_entitlements/balance_create_ledger_entry_params.rbi

@@ -42,7 +42,7 @@ module Dodopayments
         attr_accessor :idempotency_key
 
         # Optional metadata (max 50 key-value pairs, key max 40 chars, value max 500
-        # chars)
+        # chars).
         sig do
           returns(
             T.nilable(T::Hash[Symbol, Dodopayments::MetadataItem::Variants])
@@ -83,7 +83,7 @@ module Dodopayments
           # Idempotency key to prevent duplicate entries
           idempotency_key: nil,
           # Optional metadata (max 50 key-value pairs, key max 40 chars, value max 500
-          # chars)
+          # chars).
           metadata: nil,
           # Human-readable reason for the entry
           reason: nil,

data/rbi/dodopayments/models/credit_entitlements/balance_create_ledger_entry_response.rbi

@@ -43,6 +43,10 @@ module Dodopayments
         sig { returns(T::Boolean) }
         attr_accessor :is_credit
 
+        # Metadata stored on this entry.
+        sig { returns(T::Hash[Symbol, Dodopayments::MetadataItem::Variants]) }
+        attr_accessor :metadata
+
         sig { returns(String) }
         attr_accessor :overage_after
 
@@ -68,6 +72,7 @@ module Dodopayments
             entry_type:
               Dodopayments::CreditEntitlements::LedgerEntryType::OrSymbol,
             is_credit: T::Boolean,
+            metadata: T::Hash[Symbol, Dodopayments::MetadataItem::Variants],
             overage_after: String,
             overage_before: String,
             grant_id: T.nilable(String),
@@ -84,6 +89,8 @@ module Dodopayments
           customer_id:,
           entry_type:,
           is_credit:,
+          # Metadata stored on this entry.
+          metadata:,
           overage_after:,
           overage_before:,
           grant_id: nil,
@@ -104,6 +111,7 @@ module Dodopayments
               entry_type:
                 Dodopayments::CreditEntitlements::LedgerEntryType::TaggedSymbol,
               is_credit: T::Boolean,
+              metadata: T::Hash[Symbol, Dodopayments::MetadataItem::Variants],
               overage_after: String,
               overage_before: String,
               grant_id: T.nilable(String),

data/rbi/dodopayments/models/credit_entitlements/credit_ledger_entry.rbi

@@ -43,9 +43,7 @@ module Dodopayments
         sig { returns(T::Boolean) }
         attr_accessor :is_credit
 
-        # Metadata associated with the credit grant's source (the subscription or payment
-        # created at checkout). Empty when the grant has no resolvable source (e.g.
-        # credits granted directly via the API).
+        # Metadata associated with this entry.
         sig { returns(T::Hash[Symbol, Dodopayments::MetadataItem::Variants]) }
         attr_accessor :metadata
 
@@ -110,9 +108,7 @@ module Dodopayments
           credit_entitlement_id:,
           customer_id:,
           is_credit:,
-          # Metadata associated with the credit grant's source (the subscription or payment
-          # created at checkout). Empty when the grant has no resolvable source (e.g.
-          # credits granted directly via the API).
+          # Metadata associated with this entry.
           metadata:,
           overage_after:,
           overage_before:,