dodopayments 2.32.2 → 2.33.0

data/lib/dodopayments/models/subscription_update_payment_method_webhook_event.rb

@@ -55,7 +55,14 @@ module Dodopayments
         #   @return [Time, nil]
         optional :past_due_ends_at, Time, nil?: true
 
-        # @!method initialize(past_due_ends_at: nil)
+        # @!attribute payment_id
+        #   Identifier of the payment that caused this event. It is set only for
+        #   `subscription.renewed`. It is null for all other subscription events.
+        #
+        #   @return [String, nil]
+        optional :payment_id, String, nil?: true
+
+        # @!method initialize(past_due_ends_at: nil, payment_id: nil)
         #   Some parameter documentations has been truncated, see
         #   {Dodopayments::Models::SubscriptionUpdatePaymentMethodWebhookEvent::Data} for
         #   more details.
@@ -64,6 +71,8 @@ module Dodopayments
         #   `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
+        #
+        #   @param payment_id [String, nil] Identifier of the payment that caused this event.
       end
     end
   end

data/lib/dodopayments/models/subscription_updated_webhook_event.rb

@@ -54,7 +54,14 @@ module Dodopayments
         #   @return [Time, nil]
         optional :past_due_ends_at, Time, nil?: true
 
-        # @!method initialize(past_due_ends_at: nil)
+        # @!attribute payment_id
+        #   Identifier of the payment that caused this event. It is set only for
+        #   `subscription.renewed`. It is null for all other subscription events.
+        #
+        #   @return [String, nil]
+        optional :payment_id, String, nil?: true
+
+        # @!method initialize(past_due_ends_at: nil, payment_id: nil)
         #   Some parameter documentations has been truncated, see
         #   {Dodopayments::Models::SubscriptionUpdatedWebhookEvent::Data} for more details.
         #
@@ -62,6 +69,8 @@ module Dodopayments
         #   `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
+        #
+        #   @param payment_id [String, nil] Identifier of the payment that caused this event.
       end
     end
   end

data/lib/dodopayments/models/update_subscription_plan_req.rb

@@ -190,6 +190,7 @@ module Dodopayments
         FULL_IMMEDIATELY = :full_immediately
         DIFFERENCE_IMMEDIATELY = :difference_immediately
         DO_NOT_BILL = :do_not_bill
+        PRORATED_IMMEDIATELY_KEEP_CYCLE = :prorated_immediately_keep_cycle
 
         # @!method self.values
         #   @return [Array<Symbol>]

data/lib/dodopayments/models/webhook_payload.rb

@@ -101,7 +101,14 @@ module Dodopayments
           #   @return [Time, nil]
           optional :past_due_ends_at, Time, nil?: true
 
-          # @!method initialize(past_due_ends_at: nil, payload_type: :Subscription)
+          # @!attribute payment_id
+          #   Identifier of the payment that caused this event. It is set only for
+          #   `subscription.renewed`. It is null for all other subscription events.
+          #
+          #   @return [String, nil]
+          optional :payment_id, String, nil?: true
+
+          # @!method initialize(past_due_ends_at: nil, payment_id: nil, payload_type: :Subscription)
           #   Some parameter documentations has been truncated, see
           #   {Dodopayments::Models::WebhookPayload::Data::Subscription} for more details.
           #
@@ -109,6 +116,8 @@ module Dodopayments
           #
           #   @param past_due_ends_at [Time, nil] Time when the grace period ends. The subscription moves to `on_hold` or
           #
+          #   @param payment_id [String, nil] Identifier of the payment that caused this event.
+          #
           #   @param payload_type [Symbol, :Subscription]
         end
 

data/lib/dodopayments/models.rb

@@ -514,6 +514,8 @@ module Dodopayments
 
   SubscriptionRetrieveUsageHistoryParams = Dodopayments::Models::SubscriptionRetrieveUsageHistoryParams
 
+  SubscriptionServicePeriod = Dodopayments::Models::SubscriptionServicePeriod
+
   SubscriptionStatus = Dodopayments::Models::SubscriptionStatus
 
   SubscriptionUnpausedWebhookEvent = Dodopayments::Models::SubscriptionUnpausedWebhookEvent

data/lib/dodopayments/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Dodopayments
-  VERSION = "2.32.2"
+  VERSION = "2.33.0"
 end

data/lib/dodopayments.rb

