dodopayments 2.2.0 → 2.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 288683b7ef76f820f060d6adff43714ad2fb7be3a72f47e3244d07c81e744fe8
-  data.tar.gz: 3f7d919faa8bf245058c30aa1fee3c7ab7a1a845036528e34bd3e8e81aa6f290
+  metadata.gz: 7b9060cc76ee60562ea5bec0a17398c37dd9d9d74d0c3050274e4e44b9421724
+  data.tar.gz: 9ac3c0892df1ec8600fdcc7f3ab697ae6d588539f323a31ebcf78fb0812e28f0
 SHA512:
-  metadata.gz: e1d7c7dc76e74e7da61a5762ec7132be03c49c1abd34b904d6c07ccfb1e9a24f0e54f45884cef06f14dbf09b695ffe6f6e8aea0719b00a2b2e532cdce79e5240
-  data.tar.gz: b0128ca6313bcabc75be7378752e04e9f4865538a0638782dd5e311467c46193aaa92798004ee9dd43970f804dffc2b7cca71df5138b16edd280ef0afbefac53
+  metadata.gz: aa21151a63d47c5a9f301f30861adcaa5abd19292808a9c4875c0b0887dcff01d6bdd10467916ebc4d82a2de3d3b2613ffbcc3276f63432d30ee689d49ab8b14
+  data.tar.gz: 50fcd2ee3f2ddd5fdb33afe26b747133779e892109f09330b9dac8f975d6326f7ce83f6dc74d23b562b4068a486989c2d3885f33e799aad0b1c452bfb63d4861

