dodopayments 2.26.0 → 2.28.0

data/lib/dodopayments/models/payment_retry_params.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    # @see Dodopayments::Resources::Payments#retry_
+    class PaymentRetryParams < Dodopayments::Internal::Type::BaseModel
+      extend Dodopayments::Internal::Type::RequestParameters::Converter
+      include Dodopayments::Internal::Type::RequestParameters
+
+      # @!attribute payment_id
+      #
+      #   @return [String]
+      required :payment_id, String
+
+      # @!method initialize(payment_id:, request_options: {})
+      #   @param payment_id [String]
+      #   @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

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_active_webhook_event.rb

@@ -10,10 +10,11 @@ module Dodopayments
       required :business_id, String
 
       # @!attribute data
-      #   Response struct representing subscription details
+      #   Subscription payload sent on a webhook. It carries every field of
+      #   `SubscriptionResponse`, plus the grace-period deadline.
       #
-      #   @return [Dodopayments::Models::Subscription]
-      required :data, -> { Dodopayments::Subscription }
+      #   @return [Dodopayments::Models::SubscriptionActiveWebhookEvent::Data]
+      required :data, -> { Dodopayments::SubscriptionActiveWebhookEvent::Data }
 
       # @!attribute timestamp
       #   The timestamp of when the event occurred
@@ -28,13 +29,40 @@ module Dodopayments
       required :type, const: :"subscription.active"
 
       # @!method initialize(business_id:, data:, timestamp:, type: :"subscription.active")
+      #   Some parameter documentations has been truncated, see
+      #   {Dodopayments::Models::SubscriptionActiveWebhookEvent} for more details.
+      #
       #   @param business_id [String] The business identifier
       #
-      #   @param data [Dodopayments::Models::Subscription] Response struct representing subscription details
+      #   @param data [Dodopayments::Models::SubscriptionActiveWebhookEvent::Data] Subscription payload sent on a webhook. It carries every field of
       #
       #   @param timestamp [Time] The timestamp of when the event occurred
       #
       #   @param type [Symbol, :"subscription.active"] The event type
+
+      # @see Dodopayments::Models::SubscriptionActiveWebhookEvent#data
+      class Data < Dodopayments::Models::Subscription
+        # @!attribute past_due_ends_at
+        #   Time when the grace period ends. The subscription moves to `on_hold` or to
+        #   `cancelled` at this time.
+        #
+        #   Read in the same query as the rest of the payload, so it always comes from the
+        #   row snapshot that produced `status`. It is set whenever the subscription sits in
+        #   a window at that moment. A delayed event of another type therefore carries the
+        #   deadline too, next to a `past_due` status.
+        #
+        #   @return [Time, nil]
+        optional :past_due_ends_at, Time, nil?: true
+
+        # @!method initialize(past_due_ends_at: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Dodopayments::Models::SubscriptionActiveWebhookEvent::Data} for more details.
+        #
+        #   Subscription payload sent on a webhook. It carries every field of
+        #   `SubscriptionResponse`, plus the grace-period deadline.
+        #
+        #   @param past_due_ends_at [Time, nil] Time when the grace period ends. The subscription moves to `on_hold` or
+      end
     end
   end
 end

data/lib/dodopayments/models/subscription_cancelled_webhook_event.rb

@@ -10,10 +10,11 @@ module Dodopayments
       required :business_id, String
 
       # @!attribute data
-      #   Response struct representing subscription details
+      #   Subscription payload sent on a webhook. It carries every field of
+      #   `SubscriptionResponse`, plus the grace-period deadline.
       #
-      #   @return [Dodopayments::Models::Subscription]
-      required :data, -> { Dodopayments::Subscription }
+      #   @return [Dodopayments::Models::SubscriptionCancelledWebhookEvent::Data]
+      required :data, -> { Dodopayments::SubscriptionCancelledWebhookEvent::Data }
 
       # @!attribute timestamp
       #   The timestamp of when the event occurred
@@ -28,13 +29,41 @@ module Dodopayments
       required :type, const: :"subscription.cancelled"
 
       # @!method initialize(business_id:, data:, timestamp:, type: :"subscription.cancelled")
+      #   Some parameter documentations has been truncated, see
+      #   {Dodopayments::Models::SubscriptionCancelledWebhookEvent} for more details.
+      #
       #   @param business_id [String] The business identifier
       #
-      #   @param data [Dodopayments::Models::Subscription] Response struct representing subscription details
+      #   @param data [Dodopayments::Models::SubscriptionCancelledWebhookEvent::Data] Subscription payload sent on a webhook. It carries every field of
       #
       #   @param timestamp [Time] The timestamp of when the event occurred
       #
       #   @param type [Symbol, :"subscription.cancelled"] The event type