@@ -393,6 +393,7 @@ require_relative "dodopayments/models/subscription_retrieve_credit_usage_respons
 require_relative "dodopayments/models/subscription_retrieve_params"
 require_relative "dodopayments/models/subscription_retrieve_usage_history_params"
 require_relative "dodopayments/models/subscription_retrieve_usage_history_response"
+require_relative "dodopayments/models/subscription_service_period"
 require_relative "dodopayments/models/subscription_status"
 require_relative "dodopayments/models/subscription_unpaused_webhook_event"
 require_relative "dodopayments/models/subscription_updated_webhook_event"

data/rbi/dodopayments/models/balance_ledger_entry.rbi

@@ -268,6 +268,21 @@ module Dodopayments
             :moderation_fees,
             Dodopayments::BalanceLedgerEntry::EventType::TaggedSymbol
           )
+        DODO_FIXED_FEE =
+          T.let(
+            :dodo_fixed_fee,
+            Dodopayments::BalanceLedgerEntry::EventType::TaggedSymbol
+          )
+        INTERCHANGE_FEE =
+          T.let(
+            :interchange_fee,
+            Dodopayments::BalanceLedgerEntry::EventType::TaggedSymbol
+          )
+        SCHEME_FEE =
+          T.let(
+            :scheme_fee,
+            Dodopayments::BalanceLedgerEntry::EventType::TaggedSymbol
+          )
 
         sig do
           override.returns(

data/rbi/dodopayments/models/balance_retrieve_ledger_params.rbi

@@ -1060,6 +1060,21 @@ module Dodopayments
             :moderation_fees,
             Dodopayments::BalanceRetrieveLedgerParams::EventType::TaggedSymbol
           )
+        DODO_FIXED_FEE =
+          T.let(
+            :dodo_fixed_fee,
+            Dodopayments::BalanceRetrieveLedgerParams::EventType::TaggedSymbol
+          )
+        INTERCHANGE_FEE =
+          T.let(
+            :interchange_fee,
+            Dodopayments::BalanceRetrieveLedgerParams::EventType::TaggedSymbol
+          )
+        SCHEME_FEE =
+          T.let(
+            :scheme_fee,
+            Dodopayments::BalanceRetrieveLedgerParams::EventType::TaggedSymbol
+          )
 
         sig do
           override.returns(

data/rbi/dodopayments/models/checkout_session_flags.rbi

@@ -83,6 +83,9 @@ module Dodopayments
 
       # If the customer is allowed to apply discount code, set it to true.
       #
+      # If this flag is false, the customer cannot change the discount codes. The
+      # discount codes that you give when you create the session still apply.
+      #
       # Default is true
       sig { returns(T.nilable(T::Boolean)) }
       attr_reader :allow_discount_code
@@ -234,6 +237,9 @@ module Dodopayments
         allow_customer_editing_zipcode: nil,
         # If the customer is allowed to apply discount code, set it to true.
         #
+        # If this flag is false, the customer cannot change the discount codes. The
+        # discount codes that you give when you create the session still apply.
+        #
         # Default is true
         allow_discount_code: nil,
         # If true, the customer can add or remove addons on a subscription product during

data/rbi/dodopayments/models/manual_retry_state.rbi

@@ -17,6 +17,20 @@ module Dodopayments
       sig { returns(Integer) }
       attr_accessor :sends_used
 
+      # The number of the queued automatic retry, starting at 1.
+      sig { returns(T.nilable(Integer)) }
+      attr_accessor :automatic_retry_number
+
+      # The number of automatic retries that the current configuration plans for this
+      # invoice. It is never less than `automatic_retry_number`.
+      sig { returns(T.nilable(Integer)) }
+      attr_accessor :automatic_retry_total
+
+      # When the next automatic retry on this invoice is scheduled. Null when no
+      # automatic retry is queued or automatic retries are disabled.
+      sig { returns(T.nilable(Time)) }
+      attr_accessor :next_automatic_retry_at
+
       # The code `POST` would fail with. Null when `can_retry` is true.
       sig { returns(T.nilable(String)) }
       attr_accessor :reason
@@ -31,6 +45,9 @@ module Dodopayments
           can_retry: T::Boolean,
           sends_allowed: Integer,
           sends_used: Integer,
+          automatic_retry_number: T.nilable(Integer),
+          automatic_retry_total: T.nilable(Integer),
+          next_automatic_retry_at: T.nilable(Time),
           reason: T.nilable(String),
           retry_available_at: T.nilable(Time)
         ).returns(T.attached_class)