data/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 2.3.0 (2026-03-25)
+
+Full Changelog: [v2.2.0...v2.3.0](https://github.com/dodopayments/dodopayments-ruby/compare/v2.2.0...v2.3.0)
+
+### Features
+
+* **api:** added cancel change plan endpoint ([c8748db](https://github.com/dodopayments/dodopayments-ruby/commit/c8748db3c02b945204bf7fab98c48361ff8615a7))
+* **api:** updated openapi spec to 1.92.1 ([0355574](https://github.com/dodopayments/dodopayments-ruby/commit/035557423766f101ac5f35e62ba84cfbe0fbfbd5))
+
+
+### Chores
+
+* **ci:** skip lint on metadata-only changes ([ad5b48a](https://github.com/dodopayments/dodopayments-ruby/commit/ad5b48a9eebd480a0da063316bd0732b200ffa2a))
+* **internal:** update gitignore ([249ca11](https://github.com/dodopayments/dodopayments-ruby/commit/249ca1127b6aa3913db257668ec8f2fb6d1d0c5c))
+* **tests:** bump steady to v0.19.6 ([b3ff385](https://github.com/dodopayments/dodopayments-ruby/commit/b3ff385d9e3db267aeedfe9f27a294f0239f989c))
+* **tests:** bump steady to v0.19.7 ([4f7229a](https://github.com/dodopayments/dodopayments-ruby/commit/4f7229ae821eb448e3efc1335a6a13da1b391156))
+
 ## 2.2.0 (2026-03-21)
 
 Full Changelog: [v2.1.2...v2.2.0](https://github.com/dodopayments/dodopayments-ruby/compare/v2.1.2...v2.2.0)

data/README.md

@@ -8,8 +8,8 @@ It is generated with [Stainless](https://www.stainless.com/).
 
 Use the Dodo Payments MCP Server to enable AI assistants to interact with this API, allowing them to explore endpoints, make test requests, and use documentation to help integrate this SDK into your application.
 
-[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=dodopayments-mcp&config=eyJuYW1lIjoiZG9kb3BheW1lbnRzLW1jcCIsInRyYW5zcG9ydCI6Imh0dHAiLCJ1cmwiOiJodHRwczovL2RvZG8tcGF5bWVudHMuc3RsbWNwLmNvbSIsImhlYWRlcnMiOnsieC1kb2RvLXBheW1lbnRzLWFwaS1rZXkiOiJNeSBCZWFyZXIgVG9rZW4ifX0)
-[![Install in VS Code](https://img.shields.io/badge/_-Add_to_VS_Code-blue?style=for-the-badge&logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIGZpbGw9Im5vbmUiIHZpZXdCb3g9IjAgMCA0MCA0MCI+PHBhdGggZmlsbD0iI0VFRSIgZmlsbC1ydWxlPSJldmVub2RkIiBkPSJNMzAuMjM1IDM5Ljg4NGEyLjQ5MSAyLjQ5MSAwIDAgMS0xLjc4MS0uNzNMMTIuNyAyNC43OGwtMy40NiAyLjYyNC0zLjQwNiAyLjU4MmExLjY2NSAxLjY2NSAwIDAgMS0xLjA4Mi4zMzggMS42NjQgMS42NjQgMCAwIDEtMS4wNDYtLjQzMWwtMi4yLTJhMS42NjYgMS42NjYgMCAwIDEgMC0yLjQ2M0w3LjQ1OCAyMCA0LjY3IDE3LjQ1MyAxLjUwNyAxNC41N2ExLjY2NSAxLjY2NSAwIDAgMSAwLTIuNDYzbDIuMi0yYTEuNjY1IDEuNjY1IDAgMCAxIDIuMTMtLjA5N2w2Ljg2MyA1LjIwOUwyOC40NTIuODQ0YTIuNDg4IDIuNDg4IDAgMCAxIDEuODQxLS43MjljLjM1MS4wMDkuNjk5LjA5MSAxLjAxOS4yNDVsOC4yMzYgMy45NjFhMi41IDIuNSAwIDAgMSAxLjQxNSAyLjI1M3YuMDk5LS4wNDVWMzMuMzd2LS4wNDUuMDk1YTIuNTAxIDIuNTAxIDAgMCAxLTEuNDE2IDIuMjU3bC04LjIzNSAzLjk2MWEyLjQ5MiAyLjQ5MiAwIDAgMS0xLjA3Ny4yNDZabS43MTYtMjguOTQ3LTExLjk0OCA5LjA2MiAxMS45NTIgOS4wNjUtLjAwNC0xOC4xMjdaIi8+PC9zdmc+)](https://vscode.stainless.com/mcp/%7B%22name%22%3A%22dodopayments-mcp%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fdodo-payments.stlmcp.com%22%2C%22headers%22%3A%7B%22x-dodo-payments-api-key%22%3A%22My%20Bearer%20Token%22%7D%7D)
+[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=dodopayments-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImRvZG9wYXltZW50cy1tY3AiXSwiZW52Ijp7IkRPRE9fUEFZTUVOVFNfQVBJX0tFWSI6Ik15IEJlYXJlciBUb2tlbiIsIkRPRE9fUEFZTUVOVFNfV0VCSE9PS19LRVkiOiJNeSBXZWJob29rIEtleSJ9fQ)
+[![Install in VS Code](https://img.shields.io/badge/_-Add_to_VS_Code-blue?style=for-the-badge&logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIGZpbGw9Im5vbmUiIHZpZXdCb3g9IjAgMCA0MCA0MCI+PHBhdGggZmlsbD0iI0VFRSIgZmlsbC1ydWxlPSJldmVub2RkIiBkPSJNMzAuMjM1IDM5Ljg4NGEyLjQ5MSAyLjQ5MSAwIDAgMS0xLjc4MS0uNzNMMTIuNyAyNC43OGwtMy40NiAyLjYyNC0zLjQwNiAyLjU4MmExLjY2NSAxLjY2NSAwIDAgMS0xLjA4Mi4zMzggMS42NjQgMS42NjQgMCAwIDEtMS4wNDYtLjQzMWwtMi4yLTJhMS42NjYgMS42NjYgMCAwIDEgMC0yLjQ2M0w3LjQ1OCAyMCA0LjY3IDE3LjQ1MyAxLjUwNyAxNC41N2ExLjY2NSAxLjY2NSAwIDAgMSAwLTIuNDYzbDIuMi0yYTEuNjY1IDEuNjY1IDAgMCAxIDIuMTMtLjA5N2w2Ljg2MyA1LjIwOUwyOC40NTIuODQ0YTIuNDg4IDIuNDg4IDAgMCAxIDEuODQxLS43MjljLjM1MS4wMDkuNjk5LjA5MSAxLjAxOS4yNDVsOC4yMzYgMy45NjFhMi41IDIuNSAwIDAgMSAxLjQxNSAyLjI1M3YuMDk5LS4wNDVWMzMuMzd2LS4wNDUuMDk1YTIuNTAxIDIuNTAxIDAgMCAxLTEuNDE2IDIuMjU3bC04LjIzNSAzLjk2MWEyLjQ5MiAyLjQ5MiAwIDAgMS0xLjA3Ny4yNDZabS43MTYtMjguOTQ3LTExLjk0OCA5LjA2MiAxMS45NTIgOS4wNjUtLjAwNC0xOC4xMjdaIi8+PC9zdmc+)](https://vscode.stainless.com/mcp/%7B%22name%22%3A%22dodopayments-mcp%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22dodopayments-mcp%22%5D%2C%22env%22%3A%7B%22DODO_PAYMENTS_API_KEY%22%3A%22My%20Bearer%20Token%22%2C%22DODO_PAYMENTS_WEBHOOK_KEY%22%3A%22My%20Webhook%20Key%22%7D%7D)
 
 > Note: You may need to set environment variables in your MCP client.
 
@@ -26,7 +26,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "dodopayments", "~> 2.2.0"
+gem "dodopayments", "~> 2.3.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/dodopayments/client.rb

@@ -93,6 +93,12 @@ module Dodopayments
     # @return [Dodopayments::Resources::CreditEntitlements]
     attr_reader :credit_entitlements
 
+    # @return [Dodopayments::Resources::ProductCollections]
+    attr_reader :product_collections
+
+    # @return [Dodopayments::Resources::YourWebhookURL]
+    attr_reader :your_webhook_url
+
     # @api private
     #
     # @return [Hash{String=>String}]
@@ -177,6 +183,8 @@ module Dodopayments
       @meters = Dodopayments::Resources::Meters.new(client: self)
       @balances = Dodopayments::Resources::Balances.new(client: self)
       @credit_entitlements = Dodopayments::Resources::CreditEntitlements.new(client: self)
+      @product_collections = Dodopayments::Resources::ProductCollections.new(client: self)
+      @your_webhook_url = Dodopayments::Resources::YourWebhookURL.new(client: self)
     end
   end
 end

data/lib/dodopayments/models/checkout_session_customization.rb

@@ -28,10 +28,10 @@ module Dodopayments
       # @!attribute theme
       #   Theme of the page (determines which mode - light/dark/system - to use)
       #
-      #   Default is `System`.
+      #   If not provided, uses the business-configured theme from business_themes table.
       #
       #   @return [Symbol, Dodopayments::Models::CheckoutSessionCustomization::Theme, nil]
-      optional :theme, enum: -> { Dodopayments::CheckoutSessionCustomization::Theme }
+      optional :theme, enum: -> { Dodopayments::CheckoutSessionCustomization::Theme }, nil?: true
 
       # @!attribute theme_config
       #   Optional custom theme configuration with colors for light and dark modes
@@ -49,13 +49,13 @@ module Dodopayments
       #
       #   @param show_order_details [Boolean] Show order details by default
       #
-      #   @param theme [Symbol, Dodopayments::Models::CheckoutSessionCustomization::Theme] Theme of the page (determines which mode - light/dark/system - to use)
+      #   @param theme [Symbol, Dodopayments::Models::CheckoutSessionCustomization::Theme, nil] Theme of the page (determines which mode - light/dark/system - to use)
       #
       #   @param theme_config [Dodopayments::Models::ThemeConfig, nil] Optional custom theme configuration with colors for light and dark modes
 
       # Theme of the page (determines which mode - light/dark/system - to use)
       #
-      # Default is `System`.
+      # If not provided, uses the business-configured theme from business_themes table.
       #
       # @see Dodopayments::Models::CheckoutSessionCustomization#theme
       module Theme

data/lib/dodopayments/models/checkout_session_request.rb

@@ -33,6 +33,13 @@ module Dodopayments
       #   @return [Symbol, Dodopayments::Models::Currency, nil]
       optional :billing_currency, enum: -> { Dodopayments::Currency }, nil?: true
 
+      # @!attribute cancel_url
+      #   The URL to redirect the customer if they cancel or go back from the checkout. If
+      #   not provided, the back button will not be displayed.
+      #
+      #   @return [String, nil]
+      optional :cancel_url, String, nil?: true
+
       # @!attribute confirm
       #   If confirm is true, all the details will be finalized. If required data is
       #   missing, an API error is thrown.
@@ -133,7 +140,7 @@ module Dodopayments
       #   @return [String, nil]
       optional :tax_id, String, nil?: true
 
-      # @!method initialize(product_cart:, allowed_payment_method_types: nil, billing_address: nil, billing_currency: nil, confirm: nil, custom_fields: nil, customer: nil, customization: nil, discount_code: nil, feature_flags: nil, force_3ds: nil, metadata: nil, minimal_address: nil, payment_method_id: nil, product_collection_id: nil, return_url: nil, short_link: nil, show_saved_payment_methods: nil, subscription_data: nil, tax_id: nil)
+      # @!method initialize(product_cart:, allowed_payment_method_types: nil, billing_address: nil, billing_currency: nil, cancel_url: nil, confirm: nil, custom_fields: nil, customer: nil, customization: nil, discount_code: nil, feature_flags: nil, force_3ds: nil, metadata: nil, minimal_address: nil, payment_method_id: nil, product_collection_id: nil, return_url: nil, short_link: nil, show_saved_payment_methods: nil, subscription_data: nil, tax_id: nil)
       #   Some parameter documentations has been truncated, see
       #   {Dodopayments::Models::CheckoutSessionRequest} for more details.
       #
@@ -145,6 +152,8 @@ module Dodopayments
       #
       #   @param billing_currency [Symbol, Dodopayments::Models::Currency, nil] This field is ingored if adaptive pricing is disabled
       #
+      #   @param cancel_url [String, nil] The URL to redirect the customer if they cancel or go back from the checkout.
+      #
       #   @param confirm [Boolean] If confirm is true, all the details will be finalized. If required data is missi
       #
       #   @param custom_fields [Array<Dodopayments::Models::CustomField>, nil] Custom fields to collect from customer during checkout (max 5 fields)

data/lib/dodopayments/models/customer_retrieve_payment_methods_response.rb

@@ -38,6 +38,9 @@ module Dodopayments
         optional :last_used_at, Time, nil?: true
 
         # @!attribute payment_method_type
+        #   All supported payment method types (from Hyperswitch).
+        #
+        #   Used for disabled-payment-methods filtering and validation.
         #
         #   @return [Symbol, Dodopayments::Models::PaymentMethodTypes, nil]
         optional :payment_method_type, enum: -> { Dodopayments::PaymentMethodTypes }, nil?: true
@@ -48,11 +51,20 @@ module Dodopayments
         optional :recurring_enabled, Dodopayments::Internal::Type::Boolean, nil?: true
 
         # @!method initialize(payment_method:, payment_method_id:, card: nil, last_used_at: nil, payment_method_type: nil, recurring_enabled: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Dodopayments::Models::CustomerRetrievePaymentMethodsResponse::Item} for more
+        #   details.
+        #
         #   @param payment_method [Symbol, Dodopayments::Models::CustomerRetrievePaymentMethodsResponse::Item::PaymentMethod]
+        #
         #   @param payment_method_id [String]
+        #
         #   @param card [Dodopayments::Models::CustomerRetrievePaymentMethodsResponse::Item::Card, nil]
+        #
         #   @param last_used_at [Time, nil]
-        #   @param payment_method_type [Symbol, Dodopayments::Models::PaymentMethodTypes, nil]
+        #
+        #   @param payment_method_type [Symbol, Dodopayments::Models::PaymentMethodTypes, nil] All supported payment method types (from Hyperswitch).
+        #
         #   @param recurring_enabled [Boolean, nil]
 
         # @see Dodopayments::Models::CustomerRetrievePaymentMethodsResponse::Item#payment_method

data/lib/dodopayments/models/customers/customer_portal_create_params.rb

@@ -13,15 +13,27 @@ module Dodopayments
         #   @return [String]
         required :customer_id, String
 
+        # @!attribute return_url
+        #   Optional return URL for this session. Overrides the business-level default. This
+        #   URL will be shown as a "Return to {business}" back button in the portal.
+        #
+        #   @return [String, nil]
+        optional :return_url, String
+
         # @!attribute send_email
         #   If true, will send link to user.
         #
         #   @return [Boolean, nil]
         optional :send_email, Dodopayments::Internal::Type::Boolean
 
-        # @!method initialize(customer_id:, send_email: nil, request_options: {})
+        # @!method initialize(customer_id:, return_url: nil, send_email: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Dodopayments::Models::Customers::CustomerPortalCreateParams} for more details.
+        #
         #   @param customer_id [String]
         #
+        #   @param return_url [String] Optional return URL for this session. Overrides the business-level default.
+        #
         #   @param send_email [Boolean] If true, will send link to user.
         #
         #   @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]

data/lib/dodopayments/models/invoices/payment_retrieve_payout_params.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    module Invoices
+      # @see Dodopayments::Resources::Invoices::Payments#retrieve_payout
+      class PaymentRetrievePayoutParams < 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/payment_method_types.rb

@@ -2,6 +2,9 @@
 
 module Dodopayments
   module Models
+    # All supported payment method types (from Hyperswitch).
+    #
+    # Used for disabled-payment-methods filtering and validation.
     module PaymentMethodTypes
       extend Dodopayments::Internal::Type::Enum
 

data/lib/dodopayments/models/product_collection_create_params.rb

@@ -0,0 +1,98 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    # @see Dodopayments::Resources::ProductCollections#create
+    class ProductCollectionCreateParams < Dodopayments::Internal::Type::BaseModel
+      extend Dodopayments::Internal::Type::RequestParameters::Converter
+      include Dodopayments::Internal::Type::RequestParameters
+
+      # @!attribute groups
+      #   Groups of products in this collection
+      #
+      #   @return [Array<Dodopayments::Models::ProductCollectionCreateParams::Group>]
+      required :groups,
+               -> { Dodopayments::Internal::Type::ArrayOf[Dodopayments::ProductCollectionCreateParams::Group] }
+
+      # @!attribute name
+      #   Name of the product collection
+      #
+      #   @return [String]
+      required :name, String
+
+      # @!attribute brand_id
+      #   Brand id for the collection, if not provided will default to primary brand
+      #
+      #   @return [String, nil]
+      optional :brand_id, String, nil?: true
+
+      # @!attribute description
+      #   Optional description of the product collection
+      #
+      #   @return [String, nil]
+      optional :description, String, nil?: true
+
+      # @!method initialize(groups:, name:, brand_id: nil, description: nil, request_options: {})
+      #   @param groups [Array<Dodopayments::Models::ProductCollectionCreateParams::Group>] Groups of products in this collection
+      #
+      #   @param name [String] Name of the product collection
+      #
+      #   @param brand_id [String, nil] Brand id for the collection, if not provided will default to primary brand
+      #
+      #   @param description [String, nil] Optional description of the product collection
+      #
+      #   @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]
+
+      class Group < Dodopayments::Internal::Type::BaseModel
+        # @!attribute products
+        #   Products in this group
+        #
+        #   @return [Array<Dodopayments::Models::ProductCollectionCreateParams::Group::Product>]
+        required :products,
+                 -> { Dodopayments::Internal::Type::ArrayOf[Dodopayments::ProductCollectionCreateParams::Group::Product] }
+
+        # @!attribute group_name
+        #   Optional group name. Multiple groups can have null names, but named groups must
+        #   be unique per collection
+        #
+        #   @return [String, nil]
+        optional :group_name, String, nil?: true
+
+        # @!attribute status
+        #   Status of the group (defaults to true if not provided)
+        #
+        #   @return [Boolean, nil]
+        optional :status, Dodopayments::Internal::Type::Boolean, nil?: true
+
+        # @!method initialize(products:, group_name: nil, status: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Dodopayments::Models::ProductCollectionCreateParams::Group} for more details.
+        #
+        #   @param products [Array<Dodopayments::Models::ProductCollectionCreateParams::Group::Product>] Products in this group
+        #
+        #   @param group_name [String, nil] Optional group name. Multiple groups can have null names, but named groups must
+        #
+        #   @param status [Boolean, nil] Status of the group (defaults to true if not provided)
+
+        class Product < Dodopayments::Internal::Type::BaseModel
+          # @!attribute product_id
+          #   Product ID to include in the group
+          #
+          #   @return [String]
+          required :product_id, String
+
+          # @!attribute status
+          #   Status of the product in this group (defaults to true if not provided)
+          #
+          #   @return [Boolean, nil]
+          optional :status, Dodopayments::Internal::Type::Boolean, nil?: true
+
+          # @!method initialize(product_id:, status: nil)
+          #   @param product_id [String] Product ID to include in the group
+          #
+          #   @param status [Boolean, nil] Status of the product in this group (defaults to true if not provided)
+        end
+      end
+    end
+  end
+end

data/lib/dodopayments/models/product_collection_create_response.rb

@@ -0,0 +1,226 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    # @see Dodopayments::Resources::ProductCollections#create
+    class ProductCollectionCreateResponse < Dodopayments::Internal::Type::BaseModel
+      # @!attribute id
+      #   Unique identifier for the product collection
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute brand_id
+      #   Brand ID for the collection
+      #
+      #   @return [String]
+      required :brand_id, String
+
+      # @!attribute created_at
+      #   Timestamp when the collection was created
+      #
+      #   @return [Time]
+      required :created_at, Time
+
+      # @!attribute groups
+      #   Groups in this collection
+      #
+      #   @return [Array<Dodopayments::Models::ProductCollectionCreateResponse::Group>]
+      required :groups,
+               -> { Dodopayments::Internal::Type::ArrayOf[Dodopayments::Models::ProductCollectionCreateResponse::Group] }
+
+      # @!attribute name
+      #   Name of the collection
+      #
+      #   @return [String]
+      required :name, String
+
+      # @!attribute updated_at
+      #   Timestamp when the collection was last updated
+      #
+      #   @return [Time]
+      required :updated_at, Time
+
+      # @!attribute description
+      #   Description of the collection
+      #
+      #   @return [String, nil]
+      optional :description, String, nil?: true
+
+      # @!attribute image
+      #   URL of the collection image
+      #
+      #   @return [String, nil]
+      optional :image, String, nil?: true
+
+      # @!method initialize(id:, brand_id:, created_at:, groups:, name:, updated_at:, description: nil, image: nil)
+      #   @param id [String] Unique identifier for the product collection
+      #
+      #   @param brand_id [String] Brand ID for the collection
+      #
+      #   @param created_at [Time] Timestamp when the collection was created
+      #
+      #   @param groups [Array<Dodopayments::Models::ProductCollectionCreateResponse::Group>] Groups in this collection
+      #
+      #   @param name [String] Name of the collection
+      #
+      #   @param updated_at [Time] Timestamp when the collection was last updated
+      #
+      #   @param description [String, nil] Description of the collection
+      #
+      #   @param image [String, nil] URL of the collection image
+
+      class Group < Dodopayments::Internal::Type::BaseModel
+        # @!attribute group_id
+        #
+        #   @return [String]
+        required :group_id, String
+
+        # @!attribute products
+        #
+        #   @return [Array<Dodopayments::Models::ProductCollectionCreateResponse::Group::Product>]
+        required :products,
+                 -> { Dodopayments::Internal::Type::ArrayOf[Dodopayments::Models::ProductCollectionCreateResponse::Group::Product] }
+
+        # @!attribute status
+        #
+        #   @return [Boolean]
+        required :status, Dodopayments::Internal::Type::Boolean
+
+        # @!attribute group_name
+        #
+        #   @return [String, nil]
+        optional :group_name, String, nil?: true
+
+        # @!method initialize(group_id:, products:, status:, group_name: nil)
+        #   @param group_id [String]
+        #   @param products [Array<Dodopayments::Models::ProductCollectionCreateResponse::Group::Product>]
+        #   @param status [Boolean]
+        #   @param group_name [String, nil]
+
+        class Product < Dodopayments::Internal::Type::BaseModel
+          # @!attribute id
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute addons_count
+          #
+          #   @return [Integer]
+          required :addons_count, Integer
+
+          # @!attribute files_count
+          #
+          #   @return [Integer]
+          required :files_count, Integer
+
+          # @!attribute has_credit_entitlements
+          #   Whether this product has any credit entitlements attached
+          #
+          #   @return [Boolean]
+          required :has_credit_entitlements, Dodopayments::Internal::Type::Boolean
+
+          # @!attribute is_recurring
+          #
+          #   @return [Boolean]
+          required :is_recurring, Dodopayments::Internal::Type::Boolean
+
+          # @!attribute license_key_enabled
+          #
+          #   @return [Boolean]
+          required :license_key_enabled, Dodopayments::Internal::Type::Boolean
+
+          # @!attribute meters_count
+          #
+          #   @return [Integer]
+          required :meters_count, Integer
+
+          # @!attribute product_id
+          #
+          #   @return [String]
+          required :product_id, String
+
+          # @!attribute status
+          #
+          #   @return [Boolean]
+          required :status, Dodopayments::Internal::Type::Boolean
+
+          # @!attribute currency
+          #
+          #   @return [Symbol, Dodopayments::Models::Currency, nil]
+          optional :currency, enum: -> { Dodopayments::Currency }, nil?: true
+
+          # @!attribute description
+          #
+          #   @return [String, nil]
+          optional :description, String, nil?: true
+
+          # @!attribute name
+          #
+          #   @return [String, nil]
+          optional :name, String, nil?: true
+
+          # @!attribute price
+          #
+          #   @return [Integer, nil]
+          optional :price, Integer, nil?: true
+
+          # @!attribute price_detail
+          #   One-time price details.
+          #
+          #   @return [Dodopayments::Models::Price::OneTimePrice, Dodopayments::Models::Price::RecurringPrice, Dodopayments::Models::Price::UsageBasedPrice, nil]
+          optional :price_detail, union: -> { Dodopayments::Price }, nil?: true
+
+          # @!attribute tax_category
+          #   Represents the different categories of taxation applicable to various products
+          #   and services.
+          #
+          #   @return [Symbol, Dodopayments::Models::TaxCategory, nil]
+          optional :tax_category, enum: -> { Dodopayments::TaxCategory }, nil?: true
+
+          # @!attribute tax_inclusive
+          #
+          #   @return [Boolean, nil]
+          optional :tax_inclusive, Dodopayments::Internal::Type::Boolean, nil?: true
+
+          # @!method initialize(id:, addons_count:, files_count:, has_credit_entitlements:, is_recurring:, license_key_enabled:, meters_count:, product_id:, status:, currency: nil, description: nil, name: nil, price: nil, price_detail: nil, tax_category: nil, tax_inclusive: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Dodopayments::Models::ProductCollectionCreateResponse::Group::Product} for more
+          #   details.
+          #
+          #   @param id [String]
+          #
+          #   @param addons_count [Integer]
+          #
+          #   @param files_count [Integer]
+          #
+          #   @param has_credit_entitlements [Boolean] Whether this product has any credit entitlements attached
+          #
+          #   @param is_recurring [Boolean]
+          #
+          #   @param license_key_enabled [Boolean]
+          #
+          #   @param meters_count [Integer]
+          #
+          #   @param product_id [String]
+          #
+          #   @param status [Boolean]
+          #
+          #   @param currency [Symbol, Dodopayments::Models::Currency, nil]
+          #
+          #   @param description [String, nil]
+          #
+          #   @param name [String, nil]
+          #
+          #   @param price [Integer, nil]
+          #
+          #   @param price_detail [Dodopayments::Models::Price::OneTimePrice, Dodopayments::Models::Price::RecurringPrice, Dodopayments::Models::Price::UsageBasedPrice, nil] One-time price details.
+          #
+          #   @param tax_category [Symbol, Dodopayments::Models::TaxCategory, nil] Represents the different categories of taxation applicable to various products a
+          #
+          #   @param tax_inclusive [Boolean, nil]
+        end
+      end
+    end
+  end
+end

data/lib/dodopayments/models/product_collection_delete_params.rb

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

data/lib/dodopayments/models/product_collection_list_params.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    # @see Dodopayments::Resources::ProductCollections#list
+    class ProductCollectionListParams < Dodopayments::Internal::Type::BaseModel
+      extend Dodopayments::Internal::Type::RequestParameters::Converter
+      include Dodopayments::Internal::Type::RequestParameters
+
+      # @!attribute archived
+      #   List archived collections
+      #
+      #   @return [Boolean, nil]
+      optional :archived, Dodopayments::Internal::Type::Boolean
+
+      # @!attribute brand_id
+      #   Filter by Brand id
+      #
+      #   @return [String, nil]
+      optional :brand_id, String
+
+      # @!attribute page_number
+      #   Page number default is 0
+      #
+      #   @return [Integer, nil]
+      optional :page_number, Integer
+
+      # @!attribute page_size
+      #   Page size default is 10 max is 100
+      #
+      #   @return [Integer, nil]
+      optional :page_size, Integer
+
+      # @!method initialize(archived: nil, brand_id: nil, page_number: nil, page_size: nil, request_options: {})
+      #   @param archived [Boolean] List archived collections
+      #
+      #   @param brand_id [String] Filter by Brand id
+      #
+      #   @param page_number [Integer] Page number default is 0
+      #
+      #   @param page_size [Integer] Page size default is 10 max is 100
+      #
+      #   @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end