dodopayments 2.20.0 → 2.20.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e2cd02edaf02bbba60396ecdaa61838414cc46e8358d17a40e7f1b105dc82dc5
-  data.tar.gz: 57d5217495e2ea04533e49716dbffc5b0407bf17f53610b53de90e7bb13293e8
+  metadata.gz: e34bae6e8f112347d01747da053dfdfe8c59aee24d21a3fcd819e84d7e97cba3
+  data.tar.gz: 67ee243d3c0073abd94d91493801a629900c62a60c5281a6dcd42716b224f322
 SHA512:
-  metadata.gz: c66c1e27ffe9b8b5cf488eff8c2e68fd9014db0d390fd1280f78bca1b033e5cca47a1676c54059cebd7c338f83bc0cc052c55a3c33e27d5d7bcc063df30923ad
-  data.tar.gz: ea64df9520da5a12eb56386bd771376624a4bfcfdda8225d823270d6fb687e5876b53c1435f3d3479197f8df4127f20e4a652357af15b369d24b5a594b406c3a
+  metadata.gz: 6c541301db330885909821106447abee6878fe8ef0bc53abce8d91ca151906ae609f57e102cb366826a340cb70d445816b856e7e8bc9881512652a0bd5077362
+  data.tar.gz: 8d9ff09789b3e055edf9e19f310e89fe792e8ebe33376d414caadc0093ed443188b3304d2dad999e66e061a43ec15953d5a62fa0f548ce67c2057401a4694982

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [2.20.1](https://github.com/dodopayments/dodopayments-ruby/compare/v2.20.0...v2.20.1) (2026-07-09)
+
+
+### Bug Fixes
+
+* **api:** add subscription.update_payment_method webhook and payment-method fields ([67881e2](https://github.com/dodopayments/dodopayments-ruby/commit/67881e21860b5692c69085d56a58534bb243fed8))
+* **api:** add subscription.update_payment_method webhook and payment-method fields ([4f62da1](https://github.com/dodopayments/dodopayments-ruby/commit/4f62da18abf750e179ebd2c697958fb00bf0320e))
+
 ## [2.20.0](https://github.com/dodopayments/dodopayments-ruby/compare/v2.19.0...v2.20.0) (2026-07-06)
 
 

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.20.0"
+gem "dodopayments", "~> 2.20.1"
 ```
 
 <!-- x-release-please-end -->

data/lib/dodopayments/models/checkout_session_preview_response.rb

@@ -44,6 +44,15 @@ module Dodopayments
       #   @return [Integer]
       required :total_price, Integer
 
+      # @!attribute next_billing_date
+      #   The upcoming billing date for subscriptions, computed relative to now: with a
+      #   trial it is `now + trial_period_days`, otherwise `now + payment frequency`.
+      #   `None` for one-time-only carts. This is a preview estimate; the authoritative
+      #   value is set when the subscription activates.
+      #
+      #   @return [Time, nil]
+      optional :next_billing_date, Time, nil?: true
+
       # @!attribute recurring_breakup
       #   Breakup of recurring payments (None for one-time only)
       #
@@ -76,7 +85,7 @@ module Dodopayments
       #   @return [Integer, nil]
       optional :total_tax, Integer, nil?: true
 
-      # @!method initialize(billing_country:, currency:, current_breakup:, is_byop:, product_cart:, total_price:, recurring_breakup: nil, tax_id_business_name: nil, tax_id_err_msg: nil, tax_id_format_name: nil, total_tax: nil)
+      # @!method initialize(billing_country:, currency:, current_breakup:, is_byop:, product_cart:, total_price:, next_billing_date: nil, recurring_breakup: nil, tax_id_business_name: nil, tax_id_err_msg: nil, tax_id_format_name: nil, total_tax: nil)
       #   Some parameter documentations has been truncated, see
       #   {Dodopayments::Models::CheckoutSessionPreviewResponse} for more details.
       #
@@ -94,6 +103,8 @@ module Dodopayments
       #
       #   @param total_price [Integer] Total calculate price of the product cart
       #
+      #   @param next_billing_date [Time, nil] The upcoming billing date for subscriptions, computed relative to now:
+      #
       #   @param recurring_breakup [Dodopayments::Models::CheckoutSessionPreviewResponse::RecurringBreakup, nil] Breakup of recurring payments (None for one-time only)
       #
       #   @param tax_id_business_name [String, nil] Registered business name from the official registry (EU/GB/AU) when found

data/lib/dodopayments/models/payment.rb

@@ -52,6 +52,13 @@ module Dodopayments
       #   @return [Array<Dodopayments::Models::Dispute>]
       required :disputes, -> { Dodopayments::Internal::Type::ArrayOf[Dodopayments::Dispute] }
 
+      # @!attribute is_update_payment_method
+      #   Whether this payment was created solely to update a subscription's payment
+      #   method (a zero-/setup-amount charge). `false` for normal charges.
+      #
+      #   @return [Boolean]
+      required :is_update_payment_method, Dodopayments::Internal::Type::Boolean
+
       # @!attribute metadata
       #   Additional custom data associated with the payment
       #
@@ -206,6 +213,12 @@ module Dodopayments
       #   @return [String, nil]
       optional :payment_method, String, nil?: true
 
+      # @!attribute payment_method_id
+      #   Identifier of the saved payment method used for this payment, if any.
+      #
+      #   @return [String, nil]
+      optional :payment_method_id, String, nil?: true
+
       # @!attribute payment_method_type
       #   Specific type of payment method (e.g. "visa", "mastercard")
       #
@@ -260,7 +273,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:, metadata:, payment_id:, payment_provider:, refunds:, retry_attempt:, settlement_amount:, settlement_currency:, 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_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_update_payment_method:, metadata:, payment_id:, payment_provider:, refunds:, retry_attempt:, settlement_amount:, settlement_currency:, 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.
       #
@@ -280,6 +293,8 @@ module Dodopayments
       #
       #   @param disputes [Array<Dodopayments::Models::Dispute>] List of disputes associated with this payment
       #
+      #   @param is_update_payment_method [Boolean] Whether this payment was created solely to update a subscription's
+      #
       #   @param metadata [Hash{Symbol=>String, Float, Boolean}] Additional custom data associated with the payment
       #
       #   @param payment_id [String] Unique identifier for the payment
@@ -326,6 +341,8 @@ module Dodopayments
       #
       #   @param payment_method [String, nil] Payment method used by customer (e.g. "card", "bank_transfer")
       #
+      #   @param payment_method_id [String, nil] Identifier of the saved payment method used for this payment, if any.
+      #
       #   @param payment_method_type [String, nil] Specific type of payment method (e.g. "visa", "mastercard")
       #
       #   @param product_cart [Array<Dodopayments::Models::Payment::ProductCart>, nil] List of products purchased in a one-time payment

data/lib/dodopayments/models/subscription_list_params.rb

@@ -13,6 +13,12 @@ module Dodopayments
       #   @return [String, nil]
       optional :brand_id, String
 
+      # @!attribute cancel_at_next_billing_date
+      #   Filter by cancel_at_next_billing_date (subscriptions scheduled for cancellation)
+      #
+      #   @return [Boolean, nil]
+      optional :cancel_at_next_billing_date, Dodopayments::Internal::Type::Boolean
+
       # @!attribute created_at_gte
       #   Get events after this created time
       #
@@ -55,9 +61,14 @@ module Dodopayments
       #   @return [Symbol, Dodopayments::Models::SubscriptionListParams::Status, nil]
       optional :status, enum: -> { Dodopayments::SubscriptionListParams::Status }
 
-      # @!method initialize(brand_id: nil, created_at_gte: nil, created_at_lte: nil, customer_id: nil, page_number: nil, page_size: nil, product_id: nil, status: nil, request_options: {})
+      # @!method initialize(brand_id: nil, cancel_at_next_billing_date: nil, created_at_gte: nil, created_at_lte: nil, customer_id: nil, page_number: nil, page_size: nil, product_id: nil, status: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Dodopayments::Models::SubscriptionListParams} for more details.
+      #
       #   @param brand_id [String] filter by Brand id
       #
+      #   @param cancel_at_next_billing_date [Boolean] Filter by cancel_at_next_billing_date (subscriptions scheduled for cancellation)
+      #
       #   @param created_at_gte [Time] Get events after this created time
       #
       #   @param created_at_lte [Time] Get events created before this time

data/lib/dodopayments/models/subscription_update_payment_method_webhook_event.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    class SubscriptionUpdatePaymentMethodWebhookEvent < Dodopayments::Internal::Type::BaseModel
+      # @!attribute business_id
+      #   The business identifier
+      #
+      #   @return [String]
+      required :business_id, String
+
+      # @!attribute data
+      #   Response struct representing subscription details
+      #
+      #   @return [Dodopayments::Models::Subscription]
+      required :data, -> { Dodopayments::Subscription }
+
+      # @!attribute timestamp
+      #   The timestamp of when the event occurred
+      #
+      #   @return [Time]
+      required :timestamp, Time
+
+      # @!attribute type
+      #   The event type
+      #
+      #   @return [Symbol, :"subscription.update_payment_method"]
+      required :type, const: :"subscription.update_payment_method"
+
+      # @!method initialize(business_id:, data:, timestamp:, type: :"subscription.update_payment_method")
+      #   @param business_id [String] The business identifier
+      #
+      #   @param data [Dodopayments::Models::Subscription] Response struct representing subscription details
+      #
+      #   @param timestamp [Time] The timestamp of when the event occurred
+      #
+      #   @param type [Symbol, :"subscription.update_payment_method"] The event type
+    end
+  end
+end

data/lib/dodopayments/models/unsafe_unwrap_webhook_event.rb

@@ -83,10 +83,13 @@ module Dodopayments
 
       variant :"subscription.renewed", -> { Dodopayments::SubscriptionRenewedWebhookEvent }
 
+      variant :"subscription.update_payment_method",
+              -> { Dodopayments::SubscriptionUpdatePaymentMethodWebhookEvent }
+
       variant :"subscription.updated", -> { Dodopayments::SubscriptionUpdatedWebhookEvent }
 
       # @!method self.variants
-      #   @return [Array(Dodopayments::Models::AbandonedCheckoutDetectedWebhookEvent, Dodopayments::Models::AbandonedCheckoutRecoveredWebhookEvent, Dodopayments::Models::CreditAddedWebhookEvent, Dodopayments::Models::CreditBalanceLowWebhookEvent, Dodopayments::Models::CreditDeductedWebhookEvent, Dodopayments::Models::CreditExpiredWebhookEvent, Dodopayments::Models::CreditManualAdjustmentWebhookEvent, Dodopayments::Models::CreditOverageChargedWebhookEvent, Dodopayments::Models::CreditOverageResetWebhookEvent, Dodopayments::Models::CreditRolledOverWebhookEvent, Dodopayments::Models::CreditRolloverForfeitedWebhookEvent, Dodopayments::Models::DisputeAcceptedWebhookEvent, Dodopayments::Models::DisputeCancelledWebhookEvent, Dodopayments::Models::DisputeChallengedWebhookEvent, Dodopayments::Models::DisputeExpiredWebhookEvent, Dodopayments::Models::DisputeLostWebhookEvent, Dodopayments::Models::DisputeOpenedWebhookEvent, Dodopayments::Models::DisputeWonWebhookEvent, Dodopayments::Models::DunningRecoveredWebhookEvent, Dodopayments::Models::DunningStartedWebhookEvent, Dodopayments::Models::EntitlementGrantCreatedWebhookEvent, Dodopayments::Models::EntitlementGrantDeliveredWebhookEvent, Dodopayments::Models::EntitlementGrantFailedWebhookEvent, Dodopayments::Models::EntitlementGrantRevokedWebhookEvent, Dodopayments::Models::LicenseKeyCreatedWebhookEvent, Dodopayments::Models::PaymentCancelledWebhookEvent, Dodopayments::Models::PaymentFailedWebhookEvent, Dodopayments::Models::PaymentProcessingWebhookEvent, Dodopayments::Models::PaymentSucceededWebhookEvent, Dodopayments::Models::RefundFailedWebhookEvent, Dodopayments::Models::RefundSucceededWebhookEvent, Dodopayments::Models::SubscriptionActiveWebhookEvent, Dodopayments::Models::SubscriptionCancelledWebhookEvent, Dodopayments::Models::SubscriptionExpiredWebhookEvent, Dodopayments::Models::SubscriptionFailedWebhookEvent, Dodopayments::Models::SubscriptionOnHoldWebhookEvent, Dodopayments::Models::SubscriptionPlanChangedWebhookEvent, Dodopayments::Models::SubscriptionRenewedWebhookEvent, Dodopayments::Models::SubscriptionUpdatedWebhookEvent)]
+      #   @return [Array(Dodopayments::Models::AbandonedCheckoutDetectedWebhookEvent, Dodopayments::Models::AbandonedCheckoutRecoveredWebhookEvent, Dodopayments::Models::CreditAddedWebhookEvent, Dodopayments::Models::CreditBalanceLowWebhookEvent, Dodopayments::Models::CreditDeductedWebhookEvent, Dodopayments::Models::CreditExpiredWebhookEvent, Dodopayments::Models::CreditManualAdjustmentWebhookEvent, Dodopayments::Models::CreditOverageChargedWebhookEvent, Dodopayments::Models::CreditOverageResetWebhookEvent, Dodopayments::Models::CreditRolledOverWebhookEvent, Dodopayments::Models::CreditRolloverForfeitedWebhookEvent, Dodopayments::Models::DisputeAcceptedWebhookEvent, Dodopayments::Models::DisputeCancelledWebhookEvent, Dodopayments::Models::DisputeChallengedWebhookEvent, Dodopayments::Models::DisputeExpiredWebhookEvent, Dodopayments::Models::DisputeLostWebhookEvent, Dodopayments::Models::DisputeOpenedWebhookEvent, Dodopayments::Models::DisputeWonWebhookEvent, Dodopayments::Models::DunningRecoveredWebhookEvent, Dodopayments::Models::DunningStartedWebhookEvent, Dodopayments::Models::EntitlementGrantCreatedWebhookEvent, Dodopayments::Models::EntitlementGrantDeliveredWebhookEvent, Dodopayments::Models::EntitlementGrantFailedWebhookEvent, Dodopayments::Models::EntitlementGrantRevokedWebhookEvent, Dodopayments::Models::LicenseKeyCreatedWebhookEvent, Dodopayments::Models::PaymentCancelledWebhookEvent, Dodopayments::Models::PaymentFailedWebhookEvent, Dodopayments::Models::PaymentProcessingWebhookEvent, Dodopayments::Models::PaymentSucceededWebhookEvent, Dodopayments::Models::RefundFailedWebhookEvent, Dodopayments::Models::RefundSucceededWebhookEvent, Dodopayments::Models::SubscriptionActiveWebhookEvent, Dodopayments::Models::SubscriptionCancelledWebhookEvent, Dodopayments::Models::SubscriptionExpiredWebhookEvent, Dodopayments::Models::SubscriptionFailedWebhookEvent, Dodopayments::Models::SubscriptionOnHoldWebhookEvent, Dodopayments::Models::SubscriptionPlanChangedWebhookEvent, Dodopayments::Models::SubscriptionRenewedWebhookEvent, Dodopayments::Models::SubscriptionUpdatePaymentMethodWebhookEvent, Dodopayments::Models::SubscriptionUpdatedWebhookEvent)]
     end
   end
 end

data/lib/dodopayments/models/unwrap_webhook_event.rb

@@ -83,10 +83,13 @@ module Dodopayments
 
       variant :"subscription.renewed", -> { Dodopayments::SubscriptionRenewedWebhookEvent }
 
+      variant :"subscription.update_payment_method",
+              -> { Dodopayments::SubscriptionUpdatePaymentMethodWebhookEvent }
+
       variant :"subscription.updated", -> { Dodopayments::SubscriptionUpdatedWebhookEvent }
 
       # @!method self.variants
-      #   @return [Array(Dodopayments::Models::AbandonedCheckoutDetectedWebhookEvent, Dodopayments::Models::AbandonedCheckoutRecoveredWebhookEvent, Dodopayments::Models::CreditAddedWebhookEvent, Dodopayments::Models::CreditBalanceLowWebhookEvent, Dodopayments::Models::CreditDeductedWebhookEvent, Dodopayments::Models::CreditExpiredWebhookEvent, Dodopayments::Models::CreditManualAdjustmentWebhookEvent, Dodopayments::Models::CreditOverageChargedWebhookEvent, Dodopayments::Models::CreditOverageResetWebhookEvent, Dodopayments::Models::CreditRolledOverWebhookEvent, Dodopayments::Models::CreditRolloverForfeitedWebhookEvent, Dodopayments::Models::DisputeAcceptedWebhookEvent, Dodopayments::Models::DisputeCancelledWebhookEvent, Dodopayments::Models::DisputeChallengedWebhookEvent, Dodopayments::Models::DisputeExpiredWebhookEvent, Dodopayments::Models::DisputeLostWebhookEvent, Dodopayments::Models::DisputeOpenedWebhookEvent, Dodopayments::Models::DisputeWonWebhookEvent, Dodopayments::Models::DunningRecoveredWebhookEvent, Dodopayments::Models::DunningStartedWebhookEvent, Dodopayments::Models::EntitlementGrantCreatedWebhookEvent, Dodopayments::Models::EntitlementGrantDeliveredWebhookEvent, Dodopayments::Models::EntitlementGrantFailedWebhookEvent, Dodopayments::Models::EntitlementGrantRevokedWebhookEvent, Dodopayments::Models::LicenseKeyCreatedWebhookEvent, Dodopayments::Models::PaymentCancelledWebhookEvent, Dodopayments::Models::PaymentFailedWebhookEvent, Dodopayments::Models::PaymentProcessingWebhookEvent, Dodopayments::Models::PaymentSucceededWebhookEvent, Dodopayments::Models::RefundFailedWebhookEvent, Dodopayments::Models::RefundSucceededWebhookEvent, Dodopayments::Models::SubscriptionActiveWebhookEvent, Dodopayments::Models::SubscriptionCancelledWebhookEvent, Dodopayments::Models::SubscriptionExpiredWebhookEvent, Dodopayments::Models::SubscriptionFailedWebhookEvent, Dodopayments::Models::SubscriptionOnHoldWebhookEvent, Dodopayments::Models::SubscriptionPlanChangedWebhookEvent, Dodopayments::Models::SubscriptionRenewedWebhookEvent, Dodopayments::Models::SubscriptionUpdatedWebhookEvent)]
+      #   @return [Array(Dodopayments::Models::AbandonedCheckoutDetectedWebhookEvent, Dodopayments::Models::AbandonedCheckoutRecoveredWebhookEvent, Dodopayments::Models::CreditAddedWebhookEvent, Dodopayments::Models::CreditBalanceLowWebhookEvent, Dodopayments::Models::CreditDeductedWebhookEvent, Dodopayments::Models::CreditExpiredWebhookEvent, Dodopayments::Models::CreditManualAdjustmentWebhookEvent, Dodopayments::Models::CreditOverageChargedWebhookEvent, Dodopayments::Models::CreditOverageResetWebhookEvent, Dodopayments::Models::CreditRolledOverWebhookEvent, Dodopayments::Models::CreditRolloverForfeitedWebhookEvent, Dodopayments::Models::DisputeAcceptedWebhookEvent, Dodopayments::Models::DisputeCancelledWebhookEvent, Dodopayments::Models::DisputeChallengedWebhookEvent, Dodopayments::Models::DisputeExpiredWebhookEvent, Dodopayments::Models::DisputeLostWebhookEvent, Dodopayments::Models::DisputeOpenedWebhookEvent, Dodopayments::Models::DisputeWonWebhookEvent, Dodopayments::Models::DunningRecoveredWebhookEvent, Dodopayments::Models::DunningStartedWebhookEvent, Dodopayments::Models::EntitlementGrantCreatedWebhookEvent, Dodopayments::Models::EntitlementGrantDeliveredWebhookEvent, Dodopayments::Models::EntitlementGrantFailedWebhookEvent, Dodopayments::Models::EntitlementGrantRevokedWebhookEvent, Dodopayments::Models::LicenseKeyCreatedWebhookEvent, Dodopayments::Models::PaymentCancelledWebhookEvent, Dodopayments::Models::PaymentFailedWebhookEvent, Dodopayments::Models::PaymentProcessingWebhookEvent, Dodopayments::Models::PaymentSucceededWebhookEvent, Dodopayments::Models::RefundFailedWebhookEvent, Dodopayments::Models::RefundSucceededWebhookEvent, Dodopayments::Models::SubscriptionActiveWebhookEvent, Dodopayments::Models::SubscriptionCancelledWebhookEvent, Dodopayments::Models::SubscriptionExpiredWebhookEvent, Dodopayments::Models::SubscriptionFailedWebhookEvent, Dodopayments::Models::SubscriptionOnHoldWebhookEvent, Dodopayments::Models::SubscriptionPlanChangedWebhookEvent, Dodopayments::Models::SubscriptionRenewedWebhookEvent, Dodopayments::Models::SubscriptionUpdatePaymentMethodWebhookEvent, Dodopayments::Models::SubscriptionUpdatedWebhookEvent)]
     end
   end
 end

data/lib/dodopayments/models/webhook_event_type.rb

@@ -28,6 +28,7 @@ module Dodopayments
       SUBSCRIPTION_EXPIRED = :"subscription.expired"
       SUBSCRIPTION_PLAN_CHANGED = :"subscription.plan_changed"
       SUBSCRIPTION_UPDATED = :"subscription.updated"
+      SUBSCRIPTION_UPDATE_PAYMENT_METHOD = :"subscription.update_payment_method"
       LICENSE_KEY_CREATED = :"license_key.created"
       PAYOUT_NOT_INITIATED = :"payout.not_initiated"
       PAYOUT_ON_HOLD = :"payout.on_hold"

data/lib/dodopayments/models.rb

@@ -478,6 +478,9 @@ module Dodopayments
 
   SubscriptionUpdatePaymentMethodParams = Dodopayments::Models::SubscriptionUpdatePaymentMethodParams
 
+  SubscriptionUpdatePaymentMethodWebhookEvent =
+    Dodopayments::Models::SubscriptionUpdatePaymentMethodWebhookEvent
+
   TaxCategory = Dodopayments::Models::TaxCategory
 
   ThemeConfig = Dodopayments::Models::ThemeConfig

data/lib/dodopayments/resources/subscriptions.rb

@@ -145,10 +145,15 @@ module Dodopayments
         )
       end
 
-      # @overload list(brand_id: nil, created_at_gte: nil, created_at_lte: nil, customer_id: nil, page_number: nil, page_size: nil, product_id: nil, status: nil, request_options: {})
+      # Some parameter documentations has been truncated, see
+      # {Dodopayments::Models::SubscriptionListParams} for more details.
+      #
+      # @overload list(brand_id: nil, cancel_at_next_billing_date: nil, created_at_gte: nil, created_at_lte: nil, customer_id: nil, page_number: nil, page_size: nil, product_id: nil, status: nil, request_options: {})
       #
       # @param brand_id [String] filter by Brand id
       #
+      # @param cancel_at_next_billing_date [Boolean] Filter by cancel_at_next_billing_date (subscriptions scheduled for cancellation)
+      #
       # @param created_at_gte [Time] Get events after this created time
       #
       # @param created_at_lte [Time] Get events created before this time

data/lib/dodopayments/resources/webhooks.rb

@@ -170,7 +170,7 @@ module Dodopayments
 
       # @param payload [String] The raw webhook payload as a string
       #
-      # @return [Dodopayments::Models::AbandonedCheckoutDetectedWebhookEvent, Dodopayments::Models::AbandonedCheckoutRecoveredWebhookEvent, Dodopayments::Models::CreditAddedWebhookEvent, Dodopayments::Models::CreditBalanceLowWebhookEvent, Dodopayments::Models::CreditDeductedWebhookEvent, Dodopayments::Models::CreditExpiredWebhookEvent, Dodopayments::Models::CreditManualAdjustmentWebhookEvent, Dodopayments::Models::CreditOverageChargedWebhookEvent, Dodopayments::Models::CreditOverageResetWebhookEvent, Dodopayments::Models::CreditRolledOverWebhookEvent, Dodopayments::Models::CreditRolloverForfeitedWebhookEvent, Dodopayments::Models::DisputeAcceptedWebhookEvent, Dodopayments::Models::DisputeCancelledWebhookEvent, Dodopayments::Models::DisputeChallengedWebhookEvent, Dodopayments::Models::DisputeExpiredWebhookEvent, Dodopayments::Models::DisputeLostWebhookEvent, Dodopayments::Models::DisputeOpenedWebhookEvent, Dodopayments::Models::DisputeWonWebhookEvent, Dodopayments::Models::DunningRecoveredWebhookEvent, Dodopayments::Models::DunningStartedWebhookEvent, Dodopayments::Models::EntitlementGrantCreatedWebhookEvent, Dodopayments::Models::EntitlementGrantDeliveredWebhookEvent, Dodopayments::Models::EntitlementGrantFailedWebhookEvent, Dodopayments::Models::EntitlementGrantRevokedWebhookEvent, Dodopayments::Models::LicenseKeyCreatedWebhookEvent, Dodopayments::Models::PaymentCancelledWebhookEvent, Dodopayments::Models::PaymentFailedWebhookEvent, Dodopayments::Models::PaymentProcessingWebhookEvent, Dodopayments::Models::PaymentSucceededWebhookEvent, Dodopayments::Models::RefundFailedWebhookEvent, Dodopayments::Models::RefundSucceededWebhookEvent, Dodopayments::Models::SubscriptionActiveWebhookEvent, Dodopayments::Models::SubscriptionCancelledWebhookEvent, Dodopayments::Models::SubscriptionExpiredWebhookEvent, Dodopayments::Models::SubscriptionFailedWebhookEvent, Dodopayments::Models::SubscriptionOnHoldWebhookEvent, Dodopayments::Models::SubscriptionPlanChangedWebhookEvent, Dodopayments::Models::SubscriptionRenewedWebhookEvent, Dodopayments::Models::SubscriptionUpdatedWebhookEvent]
+      # @return [Dodopayments::Models::AbandonedCheckoutDetectedWebhookEvent, Dodopayments::Models::AbandonedCheckoutRecoveredWebhookEvent, Dodopayments::Models::CreditAddedWebhookEvent, Dodopayments::Models::CreditBalanceLowWebhookEvent, Dodopayments::Models::CreditDeductedWebhookEvent, Dodopayments::Models::CreditExpiredWebhookEvent, Dodopayments::Models::CreditManualAdjustmentWebhookEvent, Dodopayments::Models::CreditOverageChargedWebhookEvent, Dodopayments::Models::CreditOverageResetWebhookEvent, Dodopayments::Models::CreditRolledOverWebhookEvent, Dodopayments::Models::CreditRolloverForfeitedWebhookEvent, Dodopayments::Models::DisputeAcceptedWebhookEvent, Dodopayments::Models::DisputeCancelledWebhookEvent, Dodopayments::Models::DisputeChallengedWebhookEvent, Dodopayments::Models::DisputeExpiredWebhookEvent, Dodopayments::Models::DisputeLostWebhookEvent, Dodopayments::Models::DisputeOpenedWebhookEvent, Dodopayments::Models::DisputeWonWebhookEvent, Dodopayments::Models::DunningRecoveredWebhookEvent, Dodopayments::Models::DunningStartedWebhookEvent, Dodopayments::Models::EntitlementGrantCreatedWebhookEvent, Dodopayments::Models::EntitlementGrantDeliveredWebhookEvent, Dodopayments::Models::EntitlementGrantFailedWebhookEvent, Dodopayments::Models::EntitlementGrantRevokedWebhookEvent, Dodopayments::Models::LicenseKeyCreatedWebhookEvent, Dodopayments::Models::PaymentCancelledWebhookEvent, Dodopayments::Models::PaymentFailedWebhookEvent, Dodopayments::Models::PaymentProcessingWebhookEvent, Dodopayments::Models::PaymentSucceededWebhookEvent, Dodopayments::Models::RefundFailedWebhookEvent, Dodopayments::Models::RefundSucceededWebhookEvent, Dodopayments::Models::SubscriptionActiveWebhookEvent, Dodopayments::Models::SubscriptionCancelledWebhookEvent, Dodopayments::Models::SubscriptionExpiredWebhookEvent, Dodopayments::Models::SubscriptionFailedWebhookEvent, Dodopayments::Models::SubscriptionOnHoldWebhookEvent, Dodopayments::Models::SubscriptionPlanChangedWebhookEvent, Dodopayments::Models::SubscriptionRenewedWebhookEvent, Dodopayments::Models::SubscriptionUpdatePaymentMethodWebhookEvent, Dodopayments::Models::SubscriptionUpdatedWebhookEvent]
       def unsafe_unwrap(payload)
         parsed = JSON.parse(payload, symbolize_names: true)
         Dodopayments::Internal::Type::Converter.coerce(Dodopayments::Models::UnsafeUnwrapWebhookEvent, parsed)
@@ -182,7 +182,7 @@ module Dodopayments
       #
       # @param key [String, nil] The webhook signing key
       #
-      # @return [Dodopayments::Models::AbandonedCheckoutDetectedWebhookEvent, Dodopayments::Models::AbandonedCheckoutRecoveredWebhookEvent, Dodopayments::Models::CreditAddedWebhookEvent, Dodopayments::Models::CreditBalanceLowWebhookEvent, Dodopayments::Models::CreditDeductedWebhookEvent, Dodopayments::Models::CreditExpiredWebhookEvent, Dodopayments::Models::CreditManualAdjustmentWebhookEvent, Dodopayments::Models::CreditOverageChargedWebhookEvent, Dodopayments::Models::CreditOverageResetWebhookEvent, Dodopayments::Models::CreditRolledOverWebhookEvent, Dodopayments::Models::CreditRolloverForfeitedWebhookEvent, Dodopayments::Models::DisputeAcceptedWebhookEvent, Dodopayments::Models::DisputeCancelledWebhookEvent, Dodopayments::Models::DisputeChallengedWebhookEvent, Dodopayments::Models::DisputeExpiredWebhookEvent, Dodopayments::Models::DisputeLostWebhookEvent, Dodopayments::Models::DisputeOpenedWebhookEvent, Dodopayments::Models::DisputeWonWebhookEvent, Dodopayments::Models::DunningRecoveredWebhookEvent, Dodopayments::Models::DunningStartedWebhookEvent, Dodopayments::Models::EntitlementGrantCreatedWebhookEvent, Dodopayments::Models::EntitlementGrantDeliveredWebhookEvent, Dodopayments::Models::EntitlementGrantFailedWebhookEvent, Dodopayments::Models::EntitlementGrantRevokedWebhookEvent, Dodopayments::Models::LicenseKeyCreatedWebhookEvent, Dodopayments::Models::PaymentCancelledWebhookEvent, Dodopayments::Models::PaymentFailedWebhookEvent, Dodopayments::Models::PaymentProcessingWebhookEvent, Dodopayments::Models::PaymentSucceededWebhookEvent, Dodopayments::Models::RefundFailedWebhookEvent, Dodopayments::Models::RefundSucceededWebhookEvent, Dodopayments::Models::SubscriptionActiveWebhookEvent, Dodopayments::Models::SubscriptionCancelledWebhookEvent, Dodopayments::Models::SubscriptionExpiredWebhookEvent, Dodopayments::Models::SubscriptionFailedWebhookEvent, Dodopayments::Models::SubscriptionOnHoldWebhookEvent, Dodopayments::Models::SubscriptionPlanChangedWebhookEvent, Dodopayments::Models::SubscriptionRenewedWebhookEvent, Dodopayments::Models::SubscriptionUpdatedWebhookEvent]
+      # @return [Dodopayments::Models::AbandonedCheckoutDetectedWebhookEvent, Dodopayments::Models::AbandonedCheckoutRecoveredWebhookEvent, Dodopayments::Models::CreditAddedWebhookEvent, Dodopayments::Models::CreditBalanceLowWebhookEvent, Dodopayments::Models::CreditDeductedWebhookEvent, Dodopayments::Models::CreditExpiredWebhookEvent, Dodopayments::Models::CreditManualAdjustmentWebhookEvent, Dodopayments::Models::CreditOverageChargedWebhookEvent, Dodopayments::Models::CreditOverageResetWebhookEvent, Dodopayments::Models::CreditRolledOverWebhookEvent, Dodopayments::Models::CreditRolloverForfeitedWebhookEvent, Dodopayments::Models::DisputeAcceptedWebhookEvent, Dodopayments::Models::DisputeCancelledWebhookEvent, Dodopayments::Models::DisputeChallengedWebhookEvent, Dodopayments::Models::DisputeExpiredWebhookEvent, Dodopayments::Models::DisputeLostWebhookEvent, Dodopayments::Models::DisputeOpenedWebhookEvent, Dodopayments::Models::DisputeWonWebhookEvent, Dodopayments::Models::DunningRecoveredWebhookEvent, Dodopayments::Models::DunningStartedWebhookEvent, Dodopayments::Models::EntitlementGrantCreatedWebhookEvent, Dodopayments::Models::EntitlementGrantDeliveredWebhookEvent, Dodopayments::Models::EntitlementGrantFailedWebhookEvent, Dodopayments::Models::EntitlementGrantRevokedWebhookEvent, Dodopayments::Models::LicenseKeyCreatedWebhookEvent, Dodopayments::Models::PaymentCancelledWebhookEvent, Dodopayments::Models::PaymentFailedWebhookEvent, Dodopayments::Models::PaymentProcessingWebhookEvent, Dodopayments::Models::PaymentSucceededWebhookEvent, Dodopayments::Models::RefundFailedWebhookEvent, Dodopayments::Models::RefundSucceededWebhookEvent, Dodopayments::Models::SubscriptionActiveWebhookEvent, Dodopayments::Models::SubscriptionCancelledWebhookEvent, Dodopayments::Models::SubscriptionExpiredWebhookEvent, Dodopayments::Models::SubscriptionFailedWebhookEvent, Dodopayments::Models::SubscriptionOnHoldWebhookEvent, Dodopayments::Models::SubscriptionPlanChangedWebhookEvent, Dodopayments::Models::SubscriptionRenewedWebhookEvent, Dodopayments::Models::SubscriptionUpdatePaymentMethodWebhookEvent, Dodopayments::Models::SubscriptionUpdatedWebhookEvent]
       def unwrap(payload, headers:, key: @client.webhook_key)
         if key.nil?
           raise ArgumentError.new("Cannot verify a webhook without a key on either the client's webhook_key or passed in as an argument")

data/lib/dodopayments/version.rb

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

data/lib/dodopayments.rb

@@ -352,6 +352,7 @@ require_relative "dodopayments/models/subscription_updated_webhook_event"
 require_relative "dodopayments/models/subscription_update_params"
 require_relative "dodopayments/models/subscription_update_payment_method_params"
 require_relative "dodopayments/models/subscription_update_payment_method_response"
+require_relative "dodopayments/models/subscription_update_payment_method_webhook_event"
 require_relative "dodopayments/models/tax_category"
 require_relative "dodopayments/models/theme_config"
 require_relative "dodopayments/models/theme_mode_config"

data/rbi/dodopayments/models/checkout_session_preview_response.rbi

@@ -56,6 +56,13 @@ module Dodopayments
       sig { returns(Integer) }
       attr_accessor :total_price
 
+      # The upcoming billing date for subscriptions, computed relative to now: with a
+      # trial it is `now + trial_period_days`, otherwise `now + payment frequency`.
+      # `None` for one-time-only carts. This is a preview estimate; the authoritative
+      # value is set when the subscription activates.
+      sig { returns(T.nilable(Time)) }
+      attr_accessor :next_billing_date
+
       # Breakup of recurring payments (None for one-time only)
       sig do
         returns(
@@ -105,6 +112,7 @@ module Dodopayments
               Dodopayments::Models::CheckoutSessionPreviewResponse::ProductCart::OrHash
             ],
           total_price: Integer,
+          next_billing_date: T.nilable(Time),
           recurring_breakup:
             T.nilable(
               Dodopayments::Models::CheckoutSessionPreviewResponse::RecurringBreakup::OrHash
@@ -131,6 +139,11 @@ module Dodopayments
         product_cart:,
         # Total calculate price of the product cart
         total_price:,
+        # The upcoming billing date for subscriptions, computed relative to now: with a
+        # trial it is `now + trial_period_days`, otherwise `now + payment frequency`.
+        # `None` for one-time-only carts. This is a preview estimate; the authoritative
+        # value is set when the subscription activates.
+        next_billing_date: nil,
         # Breakup of recurring payments (None for one-time only)
         recurring_breakup: nil,
         # Registered business name from the official registry (EU/GB/AU) when found
@@ -157,6 +170,7 @@ module Dodopayments
                 Dodopayments::Models::CheckoutSessionPreviewResponse::ProductCart
               ],
             total_price: Integer,
+            next_billing_date: T.nilable(Time),
             recurring_breakup:
               T.nilable(
                 Dodopayments::Models::CheckoutSessionPreviewResponse::RecurringBreakup

data/rbi/dodopayments/models/payment.rbi

@@ -48,6 +48,11 @@ module Dodopayments
       sig { returns(T::Array[Dodopayments::Dispute]) }
       attr_accessor :disputes
 
+      # Whether this payment was created solely to update a subscription's payment
+      # method (a zero-/setup-amount charge). `false` for normal charges.
+      sig { returns(T::Boolean) }
+      attr_accessor :is_update_payment_method
+
       # Additional custom data associated with the payment
       sig { returns(T::Hash[Symbol, Dodopayments::MetadataItem::Variants]) }
       attr_accessor :metadata
@@ -150,6 +155,10 @@ module Dodopayments
       sig { returns(T.nilable(String)) }
       attr_accessor :payment_method
 
+      # Identifier of the saved payment method used for this payment, if any.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :payment_method_id
+
       # Specific type of payment method (e.g. "visa", "mastercard")
       sig { returns(T.nilable(String)) }
       attr_accessor :payment_method_type
@@ -198,6 +207,7 @@ module Dodopayments
           customer: Dodopayments::CustomerLimitedDetails::OrHash,
           digital_products_delivered: T::Boolean,
           disputes: T::Array[Dodopayments::Dispute::OrHash],
+          is_update_payment_method: T::Boolean,
           metadata: T::Hash[Symbol, Dodopayments::MetadataItem::Variants],
           payment_id: String,
           payment_provider: Dodopayments::Payment::PaymentProvider::OrSymbol,
@@ -222,6 +232,7 @@ module Dodopayments
           invoice_url: T.nilable(String),
           payment_link: T.nilable(String),
           payment_method: T.nilable(String),
+          payment_method_id: T.nilable(String),
           payment_method_type: T.nilable(String),
           product_cart:
             T.nilable(T::Array[Dodopayments::Payment::ProductCart::OrHash]),
@@ -250,6 +261,9 @@ module Dodopayments
         digital_products_delivered:,
         # List of disputes associated with this payment
         disputes:,
+        # Whether this payment was created solely to update a subscription's payment
+        # method (a zero-/setup-amount charge). `false` for normal charges.
+        is_update_payment_method:,
         # Additional custom data associated with the payment
         metadata:,
         # Unique identifier for the payment
@@ -306,6 +320,8 @@ module Dodopayments
         payment_link: nil,
         # Payment method used by customer (e.g. "card", "bank_transfer")
         payment_method: nil,
+        # Identifier of the saved payment method used for this payment, if any.
+        payment_method_id: nil,
         # Specific type of payment method (e.g. "visa", "mastercard")
         payment_method_type: nil,
         # List of products purchased in a one-time payment
@@ -340,6 +356,7 @@ module Dodopayments
             customer: Dodopayments::CustomerLimitedDetails,
             digital_products_delivered: T::Boolean,
             disputes: T::Array[Dodopayments::Dispute],
+            is_update_payment_method: T::Boolean,
             metadata: T::Hash[Symbol, Dodopayments::MetadataItem::Variants],
             payment_id: String,
             payment_provider:
@@ -366,6 +383,7 @@ module Dodopayments
             invoice_url: T.nilable(String),
             payment_link: T.nilable(String),
             payment_method: T.nilable(String),
+            payment_method_id: T.nilable(String),
             payment_method_type: T.nilable(String),
             product_cart:
               T.nilable(T::Array[Dodopayments::Payment::ProductCart]),

data/rbi/dodopayments/models/subscription_list_params.rbi

@@ -21,6 +21,13 @@ module Dodopayments
       sig { params(brand_id: String).void }
       attr_writer :brand_id
 
+      # Filter by cancel_at_next_billing_date (subscriptions scheduled for cancellation)
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :cancel_at_next_billing_date
+
+      sig { params(cancel_at_next_billing_date: T::Boolean).void }
+      attr_writer :cancel_at_next_billing_date
+
       # Get events after this created time
       sig { returns(T.nilable(Time)) }
       attr_reader :created_at_gte
@@ -81,6 +88,7 @@ module Dodopayments
       sig do
         params(
           brand_id: String,
+          cancel_at_next_billing_date: T::Boolean,
           created_at_gte: Time,
           created_at_lte: Time,
           customer_id: String,
@@ -94,6 +102,8 @@ module Dodopayments
       def self.new(
         # filter by Brand id
         brand_id: nil,
+        # Filter by cancel_at_next_billing_date (subscriptions scheduled for cancellation)
+        cancel_at_next_billing_date: nil,
         # Get events after this created time
         created_at_gte: nil,
         # Get events created before this time
@@ -116,6 +126,7 @@ module Dodopayments
         override.returns(
           {
             brand_id: String,
+            cancel_at_next_billing_date: T::Boolean,
             created_at_gte: Time,
             created_at_lte: Time,
             customer_id: String,

data/rbi/dodopayments/models/subscription_update_payment_method_webhook_event.rbi

@@ -0,0 +1,67 @@
+# typed: strong
+
+module Dodopayments
+  module Models
+    class SubscriptionUpdatePaymentMethodWebhookEvent < Dodopayments::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Dodopayments::SubscriptionUpdatePaymentMethodWebhookEvent,
+            Dodopayments::Internal::AnyHash
+          )
+        end
+
+      # The business identifier
+      sig { returns(String) }
+      attr_accessor :business_id
+
+      # Response struct representing subscription details
+      sig { returns(Dodopayments::Subscription) }
+      attr_reader :data
+
+      sig { params(data: Dodopayments::Subscription::OrHash).void }
+      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::Subscription::OrHash,
+          timestamp: Time,
+          type: Symbol
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The business identifier
+        business_id:,
+        # Response struct representing subscription details
+        data:,
+        # The timestamp of when the event occurred
+        timestamp:,
+        # The event type
+        type: :"subscription.update_payment_method"
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            business_id: String,
+            data: Dodopayments::Subscription,
+            timestamp: Time,
+            type: Symbol
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/dodopayments/models/unsafe_unwrap_webhook_event.rbi

@@ -46,6 +46,7 @@ module Dodopayments
             Dodopayments::SubscriptionOnHoldWebhookEvent,
             Dodopayments::SubscriptionPlanChangedWebhookEvent,
             Dodopayments::SubscriptionRenewedWebhookEvent,
+            Dodopayments::SubscriptionUpdatePaymentMethodWebhookEvent,
             Dodopayments::SubscriptionUpdatedWebhookEvent
           )
         end

data/rbi/dodopayments/models/unwrap_webhook_event.rbi

@@ -46,6 +46,7 @@ module Dodopayments
             Dodopayments::SubscriptionOnHoldWebhookEvent,
             Dodopayments::SubscriptionPlanChangedWebhookEvent,
             Dodopayments::SubscriptionRenewedWebhookEvent,
+            Dodopayments::SubscriptionUpdatePaymentMethodWebhookEvent,
             Dodopayments::SubscriptionUpdatedWebhookEvent
           )
         end

data/rbi/dodopayments/models/webhook_event_type.rbi

@@ -96,6 +96,11 @@ module Dodopayments
           :"subscription.updated",
           Dodopayments::WebhookEventType::TaggedSymbol
         )
+      SUBSCRIPTION_UPDATE_PAYMENT_METHOD =
+        T.let(
+          :"subscription.update_payment_method",
+          Dodopayments::WebhookEventType::TaggedSymbol
+        )
       LICENSE_KEY_CREATED =
         T.let(
           :"license_key.created",

data/rbi/dodopayments/models.rbi

@@ -511,6 +511,9 @@ module Dodopayments
   SubscriptionUpdatePaymentMethodParams =
     Dodopayments::Models::SubscriptionUpdatePaymentMethodParams
 
+  SubscriptionUpdatePaymentMethodWebhookEvent =
+    Dodopayments::Models::SubscriptionUpdatePaymentMethodWebhookEvent
+
   TaxCategory = Dodopayments::Models::TaxCategory
 
   ThemeConfig = Dodopayments::Models::ThemeConfig

data/rbi/dodopayments/resources/subscriptions.rbi

@@ -204,6 +204,7 @@ module Dodopayments
       sig do
         params(
           brand_id: String,
+          cancel_at_next_billing_date: T::Boolean,
           created_at_gte: Time,
           created_at_lte: Time,
           customer_id: String,
@@ -221,6 +222,8 @@ module Dodopayments
       def list(
         # filter by Brand id
         brand_id: nil,
+        # Filter by cancel_at_next_billing_date (subscriptions scheduled for cancellation)
+        cancel_at_next_billing_date: nil,
         # Get events after this created time
         created_at_gte: nil,
         # Get events created before this time

data/rbi/dodopayments/resources/webhooks.rbi

@@ -182,6 +182,7 @@ module Dodopayments
             Dodopayments::SubscriptionOnHoldWebhookEvent,
             Dodopayments::SubscriptionPlanChangedWebhookEvent,
             Dodopayments::SubscriptionRenewedWebhookEvent,
+            Dodopayments::SubscriptionUpdatePaymentMethodWebhookEvent,
             Dodopayments::SubscriptionUpdatedWebhookEvent
           )
         )
@@ -237,6 +238,7 @@ module Dodopayments
             Dodopayments::SubscriptionOnHoldWebhookEvent,
             Dodopayments::SubscriptionPlanChangedWebhookEvent,
             Dodopayments::SubscriptionRenewedWebhookEvent,
+            Dodopayments::SubscriptionUpdatePaymentMethodWebhookEvent,
             Dodopayments::SubscriptionUpdatedWebhookEvent
           )
         )

data/sig/dodopayments/models/checkout_session_preview_response.rbs

@@ -8,6 +8,7 @@ module Dodopayments
         is_byop: bool,
         product_cart: ::Array[Dodopayments::Models::CheckoutSessionPreviewResponse::ProductCart],
         total_price: Integer,
+        next_billing_date: Time?,
         recurring_breakup: Dodopayments::Models::CheckoutSessionPreviewResponse::RecurringBreakup?,
         tax_id_business_name: String?,
         tax_id_err_msg: String?,
@@ -28,6 +29,8 @@ module Dodopayments
 
       attr_accessor total_price: Integer
 
+      attr_accessor next_billing_date: Time?
+
       attr_accessor recurring_breakup: Dodopayments::Models::CheckoutSessionPreviewResponse::RecurringBreakup?
 
       attr_accessor tax_id_business_name: String?
@@ -45,6 +48,7 @@ module Dodopayments
         is_byop: bool,
         product_cart: ::Array[Dodopayments::Models::CheckoutSessionPreviewResponse::ProductCart],
         total_price: Integer,
+        ?next_billing_date: Time?,
         ?recurring_breakup: Dodopayments::Models::CheckoutSessionPreviewResponse::RecurringBreakup?,
         ?tax_id_business_name: String?,
         ?tax_id_err_msg: String?,
@@ -59,6 +63,7 @@ module Dodopayments
         is_byop: bool,
         product_cart: ::Array[Dodopayments::Models::CheckoutSessionPreviewResponse::ProductCart],
         total_price: Integer,
+        next_billing_date: Time?,
         recurring_breakup: Dodopayments::Models::CheckoutSessionPreviewResponse::RecurringBreakup?,
         tax_id_business_name: String?,
         tax_id_err_msg: String?,

data/sig/dodopayments/models/payment.rbs

@@ -10,6 +10,7 @@ module Dodopayments
         customer: Dodopayments::CustomerLimitedDetails,
         digital_products_delivered: bool,
         disputes: ::Array[Dodopayments::Dispute],
+        is_update_payment_method: bool,
         metadata: Dodopayments::Models::metadata,
         payment_id: String,
         payment_provider: Dodopayments::Models::Payment::payment_provider,
@@ -33,6 +34,7 @@ module Dodopayments
         invoice_url: String?,
         payment_link: String?,
         payment_method: String?,
+        payment_method_id: String?,
         payment_method_type: String?,
         product_cart: ::Array[Dodopayments::Payment::ProductCart]?,
         refund_status: Dodopayments::Models::payment_refund_status?,
@@ -60,6 +62,8 @@ module Dodopayments
 
       attr_accessor disputes: ::Array[Dodopayments::Dispute]
 
+      attr_accessor is_update_payment_method: bool
+
       attr_accessor metadata: Dodopayments::Models::metadata
 
       attr_accessor payment_id: String
@@ -106,6 +110,8 @@ module Dodopayments
 
       attr_accessor payment_method: String?
 
+      attr_accessor payment_method_id: String?
+
       attr_accessor payment_method_type: String?
 
       attr_accessor product_cart: ::Array[Dodopayments::Payment::ProductCart]?
@@ -131,6 +137,7 @@ module Dodopayments
         customer: Dodopayments::CustomerLimitedDetails,
         digital_products_delivered: bool,
         disputes: ::Array[Dodopayments::Dispute],
+        is_update_payment_method: bool,
         metadata: Dodopayments::Models::metadata,
         payment_id: String,
         payment_provider: Dodopayments::Models::Payment::payment_provider,
@@ -154,6 +161,7 @@ module Dodopayments
         ?invoice_url: String?,
         ?payment_link: String?,
         ?payment_method: String?,
+        ?payment_method_id: String?,
         ?payment_method_type: String?,
         ?product_cart: ::Array[Dodopayments::Payment::ProductCart]?,
         ?refund_status: Dodopayments::Models::payment_refund_status?,
@@ -173,6 +181,7 @@ module Dodopayments
         customer: Dodopayments::CustomerLimitedDetails,
         digital_products_delivered: bool,
         disputes: ::Array[Dodopayments::Dispute],
+        is_update_payment_method: bool,
         metadata: Dodopayments::Models::metadata,
         payment_id: String,
         payment_provider: Dodopayments::Models::Payment::payment_provider,
@@ -196,6 +205,7 @@ module Dodopayments
         invoice_url: String?,
         payment_link: String?,
         payment_method: String?,
+        payment_method_id: String?,
         payment_method_type: String?,
         product_cart: ::Array[Dodopayments::Payment::ProductCart]?,
         refund_status: Dodopayments::Models::payment_refund_status?,

data/sig/dodopayments/models/subscription_list_params.rbs

@@ -3,6 +3,7 @@ module Dodopayments
     type subscription_list_params =
       {
         brand_id: String,
+        cancel_at_next_billing_date: bool,
         created_at_gte: Time,
         created_at_lte: Time,
         customer_id: String,
@@ -21,6 +22,10 @@ module Dodopayments
 
       def brand_id=: (String) -> String
 
+      attr_reader cancel_at_next_billing_date: bool?
+
+      def cancel_at_next_billing_date=: (bool) -> bool
+
       attr_reader created_at_gte: Time?
 
       def created_at_gte=: (Time) -> Time
@@ -53,6 +58,7 @@ module Dodopayments
 
       def initialize: (
         ?brand_id: String,
+        ?cancel_at_next_billing_date: bool,
         ?created_at_gte: Time,
         ?created_at_lte: Time,
         ?customer_id: String,
@@ -65,6 +71,7 @@ module Dodopayments
 
       def to_hash: -> {
         brand_id: String,
+        cancel_at_next_billing_date: bool,
         created_at_gte: Time,
         created_at_lte: Time,
         customer_id: String,

data/sig/dodopayments/models/subscription_update_payment_method_webhook_event.rbs

@@ -0,0 +1,35 @@
+module Dodopayments
+  module Models
+    type subscription_update_payment_method_webhook_event =
+      {
+        business_id: String,
+        data: Dodopayments::Subscription,
+        timestamp: Time,
+        type: :"subscription.update_payment_method"
+      }
+
+    class SubscriptionUpdatePaymentMethodWebhookEvent < Dodopayments::Internal::Type::BaseModel
+      attr_accessor business_id: String
+
+      attr_accessor data: Dodopayments::Subscription
+
+      attr_accessor timestamp: Time
+
+      attr_accessor type: :"subscription.update_payment_method"
+
+      def initialize: (
+        business_id: String,
+        data: Dodopayments::Subscription,
+        timestamp: Time,
+        ?type: :"subscription.update_payment_method"
+      ) -> void
+
+      def to_hash: -> {
+        business_id: String,
+        data: Dodopayments::Subscription,
+        timestamp: Time,
+        type: :"subscription.update_payment_method"
+      }
+    end
+  end
+end

data/sig/dodopayments/models/unsafe_unwrap_webhook_event.rbs

@@ -39,6 +39,7 @@ module Dodopayments
       | Dodopayments::SubscriptionOnHoldWebhookEvent
       | Dodopayments::SubscriptionPlanChangedWebhookEvent
       | Dodopayments::SubscriptionRenewedWebhookEvent
+      | Dodopayments::SubscriptionUpdatePaymentMethodWebhookEvent
       | Dodopayments::SubscriptionUpdatedWebhookEvent
 
     module UnsafeUnwrapWebhookEvent

data/sig/dodopayments/models/unwrap_webhook_event.rbs

@@ -39,6 +39,7 @@ module Dodopayments
       | Dodopayments::SubscriptionOnHoldWebhookEvent
       | Dodopayments::SubscriptionPlanChangedWebhookEvent
       | Dodopayments::SubscriptionRenewedWebhookEvent
+      | Dodopayments::SubscriptionUpdatePaymentMethodWebhookEvent
       | Dodopayments::SubscriptionUpdatedWebhookEvent
 
     module UnwrapWebhookEvent

data/sig/dodopayments/models/webhook_event_type.rbs

@@ -23,6 +23,7 @@ module Dodopayments
       | :"subscription.expired"
       | :"subscription.plan_changed"
       | :"subscription.updated"
+      | :"subscription.update_payment_method"
       | :"license_key.created"
       | :"payout.not_initiated"
       | :"payout.on_hold"
@@ -72,6 +73,7 @@ module Dodopayments
       SUBSCRIPTION_EXPIRED: :"subscription.expired"
       SUBSCRIPTION_PLAN_CHANGED: :"subscription.plan_changed"
       SUBSCRIPTION_UPDATED: :"subscription.updated"
+      SUBSCRIPTION_UPDATE_PAYMENT_METHOD: :"subscription.update_payment_method"
       LICENSE_KEY_CREATED: :"license_key.created"
       PAYOUT_NOT_INITIATED: :"payout.not_initiated"
       PAYOUT_ON_HOLD: :"payout.on_hold"

data/sig/dodopayments/models.rbs

@@ -437,6 +437,8 @@ module Dodopayments
 
   class SubscriptionUpdatePaymentMethodParams = Dodopayments::Models::SubscriptionUpdatePaymentMethodParams
 
+  class SubscriptionUpdatePaymentMethodWebhookEvent = Dodopayments::Models::SubscriptionUpdatePaymentMethodWebhookEvent
+
   module TaxCategory = Dodopayments::Models::TaxCategory
 
   class ThemeConfig = Dodopayments::Models::ThemeConfig

data/sig/dodopayments/resources/subscriptions.rbs

@@ -56,6 +56,7 @@ module Dodopayments
 
       def list: (
         ?brand_id: String,
+        ?cancel_at_next_billing_date: bool,
         ?created_at_gte: Time,
         ?created_at_lte: Time,
         ?customer_id: String,

data/sig/dodopayments/resources/webhooks.rbs

@@ -87,6 +87,7 @@ module Dodopayments
       | Dodopayments::SubscriptionOnHoldWebhookEvent
       | Dodopayments::SubscriptionPlanChangedWebhookEvent
       | Dodopayments::SubscriptionRenewedWebhookEvent
+      | Dodopayments::SubscriptionUpdatePaymentMethodWebhookEvent
       | Dodopayments::SubscriptionUpdatedWebhookEvent)
 
       def unwrap: (
@@ -131,6 +132,7 @@ module Dodopayments
       | Dodopayments::SubscriptionOnHoldWebhookEvent
       | Dodopayments::SubscriptionPlanChangedWebhookEvent
       | Dodopayments::SubscriptionRenewedWebhookEvent
+      | Dodopayments::SubscriptionUpdatePaymentMethodWebhookEvent
       | Dodopayments::SubscriptionUpdatedWebhookEvent)
 
       def initialize: (client: Dodopayments::Client) -> void

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: dodopayments
 version: !ruby/object:Gem::Version
-  version: 2.20.0
+  version: 2.20.1
 platform: ruby
 authors:
 - Dodo Payments
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-06 00:00:00.000000000 Z
+date: 2026-07-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -380,6 +380,7 @@ files:
 - lib/dodopayments/models/subscription_update_params.rb
 - lib/dodopayments/models/subscription_update_payment_method_params.rb
 - lib/dodopayments/models/subscription_update_payment_method_response.rb
+- lib/dodopayments/models/subscription_update_payment_method_webhook_event.rb
 - lib/dodopayments/models/subscription_updated_webhook_event.rb
 - lib/dodopayments/models/tax_category.rb
 - lib/dodopayments/models/theme_config.rb
@@ -765,6 +766,7 @@ files:
 - rbi/dodopayments/models/subscription_update_params.rbi
 - rbi/dodopayments/models/subscription_update_payment_method_params.rbi
 - rbi/dodopayments/models/subscription_update_payment_method_response.rbi
+- rbi/dodopayments/models/subscription_update_payment_method_webhook_event.rbi
 - rbi/dodopayments/models/subscription_updated_webhook_event.rbi
 - rbi/dodopayments/models/tax_category.rbi
 - rbi/dodopayments/models/theme_config.rbi
@@ -1149,6 +1151,7 @@ files:
 - sig/dodopayments/models/subscription_update_params.rbs
 - sig/dodopayments/models/subscription_update_payment_method_params.rbs
 - sig/dodopayments/models/subscription_update_payment_method_response.rbs
+- sig/dodopayments/models/subscription_update_payment_method_webhook_event.rbs
 - sig/dodopayments/models/subscription_updated_webhook_event.rbs
 - sig/dodopayments/models/tax_category.rbs
 - sig/dodopayments/models/theme_config.rbs