@@ -39,6 +56,14 @@ module Dodopayments
         can_retry:,
         sends_allowed:,
         sends_used:,
+        # The number of the queued automatic retry, starting at 1.
+        automatic_retry_number: nil,
+        # The number of automatic retries that the current configuration plans for this
+        # invoice. It is never less than `automatic_retry_number`.
+        automatic_retry_total: nil,
+        # When the next automatic retry on this invoice is scheduled. Null when no
+        # automatic retry is queued or automatic retries are disabled.
+        next_automatic_retry_at: nil,
         # The code `POST` would fail with. Null when `can_retry` is true.
         reason: nil,
         # When the next send becomes available. Null when no send is left, or when the
@@ -53,6 +78,9 @@ module Dodopayments
             can_retry: T::Boolean,
             sends_allowed: Integer,
             sends_used: Integer,
+            automatic_retry_number: T.nilable(Integer),
+            automatic_retry_total: T.nilable(Integer),
+            next_automatic_retry_at: T.nilable(Time),
             reason: T.nilable(String),
             retry_available_at: T.nilable(Time)
           }

data/rbi/dodopayments/models/payment.rbi

@@ -82,6 +82,14 @@ module Dodopayments
       sig { returns(Integer) }
       attr_accessor :retry_attempt
 
+      # The service period of each subscription that this payment pays for. The order is
+      # the same as `subscription_ids`. For a plan change charge, the period starts at
+      # the plan change and ends at the next billing date. The list is empty unless the
+      # payment status is `succeeded`. The list is also empty for a one-time payment, an
+      # on-demand charge, or a payment method update.
+      sig { returns(T::Array[Dodopayments::SubscriptionServicePeriod]) }
+      attr_accessor :service_periods
+
       # The amount that will be credited to your Dodo balance after currency conversion
       # and processing. Especially relevant for adaptive pricing where the customer's
       # payment currency differs from your settlement currency.
@@ -230,6 +238,8 @@ module Dodopayments
           payment_provider: Dodopayments::Payment::PaymentProvider::OrSymbol,
           refunds: T::Array[Dodopayments::RefundListItem::OrHash],
           retry_attempt: Integer,
+          service_periods:
+            T::Array[Dodopayments::SubscriptionServicePeriod::OrHash],
           settlement_amount: Integer,
           settlement_currency: Dodopayments::Currency::OrSymbol,
           subscription_ids: T::Array[String],
@@ -299,6 +309,12 @@ module Dodopayments
         # payment, `1`+ for each scheduled off-session retry after a failed renewal.
         # Always `0` for non-subscription payments.
         retry_attempt:,
+        # The service period of each subscription that this payment pays for. The order is
+        # the same as `subscription_ids`. For a plan change charge, the period starts at
+        # the plan change and ends at the next billing date. The list is empty unless the
+        # payment status is `succeeded`. The list is also empty for a one-time payment, an
+        # on-demand charge, or a payment method update.
+        service_periods:,
         # The amount that will be credited to your Dodo balance after currency conversion
         # and processing. Especially relevant for adaptive pricing where the customer's
         # payment currency differs from your settlement currency.
@@ -394,6 +410,7 @@ module Dodopayments
               Dodopayments::Payment::PaymentProvider::TaggedSymbol,
             refunds: T::Array[Dodopayments::RefundListItem],
             retry_attempt: Integer,
+            service_periods: T::Array[Dodopayments::SubscriptionServicePeriod],
             settlement_amount: Integer,
             settlement_currency: Dodopayments::Currency::TaggedSymbol,
             subscription_ids: T::Array[String],

data/rbi/dodopayments/models/payment_list_response.rbi

@@ -56,6 +56,20 @@ module Dodopayments
       end
       attr_accessor :payment_provider
 
+      # The retry attempt number of this payment. The value is `0` for the original
+      # payment. Each retry after a failed subscription renewal adds `1`. The value is
+      # always `0` for a payment that is not for a subscription.
+      sig { returns(Integer) }
+      attr_accessor :retry_attempt
+
+      # The service period of each subscription that this payment pays for. The order is
+      # the same as `subscription_ids`. For a plan change charge, the period starts at
+      # the plan change and ends at the next billing date. The list is empty unless the
+      # payment status is `succeeded`. The list is also empty for a one-time payment, an
+      # on-demand charge, or a payment method update.
+      sig { returns(T::Array[Dodopayments::SubscriptionServicePeriod]) }
+      attr_accessor :service_periods
+
       # Every subscription that this payment starts or charges, in a stable order. It is
       # empty for a one-time payment. It holds the value of `subscription_id` when the
       # payment names one subscription.
