dodopayments 2.25.0 → 2.27.0

data/lib/dodopayments/models/dunning_started_webhook_event.rb

@@ -109,6 +109,7 @@ module Dodopayments
 
           ON_HOLD = :on_hold
           CANCELLED = :cancelled
+          PAST_DUE = :past_due
 
           # @!method self.values
           #   @return [Array<Symbol>]

data/lib/dodopayments/models/entitlements/license_key_grant.rb

@@ -4,8 +4,15 @@ module Dodopayments
   module Models
     module Entitlements
       class LicenseKeyGrant < Dodopayments::Internal::Type::BaseModel
+        # @!attribute id
+        #   Identifier of the issued license key.
+        #
+        #   @return [String]
+        required :id, String
+
         # @!attribute activations_used
-        #   Number of activations consumed so far.
+        #   Number of instances currently active. Activation increments it and deactivation
+        #   decrements it, so it is a live count and not a total.
         #
         #   @return [Integer]
         required :activations_used, Integer
@@ -16,6 +23,13 @@ module Dodopayments
         #   @return [String]
         required :key, String
 
+        # @!attribute status
+        #   Current status of the license key. Activation fails unless it is `active`, so a
+        #   client can warn before the customer tries.
+        #
+        #   @return [Symbol, Dodopayments::Models::LicenseKeyStatus]
+        required :status, enum: -> { Dodopayments::LicenseKeyStatus }
+
         # @!attribute activations_limit
         #   Maximum activations allowed by the entitlement, when set.
         #
@@ -28,14 +42,21 @@ module Dodopayments
         #   @return [Time, nil]
         optional :expires_at, Time, nil?: true
 
-        # @!method initialize(activations_used:, key:, activations_limit: nil, expires_at: nil)
+        # @!method initialize(id:, activations_used:, key:, status:, activations_limit: nil, expires_at: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Dodopayments::Models::Entitlements::LicenseKeyGrant} for more details.
+        #
         #   License-key delivery payload, present on grants for `license_key` entitlements.
         #   The grant's top-level `status` is the source of truth for the grant's lifecycle.
         #
-        #   @param activations_used [Integer] Number of activations consumed so far.
+        #   @param id [String] Identifier of the issued license key.
+        #
+        #   @param activations_used [Integer] Number of instances currently active. Activation increments it and
         #
         #   @param key [String] Issued license key.
         #
+        #   @param status [Symbol, Dodopayments::Models::LicenseKeyStatus] Current status of the license key. Activation fails unless it is
+        #
         #   @param activations_limit [Integer, nil] Maximum activations allowed by the entitlement, when set.
         #
         #   @param expires_at [Time, nil] When the license key expires, when applicable.

