dodopayments 2.4.1 → 2.5.0

data/lib/dodopayments/models/payouts/breakup/detail_list_response.rb

@@ -0,0 +1,94 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    module Payouts
+      module Breakup
+        # @see Dodopayments::Resources::Payouts::Breakup::Details#list
+        class DetailListResponse < Dodopayments::Internal::Type::BaseModel
+          # @!attribute id
+          #   Unique identifier of the balance ledger entry.
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute created_at
+          #   Timestamp when this entry was created.
+          #
+          #   @return [Time]
+          required :created_at, Time
+
+          # @!attribute event_type
+          #   The type of balance ledger event (e.g., "payment", "refund", "dispute",
+          #   "payment_fees").
+          #
+          #   @return [String]
+          required :event_type, String
+
+          # @!attribute original_amount
+          #   Original amount in the original currency (in smallest currency unit, e.g.,
+          #   cents).
+          #
+          #   @return [Integer]
+          required :original_amount, Integer
+
+          # @!attribute original_currency
+          #   Original currency as ISO 4217 code (e.g., "USD", "EUR").
+          #
+          #   @return [String]
+          required :original_currency, String
+
+          # @!attribute payout_currency_amount
+          #   Amount in the payout's currency (in smallest currency unit). Uses cumulative
+          #   rounding to ensure sum matches payout total exactly.
+          #
+          #   @return [Integer]
+          required :payout_currency_amount, Integer
+
+          # @!attribute usd_equivalent_amount
+          #   USD equivalent of the original amount (in cents).
+          #
+          #   @return [Integer]
+          required :usd_equivalent_amount, Integer
+
+          # @!attribute description
+          #   Human-readable description of the transaction.
+          #
+          #   @return [String, nil]
+          optional :description, String, nil?: true
+
+          # @!attribute reference_object_id
+          #   ID of the related object (e.g., payment ID, refund ID) if applicable.
+          #
+          #   @return [String, nil]
+          optional :reference_object_id, String, nil?: true
+
+          # @!method initialize(id:, created_at:, event_type:, original_amount:, original_currency:, payout_currency_amount:, usd_equivalent_amount:, description: nil, reference_object_id: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Dodopayments::Models::Payouts::Breakup::DetailListResponse} for more details.
+          #
+          #   Individual balance ledger entry for a payout, with amounts pro-rated into the
+          #   payout's currency.
+          #
+          #   @param id [String] Unique identifier of the balance ledger entry.
+          #
+          #   @param created_at [Time] Timestamp when this entry was created.
+          #
+          #   @param event_type [String] The type of balance ledger event (e.g., "payment", "refund", "dispute", "payment
+          #
+          #   @param original_amount [Integer] Original amount in the original currency (in smallest currency unit, e.g., cents
+          #
+          #   @param original_currency [String] Original currency as ISO 4217 code (e.g., "USD", "EUR").
+          #
+          #   @param payout_currency_amount [Integer] Amount in the payout's currency (in smallest currency unit). Uses cumulative rou
+          #
+          #   @param usd_equivalent_amount [Integer] USD equivalent of the original amount (in cents).
+          #
+          #   @param description [String, nil] Human-readable description of the transaction.
+          #
+          #   @param reference_object_id [String, nil] ID of the related object (e.g., payment ID, refund ID) if applicable.
+        end
+      end
+    end
+  end
+end