@@ -73,6 +87,11 @@ module Dodopayments
       sig { returns(T.nilable(String)) }
       attr_accessor :card_network
 
+      # The ID of the checkout session for this payment. The value is null when the
+      # payment does not use a checkout session.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :checkout_session_id
+
       # The most recent dispute status for this payment. None if no disputes exist.
       sig { returns(T.nilable(Dodopayments::DisputeStatus::TaggedSymbol)) }
       attr_accessor :dispute_status
@@ -117,10 +136,14 @@ module Dodopayments
           payment_id: String,
           payment_provider:
             Dodopayments::Models::PaymentListResponse::PaymentProvider::OrSymbol,
+          retry_attempt: Integer,
+          service_periods:
+            T::Array[Dodopayments::SubscriptionServicePeriod::OrHash],
           subscription_ids: T::Array[String],
           total_amount: Integer,
           card_last_four: T.nilable(String),
           card_network: T.nilable(String),
+          checkout_session_id: T.nilable(String),
           dispute_status: T.nilable(Dodopayments::DisputeStatus::OrSymbol),
           invoice_id: T.nilable(String),
           invoice_url: T.nilable(String),
@@ -148,6 +171,16 @@ module Dodopayments
         # Which processor handled this payment. `stripe` / `adyen` for BYOP routes (the
         # merchant's own payment connector); `dodo` for everything Dodo processed itself.
         payment_provider:,
+        # The retry attempt number of this payment. The value is `0` for the original
+        # payment. Each retry after a failed subscription renewal adds `1`. The value is
+        # always `0` for a payment that is not for a subscription.
+        retry_attempt:,
+        # The service period of each subscription that this payment pays for. The order is
+        # the same as `subscription_ids`. For a plan change charge, the period starts at
+        # the plan change and ends at the next billing date. The list is empty unless the
+        # payment status is `succeeded`. The list is also empty for a one-time payment, an
+        # on-demand charge, or a payment method update.
+        service_periods:,
         # Every subscription that this payment starts or charges, in a stable order. It is
         # empty for a one-time payment. It holds the value of `subscription_id` when the
         # payment names one subscription.
@@ -157,6 +190,9 @@ module Dodopayments
         card_last_four: nil,
         # Card network like VISA, MASTERCARD etc.
         card_network: nil,
+        # The ID of the checkout session for this payment. The value is null when the
+        # payment does not use a checkout session.
+        checkout_session_id: nil,
         # The most recent dispute status for this payment. None if no disputes exist.
         dispute_status: nil,
         # Invoice ID for this payment. Uses India-specific invoice ID if available.
@@ -187,10 +223,13 @@ module Dodopayments
             payment_id: String,
             payment_provider:
               Dodopayments::Models::PaymentListResponse::PaymentProvider::TaggedSymbol,
+            retry_attempt: Integer,
+            service_periods: T::Array[Dodopayments::SubscriptionServicePeriod],
             subscription_ids: T::Array[String],
             total_amount: Integer,
             card_last_four: T.nilable(String),
             card_network: T.nilable(String),
+            checkout_session_id: T.nilable(String),
             dispute_status:
               T.nilable(Dodopayments::DisputeStatus::TaggedSymbol),
             invoice_id: T.nilable(String),

data/rbi/dodopayments/models/product_collection.rbi

@@ -350,6 +350,11 @@ module Dodopayments
             :do_not_bill,
             Dodopayments::ProductCollection::ProrationBillingModeOnDowngrade::TaggedSymbol
           )
+        PRORATED_IMMEDIATELY_KEEP_CYCLE =
+          T.let(
+            :prorated_immediately_keep_cycle,
+            Dodopayments::ProductCollection::ProrationBillingModeOnDowngrade::TaggedSymbol
+          )
 
         sig do
           override.returns(
@@ -396,6 +401,11 @@ module Dodopayments
             :do_not_bill,
             Dodopayments::ProductCollection::ProrationBillingModeOnUpgrade::TaggedSymbol
           )
+        PRORATED_IMMEDIATELY_KEEP_CYCLE =
+          T.let(
+            :prorated_immediately_keep_cycle,
+            Dodopayments::ProductCollection::ProrationBillingModeOnUpgrade::TaggedSymbol
+          )
 
         sig do
           override.returns(

data/rbi/dodopayments/models/product_collection_create_params.rbi

@@ -330,6 +330,11 @@ module Dodopayments
             :do_not_bill,
             Dodopayments::ProductCollectionCreateParams::ProrationBillingModeOnDowngrade::TaggedSymbol
           )
