dodopayments 1.71.1 → 1.74.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 77315a63211829ffd20ff12c90c642845a7ce39e6c8bf6f92c72590b17e4a89b
-  data.tar.gz: b7172692122716c4e81952ea3606d2c628213258c9369284076e71c1da88fccb
+  metadata.gz: fddfc5463bfdb2c80d2f98a580ba1a41eaa68a20d1cb4e9e3c8507d3778fea52
+  data.tar.gz: 9ca12b9e7007d21f3d886877d0c85baa3e4e5e331ecaf5a151b687f34fec62f0
 SHA512:
-  metadata.gz: b688abd5f1beac05c0ae5df4efa900b95bd0a2a1e6b91f71ffbbe5acbb44089e3fc6d09401a10c731f118b589735754569c3f50554ea8ef7a9e077b39e43bd71
-  data.tar.gz: 52ab6bfacf16643e4883d7bc374d50f32a5950ae8fd86d6c4a297ee8667f9604ef02e348bd726887c427867ad3ca84a242c73f67aad4ba2b66ff49abd912cdbe
+  metadata.gz: c0904785bd1cd4537e85092279c8399695e1c42e59317de80cff033b4cb70cb2269743c96ee25dfccedb9685bd680e9570f1cef856404250f66c4f19beb933a9
+  data.tar.gz: b6a7fc6ae6078abc1d471cad412b953e336248ca26e0a3c8b3f03c83d64cfa3e34ff347789f53fbaecebf471df9bfe1d43a2c89a5b0ffc6ad59817d34b656b73