data/lib/dodopayments/models/payouts/breakup_retrieve_params.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    module Payouts
+      # @see Dodopayments::Resources::Payouts::Breakup#retrieve
+      class BreakupRetrieveParams < Dodopayments::Internal::Type::BaseModel
+        extend Dodopayments::Internal::Type::RequestParameters::Converter
+        include Dodopayments::Internal::Type::RequestParameters
+
+        # @!attribute payout_id
+        #
+        #   @return [String]
+        required :payout_id, String
+
+        # @!method initialize(payout_id:, request_options: {})
+        #   @param payout_id [String]
+        #   @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/dodopayments/models/payouts/breakup_retrieve_response.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    module Payouts
+      class BreakupRetrieveResponseItem < Dodopayments::Internal::Type::BaseModel
+        # @!attribute event_type
+        #   The type of balance ledger event (e.g., "payment", "refund", "dispute",
+        #   "payment_fees").
+        #
+        #   @return [String]
+        required :event_type, String
+
+        # @!attribute total
+        #   Total amount for this event type in the payout's currency (in smallest currency
+        #   unit, e.g., cents).
+        #
+        #   @return [Integer]
+        required :total, Integer
+
+        # @!method initialize(event_type:, total:)
+        #   Some parameter documentations has been truncated, see
+        #   {Dodopayments::Models::Payouts::BreakupRetrieveResponseItem} for more details.
+        #
+        #   Payout breakup aggregated by event type, with amounts in the payout's currency.
+        #
+        #   @param event_type [String] The type of balance ledger event (e.g., "payment", "refund", "dispute", "payment
+        #
+        #   @param total [Integer] Total amount for this event type in the payout's currency (in smallest currency
+      end
+
+      # @type [Dodopayments::Internal::Type::Converter]
+      BreakupRetrieveResponse =
+        Dodopayments::Internal::Type::ArrayOf[-> { Dodopayments::Models::Payouts::BreakupRetrieveResponseItem }]
+    end
+  end
+end

data/lib/dodopayments/models/subscription_update_params.rb

@@ -23,6 +23,11 @@ module Dodopayments
       #   @return [Boolean, nil]
       optional :cancel_at_next_billing_date, Dodopayments::Internal::Type::Boolean, nil?: true
 
+      # @!attribute cancel_reason
+      #
+      #   @return [Symbol, Dodopayments::Models::SubscriptionUpdateParams::CancelReason, nil]
+      optional :cancel_reason, enum: -> { Dodopayments::SubscriptionUpdateParams::CancelReason }, nil?: true
+
       # @!attribute credit_entitlement_cart
       #   Update credit entitlement cart settings
       #
@@ -63,13 +68,15 @@ module Dodopayments
       #   @return [String, nil]
       optional :tax_id, String, nil?: true
 
-      # @!method initialize(subscription_id:, billing: nil, cancel_at_next_billing_date: nil, credit_entitlement_cart: nil, customer_name: nil, disable_on_demand: nil, metadata: nil, next_billing_date: nil, status: nil, tax_id: nil, request_options: {})
+      # @!method initialize(subscription_id:, billing: nil, cancel_at_next_billing_date: nil, cancel_reason: nil, credit_entitlement_cart: nil, customer_name: nil, disable_on_demand: nil, metadata: nil, next_billing_date: nil, status: nil, tax_id: nil, request_options: {})
       #   @param subscription_id [String]
       #
       #   @param billing [Dodopayments::Models::BillingAddress, nil]
       #
       #   @param cancel_at_next_billing_date [Boolean, nil] When set, the subscription will remain active until the end of billing period
       #
+      #   @param cancel_reason [Symbol, Dodopayments::Models::SubscriptionUpdateParams::CancelReason, nil]
+      #
       #   @param credit_entitlement_cart [Array<Dodopayments::Models::SubscriptionUpdateParams::CreditEntitlementCart>, nil] Update credit entitlement cart settings
       #
       #   @param customer_name [String, nil]
@@ -86,6 +93,17 @@ module Dodopayments
       #
       #   @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]
 
+      module CancelReason
+        extend Dodopayments::Internal::Type::Enum
+
+        CANCELLED_BY_CUSTOMER = :cancelled_by_customer
+        CANCELLED_BY_MERCHANT = :cancelled_by_merchant
+        CANCELLED_BY_MERCHANT_SEND_DUNNING = :cancelled_by_merchant_send_dunning
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
       class CreditEntitlementCart < Dodopayments::Internal::Type::BaseModel
         # @!attribute credit_entitlement_id
         #

data/lib/dodopayments/models/unsafe_unwrap_webhook_event.rb

@@ -5,6 +5,10 @@ module Dodopayments
     module UnsafeUnwrapWebhookEvent
       extend Dodopayments::Internal::Type::Union
 
+      variant -> { Dodopayments::AbandonedCheckoutDetectedWebhookEvent }
+
+      variant -> { Dodopayments::AbandonedCheckoutRecoveredWebhookEvent }
+
       variant -> { Dodopayments::CreditAddedWebhookEvent }
 
       variant -> { Dodopayments::CreditBalanceLowWebhookEvent }
@@ -35,6 +39,10 @@ module Dodopayments
 
       variant -> { Dodopayments::DisputeWonWebhookEvent }
 
