dodopayments 2.32.1 → 2.33.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ef1be38d6c9556b1c146575b34a4f4d8ad2db18b190d918cb191d84d39b64fa1
-  data.tar.gz: c4cbac2db3c1b11b4c6abb932fee6040c70ef3b9be1e336636f605814eb69a51
+  metadata.gz: 27eda33527f7fc36507b133919bcf76f5bfe1d537e875e0ed762c3b3fd5aad53
+  data.tar.gz: 904efd6de1bbdc9e54a65483709a8d9d3c7f0b4496011d46e9f69bb753e26083
 SHA512:
-  metadata.gz: baafc8d5785e2698aba3a7901c04b4120f49ea95b277da059eaf26e48d663ddc54709ad87bc7cf73066171b79838fc5630ef034baa0bd918b257366ccabf05e0
-  data.tar.gz: b82b6b4f3ec62d210363c1510be0f8d915f62fc93c4fbb1530f92cff26ec71cc61ee9b6a73268c952a1e1df870bcac749a6e4725b7f5097c19d86202b96fc1a8
+  metadata.gz: b4eb25c02f04ca12ea6b41f3b3d254d7afbdce14137dd5213b52994d172b227ec5a87db193a6ed4c0330fcda867f79e522a1b0f74ebc6e6a8e23d81dc2615bab
+  data.tar.gz: f72f531842560027f90d5fc5ec789025487305ec95993829a79b704210803d81cb8a33c357cb09a79be7abef9e030673b325663a2d27b6427d78737ade894f0e

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [2.33.0](https://github.com/dodopayments/dodopayments-ruby/compare/v2.32.2...v2.33.0) (2026-10-14)
+
+
+### Features
+
+* **api:** payment service periods, retry attempts and subscription renewal payment_id ([4fc54c1](https://github.com/dodopayments/dodopayments-ruby/commit/4fc54c154ba2b49a904249f27d30a7b5b7fb165d))
+* **api:** payment service periods, retry attempts and subscription renewal payment_id ([53b94e3](https://github.com/dodopayments/dodopayments-ruby/commit/53b94e35bbff1d1882582852e58e9cc592ab1772))
+
+## [2.32.2](https://github.com/dodopayments/dodopayments-ruby/compare/v2.32.1...v2.32.2) (2026-10-09)
+
+
+### Bug Fixes
+
+* **deps:** upgrade SDK toolchains (pnpm, uv, TypeScript 7, Gradle 9, okhttp 5, zod 4) and stop cursor pagination on done ([a5672d8](https://github.com/dodopayments/dodopayments-ruby/commit/a5672d8d65e5bc9d738fae31f708aae54984034a))
+* **deps:** upgrade SDK toolchains (pnpm, uv, TypeScript 7, Gradle 9, okhttp 5, zod 4) and stop cursor pagination on done ([7e80b1c](https://github.com/dodopayments/dodopayments-ruby/commit/7e80b1c860b58e16d08c8d6b6bb5822199726ab2))
+
 ## [2.32.1](https://github.com/dodopayments/dodopayments-ruby/compare/v2.32.0...v2.32.1) (2026-10-09)
 
 

data/README.md

@@ -23,7 +23,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "dodopayments", "~> 2.32.1"
+gem "dodopayments", "~> 2.33.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/dodopayments/internal/cursor_page_pagination.rb

@@ -27,7 +27,7 @@ module Dodopayments
 
       # @return [Boolean]
       def next_page?
-        !data.to_a.empty? && !iterator.to_s.empty?
+        (done != true) && !data.to_a.empty? && !iterator.to_s.empty?
       end
 
       # @raise [Dodopayments::HTTP::Error]

data/lib/dodopayments/models/balance_ledger_entry.rb

@@ -119,6 +119,9 @@ module Dodopayments
         RESERVE_HOLD = :reserve_hold
         RESERVE_RELEASE = :reserve_release
         MODERATION_FEES = :moderation_fees
+        DODO_FIXED_FEE = :dodo_fixed_fee
+        INTERCHANGE_FEE = :interchange_fee
+        SCHEME_FEE = :scheme_fee
 
         # @!method self.values
         #   @return [Array<Symbol>]

data/lib/dodopayments/models/balance_retrieve_ledger_params.rb

@@ -266,6 +266,9 @@ module Dodopayments
         RESERVE_HOLD = :reserve_hold
         RESERVE_RELEASE = :reserve_release
         MODERATION_FEES = :moderation_fees
+        DODO_FIXED_FEE = :dodo_fixed_fee
+        INTERCHANGE_FEE = :interchange_fee
+        SCHEME_FEE = :scheme_fee
 
         # @!method self.values
         #   @return [Array<Symbol>]

data/lib/dodopayments/models/checkout_session_flags.rb

@@ -66,6 +66,9 @@ module Dodopayments
       # @!attribute allow_discount_code
       #   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
       #
       #   @return [Boolean, nil]

data/lib/dodopayments/models/manual_retry_state.rb

@@ -19,6 +19,26 @@ module Dodopayments
       #   @return [Integer]
       required :sends_used, Integer
 
+      # @!attribute automatic_retry_number
+      #   The number of the queued automatic retry, starting at 1.
+      #
+      #   @return [Integer, nil]
+      optional :automatic_retry_number, Integer, nil?: true
+
+      # @!attribute automatic_retry_total
+      #   The number of automatic retries that the current configuration plans for this
+      #   invoice. It is never less than `automatic_retry_number`.
+      #
+      #   @return [Integer, nil]
+      optional :automatic_retry_total, Integer, nil?: true
+
+      # @!attribute next_automatic_retry_at
+      #   When the next automatic retry on this invoice is scheduled. Null when no
+      #   automatic retry is queued or automatic retries are disabled.
+      #
+      #   @return [Time, nil]
+      optional :next_automatic_retry_at, Time, nil?: true
+
       # @!attribute reason
       #   The code `POST` would fail with. Null when `can_retry` is true.
       #
@@ -32,7 +52,7 @@ module Dodopayments
       #   @return [Time, nil]
       optional :retry_available_at, Time, nil?: true
 
-      # @!method initialize(can_retry:, sends_allowed:, sends_used:, reason: nil, retry_available_at: nil)
+      # @!method initialize(can_retry:, sends_allowed:, sends_used:, automatic_retry_number: nil, automatic_retry_total: nil, next_automatic_retry_at: nil, reason: nil, retry_available_at: nil)
       #   Some parameter documentations has been truncated, see
       #   {Dodopayments::Models::ManualRetryState} for more details.
       #
@@ -42,6 +62,12 @@ module Dodopayments
       #
       #   @param sends_used [Integer]
       #
+      #   @param automatic_retry_number [Integer, nil] The number of the queued automatic retry, starting at 1.
+      #
+      #   @param automatic_retry_total [Integer, nil] The number of automatic retries that the current configuration plans for
+      #
+      #   @param next_automatic_retry_at [Time, nil] When the next automatic retry on this invoice is scheduled. Null when no
+      #
       #   @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

data/lib/dodopayments/models/payment.rb

@@ -100,6 +100,17 @@ module Dodopayments
       #   @return [Integer]
       required :retry_attempt, Integer
 
+      # @!attribute service_periods
+      #   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.
+      #
+      #   @return [Array<Dodopayments::Models::SubscriptionServicePeriod>]
+      required :service_periods,
+               -> { Dodopayments::Internal::Type::ArrayOf[Dodopayments::SubscriptionServicePeriod] }
+
       # @!attribute settlement_amount
       #   The amount that will be credited to your Dodo balance after currency conversion
       #   and processing. Especially relevant for adaptive pricing where the customer's
@@ -293,7 +304,7 @@ module Dodopayments
       #   @return [Time, nil]
       optional :updated_at, Time, nil?: true
 
-      # @!method initialize(billing:, brand_id:, business_id:, created_at:, currency:, customer:, digital_products_delivered:, disputes:, is_multi_subscription:, is_update_payment_method:, metadata:, payment_id:, payment_provider:, refunds:, retry_attempt:, settlement_amount:, settlement_currency:, subscription_ids:, total_amount:, card_holder_name: nil, card_issuing_country: nil, card_last_four: nil, card_network: nil, card_type: nil, checkout_session_id: nil, custom_field_responses: nil, discount_id: nil, discounts: nil, error_code: nil, error_message: nil, invoice_id: nil, invoice_url: nil, payment_link: nil, payment_method: nil, payment_method_id: nil, payment_method_type: nil, product_cart: nil, refund_status: nil, settlement_tax: nil, status: nil, subscription_id: nil, tax: nil, updated_at: nil)
+      # @!method initialize(billing:, brand_id:, business_id:, created_at:, currency:, customer:, digital_products_delivered:, disputes:, is_multi_subscription:, is_update_payment_method:, metadata:, payment_id:, payment_provider:, refunds:, retry_attempt:, service_periods:, settlement_amount:, settlement_currency:, subscription_ids:, total_amount:, card_holder_name: nil, card_issuing_country: nil, card_last_four: nil, card_network: nil, card_type: nil, checkout_session_id: nil, custom_field_responses: nil, discount_id: nil, discounts: nil, error_code: nil, error_message: nil, invoice_id: nil, invoice_url: nil, payment_link: nil, payment_method: nil, payment_method_id: nil, payment_method_type: nil, product_cart: nil, refund_status: nil, settlement_tax: nil, status: nil, subscription_id: nil, tax: nil, updated_at: nil)
       #   Some parameter documentations has been truncated, see
       #   {Dodopayments::Models::Payment} for more details.
       #
@@ -327,6 +338,8 @@ module Dodopayments
       #
       #   @param retry_attempt [Integer] Retry attempt number for subscription renewal payments.
       #
+      #   @param service_periods [Array<Dodopayments::Models::SubscriptionServicePeriod>] The service period of each subscription that this payment pays for.
+      #
       #   @param settlement_amount [Integer] The amount that will be credited to your Dodo balance after currency conversion
       #
       #   @param settlement_currency [Symbol, Dodopayments::Models::Currency] The currency in which the settlement_amount will be credited to your Dodo balanc

data/lib/dodopayments/models/payment_list_response.rb

@@ -60,6 +60,25 @@ module Dodopayments
       #   @return [Symbol, Dodopayments::Models::PaymentListResponse::PaymentProvider]
       required :payment_provider, enum: -> { Dodopayments::Models::PaymentListResponse::PaymentProvider }
 
+      # @!attribute retry_attempt
+      #   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.
+      #
+      #   @return [Integer]
+      required :retry_attempt, Integer
+
+      # @!attribute service_periods
+      #   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.
+      #
+      #   @return [Array<Dodopayments::Models::SubscriptionServicePeriod>]
+      required :service_periods,
+               -> { Dodopayments::Internal::Type::ArrayOf[Dodopayments::SubscriptionServicePeriod] }
+
       # @!attribute subscription_ids
       #   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
@@ -85,6 +104,13 @@ module Dodopayments
       #   @return [String, nil]
       optional :card_network, String, nil?: true
 
+      # @!attribute checkout_session_id
+      #   The ID of the checkout session for this payment. The value is null when the
+      #   payment does not use a checkout session.
+      #
+      #   @return [String, nil]
+      optional :checkout_session_id, String, nil?: true
+
       # @!attribute dispute_status
       #   The most recent dispute status for this payment. None if no disputes exist.
       #
@@ -130,7 +156,7 @@ module Dodopayments
       #   @return [String, nil]
       optional :subscription_id, String, nil?: true
 
-      # @!method initialize(brand_id:, created_at:, currency:, customer:, digital_products_delivered:, has_license_key:, is_multi_subscription:, metadata:, payment_id:, payment_provider:, subscription_ids:, total_amount:, card_last_four: nil, card_network: nil, dispute_status: nil, invoice_id: nil, invoice_url: nil, payment_method: nil, payment_method_type: nil, refund_status: nil, status: nil, subscription_id: nil)
+      # @!method initialize(brand_id:, created_at:, currency:, customer:, digital_products_delivered:, has_license_key:, is_multi_subscription:, metadata:, payment_id:, payment_provider:, retry_attempt:, service_periods:, subscription_ids:, total_amount:, card_last_four: nil, card_network: nil, checkout_session_id: nil, dispute_status: nil, invoice_id: nil, invoice_url: nil, payment_method: nil, payment_method_type: nil, refund_status: nil, status: nil, subscription_id: nil)
       #   Some parameter documentations has been truncated, see
       #   {Dodopayments::Models::PaymentListResponse} for more details.
       #
@@ -154,6 +180,10 @@ module Dodopayments
       #
       #   @param payment_provider [Symbol, Dodopayments::Models::PaymentListResponse::PaymentProvider] Which processor handled this payment. `stripe` / `adyen` for BYOP routes
       #
+      #   @param retry_attempt [Integer] The retry attempt number of this payment. The value is `0` for the original
+      #
+      #   @param service_periods [Array<Dodopayments::Models::SubscriptionServicePeriod>] The service period of each subscription that this payment pays for.
+      #
       #   @param subscription_ids [Array<String>] Every subscription that this payment starts or charges, in a stable order.
       #
       #   @param total_amount [Integer]
@@ -162,6 +192,8 @@ module Dodopayments
       #
       #   @param card_network [String, nil] Card network like VISA, MASTERCARD etc.
       #
+      #   @param checkout_session_id [String, nil] The ID of the checkout session for this payment. The value is null when
+      #
       #   @param dispute_status [Symbol, Dodopayments::Models::DisputeStatus, nil] The most recent dispute status for this payment. None if no disputes exist.
       #
       #   @param invoice_id [String, nil] Invoice ID for this payment. Uses India-specific invoice ID if available.

data/lib/dodopayments/models/product_collection.rb

@@ -179,6 +179,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>]
@@ -195,6 +196,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/product_collection_create_params.rb

@@ -146,6 +146,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>]
@@ -160,6 +161,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/product_collection_update_params.rb

@@ -160,6 +160,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>]
@@ -174,6 +175,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/refund.rb

@@ -84,13 +84,21 @@ module Dodopayments
       #   @return [Symbol, Dodopayments::Models::RefundNetworkReferenceType, nil]
       optional :network_reference_type, enum: -> { Dodopayments::RefundNetworkReferenceType }, nil?: true
 
+      # @!attribute network_reference_updated_at
+      #   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.
+      #
+      #   @return [Time, nil]
+      optional :network_reference_updated_at, Time, nil?: true
+
       # @!attribute reason
       #   The reason provided for the refund, if any. Optional.
       #
       #   @return [String, nil]
       optional :reason, String, nil?: true
 
-      # @!method initialize(brand_id:, business_id:, created_at:, customer:, is_partial:, metadata:, payment_id:, refund_id:, status:, amount: nil, currency: nil, network_reference: nil, network_reference_type: nil, reason: nil)
+      # @!method initialize(brand_id:, business_id:, created_at:, customer:, is_partial:, metadata:, payment_id:, refund_id:, status:, amount: nil, currency: nil, network_reference: nil, network_reference_type: nil, network_reference_updated_at: nil, reason: nil)
       #   Some parameter documentations has been truncated, see
       #   {Dodopayments::Models::Refund} for more details.
       #
@@ -120,6 +128,8 @@ module Dodopayments
       #
       #   @param network_reference_type [Symbol, Dodopayments::Models::RefundNetworkReferenceType, nil] The kind of `network_reference`: ARN, STAN or RRN.
       #
+      #   @param network_reference_updated_at [Time, nil] The time in UTC when `network_reference` became available. It is null when the
+      #
       #   @param reason [String, nil] The reason provided for the refund, if any. Optional.
     end
   end

data/lib/dodopayments/models/refund_list_item.rb

@@ -65,13 +65,21 @@ module Dodopayments
       #   @return [Symbol, Dodopayments::Models::RefundNetworkReferenceType, nil]
       optional :network_reference_type, enum: -> { Dodopayments::RefundNetworkReferenceType }, nil?: true
 
+      # @!attribute network_reference_updated_at
+      #   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.
+      #
+      #   @return [Time, nil]
+      optional :network_reference_updated_at, Time, nil?: true
+
       # @!attribute reason
       #   The reason provided for the refund, if any. Optional.
       #
       #   @return [String, nil]
       optional :reason, String, nil?: true
 
-      # @!method initialize(business_id:, created_at:, is_partial:, payment_id:, refund_id:, status:, amount: nil, currency: nil, network_reference: nil, network_reference_type: nil, reason: nil)
+      # @!method initialize(business_id:, created_at:, is_partial:, payment_id:, refund_id:, status:, amount: nil, currency: nil, network_reference: nil, network_reference_type: nil, network_reference_updated_at: nil, reason: nil)
       #   Some parameter documentations has been truncated, see
       #   {Dodopayments::Models::RefundListItem} for more details.
       #
@@ -95,6 +103,8 @@ module Dodopayments
       #
       #   @param network_reference_type [Symbol, Dodopayments::Models::RefundNetworkReferenceType, nil] The kind of `network_reference`: ARN, STAN or RRN.
       #
+      #   @param network_reference_updated_at [Time, nil] The time in UTC when `network_reference` became available. It is null when the
+      #
       #   @param reason [String, nil] The reason provided for the refund, if any. Optional.
     end
   end

data/lib/dodopayments/models/subscription_active_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::SubscriptionActiveWebhookEvent::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/subscription_cancelled_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::SubscriptionCancelledWebhookEvent::Data} for more
         #   details.
@@ -63,6 +70,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_expired_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::SubscriptionExpiredWebhookEvent::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/subscription_failed_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::SubscriptionFailedWebhookEvent::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/subscription_on_hold_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::SubscriptionOnHoldWebhookEvent::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/subscription_past_due_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::SubscriptionPastDueWebhookEvent::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/subscription_paused_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::SubscriptionPausedWebhookEvent::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/subscription_plan_changed_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::SubscriptionPlanChangedWebhookEvent::Data} for more
         #   details.
@@ -63,6 +70,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_renewed_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::SubscriptionRenewedWebhookEvent::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/subscription_service_period.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    class SubscriptionServicePeriod < Dodopayments::Internal::Type::BaseModel
+      # @!attribute ends_at
+      #   End of the service period.
+      #
+      #   @return [Time]
+      required :ends_at, Time
+
+      # @!attribute starts_at
+      #   Start of the service period. For a renewal, this is the billing date. For a plan
+      #   change that applies at the next billing date, this is the time when the change
+      #   applied. This time can be some minutes after the billing date.
+      #
+      #   @return [Time]
+      required :starts_at, Time
+
+      # @!attribute subscription_id
+      #   Identifier of the subscription.
+      #
+      #   @return [String]
+      required :subscription_id, String
+
+      # @!method initialize(ends_at:, starts_at:, subscription_id:)
+      #   Some parameter documentations has been truncated, see
+      #   {Dodopayments::Models::SubscriptionServicePeriod} for more details.
+      #
+      #   The service period that a payment pays for, for one subscription.
+      #
+      #   @param ends_at [Time] End of the service period.
+      #
+      #   @param starts_at [Time] Start of the service period. For a renewal, this is the billing date. For a
+      #
+      #   @param subscription_id [String] Identifier of the subscription.
+    end
+  end
+end

data/lib/dodopayments/models/subscription_unpaused_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::SubscriptionUnpausedWebhookEvent::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