dodopayments 2.26.0 → 2.27.0

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/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_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_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

data/lib/dodopayments/models/subscription_past_due_webhook_event.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    class SubscriptionPastDueWebhookEvent < Dodopayments::Internal::Type::BaseModel
+      # @!attribute business_id
+      #   The business identifier
+      #
+      #   @return [String]
+      required :business_id, String
+
+      # @!attribute data
+      #   Subscription payload sent on a webhook. It carries every field of
+      #   `SubscriptionResponse`, plus the grace-period deadline.
+      #
+      #   @return [Dodopayments::Models::SubscriptionPastDueWebhookEvent::Data]
+      required :data, -> { Dodopayments::SubscriptionPastDueWebhookEvent::Data }
+
+      # @!attribute timestamp
+      #   The timestamp of when the event occurred
+      #
+      #   @return [Time]
+      required :timestamp, Time
+
+      # @!attribute type
+      #   The event type
+      #
+      #   @return [Symbol, :"subscription.past_due"]
+      required :type, const: :"subscription.past_due"
+
+      # @!method initialize(business_id:, data:, timestamp:, type: :"subscription.past_due")
+      #   Some parameter documentations has been truncated, see
+      #   {Dodopayments::Models::SubscriptionPastDueWebhookEvent} for more details.
+      #
+      #   @param business_id [String] The business identifier
+      #
+      #   @param data [Dodopayments::Models::SubscriptionPastDueWebhookEvent::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.past_due"] The event type
+
+      # @see Dodopayments::Models::SubscriptionPastDueWebhookEvent#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::SubscriptionPastDueWebhookEvent::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_paused_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::SubscriptionPausedWebhookEvent::Data]
+      required :data, -> { Dodopayments::SubscriptionPausedWebhookEvent::Data }
 
       # @!attribute timestamp
       #   The timestamp of when the event occurred
@@ -28,13 +29,40 @@ module Dodopayments
       required :type, const: :"subscription.paused"
 
       # @!method initialize(business_id:, data:, timestamp:, type: :"subscription.paused")
+      #   Some parameter documentations has been truncated, see
+      #   {Dodopayments::Models::SubscriptionPausedWebhookEvent} for more details.
+      #
       #   @param business_id [String] The business identifier
       #
-      #   @param data [Dodopayments::Models::Subscription] Response struct representing subscription details
+      #   @param data [Dodopayments::Models::SubscriptionPausedWebhookEvent::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.paused"] The event type
+
+      # @see Dodopayments::Models::SubscriptionPausedWebhookEvent#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::SubscriptionPausedWebhookEvent::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_plan_changed_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::SubscriptionPlanChangedWebhookEvent::Data]
+      required :data, -> { Dodopayments::SubscriptionPlanChangedWebhookEvent::Data }
 
       # @!attribute timestamp
       #   The timestamp of when the event occurred
@@ -28,13 +29,41 @@ module Dodopayments
       required :type, const: :"subscription.plan_changed"
 
       # @!method initialize(business_id:, data:, timestamp:, type: :"subscription.plan_changed")
+      #   Some parameter documentations has been truncated, see
+      #   {Dodopayments::Models::SubscriptionPlanChangedWebhookEvent} for more details.
+      #
       #   @param business_id [String] The business identifier
       #
-      #   @param data [Dodopayments::Models::Subscription] Response struct representing subscription details
+      #   @param data [Dodopayments::Models::SubscriptionPlanChangedWebhookEvent::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.plan_changed"] The event type
+
+      # @see Dodopayments::Models::SubscriptionPlanChangedWebhookEvent#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::SubscriptionPlanChangedWebhookEvent::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