+
+      # @see Dodopayments::Models::SubscriptionCancelledWebhookEvent#data
+      class Data < Dodopayments::Models::Subscription
+        # @!attribute past_due_ends_at
+        #   Time when the grace period ends. The subscription moves to `on_hold` or to
+        #   `cancelled` at this time.
+        #
+        #   Read in the same query as the rest of the payload, so it always comes from the
+        #   row snapshot that produced `status`. It is set whenever the subscription sits in
+        #   a window at that moment. A delayed event of another type therefore carries the
+        #   deadline too, next to a `past_due` status.
+        #
+        #   @return [Time, nil]
+        optional :past_due_ends_at, Time, nil?: true
+
+        # @!method initialize(past_due_ends_at: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Dodopayments::Models::SubscriptionCancelledWebhookEvent::Data} for more
+        #   details.
+        #
+        #   Subscription payload sent on a webhook. It carries every field of
+        #   `SubscriptionResponse`, plus the grace-period deadline.
+        #
+        #   @param past_due_ends_at [Time, nil] Time when the grace period ends. The subscription moves to `on_hold` or
+      end
     end
   end
 end

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_expired_webhook_event.rb

@@ -10,10 +10,11 @@ module Dodopayments
       required :business_id, String
 
       # @!attribute data
-      #   Response struct representing subscription details
+      #   Subscription payload sent on a webhook. It carries every field of
+      #   `SubscriptionResponse`, plus the grace-period deadline.
       #
-      #   @return [Dodopayments::Models::Subscription]
-      required :data, -> { Dodopayments::Subscription }
+      #   @return [Dodopayments::Models::SubscriptionExpiredWebhookEvent::Data]
+      required :data, -> { Dodopayments::SubscriptionExpiredWebhookEvent::Data }
 
       # @!attribute timestamp
       #   The timestamp of when the event occurred
@@ -28,13 +29,40 @@ module Dodopayments
       required :type, const: :"subscription.expired"
 
       # @!method initialize(business_id:, data:, timestamp:, type: :"subscription.expired")
+      #   Some parameter documentations has been truncated, see
+      #   {Dodopayments::Models::SubscriptionExpiredWebhookEvent} for more details.
+      #
       #   @param business_id [String] The business identifier
       #
-      #   @param data [Dodopayments::Models::Subscription] Response struct representing subscription details
+      #   @param data [Dodopayments::Models::SubscriptionExpiredWebhookEvent::Data] Subscription payload sent on a webhook. It carries every field of
       #
       #   @param timestamp [Time] The timestamp of when the event occurred
       #
       #   @param type [Symbol, :"subscription.expired"] The event type
+
+      # @see Dodopayments::Models::SubscriptionExpiredWebhookEvent#data
+      class Data < Dodopayments::Models::Subscription
+        # @!attribute past_due_ends_at
+        #   Time when the grace period ends. The subscription moves to `on_hold` or to
+        #   `cancelled` at this time.
+        #
+        #   Read in the same query as the rest of the payload, so it always comes from the
+        #   row snapshot that produced `status`. It is set whenever the subscription sits in
+        #   a window at that moment. A delayed event of another type therefore carries the
+        #   deadline too, next to a `past_due` status.
+        #
+        #   @return [Time, nil]
+        optional :past_due_ends_at, Time, nil?: true
+
+        # @!method initialize(past_due_ends_at: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Dodopayments::Models::SubscriptionExpiredWebhookEvent::Data} for more details.
+        #
+        #   Subscription payload sent on a webhook. It carries every field of
+        #   `SubscriptionResponse`, plus the grace-period deadline.
+        #
+        #   @param past_due_ends_at [Time, nil] Time when the grace period ends. The subscription moves to `on_hold` or
+      end
     end
   end
 end

data/lib/dodopayments/models/subscription_failed_webhook_event.rb

@@ -10,10 +10,11 @@ module Dodopayments
       required :business_id, String
 
       # @!attribute data
-      #   Response struct representing subscription details
+      #   Subscription payload sent on a webhook. It carries every field of
+      #   `SubscriptionResponse`, plus the grace-period deadline.
       #
-      #   @return [Dodopayments::Models::Subscription]
-      required :data, -> { Dodopayments::Subscription }
+      #   @return [Dodopayments::Models::SubscriptionFailedWebhookEvent::Data]
+      required :data, -> { Dodopayments::SubscriptionFailedWebhookEvent::Data }
 
       # @!attribute timestamp
       #   The timestamp of when the event occurred
@@ -28,13 +29,40 @@ module Dodopayments
       required :type, const: :"subscription.failed"
 
       # @!method initialize(business_id:, data:, timestamp:, type: :"subscription.failed")