data/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 1.74.0 (2026-01-21)
+
+Full Changelog: [v1.73.0...v1.74.0](https://github.com/dodopayments/dodopayments-ruby/compare/v1.73.0...v1.74.0)
+
+### Features
+
+* **api:** updated openapi spec to v1.74.0 ([81bd146](https://github.com/dodopayments/dodopayments-ruby/commit/81bd146a912f98174fed1ef0ad741f585d78a322))
+
+## 1.73.0 (2026-01-20)
+
+Full Changelog: [v1.71.1...v1.73.0](https://github.com/dodopayments/dodopayments-ruby/compare/v1.71.1...v1.73.0)
+
+### Features
+
+* **api:** update openapi spec to v1.73.0 ([24b7c76](https://github.com/dodopayments/dodopayments-ruby/commit/24b7c763b9f8845d138ca8d286bce058831e27a9))
+
+
+### Chores
+
+* **internal:** update `actions/checkout` version ([7ea17a7](https://github.com/dodopayments/dodopayments-ruby/commit/7ea17a7662be22901a344ddbe9b2b7788c08f781))
+
 ## 1.71.1 (2026-01-10)
 
 Full Changelog: [v1.71.0...v1.71.1](https://github.com/dodopayments/dodopayments-ruby/compare/v1.71.0...v1.71.1)

data/README.md

@@ -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", "~> 1.71.1"
+gem "dodopayments", "~> 1.74.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/dodopayments/models/checkout_session_preview_params.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    # @see Dodopayments::Resources::CheckoutSessions#preview
+    class CheckoutSessionPreviewParams < Dodopayments::Models::CheckoutSessionRequest
+      extend Dodopayments::Internal::Type::RequestParameters::Converter
+      include Dodopayments::Internal::Type::RequestParameters
+
+      # @!method initialize(request_options: {})
+      #   @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/dodopayments/models/checkout_session_preview_response.rb

@@ -0,0 +1,426 @@
+# frozen_string_literal: true
+
+module Dodopayments
+  module Models
+    # @see Dodopayments::Resources::CheckoutSessions#preview
+    class CheckoutSessionPreviewResponse < Dodopayments::Internal::Type::BaseModel
+      # @!attribute billing_country
+      #   Billing country
+      #
+      #   @return [Symbol, Dodopayments::Models::CountryCode]
+      required :billing_country, enum: -> { Dodopayments::CountryCode }
+
+      # @!attribute currency
+      #   Currency in which the calculations were made
+      #
+      #   @return [Symbol, Dodopayments::Models::Currency]
+      required :currency, enum: -> { Dodopayments::Currency }
+
+      # @!attribute current_breakup
+      #   Breakup of the current payment
+      #
+      #   @return [Dodopayments::Models::CheckoutSessionPreviewResponse::CurrentBreakup]
+      required :current_breakup, -> { Dodopayments::Models::CheckoutSessionPreviewResponse::CurrentBreakup }
+
+      # @!attribute product_cart
+      #   The total product cart
+      #
+      #   @return [Array<Dodopayments::Models::CheckoutSessionPreviewResponse::ProductCart>]
+      required :product_cart,
+               -> { Dodopayments::Internal::Type::ArrayOf[Dodopayments::Models::CheckoutSessionPreviewResponse::ProductCart] }
+
+      # @!attribute total_price
+      #   Total calculate price of the product cart
+      #
+      #   @return [Integer]
+      required :total_price, Integer
+
+      # @!attribute recurring_breakup
+      #   Breakup of recurring payments (None for one-time only)
+      #
+      #   @return [Dodopayments::Models::CheckoutSessionPreviewResponse::RecurringBreakup, nil]
+      optional :recurring_breakup,
+               -> { Dodopayments::Models::CheckoutSessionPreviewResponse::RecurringBreakup },
+               nil?: true
+
+      # @!attribute total_tax
+      #   Total tax
+      #
+      #   @return [Integer, nil]
+      optional :total_tax, Integer, nil?: true
+
+      # @!method initialize(billing_country:, currency:, current_breakup:, product_cart:, total_price:, recurring_breakup: nil, total_tax: nil)
+      #   Data returned by the calculate checkout session API
+      #
+      #   @param billing_country [Symbol, Dodopayments::Models::CountryCode] Billing country
+      #
+      #   @param currency [Symbol, Dodopayments::Models::Currency] Currency in which the calculations were made
+      #
+      #   @param current_breakup [Dodopayments::Models::CheckoutSessionPreviewResponse::CurrentBreakup] Breakup of the current payment
+      #
+      #   @param product_cart [Array<Dodopayments::Models::CheckoutSessionPreviewResponse::ProductCart>] The total product cart
+      #
+      #   @param total_price [Integer] Total calculate price of the product cart
+      #
+      #   @param recurring_breakup [Dodopayments::Models::CheckoutSessionPreviewResponse::RecurringBreakup, nil] Breakup of recurring payments (None for one-time only)
+      #
+      #   @param total_tax [Integer, nil] Total tax
+
+      # @see Dodopayments::Models::CheckoutSessionPreviewResponse#current_breakup
+      class CurrentBreakup < Dodopayments::Internal::Type::BaseModel
+        # @!attribute discount
+        #   Total discount amount
+        #
+        #   @return [Integer]
+        required :discount, Integer
+
+        # @!attribute subtotal
+        #   Subtotal before discount (pre-tax original prices)
+        #
+        #   @return [Integer]
+        required :subtotal, Integer
+
+        # @!attribute total_amount
+        #   Total amount to be charged (final amount after all calculations)
+        #
+        #   @return [Integer]
+        required :total_amount, Integer
+
+        # @!attribute tax
+        #   Total tax amount
+        #
+        #   @return [Integer, nil]
+        optional :tax, Integer, nil?: true
+
+        # @!method initialize(discount:, subtotal:, total_amount:, tax: nil)
+        #   Breakup of the current payment
+        #
+        #   @param discount [Integer] Total discount amount
+        #
+        #   @param subtotal [Integer] Subtotal before discount (pre-tax original prices)
+        #
+        #   @param total_amount [Integer] Total amount to be charged (final amount after all calculations)
+        #
+        #   @param tax [Integer, nil] Total tax amount
+      end
+
+      class ProductCart < Dodopayments::Internal::Type::BaseModel
+        # @!attribute currency
+        #   the currency in which the calculatiosn were made
+        #
+        #   @return [Symbol, Dodopayments::Models::Currency]
+        required :currency, enum: -> { Dodopayments::Currency }
+
+        # @!attribute discounted_price
+        #   discounted price
+        #
+        #   @return [Integer]
+        required :discounted_price, Integer
+
+        # @!attribute is_subscription
+        #   Whether this is a subscription product (affects tax calculation in breakup)
+        #
+        #   @return [Boolean]
+        required :is_subscription, Dodopayments::Internal::Type::Boolean
+
+        # @!attribute is_usage_based
+        #
+        #   @return [Boolean]
+        required :is_usage_based, Dodopayments::Internal::Type::Boolean
+
+        # @!attribute meters
+        #
+        #   @return [Array<Dodopayments::Models::CheckoutSessionPreviewResponse::ProductCart::Meter>]
+        required :meters,
+                 -> { Dodopayments::Internal::Type::ArrayOf[Dodopayments::Models::CheckoutSessionPreviewResponse::ProductCart::Meter] }
+
+        # @!attribute og_currency
+        #   the product currency
+        #
+        #   @return [Symbol, Dodopayments::Models::Currency]
+        required :og_currency, enum: -> { Dodopayments::Currency }
+
+        # @!attribute og_price
+        #   original price of the product
+        #
+        #   @return [Integer]
+        required :og_price, Integer
+
+        # @!attribute product_id
+        #   unique id of the product
+        #
+        #   @return [String]
+        required :product_id, String
+
+        # @!attribute quantity
+        #   Quanitity
+        #
+        #   @return [Integer]
+        required :quantity, Integer
+
+        # @!attribute tax_category
+        #   tax category
+        #
+        #   @return [Symbol, Dodopayments::Models::TaxCategory]
+        required :tax_category, enum: -> { Dodopayments::TaxCategory }
+
+        # @!attribute tax_inclusive
+        #   Whether tax is included in the price
+        #
+        #   @return [Boolean]
+        required :tax_inclusive, Dodopayments::Internal::Type::Boolean
+
+        # @!attribute tax_rate
+        #   tax rate
+        #
+        #   @return [Integer]
+        required :tax_rate, Integer
+
+        # @!attribute addons
+        #
+        #   @return [Array<Dodopayments::Models::CheckoutSessionPreviewResponse::ProductCart::Addon>, nil]
+        optional :addons,
+                 -> { Dodopayments::Internal::Type::ArrayOf[Dodopayments::Models::CheckoutSessionPreviewResponse::ProductCart::Addon] },
+                 nil?: true
+
+        # @!attribute description
+        #
+        #   @return [String, nil]
+        optional :description, String, nil?: true
+
+        # @!attribute discount_amount
+        #   discount percentage
+        #
+        #   @return [Integer, nil]
+        optional :discount_amount, Integer, nil?: true
+
+        # @!attribute discount_cycle
+        #   number of cycles the discount will apply
+        #
+        #   @return [Integer, nil]
+        optional :discount_cycle, Integer, nil?: true
+
+        # @!attribute name
+        #   name of the product
+        #
+        #   @return [String, nil]
+        optional :name, String, nil?: true
+
+        # @!attribute tax
+        #   total tax
+        #
+        #   @return [Integer, nil]
+        optional :tax, Integer, nil?: true
+
+        # @!method initialize(currency:, discounted_price:, is_subscription:, is_usage_based:, meters:, og_currency:, og_price:, product_id:, quantity:, tax_category:, tax_inclusive:, tax_rate:, addons: nil, description: nil, discount_amount: nil, discount_cycle: nil, name: nil, tax: nil)
+        #   @param currency [Symbol, Dodopayments::Models::Currency] the currency in which the calculatiosn were made
+        #
+        #   @param discounted_price [Integer] discounted price
+        #
+        #   @param is_subscription [Boolean] Whether this is a subscription product (affects tax calculation in breakup)
+        #
+        #   @param is_usage_based [Boolean]
+        #
+        #   @param meters [Array<Dodopayments::Models::CheckoutSessionPreviewResponse::ProductCart::Meter>]
+        #
+        #   @param og_currency [Symbol, Dodopayments::Models::Currency] the product currency
+        #
+        #   @param og_price [Integer] original price of the product
+        #
+        #   @param product_id [String] unique id of the product
+        #
+        #   @param quantity [Integer] Quanitity
+        #
+        #   @param tax_category [Symbol, Dodopayments::Models::TaxCategory] tax category
+        #
+        #   @param tax_inclusive [Boolean] Whether tax is included in the price
+        #
+        #   @param tax_rate [Integer] tax rate
+        #
+        #   @param addons [Array<Dodopayments::Models::CheckoutSessionPreviewResponse::ProductCart::Addon>, nil]
+        #
+        #   @param description [String, nil]
+        #
+        #   @param discount_amount [Integer, nil] discount percentage
+        #
+        #   @param discount_cycle [Integer, nil] number of cycles the discount will apply
+        #
+        #   @param name [String, nil] name of the product
+        #
+        #   @param tax [Integer, nil] total tax
+
+        class Meter < Dodopayments::Internal::Type::BaseModel
+          # @!attribute measurement_unit
+          #
+          #   @return [String]
+          required :measurement_unit, String
+
+          # @!attribute name
+          #
+          #   @return [String]
+          required :name, String
+
+          # @!attribute price_per_unit
+          #
+          #   @return [String]
+          required :price_per_unit, String
+
+          # @!attribute description
+          #
+          #   @return [String, nil]
+          optional :description, String, nil?: true
+
+          # @!attribute free_threshold
+          #
+          #   @return [Integer, nil]
+          optional :free_threshold, Integer, nil?: true
+
+          # @!method initialize(measurement_unit:, name:, price_per_unit:, description: nil, free_threshold: nil)
+          #   @param measurement_unit [String]
+          #   @param name [String]
+          #   @param price_per_unit [String]
+          #   @param description [String, nil]
+          #   @param free_threshold [Integer, nil]
+        end
+
+        class Addon < Dodopayments::Internal::Type::BaseModel
+          # @!attribute addon_id
+          #
+          #   @return [String]
+          required :addon_id, String
+
+          # @!attribute currency
+          #
+          #   @return [Symbol, Dodopayments::Models::Currency]
+          required :currency, enum: -> { Dodopayments::Currency }
+
+          # @!attribute discounted_price
+          #
+          #   @return [Integer]
+          required :discounted_price, Integer
+
+          # @!attribute name
+          #
+          #   @return [String]
+          required :name, String
+
+          # @!attribute og_currency
+          #
+          #   @return [Symbol, Dodopayments::Models::Currency]
+          required :og_currency, enum: -> { Dodopayments::Currency }
+
+          # @!attribute og_price
+          #
+          #   @return [Integer]
+          required :og_price, Integer
+
+          # @!attribute quantity
+          #
+          #   @return [Integer]
+          required :quantity, Integer
+
+          # @!attribute tax_category
+          #   Represents the different categories of taxation applicable to various products
+          #   and services.
+          #
+          #   @return [Symbol, Dodopayments::Models::TaxCategory]
+          required :tax_category, enum: -> { Dodopayments::TaxCategory }
+
+          # @!attribute tax_inclusive
+          #
+          #   @return [Boolean]
+          required :tax_inclusive, Dodopayments::Internal::Type::Boolean
+
+          # @!attribute tax_rate
+          #
+          #   @return [Integer]
+          required :tax_rate, Integer
+
+          # @!attribute description
+          #
+          #   @return [String, nil]
+          optional :description, String, nil?: true
+
+          # @!attribute discount_amount
+          #
+          #   @return [Integer, nil]
+          optional :discount_amount, Integer, nil?: true
+
+          # @!attribute tax
+          #
+          #   @return [Integer, nil]
+          optional :tax, Integer, nil?: true
+
+          # @!method initialize(addon_id:, currency:, discounted_price:, name:, og_currency:, og_price:, quantity:, tax_category:, tax_inclusive:, tax_rate:, description: nil, discount_amount: nil, tax: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Dodopayments::Models::CheckoutSessionPreviewResponse::ProductCart::Addon} for
+          #   more details.
+          #
+          #   @param addon_id [String]
+          #
+          #   @param currency [Symbol, Dodopayments::Models::Currency]
+          #
+          #   @param discounted_price [Integer]
+          #
+          #   @param name [String]
+          #
+          #   @param og_currency [Symbol, Dodopayments::Models::Currency]
+          #
+          #   @param og_price [Integer]
+          #
+          #   @param quantity [Integer]
+          #
+          #   @param tax_category [Symbol, Dodopayments::Models::TaxCategory] Represents the different categories of taxation applicable to various products a
+          #
+          #   @param tax_inclusive [Boolean]
+          #
+          #   @param tax_rate [Integer]
+          #
+          #   @param description [String, nil]
+          #
+          #   @param discount_amount [Integer, nil]
+          #
+          #   @param tax [Integer, nil]
+        end
+      end
+
+      # @see Dodopayments::Models::CheckoutSessionPreviewResponse#recurring_breakup
+      class RecurringBreakup < Dodopayments::Internal::Type::BaseModel
+        # @!attribute discount
+        #   Total discount amount
+        #
+        #   @return [Integer]
+        required :discount, Integer
+
+        # @!attribute subtotal
+        #   Subtotal before discount (pre-tax original prices)
+        #
+        #   @return [Integer]
+        required :subtotal, Integer
+
+        # @!attribute total_amount
+        #   Total recurring amount including tax
+        #
+        #   @return [Integer]
+        required :total_amount, Integer
+
+        # @!attribute tax
+        #   Total tax on recurring payments
+        #
+        #   @return [Integer, nil]
+        optional :tax, Integer, nil?: true
+
+        # @!method initialize(discount:, subtotal:, total_amount:, tax: nil)
+        #   Breakup of recurring payments (None for one-time only)
+        #
+        #   @param discount [Integer] Total discount amount
+        #
+        #   @param subtotal [Integer] Subtotal before discount (pre-tax original prices)
+        #
+        #   @param total_amount [Integer] Total recurring amount including tax
+        #
+        #   @param tax [Integer, nil] Total tax on recurring payments
+      end
+    end
+  end
+end

data/lib/dodopayments/models/checkout_session_request.rb

@@ -41,6 +41,16 @@ module Dodopayments
       #   @return [Boolean, nil]
       optional :confirm, Dodopayments::Internal::Type::Boolean
 
+      # @!attribute custom_fields
+      #   Custom fields to collect from customer during checkout (max 5 fields)
+      #
+      #   @return [Array<Dodopayments::Models::CheckoutSessionRequest::CustomField>, nil]
+      optional :custom_fields,
+               -> {
+                 Dodopayments::Internal::Type::ArrayOf[Dodopayments::CheckoutSessionRequest::CustomField]
+               },
+               nil?: true
+
       # @!attribute customer
       #   Customer details for the session
       #
@@ -90,6 +100,12 @@ module Dodopayments
       #   @return [String, nil]
       optional :payment_method_id, String, nil?: true
 
+      # @!attribute product_collection_id
+      #   Product collection ID for collection-based checkout flow
+      #
+      #   @return [String, nil]
+      optional :product_collection_id, String, nil?: true
+
       # @!attribute return_url
       #   The url to redirect after payment failure or success.
       #
@@ -113,7 +129,7 @@ module Dodopayments
       #   @return [Dodopayments::Models::CheckoutSessionRequest::SubscriptionData, nil]
       optional :subscription_data, -> { Dodopayments::CheckoutSessionRequest::SubscriptionData }, nil?: true
 
-      # @!method initialize(product_cart:, allowed_payment_method_types: nil, billing_address: nil, billing_currency: nil, confirm: nil, customer: nil, customization: nil, discount_code: nil, feature_flags: nil, force_3ds: nil, metadata: nil, minimal_address: nil, payment_method_id: nil, return_url: nil, short_link: nil, show_saved_payment_methods: nil, subscription_data: nil)
+      # @!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)
       #   Some parameter documentations has been truncated, see
       #   {Dodopayments::Models::CheckoutSessionRequest} for more details.
       #
@@ -127,6 +143,8 @@ module Dodopayments
       #
       #   @param confirm [Boolean] If confirm is true, all the details will be finalized. If required data is missi
       #
+      #   @param custom_fields [Array<Dodopayments::Models::CheckoutSessionRequest::CustomField>, nil] Custom fields to collect from customer during checkout (max 5 fields)
+      #
       #   @param customer [Dodopayments::Models::AttachExistingCustomer, Dodopayments::Models::NewCustomer, nil] Customer details for the session
       #
       #   @param customization [Dodopayments::Models::CheckoutSessionRequest::Customization] Customization for the checkout session page
@@ -143,6 +161,8 @@ module Dodopayments
       #
       #   @param payment_method_id [String, nil] Optional payment method ID to use for this checkout session.
       #
+      #   @param product_collection_id [String, nil] Product collection ID for collection-based checkout flow
+      #
       #   @param return_url [String, nil] The url to redirect after payment failure or success.
       #
       #   @param short_link [Boolean] If true, returns a shortened checkout URL.
@@ -240,6 +260,79 @@ module Dodopayments
         #   @param zipcode [String, nil] Postal code or ZIP code
       end
 
+      class CustomField < Dodopayments::Internal::Type::BaseModel
+        # @!attribute field_type
+        #   Type of field determining validation rules
+        #
+        #   @return [Symbol, Dodopayments::Models::CheckoutSessionRequest::CustomField::FieldType]
+        required :field_type, enum: -> { Dodopayments::CheckoutSessionRequest::CustomField::FieldType }
+
+        # @!attribute key
+        #   Unique identifier for this field (used as key in responses)
+        #
+        #   @return [String]
+        required :key, String
+
+        # @!attribute label
+        #   Display label shown to customer
+        #
+        #   @return [String]
+        required :label, String
+
+        # @!attribute options
+        #   Options for dropdown type (required for dropdown, ignored for others)
+        #
+        #   @return [Array<String>, nil]
+        optional :options, Dodopayments::Internal::Type::ArrayOf[String], nil?: true
+
+        # @!attribute placeholder
+        #   Placeholder text for the input
+        #
+        #   @return [String, nil]
+        optional :placeholder, String, nil?: true
+
+        # @!attribute required
+        #   Whether this field is required
+        #
+        #   @return [Boolean, nil]
+        optional :required, Dodopayments::Internal::Type::Boolean
+
+        # @!method initialize(field_type:, key:, label:, options: nil, placeholder: nil, required: nil)
+        #   Definition of a custom field for checkout
+        #
+        #   @param field_type [Symbol, Dodopayments::Models::CheckoutSessionRequest::CustomField::FieldType] Type of field determining validation rules
+        #
+        #   @param key [String] Unique identifier for this field (used as key in responses)
+        #
+        #   @param label [String] Display label shown to customer
+        #
+        #   @param options [Array<String>, nil] Options for dropdown type (required for dropdown, ignored for others)
+        #
+        #   @param placeholder [String, nil] Placeholder text for the input
+        #
+        #   @param required [Boolean] Whether this field is required
+
+        # Type of field determining validation rules
+        #
+        # @see Dodopayments::Models::CheckoutSessionRequest::CustomField#field_type
+        module FieldType
+          extend Dodopayments::Internal::Type::Enum
+
+          TEXT = :text
+          NUMBER = :number
+          EMAIL = :email
+          URL = :url
+          PHONE = :phone
+          DATE = :date
+          DATETIME = :datetime
+          DROPDOWN = :dropdown
+          BOOLEAN = :boolean
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+
       # @see Dodopayments::Models::CheckoutSessionRequest#customization
       class Customization < Dodopayments::Internal::Type::BaseModel
         # @!attribute force_language

data/lib/dodopayments/models/customer_list_params.rb

@@ -7,12 +7,30 @@ module Dodopayments
       extend Dodopayments::Internal::Type::RequestParameters::Converter
       include Dodopayments::Internal::Type::RequestParameters
 
+      # @!attribute created_at_gte
+      #   Filter customers created on or after this timestamp
+      #
+      #   @return [Time, nil]
+      optional :created_at_gte, Time
+
+      # @!attribute created_at_lte
+      #   Filter customers created on or before this timestamp
+      #
+      #   @return [Time, nil]
+      optional :created_at_lte, Time
+
       # @!attribute email
       #   Filter by customer email
       #
       #   @return [String, nil]
       optional :email, String
 
+      # @!attribute name
+      #   Filter by customer name (partial match, case-insensitive)
+      #
+      #   @return [String, nil]
+      optional :name, String
+
       # @!attribute page_number
       #   Page number default is 0
       #
@@ -25,9 +43,15 @@ module Dodopayments
       #   @return [Integer, nil]
       optional :page_size, Integer
 
-      # @!method initialize(email: nil, page_number: nil, page_size: nil, request_options: {})
+      # @!method initialize(created_at_gte: nil, created_at_lte: nil, email: nil, name: nil, page_number: nil, page_size: nil, request_options: {})
+      #   @param created_at_gte [Time] Filter customers created on or after this timestamp
+      #
+      #   @param created_at_lte [Time] Filter customers created on or before this timestamp
+      #
       #   @param email [String] Filter by customer email
       #
+      #   @param name [String] Filter by customer name (partial match, case-insensitive)
+      #
       #   @param page_number [Integer] Page number default is 0
       #
       #   @param page_size [Integer] Page size default is 10 max is 100