+        PRORATED_IMMEDIATELY_KEEP_CYCLE =
+          T.let(
+            :prorated_immediately_keep_cycle,
+            Dodopayments::ProductCollectionCreateParams::ProrationBillingModeOnDowngrade::TaggedSymbol
+          )
 
         sig do
           override.returns(
@@ -376,6 +381,11 @@ module Dodopayments
             :do_not_bill,
             Dodopayments::ProductCollectionCreateParams::ProrationBillingModeOnUpgrade::TaggedSymbol
           )
+        PRORATED_IMMEDIATELY_KEEP_CYCLE =
+          T.let(
+            :prorated_immediately_keep_cycle,
+            Dodopayments::ProductCollectionCreateParams::ProrationBillingModeOnUpgrade::TaggedSymbol
+          )
 
         sig do
           override.returns(

data/rbi/dodopayments/models/product_collection_update_params.rbi

@@ -332,6 +332,11 @@ module Dodopayments
             :do_not_bill,
             Dodopayments::ProductCollectionUpdateParams::ProrationBillingModeOnDowngrade::TaggedSymbol
           )
+        PRORATED_IMMEDIATELY_KEEP_CYCLE =
+          T.let(
+            :prorated_immediately_keep_cycle,
+            Dodopayments::ProductCollectionUpdateParams::ProrationBillingModeOnDowngrade::TaggedSymbol
+          )
 
         sig do
           override.returns(
@@ -378,6 +383,11 @@ module Dodopayments
             :do_not_bill,
             Dodopayments::ProductCollectionUpdateParams::ProrationBillingModeOnUpgrade::TaggedSymbol
           )
+        PRORATED_IMMEDIATELY_KEEP_CYCLE =
+          T.let(
+            :prorated_immediately_keep_cycle,
+            Dodopayments::ProductCollectionUpdateParams::ProrationBillingModeOnUpgrade::TaggedSymbol
+          )
 
         sig do
           override.returns(

data/rbi/dodopayments/models/refund.rbi

@@ -71,6 +71,12 @@ module Dodopayments
       end
       attr_accessor :network_reference_type
 
+      # The time in UTC when `network_reference` became available. It is null when the
+      # reference is not available, or when it became available before this field
+      # existed.
+      sig { returns(T.nilable(Time)) }
+      attr_accessor :network_reference_updated_at
+
       # The reason provided for the refund, if any. Optional.
       sig { returns(T.nilable(String)) }
       attr_accessor :reason
@@ -91,6 +97,7 @@ module Dodopayments
           network_reference: T.nilable(String),
           network_reference_type:
             T.nilable(Dodopayments::RefundNetworkReferenceType::OrSymbol),
+          network_reference_updated_at: T.nilable(Time),
           reason: T.nilable(String)
         ).returns(T.attached_class)
       end
@@ -123,6 +130,10 @@ module Dodopayments
         network_reference: nil,
         # The kind of `network_reference`: ARN, STAN or RRN.
         network_reference_type: nil,
+        # The time in UTC when `network_reference` became available. It is null when the
+        # reference is not available, or when it became available before this field
+        # existed.
+        network_reference_updated_at: nil,
         # The reason provided for the refund, if any. Optional.
         reason: nil
       )
@@ -145,6 +156,7 @@ module Dodopayments
             network_reference: T.nilable(String),
             network_reference_type:
               T.nilable(Dodopayments::RefundNetworkReferenceType::TaggedSymbol),
+            network_reference_updated_at: T.nilable(Time),
             reason: T.nilable(String)
           }
         )

data/rbi/dodopayments/models/refund_list_item.rbi

@@ -54,6 +54,12 @@ module Dodopayments
       end
       attr_accessor :network_reference_type
 
+      # The time in UTC when `network_reference` became available. It is null when the
+      # reference is not available, or when it became available before this field
+      # existed.
+      sig { returns(T.nilable(Time)) }
+      attr_accessor :network_reference_updated_at
+
       # The reason provided for the refund, if any. Optional.
       sig { returns(T.nilable(String)) }
       attr_accessor :reason
@@ -71,6 +77,7 @@ module Dodopayments
           network_reference: T.nilable(String),
           network_reference_type:
             T.nilable(Dodopayments::RefundNetworkReferenceType::OrSymbol),