+      #   Some parameter documentations has been truncated, see
+      #   {Dodopayments::Models::SubscriptionFailedWebhookEvent} for more details.
+      #
       #   @param business_id [String] The business identifier
       #
-      #   @param data [Dodopayments::Models::Subscription] Response struct representing subscription details
+      #   @param data [Dodopayments::Models::SubscriptionFailedWebhookEvent::Data] Subscription payload sent on a webhook. It carries every field of
       #
       #   @param timestamp [Time] The timestamp of when the event occurred
       #
       #   @param type [Symbol, :"subscription.failed"] The event type
+
+      # @see Dodopayments::Models::SubscriptionFailedWebhookEvent#data
+      class Data < Dodopayments::Models::Subscription
+        # @!attribute past_due_ends_at
+        #   Time when the grace period ends. The subscription moves to `on_hold` or to
+        #   `cancelled` at this time.
+        #
+        #   Read in the same query as the rest of the payload, so it always comes from the
+        #   row snapshot that produced `status`. It is set whenever the subscription sits in
+        #   a window at that moment. A delayed event of another type therefore carries the
+        #   deadline too, next to a `past_due` status.
+        #
+        #   @return [Time, nil]
+        optional :past_due_ends_at, Time, nil?: true
+
+        # @!method initialize(past_due_ends_at: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Dodopayments::Models::SubscriptionFailedWebhookEvent::Data} for more details.
+        #
+        #   Subscription payload sent on a webhook. It carries every field of
+        #   `SubscriptionResponse`, plus the grace-period deadline.
+        #
+        #   @param past_due_ends_at [Time, nil] Time when the grace period ends. The subscription moves to `on_hold` or
+      end
     end
   end
 end

data/lib/dodopayments/models/subscription_list_params.rb

@@ -96,6 +96,7 @@ module Dodopayments
         CANCELLED = :cancelled
         FAILED = :failed
         EXPIRED = :expired
+        PAST_DUE = :past_due
 
         # @!method self.values
         #   @return [Array<Symbol>]

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/models/subscription_on_hold_webhook_event.rb

@@ -10,10 +10,11 @@ module Dodopayments
       required :business_id, String
 
       # @!attribute data
-      #   Response struct representing subscription details
+      #   Subscription payload sent on a webhook. It carries every field of
+      #   `SubscriptionResponse`, plus the grace-period deadline.
       #
-      #   @return [Dodopayments::Models::Subscription]
-      required :data, -> { Dodopayments::Subscription }
+      #   @return [Dodopayments::Models::SubscriptionOnHoldWebhookEvent::Data]
+      required :data, -> { Dodopayments::SubscriptionOnHoldWebhookEvent::Data }
 
       # @!attribute timestamp
       #   The timestamp of when the event occurred
@@ -28,13 +29,40 @@ module Dodopayments
       required :type, const: :"subscription.on_hold"
 
       # @!method initialize(business_id:, data:, timestamp:, type: :"subscription.on_hold")
+      #   Some parameter documentations has been truncated, see
+      #   {Dodopayments::Models::SubscriptionOnHoldWebhookEvent} for more details.
+      #
       #   @param business_id [String] The business identifier
       #
-      #   @param data [Dodopayments::Models::Subscription] Response struct representing subscription details
+      #   @param data [Dodopayments::Models::SubscriptionOnHoldWebhookEvent::Data] Subscription payload sent on a webhook. It carries every field of
       #
       #   @param timestamp [Time] The timestamp of when the event occurred
       #
       #   @param type [Symbol, :"subscription.on_hold"] The event type
+
+      # @see Dodopayments::Models::SubscriptionOnHoldWebhookEvent#data
+      class Data < Dodopayments::Models::Subscription
+        # @!attribute past_due_ends_at
+        #   Time when the grace period ends. The subscription moves to `on_hold` or to
+        #   `cancelled` at this time.
+        #
+        #   Read in the same query as the rest of the payload, so it always comes from the
+        #   row snapshot that produced `status`. It is set whenever the subscription sits in
+        #   a window at that moment. A delayed event of another type therefore carries the
+        #   deadline too, next to a `past_due` status.
+        #
+        #   @return [Time, nil]
+        optional :past_due_ends_at, Time, nil?: true
+
+        # @!method initialize(past_due_ends_at: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Dodopayments::Models::SubscriptionOnHoldWebhookEvent::Data} for more details.
+        #
+        #   Subscription payload sent on a webhook. It carries every field of
+        #   `SubscriptionResponse`, plus the grace-period deadline.
+        #
+        #   @param past_due_ends_at [Time, nil] Time when the grace period ends. The subscription moves to `on_hold` or
+      end
     end
   end
 end