data/lib/dodopayments/models/manual_retry.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    # @see Dodopayments::Resources::Payments#retry_
+    class ManualRetry < Dodopayments::Internal::Type::BaseModel
+      # @!attribute invoice_id
+      #   The invoice the send charged.
+      #
+      #   @return [String]
+      required :invoice_id, String
+
+      # @!attribute is_manual_retry
+      #   Always true on this route. Tells the row apart from an automatic attempt.
+      #
+      #   @return [Boolean]
+      required :is_manual_retry, Dodopayments::Internal::Type::Boolean
+
+      # @!attribute payment_id
+      #   The payment row this send created.
+      #
+      #   @return [String]
+      required :payment_id, String
+
+      # @!attribute retry_attempt
+      #   Which attempt this send is, counting manual sends on the invoice.
+      #
+      #   @return [Integer]
+      required :retry_attempt, Integer
+
+      # @!attribute sends_allowed
+      #
+      #   @return [Integer]
+      required :sends_allowed, Integer
+
+      # @!attribute sends_used
+      #   Manual sends spent on this invoice, including this one.
+      #
+      #   @return [Integer]
+      required :sends_used, Integer
+
+      # @!attribute retry_available_at
+      #   When the next send becomes available. Null when no send is left.
+      #
+      #   @return [Time, nil]
+      optional :retry_available_at, Time, nil?: true
+
+      # @!attribute status
+      #   Outcome of the charge. `processing` means the processor has not settled it yet,
+      #   and the payment webhooks report the result.
+      #
+      #   @return [Symbol, Dodopayments::Models::IntentStatus, nil]
+      optional :status, enum: -> { Dodopayments::IntentStatus }, nil?: true
+
+      # @!method initialize(invoice_id:, is_manual_retry:, payment_id:, retry_attempt:, sends_allowed:, sends_used:, retry_available_at: nil, status: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Dodopayments::Models::ManualRetry} for more details.
+      #
+      #   @param invoice_id [String] The invoice the send charged.
+      #
+      #   @param is_manual_retry [Boolean] Always true on this route. Tells the row apart from an automatic attempt.
+      #
+      #   @param payment_id [String] The payment row this send created.
+      #
+      #   @param retry_attempt [Integer] Which attempt this send is, counting manual sends on the invoice.
+      #
+      #   @param sends_allowed [Integer]
+      #
+      #   @param sends_used [Integer] Manual sends spent on this invoice, including this one.
+      #
+      #   @param retry_available_at [Time, nil] When the next send becomes available. Null when no send is left.
+      #
+      #   @param status [Symbol, Dodopayments::Models::IntentStatus, nil] Outcome of the charge. `processing` means the processor has not settled it
+    end
+  end
+end

data/lib/dodopayments/models/manual_retry_state.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    # @see Dodopayments::Resources::Payments#retrieve_retry_state
+    class ManualRetryState < Dodopayments::Internal::Type::BaseModel
+      # @!attribute can_retry
+      #
+      #   @return [Boolean]
+      required :can_retry, Dodopayments::Internal::Type::Boolean
+
+      # @!attribute sends_allowed
+      #
+      #   @return [Integer]
+      required :sends_allowed, Integer
+
+      # @!attribute sends_used
+      #
+      #   @return [Integer]
+      required :sends_used, Integer
+
+      # @!attribute reason
+      #   The code `POST` would fail with. Null when `can_retry` is true.
+      #
+      #   @return [String, nil]
+      optional :reason, String, nil?: true
+
+      # @!attribute retry_available_at
+      #   When the next send becomes available. Null when no send is left, or when the
+      #   block has nothing to do with the cooldown.
+      #
+      #   @return [Time, nil]
+      optional :retry_available_at, Time, nil?: true
+
+      # @!method initialize(can_retry:, sends_allowed:, sends_used:, reason: nil, retry_available_at: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Dodopayments::Models::ManualRetryState} for more details.
+      #
+      #   @param can_retry [Boolean]
+      #
+      #   @param sends_allowed [Integer]
+      #
+      #   @param sends_used [Integer]
+      #
+      #   @param reason [String, nil] The code `POST` would fail with. Null when `can_retry` is true.
+      #
+      #   @param retry_available_at [Time, nil] When the next send becomes available. Null when no send is left, or when
+    end
+  end
+end

data/lib/dodopayments/models/payment_retrieve_retry_state_params.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    # @see Dodopayments::Resources::Payments#retrieve_retry_state
+    class PaymentRetrieveRetryStateParams < 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/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

@@ -40,13 +40,6 @@ module Dodopayments
         #   @return [Integer]
         required :price, Integer
 
-        # @!attribute purchasing_power_parity
-        #   Indicates if purchasing power parity adjustments are applied to the price.
-        #   Purchasing power parity feature is not available as of now.
-        #
-        #   @return [Boolean]
-        required :purchasing_power_parity, Dodopayments::Internal::Type::Boolean
-
         # @!attribute type
         #
         #   @return [Symbol, :one_time_price]
@@ -59,6 +52,14 @@ module Dodopayments
         #   @return [Boolean, nil]
         optional :pay_what_you_want, Dodopayments::Internal::Type::Boolean
 