+          network_reference_updated_at: T.nilable(Time),
           reason: T.nilable(String)
         ).returns(T.attached_class)
       end
@@ -97,6 +104,10 @@ module Dodopayments
         network_reference: nil,
         # The kind of `network_reference`: ARN, STAN or RRN.
         network_reference_type: nil,
+        # The time in UTC when `network_reference` became available. It is null when the
+        # reference is not available, or when it became available before this field
+        # existed.
+        network_reference_updated_at: nil,
         # The reason provided for the refund, if any. Optional.
         reason: nil
       )
@@ -116,6 +127,7 @@ module Dodopayments
             network_reference: T.nilable(String),
             network_reference_type:
               T.nilable(Dodopayments::RefundNetworkReferenceType::TaggedSymbol),
+            network_reference_updated_at: T.nilable(Time),
             reason: T.nilable(String)
           }
         )

data/rbi/dodopayments/models/subscription_active_webhook_event.rbi

@@ -88,10 +88,18 @@ module Dodopayments
         sig { returns(T.nilable(Time)) }
         attr_accessor :past_due_ends_at
 
+        # Identifier of the payment that caused this event. It is set only for
+        # `subscription.renewed`. It is null for all other subscription events.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :payment_id
+
         # 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)
+          params(
+            past_due_ends_at: T.nilable(Time),
+            payment_id: T.nilable(String)
+          ).returns(T.attached_class)
         end
         def self.new(
           # Time when the grace period ends. The subscription moves to `on_hold` or to
@@ -101,11 +109,18 @@ module Dodopayments
           # 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
+          past_due_ends_at: nil,
+          # Identifier of the payment that caused this event. It is set only for
+          # `subscription.renewed`. It is null for all other subscription events.
+          payment_id: nil
         )
         end
 
-        sig { override.returns({ past_due_ends_at: T.nilable(Time) }) }
+        sig do
+          override.returns(
+            { past_due_ends_at: T.nilable(Time), payment_id: T.nilable(String) }
+          )
+        end
         def to_hash
         end
       end

data/rbi/dodopayments/models/subscription_cancelled_webhook_event.rbi

@@ -88,10 +88,18 @@ module Dodopayments
         sig { returns(T.nilable(Time)) }
         attr_accessor :past_due_ends_at
 
+        # Identifier of the payment that caused this event. It is set only for
+        # `subscription.renewed`. It is null for all other subscription events.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :payment_id
+
         # 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)
+          params(
+            past_due_ends_at: T.nilable(Time),
+            payment_id: T.nilable(String)
+          ).returns(T.attached_class)
         end
         def self.new(
           # Time when the grace period ends. The subscription moves to `on_hold` or to
@@ -101,11 +109,18 @@ module Dodopayments
           # 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
+          past_due_ends_at: nil,
+          # Identifier of the payment that caused this event. It is set only for
+          # `subscription.renewed`. It is null for all other subscription events.
+          payment_id: nil
         )
         end
 
-        sig { override.returns({ past_due_ends_at: T.nilable(Time) }) }
+        sig do
+          override.returns(
+            { past_due_ends_at: T.nilable(Time), payment_id: T.nilable(String) }
+          )
+        end
         def to_hash
         end
       end

data/rbi/dodopayments/models/subscription_expired_webhook_event.rbi

@@ -88,10 +88,18 @@ module Dodopayments
         sig { returns(T.nilable(Time)) }
         attr_accessor :past_due_ends_at
 
+        # Identifier of the payment that caused this event. It is set only for
+        # `subscription.renewed`. It is null for all other subscription events.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :payment_id
+
         # 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)
+          params(
+            past_due_ends_at: T.nilable(Time),
+            payment_id: T.nilable(String)
+          ).returns(T.attached_class)
         end
         def self.new(
           # Time when the grace period ends. The subscription moves to `on_hold` or to
@@ -101,11 +109,18 @@ module Dodopayments
           # 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
+          past_due_ends_at: nil,
+          # Identifier of the payment that caused this event. It is set only for
+          # `subscription.renewed`. It is null for all other subscription events.
+          payment_id: nil
         )
         end
 
-        sig { override.returns({ past_due_ends_at: T.nilable(Time) }) }
+        sig do
+          override.returns(
+            { past_due_ends_at: T.nilable(Time), payment_id: T.nilable(String) }
+          )
+        end
         def to_hash
         end
       end