+      variant -> { Dodopayments::DunningRecoveredWebhookEvent }
+
+      variant -> { Dodopayments::DunningStartedWebhookEvent }
+
       variant -> { Dodopayments::LicenseKeyCreatedWebhookEvent }
 
       variant -> { Dodopayments::PaymentCancelledWebhookEvent }
@@ -66,7 +74,7 @@ module Dodopayments
       variant -> { Dodopayments::SubscriptionUpdatedWebhookEvent }
 
       # @!method self.variants
-      #   @return [Array(Dodopayments::Models::CreditAddedWebhookEvent, Dodopayments::Models::CreditBalanceLowWebhookEvent, Dodopayments::Models::CreditDeductedWebhookEvent, Dodopayments::Models::CreditExpiredWebhookEvent, Dodopayments::Models::CreditManualAdjustmentWebhookEvent, Dodopayments::Models::CreditOverageChargedWebhookEvent, 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::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::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::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)]
     end
   end
 end

data/lib/dodopayments/models/unwrap_webhook_event.rb

@@ -5,6 +5,10 @@ module Dodopayments
     module UnwrapWebhookEvent
       extend Dodopayments::Internal::Type::Union
 
+      variant -> { Dodopayments::AbandonedCheckoutDetectedWebhookEvent }
+
+      variant -> { Dodopayments::AbandonedCheckoutRecoveredWebhookEvent }
+
       variant -> { Dodopayments::CreditAddedWebhookEvent }
 
       variant -> { Dodopayments::CreditBalanceLowWebhookEvent }
@@ -35,6 +39,10 @@ module Dodopayments
 
       variant -> { Dodopayments::DisputeWonWebhookEvent }
 
+      variant -> { Dodopayments::DunningRecoveredWebhookEvent }
+
+      variant -> { Dodopayments::DunningStartedWebhookEvent }
+
       variant -> { Dodopayments::LicenseKeyCreatedWebhookEvent }
 
       variant -> { Dodopayments::PaymentCancelledWebhookEvent }
@@ -66,7 +74,7 @@ module Dodopayments
       variant -> { Dodopayments::SubscriptionUpdatedWebhookEvent }
 
       # @!method self.variants
-      #   @return [Array(Dodopayments::Models::CreditAddedWebhookEvent, Dodopayments::Models::CreditBalanceLowWebhookEvent, Dodopayments::Models::CreditDeductedWebhookEvent, Dodopayments::Models::CreditExpiredWebhookEvent, Dodopayments::Models::CreditManualAdjustmentWebhookEvent, Dodopayments::Models::CreditOverageChargedWebhookEvent, 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::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::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::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)]
     end
   end
 end

data/lib/dodopayments/models/webhook_event_type.rb

@@ -41,6 +41,12 @@ module Dodopayments
       CREDIT_OVERAGE_CHARGED = :"credit.overage_charged"
       CREDIT_MANUAL_ADJUSTMENT = :"credit.manual_adjustment"
       CREDIT_BALANCE_LOW = :"credit.balance_low"
+      ABANDONED_CHECKOUT_DETECTED = :"abandoned_checkout.detected"
+      ABANDONED_CHECKOUT_RECOVERED = :"abandoned_checkout.recovered"
+      DUNNING_STARTED = :"dunning.started"
+      DUNNING_RECOVERED = :"dunning.recovered"
+      ACR_EMAIL = :"acr.email"
+      DUNNING_EMAIL = :"dunning.email"
 
       # @!method self.values
       #   @return [Array<Symbol>]

data/lib/dodopayments/models/webhook_payload.rb

@@ -11,7 +11,7 @@ module Dodopayments
       # @!attribute data
       #   The latest data at the time of delivery attempt
       #