+        # @!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
+        #   business-wide. Defaults to `false`.
+        #
+        #   @return [Boolean, nil]
+        optional :purchasing_power_parity, Dodopayments::Internal::Type::Boolean
+
         # @!attribute suggested_price
         #   A suggested price for the user to pay. This value is only considered if
         #   [`pay_what_you_want`](Self::pay_what_you_want) is `true`. Otherwise, it is
@@ -73,7 +74,7 @@ module Dodopayments
         #   @return [Boolean, nil]
         optional :tax_inclusive, Dodopayments::Internal::Type::Boolean, nil?: true
 
-        # @!method initialize(currency:, discount:, price:, purchasing_power_parity:, pay_what_you_want: nil, suggested_price: nil, tax_inclusive: nil, type: :one_time_price)
+        # @!method initialize(currency:, discount:, price:, 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.
         #
@@ -85,10 +86,10 @@ module Dodopayments
         #
         #   @param price [Integer] The payment amount, in the smallest denomination of the currency (e.g., cents fo
         #
-        #   @param purchasing_power_parity [Boolean] Indicates if purchasing power parity adjustments are applied to the price.
-        #
         #   @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
+        #
         #   @param suggested_price [Integer, nil] A suggested price for the user to pay. This value is only considered if
         #
         #   @param tax_inclusive [Boolean, nil] Indicates if the price is tax inclusive.
@@ -129,13 +130,6 @@ module Dodopayments
         #   @return [Integer]
         required :price, Integer
 
-        # @!attribute purchasing_power_parity
-        #   Indicates if purchasing power parity adjustments are applied to the price.
-        #   Purchasing power parity feature is not available as of now
-        #
-        #   @return [Boolean]
-        required :purchasing_power_parity, Dodopayments::Internal::Type::Boolean
-
         # @!attribute subscription_period_count
         #   Number of units for the subscription period. For example, a value of `12` with a
         #   `subscription_period_interval` of `month` represents a one-year subscription.
@@ -154,6 +148,14 @@ module Dodopayments
         #   @return [Symbol, :recurring_price]
         required :type, const: :recurring_price
 
+        # @!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
+        #   business-wide. Defaults to `false`.
+        #
+        #   @return [Boolean, nil]
+        optional :purchasing_power_parity, Dodopayments::Internal::Type::Boolean
+
         # @!attribute tax_inclusive
         #   Indicates if the price is tax inclusive
         #
@@ -180,7 +182,7 @@ module Dodopayments
         #   @return [Integer, nil]
         optional :trial_period_days, Integer
 
-        # @!method initialize(currency:, discount:, payment_frequency_count:, payment_frequency_interval:, price:, purchasing_power_parity:, subscription_period_count:, subscription_period_interval:, tax_inclusive: nil, trial_amount: nil, trial_apply_discounts: nil, trial_period_days: nil, type: :recurring_price)
+        # @!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)
         #   Some parameter documentations has been truncated, see
         #   {Dodopayments::Models::Price::RecurringPrice} for more details.
         #
@@ -196,12 +198,12 @@ module Dodopayments
         #
         #   @param price [Integer] The payment amount. Represented in the lowest denomination of the currency (e.g.
         #
-        #   @param purchasing_power_parity [Boolean] Indicates if purchasing power parity adjustments are applied to the price.
-        #
         #   @param subscription_period_count [Integer] Number of units for the subscription period.
         #
         #   @param subscription_period_interval [Symbol, Dodopayments::Models::TimeInterval] The time interval for the subscription period (e.g., day, month, year).
         #
+        #   @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
         #
         #   @param trial_amount [Integer, nil] Amount charged today for a paid trial, in the price currency's minor units.
@@ -246,13 +248,6 @@ module Dodopayments
         #   @return [Symbol, Dodopayments::Models::TimeInterval]
         required :payment_frequency_interval, enum: -> { Dodopayments::TimeInterval }
 
