dodopayments 2.26.0 → 2.28.0

data/rbi/dodopayments/models/subscription_failed_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::SubscriptionFailedWebhookEvent::Data) }
       attr_reader :data
 
-      sig { params(data: Dodopayments::Subscription::OrHash).void }
+      sig do
+        params(
+          data: Dodopayments::SubscriptionFailedWebhookEvent::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::SubscriptionFailedWebhookEvent::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::SubscriptionFailedWebhookEvent::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::SubscriptionFailedWebhookEvent::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_list_params.rbi

@@ -186,6 +186,11 @@ module Dodopayments
             :expired,
             Dodopayments::SubscriptionListParams::Status::TaggedSymbol
           )
+        PAST_DUE =
+          T.let(
+            :past_due,
+            Dodopayments::SubscriptionListParams::Status::TaggedSymbol
+          )
 
         sig do
           override.returns(

data/rbi/dodopayments/models/subscription_list_response.rbi

@@ -47,6 +47,11 @@ module Dodopayments
       end
       attr_accessor :discounts
 
+      # 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
@@ -172,6 +177,7 @@ module Dodopayments
             T::Array[
               Dodopayments::Models::SubscriptionListResponse::Discount::OrHash
             ],
+          has_payment_method: T::Boolean,
           metadata: T::Hash[Symbol, Dodopayments::MetadataItem::Variants],
           next_billing_date: Time,
           on_demand: T::Boolean,
@@ -213,6 +219,9 @@ module Dodopayments
         customer:,
         # All stacked discounts applied, in order of application
         discounts:,
+        # 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:,
         # Timestamp of the next scheduled billing. Indicates the end of current billing
@@ -284,6 +293,7 @@ module Dodopayments
               T::Array[
                 Dodopayments::Models::SubscriptionListResponse::Discount
               ],
+            has_payment_method: T::Boolean,
             metadata: T::Hash[Symbol, Dodopayments::MetadataItem::Variants],
             next_billing_date: Time,
             on_demand: T::Boolean,

data/rbi/dodopayments/models/subscription_on_hold_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::SubscriptionOnHoldWebhookEvent::Data) }
       attr_reader :data
 
-      sig { params(data: Dodopayments::Subscription::OrHash).void }
+      sig do
+        params(
+          data: Dodopayments::SubscriptionOnHoldWebhookEvent::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::SubscriptionOnHoldWebhookEvent::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::SubscriptionOnHoldWebhookEvent::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::SubscriptionOnHoldWebhookEvent::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_past_due_webhook_event.rbi

@@ -0,0 +1,114 @@
+# typed: strong
+
+module Dodopayments
+  module Models
+    class SubscriptionPastDueWebhookEvent < Dodopayments::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Dodopayments::SubscriptionPastDueWebhookEvent,
+            Dodopayments::Internal::AnyHash
+          )
+        end
+
+      # The business identifier
+      sig { returns(String) }
+      attr_accessor :business_id
+
+      # Subscription payload sent on a webhook. It carries every field of
+      # `SubscriptionResponse`, plus the grace-period deadline.
+      sig { returns(Dodopayments::SubscriptionPastDueWebhookEvent::Data) }
+      attr_reader :data
+
+      sig do
+        params(
+          data: Dodopayments::SubscriptionPastDueWebhookEvent::Data::OrHash
+        ).void
+      end
+      attr_writer :data
+
+      # The timestamp of when the event occurred
+      sig { returns(Time) }
+      attr_accessor :timestamp
+
+      # The event type
+      sig { returns(Symbol) }
+      attr_accessor :type
+
+      sig do
+        params(
+          business_id: String,
+          data: Dodopayments::SubscriptionPastDueWebhookEvent::Data::OrHash,
+          timestamp: Time,
+          type: Symbol
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The business identifier
+        business_id:,
+        # 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:,
+        # The event type
+        type: :"subscription.past_due"
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            business_id: String,
+            data: Dodopayments::SubscriptionPastDueWebhookEvent::Data,
+            timestamp: Time,
+            type: Symbol
+          }
+        )
+      end
+      def to_hash
+      end
+
+      class Data < Dodopayments::Models::Subscription
+        OrHash =
+          T.type_alias do
+            T.any(
+              Dodopayments::SubscriptionPastDueWebhookEvent::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_paused_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::SubscriptionPausedWebhookEvent::Data) }
       attr_reader :data
 
-      sig { params(data: Dodopayments::Subscription::OrHash).void }
+      sig do
+        params(
+          data: Dodopayments::SubscriptionPausedWebhookEvent::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::SubscriptionPausedWebhookEvent::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::SubscriptionPausedWebhookEvent::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::SubscriptionPausedWebhookEvent::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_plan_changed_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::SubscriptionPlanChangedWebhookEvent::Data) }
       attr_reader :data
 
-      sig { params(data: Dodopayments::Subscription::OrHash).void }
+      sig do
+        params(
+          data: Dodopayments::SubscriptionPlanChangedWebhookEvent::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::SubscriptionPlanChangedWebhookEvent::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::SubscriptionPlanChangedWebhookEvent::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::SubscriptionPlanChangedWebhookEvent::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_renewed_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::SubscriptionRenewedWebhookEvent::Data) }
       attr_reader :data
 
-      sig { params(data: Dodopayments::Subscription::OrHash).void }
+      sig do
+        params(
+          data: Dodopayments::SubscriptionRenewedWebhookEvent::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::SubscriptionRenewedWebhookEvent::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::SubscriptionRenewedWebhookEvent::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::SubscriptionRenewedWebhookEvent::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_status.rbi

@@ -17,6 +17,8 @@ module Dodopayments
         T.let(:cancelled, Dodopayments::SubscriptionStatus::TaggedSymbol)
       FAILED = T.let(:failed, Dodopayments::SubscriptionStatus::TaggedSymbol)
       EXPIRED = T.let(:expired, Dodopayments::SubscriptionStatus::TaggedSymbol)
+      PAST_DUE =
+        T.let(:past_due, Dodopayments::SubscriptionStatus::TaggedSymbol)
 
       sig do
         override.returns(