-      #   @return [Dodopayments::Models::WebhookPayload::Data::Payment, Dodopayments::Models::WebhookPayload::Data::Subscription, Dodopayments::Models::WebhookPayload::Data::Refund, Dodopayments::Models::WebhookPayload::Data::Dispute, Dodopayments::Models::WebhookPayload::Data::LicenseKey, Dodopayments::Models::WebhookPayload::Data::CreditLedgerEntry, Dodopayments::Models::WebhookPayload::Data::CreditBalanceLow]
+      #   @return [Dodopayments::Models::WebhookPayload::Data::Payment, Dodopayments::Models::WebhookPayload::Data::Subscription, Dodopayments::Models::WebhookPayload::Data::Refund, Dodopayments::Models::WebhookPayload::Data::Dispute, Dodopayments::Models::WebhookPayload::Data::LicenseKey, Dodopayments::Models::WebhookPayload::Data::CreditLedgerEntry, Dodopayments::Models::WebhookPayload::Data::CreditBalanceLow, Dodopayments::Models::WebhookPayload::Data::AbandonedCheckout, Dodopayments::Models::WebhookPayload::Data::DunningAttempt]
       required :data, union: -> { Dodopayments::WebhookPayload::Data }
 
       # @!attribute timestamp
@@ -33,7 +33,7 @@ module Dodopayments
       #
       #   @param business_id [String]
       #
-      #   @param data [Dodopayments::Models::WebhookPayload::Data::Payment, Dodopayments::Models::WebhookPayload::Data::Subscription, Dodopayments::Models::WebhookPayload::Data::Refund, Dodopayments::Models::WebhookPayload::Data::Dispute, Dodopayments::Models::WebhookPayload::Data::LicenseKey, Dodopayments::Models::WebhookPayload::Data::CreditLedgerEntry, Dodopayments::Models::WebhookPayload::Data::CreditBalanceLow] The latest data at the time of delivery attempt
+      #   @param data [Dodopayments::Models::WebhookPayload::Data::Payment, Dodopayments::Models::WebhookPayload::Data::Subscription, Dodopayments::Models::WebhookPayload::Data::Refund, Dodopayments::Models::WebhookPayload::Data::Dispute, Dodopayments::Models::WebhookPayload::Data::LicenseKey, Dodopayments::Models::WebhookPayload::Data::CreditLedgerEntry, Dodopayments::Models::WebhookPayload::Data::CreditBalanceLow, Dodopayments::Models::WebhookPayload::Data::AbandonedCheckout, Dodopayments::Models::WebhookPayload::Data::DunningAttempt] The latest data at the time of delivery attempt
       #
       #   @param timestamp [Time] The timestamp of when the event occurred (not necessarily the same of when it wa
       #
@@ -61,6 +61,10 @@ module Dodopayments
 
         variant -> { Dodopayments::WebhookPayload::Data::CreditBalanceLow }
 
+        variant -> { Dodopayments::WebhookPayload::Data::AbandonedCheckout }
+
+        variant -> { Dodopayments::WebhookPayload::Data::DunningAttempt }
+
         class Payment < Dodopayments::Models::Payment
           # @!attribute payload_type
           #
@@ -247,8 +251,169 @@ module Dodopayments
           end
         end
 