-        # @!attribute purchasing_power_parity
-        #   Indicates if purchasing power parity adjustments are applied to the price.
-        #   Purchasing power parity feature is not available as of now
-        #
-        #   @return [Boolean]
-        required :purchasing_power_parity, Dodopayments::Internal::Type::Boolean
-
         # @!attribute subscription_period_count
         #   Number of units for the subscription period. For example, a value of `12` with a
         #   `subscription_period_interval` of `month` represents a one-year subscription.
@@ -280,13 +275,22 @@ module Dodopayments
                  },
                  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
+        #   business-wide. Applies to the fixed fee only, never to metered usage. Defaults
+        #   to `false`.
+        #
+        #   @return [Boolean, nil]
+        optional :purchasing_power_parity, Dodopayments::Internal::Type::Boolean
+
         # @!attribute tax_inclusive
         #   Indicates if the price is tax inclusive
         #
         #   @return [Boolean, nil]
         optional :tax_inclusive, Dodopayments::Internal::Type::Boolean, nil?: true
 
-        # @!method initialize(currency:, discount:, fixed_price:, payment_frequency_count:, payment_frequency_interval:, purchasing_power_parity:, subscription_period_count:, subscription_period_interval:, meters: nil, tax_inclusive: nil, type: :usage_based_price)
+        # @!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)
         #   Some parameter documentations has been truncated, see
         #   {Dodopayments::Models::Price::UsageBasedPrice} for more details.
         #
@@ -302,14 +306,14 @@ module Dodopayments
         #
         #   @param payment_frequency_interval [Symbol, Dodopayments::Models::TimeInterval] The time interval for the payment frequency (e.g., day, month, year).
         #
-        #   @param purchasing_power_parity [Boolean] Indicates if purchasing power parity adjustments are applied to the price.
-        #
         #   @param subscription_period_count [Integer] Number of units for the subscription period.
         #
         #   @param subscription_period_interval [Symbol, Dodopayments::Models::TimeInterval] The time interval for the subscription period (e.g., day, month, year).
         #
         #   @param meters [Array<Dodopayments::Models::AddMeterToPrice>, nil]
         #
+        #   @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
         #
         #   @param type [Symbol, :usage_based_price]

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

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    # @see Dodopayments::Resources::Subscriptions#change_plan
+    class SubscriptionChangePlanResponse < Dodopayments::Internal::Type::BaseModel
+      # @!attribute client_secret
+      #   Client secret for an embedded checkout.
+      #
+      #   @return [String, nil]
+      optional :client_secret, String, nil?: true
+
+      # @!attribute expires_on
+      #   When the link stops working.
+      #
+      #   @return [Time, nil]
+      optional :expires_on, Time, nil?: true
+
+      # @!attribute payment_id
+      #   Id of the payment that settles the plan change.
+      #
+      #   @return [String, nil]
+      optional :payment_id, String, nil?: true
+
+      # @!attribute payment_link
+      #   Checkout page URL. Give this to the customer.
+      #
+      #   @return [String, nil]
+      optional :payment_link, String, nil?: true
+
+      # @!method initialize(client_secret: nil, expires_on: nil, payment_id: nil, payment_link: nil)
+      #   Handles for a hosted checkout page that settles a plan change.
+      #
+      #   The four fields repeat `UpdatePaymentMethodResponse` and a subset of
+      #   `CreateSubscriptionResponse`. A shared type would rename the generated SDK types
+      #   for all three routes, so each route keeps its own.
+      #
+      #   @param client_secret [String, nil] Client secret for an embedded checkout.
+      #
+      #   @param expires_on [Time, nil] When the link stops working.
+      #
+      #   @param payment_id [String, nil] Id of the payment that settles the plan change.
+      #
+      #   @param payment_link [String, nil] Checkout page URL. Give this to the customer.
+    end
+  end
+end

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