dodopayments 2.26.0 → 2.28.0

data/rbi/dodopayments/models/price.rbi

@@ -28,10 +28,6 @@ module Dodopayments
         sig { returns(Dodopayments::Currency::OrSymbol) }
         attr_accessor :currency
 
-        # Discount applied to the price, represented as a percentage (0 to 100).
-        sig { returns(Integer) }
-        attr_accessor :discount
-
         # The payment amount, in the smallest denomination of the currency (e.g., cents
         # for USD). For example, to charge $1.00, pass `100`.
         #
@@ -43,6 +39,24 @@ module Dodopayments
         sig { returns(Symbol) }
         attr_accessor :type
 
+        # 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`.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :discount
+
+        sig { params(discount: Integer).void }
+        attr_writer :discount
+
+        # 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.
+        sig { returns(T.nilable(Integer)) }
+        attr_accessor :discount_bps
+
         # Indicates whether the customer can pay any amount they choose. If set to `true`,
         # the [`price`](Self::price) field is the minimum amount.
         sig { returns(T.nilable(T::Boolean)) }
@@ -74,8 +88,9 @@ module Dodopayments
         sig do
           params(
             currency: Dodopayments::Currency::OrSymbol,
-            discount: Integer,
             price: Integer,
+            discount: Integer,
+            discount_bps: T.nilable(Integer),
             pay_what_you_want: T::Boolean,
             purchasing_power_parity: T::Boolean,
             suggested_price: T.nilable(Integer),
@@ -86,14 +101,23 @@ module Dodopayments
         def self.new(
           # The currency in which the payment is made.
           currency:,
-          # Discount applied to the price, represented as a percentage (0 to 100).
-          discount:,
           # The payment amount, in the smallest denomination of the currency (e.g., cents
           # for USD). For example, to charge $1.00, pass `100`.
           #
           # If [`pay_what_you_want`](Self::pay_what_you_want) is set to `true`, this field
           # represents the **minimum** amount the customer must pay.
           price:,
+          # 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`.
+          discount: nil,
+          # 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.
+          discount_bps: nil,
           # Indicates whether the customer can pay any amount they choose. If set to `true`,
           # the [`price`](Self::price) field is the minimum amount.
           pay_what_you_want: nil,
@@ -115,9 +139,10 @@ module Dodopayments
           override.returns(
             {
               currency: Dodopayments::Currency::OrSymbol,
-              discount: Integer,
               price: Integer,
               type: Symbol,
+              discount: Integer,
+              discount_bps: T.nilable(Integer),
               pay_what_you_want: T::Boolean,
               purchasing_power_parity: T::Boolean,
               suggested_price: T.nilable(Integer),
@@ -142,10 +167,6 @@ module Dodopayments
         sig { returns(Dodopayments::Currency::OrSymbol) }
         attr_accessor :currency
 
-        # Discount applied to the price, represented as a percentage (0 to 100).
-        sig { returns(Integer) }
-        attr_accessor :discount
-
         # Number of units for the payment frequency. For example, a value of `1` with a
         # `payment_frequency_interval` of `month` represents monthly payments.
         sig { returns(Integer) }
@@ -172,6 +193,24 @@ module Dodopayments
         sig { returns(Symbol) }
         attr_accessor :type
 
+        # 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`.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :discount
+
+        sig { params(discount: Integer).void }
+        attr_writer :discount
+
+        # 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.
+        sig { returns(T.nilable(Integer)) }
+        attr_accessor :discount_bps
+
         # 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`.
@@ -195,6 +234,13 @@ module Dodopayments
         sig { returns(T.nilable(T::Boolean)) }
         attr_accessor :trial_apply_discounts
 
+        # Let a customer start a free trial with no card. Defaults to false.
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_reader :trial_payment_method_optional
+
+        sig { params(trial_payment_method_optional: T::Boolean).void }
+        attr_writer :trial_payment_method_optional
+
         # Number of days for the trial period. A value of `0` indicates no trial period.
         sig { returns(T.nilable(Integer)) }
         attr_reader :trial_period_days
@@ -202,29 +248,38 @@ module Dodopayments
         sig { params(trial_period_days: Integer).void }
         attr_writer :trial_period_days
 
+        # 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.
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_reader :zero_amount_payment_method_optional
+
+        sig { params(zero_amount_payment_method_optional: T::Boolean).void }
+        attr_writer :zero_amount_payment_method_optional
+
         # Recurring price details.
         sig do
           params(
             currency: Dodopayments::Currency::OrSymbol,
-            discount: Integer,
             payment_frequency_count: Integer,
             payment_frequency_interval: Dodopayments::TimeInterval::OrSymbol,
             price: Integer,
             subscription_period_count: Integer,
             subscription_period_interval: Dodopayments::TimeInterval::OrSymbol,
+            discount: Integer,
+            discount_bps: T.nilable(Integer),
             purchasing_power_parity: T::Boolean,
             tax_inclusive: T.nilable(T::Boolean),
             trial_amount: T.nilable(Integer),
             trial_apply_discounts: T.nilable(T::Boolean),
+            trial_payment_method_optional: T::Boolean,
             trial_period_days: Integer,
+            zero_amount_payment_method_optional: T::Boolean,
             type: Symbol
           ).returns(T.attached_class)
         end
         def self.new(
           # The currency in which the payment is made.
           currency:,
-          # Discount applied to the price, represented as a percentage (0 to 100).
-          discount:,
           # Number of units for the payment frequency. For example, a value of `1` with a
           # `payment_frequency_interval` of `month` represents monthly payments.
           payment_frequency_count:,
@@ -238,6 +293,17 @@ module Dodopayments
           subscription_period_count:,
           # The time interval for the subscription period (e.g., day, month, year).
           subscription_period_interval:,
+          # 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`.
+          discount: nil,
+          # 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.
+          discount_bps: nil,
           # 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`.
@@ -250,8 +316,13 @@ module Dodopayments
           # Whether discount codes reduce the trial charge. Defaults to false. Only
           # meaningful when a paid trial is configured.
           trial_apply_discounts: nil,
+          # Let a customer start a free trial with no card. Defaults to false.
+          trial_payment_method_optional: nil,
           # Number of days for the trial period. A value of `0` indicates no trial period.
           trial_period_days: nil,
+          # 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.
+          zero_amount_payment_method_optional: nil,
           type: :recurring_price
         )
         end
@@ -260,7 +331,6 @@ module Dodopayments
           override.returns(
             {
               currency: Dodopayments::Currency::OrSymbol,
-              discount: Integer,
               payment_frequency_count: Integer,
               payment_frequency_interval: Dodopayments::TimeInterval::OrSymbol,
               price: Integer,
@@ -268,11 +338,15 @@ module Dodopayments
               subscription_period_interval:
                 Dodopayments::TimeInterval::OrSymbol,
               type: Symbol,
+              discount: Integer,
+              discount_bps: T.nilable(Integer),
               purchasing_power_parity: T::Boolean,
               tax_inclusive: T.nilable(T::Boolean),
               trial_amount: T.nilable(Integer),
               trial_apply_discounts: T.nilable(T::Boolean),
-              trial_period_days: Integer
+              trial_payment_method_optional: T::Boolean,
+              trial_period_days: Integer,
+              zero_amount_payment_method_optional: T::Boolean
             }
           )
         end
@@ -293,10 +367,6 @@ module Dodopayments
         sig { returns(Dodopayments::Currency::OrSymbol) }
         attr_accessor :currency
 
-        # Discount applied to the price, represented as a percentage (0 to 100).
-        sig { returns(Integer) }
-        attr_accessor :discount
-
         # 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`.
         sig { returns(Integer) }
@@ -323,6 +393,24 @@ module Dodopayments
         sig { returns(Symbol) }
         attr_accessor :type
 
+        # 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`.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :discount
+
+        sig { params(discount: Integer).void }
+        attr_writer :discount
+
+        # 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.
+        sig { returns(T.nilable(Integer)) }
+        attr_accessor :discount_bps
+
         sig { returns(T.nilable(T::Array[Dodopayments::AddMeterToPrice])) }
         attr_accessor :meters
 
@@ -344,12 +432,13 @@ module Dodopayments
         sig do
           params(
             currency: Dodopayments::Currency::OrSymbol,
-            discount: Integer,
             fixed_price: Integer,
             payment_frequency_count: Integer,
             payment_frequency_interval: Dodopayments::TimeInterval::OrSymbol,
             subscription_period_count: Integer,
             subscription_period_interval: Dodopayments::TimeInterval::OrSymbol,
+            discount: Integer,
+            discount_bps: T.nilable(Integer),
             meters: T.nilable(T::Array[Dodopayments::AddMeterToPrice::OrHash]),
             purchasing_power_parity: T::Boolean,
             tax_inclusive: T.nilable(T::Boolean),
@@ -359,8 +448,6 @@ module Dodopayments
         def self.new(
           # The currency in which the payment is made.
           currency:,
-          # Discount applied to the price, represented as a percentage (0 to 100).
-          discount:,
           # 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`.
           fixed_price:,
@@ -374,6 +461,17 @@ module Dodopayments
           subscription_period_count:,
           # The time interval for the subscription period (e.g., day, month, year).
           subscription_period_interval:,
+          # 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`.
+          discount: nil,
+          # 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.
+          discount_bps: nil,
           meters: nil,
           # Opts this price in to purchasing power parity. The business must also enable
           # purchasing power parity. The discount percentage per country is always
@@ -390,7 +488,6 @@ module Dodopayments
           override.returns(
             {
               currency: Dodopayments::Currency::OrSymbol,
-              discount: Integer,
               fixed_price: Integer,
               payment_frequency_count: Integer,
               payment_frequency_interval: Dodopayments::TimeInterval::OrSymbol,
@@ -398,6 +495,8 @@ module Dodopayments
               subscription_period_interval:
                 Dodopayments::TimeInterval::OrSymbol,
               type: Symbol,
+              discount: Integer,
+              discount_bps: T.nilable(Integer),
               meters: T.nilable(T::Array[Dodopayments::AddMeterToPrice]),
               purchasing_power_parity: T::Boolean,
               tax_inclusive: T.nilable(T::Boolean)

data/rbi/dodopayments/models/subscription.rbi

@@ -48,6 +48,11 @@ module Dodopayments
       end
       attr_writer :customer
 
+      # Whether a payment method is on file. False while a card-optional subscription
+      # waits for the customer to add one.
+      sig { returns(T::Boolean) }
+      attr_accessor :has_payment_method
+
       # Additional custom data associated with the subscription
       sig { returns(T::Hash[Symbol, Dodopayments::MetadataItem::Variants]) }
       attr_accessor :metadata
@@ -201,6 +206,7 @@ module Dodopayments
             T::Array[Dodopayments::CreditEntitlementCartResponse::OrHash],
           currency: Dodopayments::Currency::OrSymbol,
           customer: Dodopayments::CustomerLimitedDetails::OrHash,
+          has_payment_method: T::Boolean,
           metadata: T::Hash[Symbol, Dodopayments::MetadataItem::Variants],
           meter_credit_entitlement_cart:
             T::Array[Dodopayments::MeterCreditEntitlementCartResponse::OrHash],
@@ -255,6 +261,9 @@ module Dodopayments
         currency:,
         # Customer details associated with the subscription
         customer:,
+        # Whether a payment method is on file. False while a card-optional subscription
+        # waits for the customer to add one.
+        has_payment_method:,
         # Additional custom data associated with the subscription
         metadata:,
         # Meter credit entitlement cart settings for this subscription
@@ -338,6 +347,7 @@ module Dodopayments
               T::Array[Dodopayments::CreditEntitlementCartResponse],
             currency: Dodopayments::Currency::TaggedSymbol,
             customer: Dodopayments::CustomerLimitedDetails,
+            has_payment_method: T::Boolean,
             metadata: T::Hash[Symbol, Dodopayments::MetadataItem::Variants],
             meter_credit_entitlement_cart:
               T::Array[Dodopayments::MeterCreditEntitlementCartResponse],

data/rbi/dodopayments/models/subscription_active_webhook_event.rbi

@@ -15,11 +15,16 @@ module Dodopayments
       sig { returns(String) }
       attr_accessor :business_id
 
-      # Response struct representing subscription details
-      sig { returns(Dodopayments::Subscription) }
+      # Subscription payload sent on a webhook. It carries every field of
+      # `SubscriptionResponse`, plus the grace-period deadline.
+      sig { returns(Dodopayments::SubscriptionActiveWebhookEvent::Data) }
       attr_reader :data
 
-      sig { params(data: Dodopayments::Subscription::OrHash).void }
+      sig do
+        params(
+          data: Dodopayments::SubscriptionActiveWebhookEvent::Data::OrHash
+        ).void
+      end
       attr_writer :data
 
       # The timestamp of when the event occurred
@@ -33,7 +38,7 @@ module Dodopayments
       sig do
         params(
           business_id: String,
-          data: Dodopayments::Subscription::OrHash,
+          data: Dodopayments::SubscriptionActiveWebhookEvent::Data::OrHash,
           timestamp: Time,
           type: Symbol
         ).returns(T.attached_class)
@@ -41,7 +46,8 @@ module Dodopayments
       def self.new(
         # The business identifier
         business_id:,
-        # Response struct representing subscription details
+        # Subscription payload sent on a webhook. It carries every field of
+        # `SubscriptionResponse`, plus the grace-period deadline.
         data:,
         # The timestamp of when the event occurred
         timestamp:,
@@ -54,7 +60,7 @@ module Dodopayments
         override.returns(
           {
             business_id: String,
-            data: Dodopayments::Subscription,
+            data: Dodopayments::SubscriptionActiveWebhookEvent::Data,
             timestamp: Time,
             type: Symbol
           }
@@ -62,6 +68,47 @@ module Dodopayments
       end
       def to_hash
       end
+
+      class Data < Dodopayments::Models::Subscription
+        OrHash =
+          T.type_alias do
+            T.any(
+              Dodopayments::SubscriptionActiveWebhookEvent::Data,
+              Dodopayments::Internal::AnyHash
+            )
+          end
+
+        # 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.
+        sig { returns(T.nilable(Time)) }
+        attr_accessor :past_due_ends_at
+
+        # Subscription payload sent on a webhook. It carries every field of
+        # `SubscriptionResponse`, plus the grace-period deadline.
+        sig do
+          params(past_due_ends_at: T.nilable(Time)).returns(T.attached_class)
+        end
+        def self.new(
+          # 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.
+          past_due_ends_at: nil
+        )
+        end
+
+        sig { override.returns({ past_due_ends_at: T.nilable(Time) }) }
+        def to_hash
+        end
+      end
     end
   end
 end

data/rbi/dodopayments/models/subscription_cancelled_webhook_event.rbi

@@ -15,11 +15,16 @@ module Dodopayments
       sig { returns(String) }
       attr_accessor :business_id
 
-      # Response struct representing subscription details
-      sig { returns(Dodopayments::Subscription) }
+      # Subscription payload sent on a webhook. It carries every field of
+      # `SubscriptionResponse`, plus the grace-period deadline.
+      sig { returns(Dodopayments::SubscriptionCancelledWebhookEvent::Data) }
       attr_reader :data
 
-      sig { params(data: Dodopayments::Subscription::OrHash).void }
+      sig do
+        params(
+          data: Dodopayments::SubscriptionCancelledWebhookEvent::Data::OrHash
+        ).void
+      end
       attr_writer :data
 
       # The timestamp of when the event occurred
@@ -33,7 +38,7 @@ module Dodopayments
       sig do
         params(
           business_id: String,
-          data: Dodopayments::Subscription::OrHash,
+          data: Dodopayments::SubscriptionCancelledWebhookEvent::Data::OrHash,
           timestamp: Time,
           type: Symbol
         ).returns(T.attached_class)
@@ -41,7 +46,8 @@ module Dodopayments
       def self.new(
         # The business identifier
         business_id:,
-        # Response struct representing subscription details
+        # Subscription payload sent on a webhook. It carries every field of
+        # `SubscriptionResponse`, plus the grace-period deadline.
         data:,
         # The timestamp of when the event occurred
         timestamp:,
@@ -54,7 +60,7 @@ module Dodopayments
         override.returns(
           {
             business_id: String,
-            data: Dodopayments::Subscription,
+            data: Dodopayments::SubscriptionCancelledWebhookEvent::Data,
             timestamp: Time,
             type: Symbol
           }
@@ -62,6 +68,47 @@ module Dodopayments
       end
       def to_hash
       end
+
+      class Data < Dodopayments::Models::Subscription
+        OrHash =
+          T.type_alias do
+            T.any(
+              Dodopayments::SubscriptionCancelledWebhookEvent::Data,
+              Dodopayments::Internal::AnyHash
+            )
+          end
+
+        # 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.
+        sig { returns(T.nilable(Time)) }
+        attr_accessor :past_due_ends_at
+
+        # Subscription payload sent on a webhook. It carries every field of
+        # `SubscriptionResponse`, plus the grace-period deadline.
+        sig do
+          params(past_due_ends_at: T.nilable(Time)).returns(T.attached_class)
+        end
+        def self.new(
+          # 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.
+          past_due_ends_at: nil
+        )
+        end
+
+        sig { override.returns({ past_due_ends_at: T.nilable(Time) }) }
+        def to_hash
+        end
+      end
     end
   end
 end

data/rbi/dodopayments/models/subscription_create_response.rbi

@@ -32,6 +32,11 @@ module Dodopayments
       sig { returns(String) }
       attr_accessor :payment_id
 
+      # False when the customer can start this subscription with no card. True for every
+      # other subscription.
+      sig { returns(T::Boolean) }
+      attr_accessor :payment_method_required
+
       # Tax will be added to the amount and charged to the customer on each billing
       # cycle
       sig { returns(Integer) }
@@ -86,6 +91,7 @@ module Dodopayments
           customer: Dodopayments::CustomerLimitedDetails::OrHash,
           metadata: T::Hash[Symbol, Dodopayments::MetadataItem::Variants],
           payment_id: String,
+          payment_method_required: T::Boolean,
           recurring_pre_tax_amount: Integer,
           subscription_id: String,
           client_secret: T.nilable(String),
@@ -111,6 +117,9 @@ module Dodopayments
         metadata:,
         # First payment id for the subscription
         payment_id:,
+        # False when the customer can start this subscription with no card. True for every
+        # other subscription.
+        payment_method_required:,
         # Tax will be added to the amount and charged to the customer on each billing
         # cycle
         recurring_pre_tax_amount:,
@@ -143,6 +152,7 @@ module Dodopayments
             customer: Dodopayments::CustomerLimitedDetails,
             metadata: T::Hash[Symbol, Dodopayments::MetadataItem::Variants],
             payment_id: String,
+            payment_method_required: T::Boolean,
             recurring_pre_tax_amount: Integer,
             subscription_id: String,
             client_secret: T.nilable(String),

data/rbi/dodopayments/models/subscription_expired_webhook_event.rbi

@@ -15,11 +15,16 @@ module Dodopayments
       sig { returns(String) }
       attr_accessor :business_id
 
-      # Response struct representing subscription details
-      sig { returns(Dodopayments::Subscription) }
+      # Subscription payload sent on a webhook. It carries every field of
+      # `SubscriptionResponse`, plus the grace-period deadline.
+      sig { returns(Dodopayments::SubscriptionExpiredWebhookEvent::Data) }
       attr_reader :data
 
-      sig { params(data: Dodopayments::Subscription::OrHash).void }
+      sig do
+        params(
+          data: Dodopayments::SubscriptionExpiredWebhookEvent::Data::OrHash
+        ).void
+      end
       attr_writer :data
 
       # The timestamp of when the event occurred
@@ -33,7 +38,7 @@ module Dodopayments
       sig do
         params(
           business_id: String,
-          data: Dodopayments::Subscription::OrHash,
+          data: Dodopayments::SubscriptionExpiredWebhookEvent::Data::OrHash,
           timestamp: Time,
           type: Symbol
         ).returns(T.attached_class)
@@ -41,7 +46,8 @@ module Dodopayments
       def self.new(
         # The business identifier
         business_id:,
-        # Response struct representing subscription details
+        # Subscription payload sent on a webhook. It carries every field of
+        # `SubscriptionResponse`, plus the grace-period deadline.
         data:,
         # The timestamp of when the event occurred
         timestamp:,
@@ -54,7 +60,7 @@ module Dodopayments
         override.returns(
           {
             business_id: String,
-            data: Dodopayments::Subscription,
+            data: Dodopayments::SubscriptionExpiredWebhookEvent::Data,
             timestamp: Time,
             type: Symbol
           }
@@ -62,6 +68,47 @@ module Dodopayments
       end
       def to_hash
       end
+
+      class Data < Dodopayments::Models::Subscription
+        OrHash =
+          T.type_alias do
+            T.any(
+              Dodopayments::SubscriptionExpiredWebhookEvent::Data,
+              Dodopayments::Internal::AnyHash
+            )
+          end
+
+        # 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.
+        sig { returns(T.nilable(Time)) }
+        attr_accessor :past_due_ends_at
+
+        # Subscription payload sent on a webhook. It carries every field of
+        # `SubscriptionResponse`, plus the grace-period deadline.
+        sig do
+          params(past_due_ends_at: T.nilable(Time)).returns(T.attached_class)
+        end
+        def self.new(
+          # 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.
+          past_due_ends_at: nil
+        )
+        end
+
+        sig { override.returns({ past_due_ends_at: T.nilable(Time) }) }
+        def to_hash
+        end
+      end
     end
   end
 end