+        class AbandonedCheckout < Dodopayments::Internal::Type::BaseModel
+          # @!attribute abandoned_at
+          #
+          #   @return [Time]
+          required :abandoned_at, Time
+
+          # @!attribute abandonment_reason
+          #
+          #   @return [Symbol, Dodopayments::Models::WebhookPayload::Data::AbandonedCheckout::AbandonmentReason]
+          required :abandonment_reason,
+                   enum: -> { Dodopayments::WebhookPayload::Data::AbandonedCheckout::AbandonmentReason }
+
+          # @!attribute customer_id
+          #
+          #   @return [String]
+          required :customer_id, String
+
+          # @!attribute payload_type
+          #
+          #   @return [Symbol, Dodopayments::Models::WebhookPayload::Data::AbandonedCheckout::PayloadType]
+          required :payload_type, enum: -> { Dodopayments::WebhookPayload::Data::AbandonedCheckout::PayloadType }
+
+          # @!attribute payment_id
+          #
+          #   @return [String]
+          required :payment_id, String
+
+          # @!attribute status
+          #
+          #   @return [Symbol, Dodopayments::Models::WebhookPayload::Data::AbandonedCheckout::Status]
+          required :status, enum: -> { Dodopayments::WebhookPayload::Data::AbandonedCheckout::Status }
+
+          # @!attribute recovered_payment_id
+          #
+          #   @return [String, nil]
+          optional :recovered_payment_id, String, nil?: true
+
+          # @!method initialize(abandoned_at:, abandonment_reason:, customer_id:, payload_type:, payment_id:, status:, recovered_payment_id: nil)
+          #   @param abandoned_at [Time]
+          #   @param abandonment_reason [Symbol, Dodopayments::Models::WebhookPayload::Data::AbandonedCheckout::AbandonmentReason]
+          #   @param customer_id [String]
+          #   @param payload_type [Symbol, Dodopayments::Models::WebhookPayload::Data::AbandonedCheckout::PayloadType]
+          #   @param payment_id [String]
+          #   @param status [Symbol, Dodopayments::Models::WebhookPayload::Data::AbandonedCheckout::Status]
+          #   @param recovered_payment_id [String, nil]
+
+          # @see Dodopayments::Models::WebhookPayload::Data::AbandonedCheckout#abandonment_reason
+          module AbandonmentReason
+            extend Dodopayments::Internal::Type::Enum
+
+            PAYMENT_FAILED = :payment_failed
+            CHECKOUT_INCOMPLETE = :checkout_incomplete
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # @see Dodopayments::Models::WebhookPayload::Data::AbandonedCheckout#payload_type
+          module PayloadType
+            extend Dodopayments::Internal::Type::Enum
+
+            ABANDONED_CHECKOUT = :AbandonedCheckout
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # @see Dodopayments::Models::WebhookPayload::Data::AbandonedCheckout#status
+          module Status
+            extend Dodopayments::Internal::Type::Enum
+
+            ABANDONED = :abandoned
+            RECOVERING = :recovering
+            RECOVERED = :recovered
+            EXHAUSTED = :exhausted
+            OPTED_OUT = :opted_out
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
+        class DunningAttempt < Dodopayments::Internal::Type::BaseModel
+          # @!attribute created_at
+          #
+          #   @return [Time]
+          required :created_at, Time
+
+          # @!attribute customer_id
+          #
+          #   @return [String]
+          required :customer_id, String
+
+          # @!attribute payload_type
+          #
+          #   @return [Symbol, Dodopayments::Models::WebhookPayload::Data::DunningAttempt::PayloadType]
+          required :payload_type, enum: -> { Dodopayments::WebhookPayload::Data::DunningAttempt::PayloadType }
+
+          # @!attribute status
+          #
+          #   @return [Symbol, Dodopayments::Models::WebhookPayload::Data::DunningAttempt::Status]
+          required :status, enum: -> { Dodopayments::WebhookPayload::Data::DunningAttempt::Status }
+
+          # @!attribute subscription_id
+          #
+          #   @return [String]
+          required :subscription_id, String
+
+          # @!attribute trigger_state
+          #
+          #   @return [Symbol, Dodopayments::Models::WebhookPayload::Data::DunningAttempt::TriggerState]
+          required :trigger_state, enum: -> { Dodopayments::WebhookPayload::Data::DunningAttempt::TriggerState }
+
+          # @!attribute payment_id
+          #
+          #   @return [String, nil]
+          optional :payment_id, String, nil?: true
+
+          # @!method initialize(created_at:, customer_id:, payload_type:, status:, subscription_id:, trigger_state:, payment_id: nil)
+          #   @param created_at [Time]
+          #   @param customer_id [String]
+          #   @param payload_type [Symbol, Dodopayments::Models::WebhookPayload::Data::DunningAttempt::PayloadType]
+          #   @param status [Symbol, Dodopayments::Models::WebhookPayload::Data::DunningAttempt::Status]
+          #   @param subscription_id [String]
+          #   @param trigger_state [Symbol, Dodopayments::Models::WebhookPayload::Data::DunningAttempt::TriggerState]
+          #   @param payment_id [String, nil]
+
+          # @see Dodopayments::Models::WebhookPayload::Data::DunningAttempt#payload_type
+          module PayloadType
+            extend Dodopayments::Internal::Type::Enum
+
+            DUNNING_ATTEMPT = :DunningAttempt
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # @see Dodopayments::Models::WebhookPayload::Data::DunningAttempt#status
+          module Status
+            extend Dodopayments::Internal::Type::Enum
+
+            RECOVERING = :recovering
+            RECOVERED = :recovered
+            EXHAUSTED = :exhausted
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # @see Dodopayments::Models::WebhookPayload::Data::DunningAttempt#trigger_state
+          module TriggerState
+            extend Dodopayments::Internal::Type::Enum
+
+            ON_HOLD = :on_hold
+            CANCELLED = :cancelled
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
         # @!method self.variants
-        #   @return [Array(Dodopayments::Models::WebhookPayload::Data::Payment, Dodopayments::Models::WebhookPayload::Data::Subscription, Dodopayments::Models::WebhookPayload::Data::Refund, Dodopayments::Models::WebhookPayload::Data::Dispute, Dodopayments::Models::WebhookPayload::Data::LicenseKey, Dodopayments::Models::WebhookPayload::Data::CreditLedgerEntry, Dodopayments::Models::WebhookPayload::Data::CreditBalanceLow)]
+        #   @return [Array(Dodopayments::Models::WebhookPayload::Data::Payment, Dodopayments::Models::WebhookPayload::Data::Subscription, Dodopayments::Models::WebhookPayload::Data::Refund, Dodopayments::Models::WebhookPayload::Data::Dispute, Dodopayments::Models::WebhookPayload::Data::LicenseKey, Dodopayments::Models::WebhookPayload::Data::CreditLedgerEntry, Dodopayments::Models::WebhookPayload::Data::CreditBalanceLow, Dodopayments::Models::WebhookPayload::Data::AbandonedCheckout, Dodopayments::Models::WebhookPayload::Data::DunningAttempt)]
       end
     end
   end

data/lib/dodopayments/models.rb

@@ -39,6 +39,10 @@ module Dodopayments
     mod.define_sorbet_constant!(const) { T.type_alias { mod.to_sorbet_type } }
   end
 
+  AbandonedCheckoutDetectedWebhookEvent = Dodopayments::Models::AbandonedCheckoutDetectedWebhookEvent
+
+  AbandonedCheckoutRecoveredWebhookEvent = Dodopayments::Models::AbandonedCheckoutRecoveredWebhookEvent
+
   AddMeterToPrice = Dodopayments::Models::AddMeterToPrice
 
   AddonCartResponseItem = Dodopayments::Models::AddonCartResponseItem
@@ -217,6 +221,10 @@ module Dodopayments
 
   DisputeWonWebhookEvent = Dodopayments::Models::DisputeWonWebhookEvent
 
+  DunningRecoveredWebhookEvent = Dodopayments::Models::DunningRecoveredWebhookEvent
+
+  DunningStartedWebhookEvent = Dodopayments::Models::DunningStartedWebhookEvent
+
   Event = Dodopayments::Models::Event
 
   EventInput = Dodopayments::Models::EventInput
@@ -309,6 +317,8 @@ module Dodopayments
 
   PayoutListParams = Dodopayments::Models::PayoutListParams
 
+  Payouts = Dodopayments::Models::Payouts
+
   Price = Dodopayments::Models::Price
 
   Product = Dodopayments::Models::Product

data/lib/dodopayments/resources/payouts/breakup/details.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Resources
+    class Payouts
+      class Breakup
+        class Details
+          # Returns paginated individual balance ledger entries for a payout, with each
+          # entry's amount pro-rated into the payout's currency. Supports pagination via
+          # `page_size` (default 10, max 100) and `page_number` (default 0) query
+          # parameters.
+          #
+          # @overload list(payout_id, page_number: nil, page_size: nil, request_options: {})
+          #
+          # @param payout_id [String] Id of the Payout to get breakup for
+          #
+          # @param page_number [Integer] Page number (0-indexed). Default: 0.
+          #
+          # @param page_size [Integer] Number of items per page. Default: 10, Max: 100.
+          #
+          # @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Dodopayments::Internal::DefaultPageNumberPagination<Dodopayments::Models::Payouts::Breakup::DetailListResponse>]
+          #
+          # @see Dodopayments::Models::Payouts::Breakup::DetailListParams
+          def list(payout_id, params = {})
+            parsed, options = Dodopayments::Payouts::Breakup::DetailListParams.dump_request(params)
+            query = Dodopayments::Internal::Util.encode_query_params(parsed)
+            @client.request(
+              method: :get,
+              path: ["payouts/%1$s/breakup/details", payout_id],
+              query: query,
+              page: Dodopayments::Internal::DefaultPageNumberPagination,
+              model: Dodopayments::Models::Payouts::Breakup::DetailListResponse,
+              options: options
+            )
+          end
+
+          # Downloads the complete payout breakup as a CSV file. Each row represents a
+          # balance ledger entry with columns: Ledger ID, Event Type, Original Amount,
+          # Original Currency, Reference Object ID, Description, Created At, USD Equivalent
+          # Amount, and Payout Currency Amount.
+          #
+          # @overload download_csv(payout_id, request_options: {})
+          #
+          # @param payout_id [String] Id of the Payout to get breakup for
+          #
+          # @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [nil]
+          #
+          # @see Dodopayments::Models::Payouts::Breakup::DetailDownloadCsvParams
+          def download_csv(payout_id, params = {})
+            @client.request(
+              method: :get,
+              path: ["payouts/%1$s/breakup/details/csv", payout_id],
+              model: NilClass,
+              options: params[:request_options]
+            )
+          end
+
+          # @api private
+          #
+          # @param client [Dodopayments::Client]
+          def initialize(client:)
+            @client = client
+          end
+        end
+      end
+    end
+  end
+end

data/lib/dodopayments/resources/payouts/breakup.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Resources
+    class Payouts
+      class Breakup
+        # @return [Dodopayments::Resources::Payouts::Breakup::Details]
+        attr_reader :details
+
+        # Returns the breakdown of a payout by event type (payments, refunds, disputes,
+        # fees, etc.) in the payout's currency. Each amount is proportionally allocated
+        # based on USD equivalent values, ensuring the total sums exactly to the payout
+        # amount.
+        #
+        # @overload retrieve(payout_id, request_options: {})
+        #
+        # @param payout_id [String] Id of the Payout to get breakup for
+        #
+        # @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Array<Dodopayments::Models::Payouts::BreakupRetrieveResponseItem>]
+        #
+        # @see Dodopayments::Models::Payouts::BreakupRetrieveParams
+        def retrieve(payout_id, params = {})
+          @client.request(
+            method: :get,
+            path: ["payouts/%1$s/breakup", payout_id],
+            model: Dodopayments::Internal::Type::ArrayOf[Dodopayments::Models::Payouts::BreakupRetrieveResponseItem],
+            options: params[:request_options]
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Dodopayments::Client]
+        def initialize(client:)
+          @client = client
+          @details = Dodopayments::Resources::Payouts::Breakup::Details.new(client: client)
+        end
+      end
+    end
+  end
+end

data/lib/dodopayments/resources/payouts.rb

@@ -3,6 +3,9 @@
 module Dodopayments
   module Resources
     class Payouts
+      # @return [Dodopayments::Resources::Payouts::Breakup]
+      attr_reader :breakup
+
       # @overload list(created_at_gte: nil, created_at_lte: nil, page_number: nil, page_size: nil, request_options: {})
       #
       # @param created_at_gte [Time] Get payouts created after this time (inclusive)
@@ -36,6 +39,7 @@ module Dodopayments
       # @param client [Dodopayments::Client]
       def initialize(client:)
         @client = client
+        @breakup = Dodopayments::Resources::Payouts::Breakup.new(client: client)
       end
     end
   end

data/lib/dodopayments/resources/subscriptions.rb

@@ -84,7 +84,7 @@ module Dodopayments
         )
       end
 
-      # @overload update(subscription_id, billing: nil, cancel_at_next_billing_date: nil, credit_entitlement_cart: nil, customer_name: nil, disable_on_demand: nil, metadata: nil, next_billing_date: nil, status: nil, tax_id: nil, request_options: {})
+      # @overload update(subscription_id, billing: nil, cancel_at_next_billing_date: nil, cancel_reason: nil, credit_entitlement_cart: nil, customer_name: nil, disable_on_demand: nil, metadata: nil, next_billing_date: nil, status: nil, tax_id: nil, request_options: {})
       #
       # @param subscription_id [String] Subscription Id
       #
@@ -92,6 +92,8 @@ module Dodopayments
       #
       # @param cancel_at_next_billing_date [Boolean, nil] When set, the subscription will remain active until the end of billing period
       #
+      # @param cancel_reason [Symbol, Dodopayments::Models::SubscriptionUpdateParams::CancelReason, nil]
+      #
       # @param credit_entitlement_cart [Array<Dodopayments::Models::SubscriptionUpdateParams::CreditEntitlementCart>, nil] Update credit entitlement cart settings
       #
       # @param customer_name [String, nil]