inttegro 9.1.0 → 9.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 505bb0fb6560e58fc73e184b3bf9768d264d2788e0fd2cd1c782c73eb004e3eb
-  data.tar.gz: 843c5c156bde85253c0f94843f5de3731b864a3c37b5479130f6a1b7fe6541eb
+  metadata.gz: 192fa0d6bd78a893b0577e6cea06f93a1577b4356176267125090f760c396e7f
+  data.tar.gz: de934a47ffb8c6028236f58560e18e34435c6db06489b7eb8770203cd9b26f88
 SHA512:
-  metadata.gz: 1a008265df9c387cd21da22d01c52a8c4bc7bfda2e3dbe5f7d703c7c593547f75daa5f98458a8b89cf99db99653d55f6d474780f979e31be5eef7114c0a87622
-  data.tar.gz: ca020602b0228107d07a475d380fa5d117f18def87ac131d97303b957f764d348bc85c286eadc3eaaff9228c9d31989e4969b2fc719bd5ddae0e02484ce2508f
+  metadata.gz: b706cd2e9276468e0626ad7294e416507846250a1e7fa6d995fde9db98144412db9ceb25072c9f123e7e492b48b76ca62a389aa15941471741c6808e64bd1e40
+  data.tar.gz: 18a789789f0bc32f289910091f918425d84c5832ddaa94064c3d16ef9eba1c71c67eb88f8354375b1582c10f3f49ec1f59a87b8f570cab85c667aa188e9c8d3f

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 ## [Unreleased]
 
+## [9.2.0] - 2026-10-01
+
+- Added typed fixed and customer-selected catalog price definitions, suggested
+  contribution amounts, and order line items that couple a catalog price with
+  the amount selected by the customer.
+
 ## [9.1.0] - 2026-09-27
 
 - Added the required application-scoped customer fingerprint to typed customer

data/lib/inttegro/generated/enums.rb

@@ -66,6 +66,7 @@ require_relative "../payment_method/tokenize_base_type"
 require_relative "../payment_method/tokenize_mobile_money_request_type"
 require_relative "../payment_method/type"
 require_relative "../payout/status"
+require_relative "../price/type"
 require_relative "../product/line_item_type"
 require_relative "../product/shipment_input_type"
 require_relative "../product/shipment_type"

data/lib/inttegro/generated/models.rb

@@ -16,8 +16,12 @@ require_relative "../payment_method/verification"
 require_relative "../payment_method/payment_method"
 require_relative "../payment_method/activate_response"
 require_relative "../money/amount_params"
+require_relative "../price/suggested_amount_params"
+require_relative "../price/customer_selected_amount_params"
 require_relative "../product/add_price_request"
 require_relative "../money/amount"
+require_relative "../price/suggested_amount"
+require_relative "../price/customer_selected_amount"
 require_relative "../purchase_intent/product_attributes_item"
 require_relative "../product/dimensions_physical"
 require_relative "../product/dimensions_digital"
@@ -97,6 +101,8 @@ require_relative "../schedule/cancel_request"
 require_relative "../file/actor_input"
 require_relative "../upload_request/cancel_request"
 require_relative "../price/catalog_price_params"
+require_relative "../product/customer_selected_price_input"
+require_relative "../product/catalog_with_customer_selected_price"
 require_relative "../price/price_params"
 require_relative "../product/catalog_with_price_data"
 require_relative "../product/catalog_with_price_reference"

data/lib/inttegro/http_client.rb

@@ -712,7 +712,10 @@ module Inttegro
       when "/products/create"
         require_keys(body, %w[type name], path)
       when "/products/add_price"
-        require_keys(body, %w[product_id amount], path)
+        require_keys(body, %w[product_id], path)
+        validate_catalog_price_definition(body, path, require_product: true)
+      when "/prices/create"
+        validate_catalog_price_definition(body, path, require_product: true)
       when "/products/set_default_unit_price"
         require_keys(body, %w[product_id price_id], path)
       when "/products/lookup", "/products/update", "/products/publish", "/products/unpublish", "/products/archive"
@@ -757,6 +760,28 @@ module Inttegro
       raise ArgumentError, "Missing required fields for #{path}: one of #{keys.join(', ')}"
     end
 
+    sig { params(body: Types::Payload, path: String, require_product: T::Boolean).void }
+    def validate_catalog_price_definition(body, path, require_product:)
+      legacy_amount = payload_value(body, "amount")
+      price_type = payload_value(body, "type")
+      fixed_amount = payload_value(body, "fixed_amount")
+      selected_amount = payload_value(body, "customer_selected_amount")
+
+      fixed = price_type == "fixed_amount" && present?(fixed_amount) &&
+        !present?(legacy_amount) && !present?(selected_amount)
+      selected = price_type == "customer_selected_amount" && present?(selected_amount) &&
+        !present?(legacy_amount) && !present?(fixed_amount)
+      selected &&= present?(payload_value(body, "product_id")) if require_product
+      return if [fixed, selected].count(true) == 1
+
+      raise ArgumentError, "Invalid price definition for #{path}: provide exactly one supported definition"
+    end
+
+    sig { params(body: Types::Payload, key: String).returns(Object) }
+    def payload_value(body, key)
+      body.key?(key) ? body[key] : body[key.to_sym]
+    end
+
     sig { params(value: Object).returns(T::Boolean) }
     def present?(value)
       return false if value.nil?

data/lib/inttegro/price/catalog_price.rb

@@ -5,7 +5,9 @@
 
 require_relative "base"
 require_relative "../money/amount"
+require_relative "customer_selected_amount"
 require_relative "embedded_product"
+require_relative "type"
 
 module Inttegro
   class Price
@@ -41,11 +43,29 @@ module Inttegro
     #   Required in the API payload. Wire name: `active`.
     #   @return [Boolean]
     #
+    # @!attribute [r] type
+    #   Price definition discriminator
+    #
+    #   Required in the API payload. Wire name: `type`.
+    #   @return [Inttegro::Price::Type]
+    #
     # @!attribute [r] nominal
-    #   Price amount
+    #   Legacy fixed price amount. Present only for fixed_amount prices.
+    #
+    #   Optional in the API payload; omitted values default to `nil`. Wire name: `nominal`.
+    #   @return [Inttegro::Money::Amount, nil]
+    #
+    # @!attribute [r] fixed_amount
+    #   Fixed price amount. Present only for fixed_amount prices.
+    #
+    #   Optional in the API payload; omitted values default to `nil`. Wire name: `fixed_amount`.
+    #   @return [Inttegro::Money::Amount, nil]
+    #
+    # @!attribute [r] customer_selected_amount
+    #   Customer-selected amount configuration. Present only for customer_selected_amount prices.
     #
-    #   Required in the API payload. Wire name: `nominal`.
-    #   @return [Inttegro::Money::Amount]
+    #   Optional in the API payload; omitted values default to `nil`. Wire name: `customer_selected_amount`.
+    #   @return [Inttegro::Price::CustomerSelectedAmount, nil]
     #
     # @!attribute [r] product_id
     #   Product ID when the operation returns the relationship by reference
@@ -81,7 +101,10 @@ module Inttegro
       const :label, T.nilable(String), default: nil
       const :about, T.nilable(String), default: nil
       const :active, T::Boolean
-      const :nominal, Inttegro::Money::Amount
+      const :type, Inttegro::Price::Type
+      const :nominal, T.nilable(Inttegro::Money::Amount), default: nil
+      const :fixed_amount, T.nilable(Inttegro::Money::Amount), default: nil
+      const :customer_selected_amount, T.nilable(Inttegro::Price::CustomerSelectedAmount), default: nil
       const :product_id, T.nilable(String), default: nil
       const :product, T.nilable(Inttegro::Price::EmbeddedProduct), default: nil
       const :created_at, Time

data/lib/inttegro/price/catalog_price_params.rb

@@ -5,6 +5,8 @@
 
 require_relative "base"
 require_relative "../money/amount_params"
+require_relative "customer_selected_amount_params"
+require_relative "type"
 
 module Inttegro
   class Price
@@ -17,7 +19,8 @@ module Inttegro
     # @api public
     #
     # @!attribute [r] product_id
-    #   Optional product ID to associate this price with. Once set, cannot be changed.
+    #   Product ID to associate this price with. Optional for fixed prices, required for
+    #   customer_selected_amount prices, and immutable once set.
     #
     #   Optional in the API payload; omitted values default to `nil`. Wire name: `product_id`.
     #   @return [String, nil]
@@ -34,16 +37,31 @@ module Inttegro
     #   Optional in the API payload; omitted values default to `nil`. Wire name: `about`.
     #   @return [String, nil]
     #
-    # @!attribute [r] amount
-    #   Value of the `amount` field in the Inttegro API payload.
+    # @!attribute [r] type
+    #   Price definition discriminator.
     #
-    #   Required in the API payload. Wire name: `amount`.
-    #   @return [Inttegro::Money::AmountParams]
+    #   Optional in the API payload; omitted values default to `nil`. Wire name: `type`.
+    #   @return [Inttegro::Price::Type, nil]
+    #
+    # @!attribute [r] fixed_amount
+    #   Required when type is fixed_amount.
+    #
+    #   Optional in the API payload; omitted values default to `nil`. Wire name: `fixed_amount`.
+    #   @return [Inttegro::Money::AmountParams, nil]
+    #
+    # @!attribute [r] customer_selected_amount
+    #   Required when type is customer_selected_amount. Available only to Commerce internal services
+    #   and Upper private beta organizations and applications.
+    #
+    #   Optional in the API payload; omitted values default to `nil`. Wire name: `customer_selected_amount`.
+    #   @return [Inttegro::Price::CustomerSelectedAmountParams, nil]
     class CatalogPriceParams < T::Struct
       const :product_id, T.nilable(String), default: nil
       const :label, T.nilable(String), default: nil
       const :about, T.nilable(String), default: nil
-      const :amount, Inttegro::Money::AmountParams
+      const :type, T.nilable(Inttegro::Price::Type), default: nil
+      const :fixed_amount, T.nilable(Inttegro::Money::AmountParams), default: nil
+      const :customer_selected_amount, T.nilable(Inttegro::Price::CustomerSelectedAmountParams), default: nil
     end
   end
 end

data/lib/inttegro/price/customer_selected_amount.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+# typed: strict
+
+# Generated from openapi/commerce.yml by bin/generate-openapi-types. Do not edit.
+
+require_relative "base"
+require_relative "../money/currency"
+require_relative "suggested_amount"
+
+module Inttegro
+  class Price
+    # Typed representation of the customer selected amount object in the Inttegro API.
+    #
+    # This generated model is immutable. Construct it with `.new`, or decode a string-keyed API
+    # payload with `.from_hash`. `#serialize` produces a string-keyed hash using the original wire
+    # field names and serialized enum values.
+    #
+    # @api public
+    #
+    # @!attribute [r] currency
+    #   Currency accepted for customer-selected amounts
+    #
+    #   Required in the API payload. Wire name: `currency`.
+    #   @return [Inttegro::Money::Currency]
+    #
+    # @!attribute [r] minimum
+    #   Minimum selectable amount in the currency's smallest unit
+    #
+    #   Required in the API payload. Wire name: `minimum`.
+    #   @return [Integer]
+    #
+    # @!attribute [r] maximum
+    #   Optional maximum selectable amount
+    #
+    #   Optional in the API payload; omitted values default to `nil`. Wire name: `maximum`.
+    #   @return [Integer, nil]
+    #
+    # @!attribute [r] suggested_amounts
+    #   Convenient choices, not an allow-list
+    #
+    #   Optional in the API payload; omitted values default to `nil`. Wire name: `suggested_amounts`.
+    #   @return [Array<Inttegro::Price::SuggestedAmount>, nil]
+    class CustomerSelectedAmount < T::Struct
+      const :currency, Inttegro::Money::Currency
+      const :minimum, Integer
+      const :maximum, T.nilable(Integer), default: nil
+      const :suggested_amounts, T.nilable(T::Array[Inttegro::Price::SuggestedAmount]), default: nil
+    end
+  end
+end

data/lib/inttegro/price/customer_selected_amount_params.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+# typed: strict
+
+# Generated from openapi/commerce.yml by bin/generate-openapi-types. Do not edit.
+
+require_relative "base"
+require_relative "../money/currency"
+require_relative "suggested_amount_params"
+
+module Inttegro
+  class Price
+    # Typed representation of the customer selected amount params object in the Inttegro API.
+    #
+    # This generated model is immutable. Construct it with `.new`, or decode a string-keyed API
+    # payload with `.from_hash`. `#serialize` produces a string-keyed hash using the original wire
+    # field names and serialized enum values.
+    #
+    # @api public
+    #
+    # @!attribute [r] currency
+    #   Currency accepted for customer-selected amounts
+    #
+    #   Required in the API payload. Wire name: `currency`.
+    #   @return [Inttegro::Money::Currency]
+    #
+    # @!attribute [r] minimum
+    #   Minimum selectable amount in the currency's smallest unit
+    #
+    #   Required in the API payload. Wire name: `minimum`.
+    #   @return [Integer]
+    #
+    # @!attribute [r] maximum
+    #   Optional maximum selectable amount; it must be at least minimum
+    #
+    #   Optional in the API payload; omitted values default to `nil`. Wire name: `maximum`.
+    #   @return [Integer, nil]
+    #
+    # @!attribute [r] suggested_amounts
+    #   Convenient choices, not an allow-list. IDs and values must be unique and at most one can be
+    #   recommended.
+    #
+    #   Optional in the API payload; omitted values default to `nil`. Wire name: `suggested_amounts`.
+    #   @return [Array<Inttegro::Price::SuggestedAmountParams>, nil]
+    class CustomerSelectedAmountParams < T::Struct
+      const :currency, Inttegro::Money::Currency
+      const :minimum, Integer
+      const :maximum, T.nilable(Integer), default: nil
+      const :suggested_amounts, T.nilable(T::Array[Inttegro::Price::SuggestedAmountParams]), default: nil
+    end
+  end
+end

data/lib/inttegro/price/suggested_amount.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+# typed: strict
+
+# Generated from openapi/commerce.yml by bin/generate-openapi-types. Do not edit.
+
+require_relative "base"
+
+module Inttegro
+  class Price
+    # Typed representation of the suggested amount object in the Inttegro API.
+    #
+    # This generated model is immutable. Construct it with `.new`, or decode a string-keyed API
+    # payload with `.from_hash`. `#serialize` produces a string-keyed hash using the original wire
+    # field names and serialized enum values.
+    #
+    # @api public
+    #
+    # @!attribute [r] id
+    #   Stable merchant-defined identifier for this suggestion
+    #
+    #   Required in the API payload. Wire name: `id`.
+    #   @return [String]
+    #
+    # @!attribute [r] value
+    #   Suggested amount in the currency's smallest unit
+    #
+    #   Required in the API payload. Wire name: `value`.
+    #   @return [Integer]
+    #
+    # @!attribute [r] recommended
+    #   Whether this is the recommended suggestion
+    #
+    #   Optional in the API payload; omitted values default to `nil`. Wire name: `recommended`.
+    #   @return [Boolean, nil]
+    class SuggestedAmount < T::Struct
+      const :id, String
+      const :value, Integer
+      const :recommended, T.nilable(T::Boolean), default: nil
+    end
+  end
+end

data/lib/inttegro/price/suggested_amount_params.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+# typed: strict
+
+# Generated from openapi/commerce.yml by bin/generate-openapi-types. Do not edit.
+
+require_relative "base"
+
+module Inttegro
+  class Price
+    # Typed representation of the suggested amount params object in the Inttegro API.
+    #
+    # This generated model is immutable. Construct it with `.new`, or decode a string-keyed API
+    # payload with `.from_hash`. `#serialize` produces a string-keyed hash using the original wire
+    # field names and serialized enum values.
+    #
+    # @api public
+    #
+    # @!attribute [r] id
+    #   Stable merchant-defined identifier for this suggestion
+    #
+    #   Required in the API payload. Wire name: `id`.
+    #   @return [String]
+    #
+    # @!attribute [r] value
+    #   Suggested amount in the currency's smallest unit
+    #
+    #   Required in the API payload. Wire name: `value`.
+    #   @return [Integer]
+    #
+    # @!attribute [r] recommended
+    #   Whether this is the single recommended suggestion
+    #
+    #   Optional in the API payload; omitted values default to `nil`. Wire name: `recommended`.
+    #   @return [Boolean, nil]
+    class SuggestedAmountParams < T::Struct
+      const :id, String
+      const :value, Integer
+      const :recommended, T.nilable(T::Boolean), default: nil
+    end
+  end
+end

data/lib/inttegro/price/type.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+# typed: strict
+
+# Generated from openapi/commerce.yml by bin/generate-openapi-types. Do not edit.
+
+require_relative "base"
+
+module Inttegro
+  class Price
+    # Price definition discriminator.
+    #
+    # Use the constants below when constructing a request. `#serialize` returns the documented
+    # string wire value received from or sent to the API.
+    #
+    # @api public
+    class Type < T::Enum
+      enums do
+        # Serialized wire value: `fixed_amount`.
+        # @return [Inttegro::Price::Type]
+        FIXED_AMOUNT = new("fixed_amount")
+        # Serialized wire value: `customer_selected_amount`.
+        # @return [Inttegro::Price::Type]
+        CUSTOMER_SELECTED_AMOUNT = new("customer_selected_amount")
+      end
+    end
+  end
+end

data/lib/inttegro/product/add_price_request.rb

@@ -5,6 +5,8 @@
 
 require_relative "base"
 require_relative "../money/amount_params"
+require_relative "../price/customer_selected_amount_params"
+require_relative "../price/type"
 
 module Inttegro
   class Product
@@ -34,16 +36,31 @@ module Inttegro
     #   Optional in the API payload; omitted values default to `nil`. Wire name: `about`.
     #   @return [String, nil]
     #
-    # @!attribute [r] amount
-    #   Value of the `amount` field in the Inttegro API payload.
+    # @!attribute [r] type
+    #   Price definition discriminator.
     #
-    #   Required in the API payload. Wire name: `amount`.
-    #   @return [Inttegro::Money::AmountParams]
+    #   Optional in the API payload; omitted values default to `nil`. Wire name: `type`.
+    #   @return [Inttegro::Price::Type, nil]
+    #
+    # @!attribute [r] fixed_amount
+    #   Required when type is fixed_amount.
+    #
+    #   Optional in the API payload; omitted values default to `nil`. Wire name: `fixed_amount`.
+    #   @return [Inttegro::Money::AmountParams, nil]
+    #
+    # @!attribute [r] customer_selected_amount
+    #   Required when type is customer_selected_amount. Available only to Commerce internal services
+    #   and Upper private beta organizations and applications.
+    #
+    #   Optional in the API payload; omitted values default to `nil`. Wire name: `customer_selected_amount`.
+    #   @return [Inttegro::Price::CustomerSelectedAmountParams, nil]
     class AddPriceRequest < T::Struct
       const :product_id, String
       const :label, T.nilable(String), default: nil
       const :about, T.nilable(String), default: nil
-      const :amount, Inttegro::Money::AmountParams
+      const :type, T.nilable(Inttegro::Price::Type), default: nil
+      const :fixed_amount, T.nilable(Inttegro::Money::AmountParams), default: nil
+      const :customer_selected_amount, T.nilable(Inttegro::Price::CustomerSelectedAmountParams), default: nil
     end
   end
 end

data/lib/inttegro/product/catalog_with_customer_selected_price.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+# typed: strict
+
+# Generated from openapi/commerce.yml by bin/generate-openapi-types. Do not edit.
+
+require_relative "base"
+require_relative "customer_selected_price_input"
+
+module Inttegro
+  class Product
+    # Typed representation of the catalog with customer selected price object in the Inttegro API.
+    #
+    # This generated model is immutable. Construct it with `.new`, or decode a string-keyed API
+    # payload with `.from_hash`. `#serialize` produces a string-keyed hash using the original wire
+    # field names and serialized enum values.
+    #
+    # @api public
+    #
+    # @!attribute [r] customer_selected_price
+    #   Available only to Commerce internal services and Upper private beta organizations and
+    #   applications.
+    #
+    #   Required in the API payload. Wire name: `customer_selected_price`.
+    #   @return [Inttegro::Product::CustomerSelectedPriceInput]
+    #
+    # @!attribute [r] product_id
+    #   Existing catalog product ID to snapshot onto the order line item
+    #
+    #   Required in the API payload. Wire name: `product_id`.
+    #   @return [String]
+    #
+    # @!attribute [r] quantity
+    #   How many units of the catalog product the customer is purchasing
+    #
+    #   Required in the API payload. Wire name: `quantity`.
+    #   @return [Integer]
+    class CatalogWithCustomerSelectedPrice < T::Struct
+      const :customer_selected_price, Inttegro::Product::CustomerSelectedPriceInput
+      const :product_id, String
+      const :quantity, Integer
+    end
+  end
+end

data/lib/inttegro/product/customer_selected_price_input.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+# typed: strict
+
+# Generated from openapi/commerce.yml by bin/generate-openapi-types. Do not edit.
+
+require_relative "base"
+require_relative "../money/amount_params"
+
+module Inttegro
+  class Product
+    # Available only to Commerce internal services and Upper private beta organizations and
+    # applications.
+    #
+    # This generated model is immutable. Construct it with `.new`, or decode a string-keyed API
+    # payload with `.from_hash`. `#serialize` produces a string-keyed hash using the original wire
+    # field names and serialized enum values.
+    #
+    # @api public
+    #
+    # @!attribute [r] price_id
+    #   Existing customer_selected_amount price belonging to the catalog product
+    #
+    #   Required in the API payload. Wire name: `price_id`.
+    #   @return [String]
+    #
+    # @!attribute [r] selected_amount
+    #   Concrete unit amount selected for this order; it must satisfy the referenced price's
+    #   currency and range
+    #
+    #   Required in the API payload. Wire name: `selected_amount`.
+    #   @return [Inttegro::Money::AmountParams]
+    class CustomerSelectedPriceInput < T::Struct
+      const :price_id, String
+      const :selected_amount, Inttegro::Money::AmountParams
+    end
+  end
+end

data/lib/inttegro/product/details.rb

@@ -4,6 +4,7 @@
 # Generated from openapi/commerce.yml by bin/generate-openapi-types. Do not edit.
 
 require_relative "base"
+require_relative "catalog_with_customer_selected_price"
 require_relative "catalog_with_price_data"
 require_relative "catalog_with_price_reference"
 require_relative "inline_details"
@@ -12,11 +13,11 @@ module Inttegro
   class Product
     # Provide either inline product data or a `product_id` reference to an existing catalog
     # product. Catalog-backed product line items can use an explicit `price` or an existing
-    # `price_id`. Inttegro never falls back to a product's default unit price during order
-    # creation.
+    # `price_id`, or a validated `customer_selected_price`. Inttegro never falls back to a
+    # product's default unit price during order creation.
     #
     # @api public
-    # @return [Inttegro::Product::InlineDetails, Inttegro::Product::CatalogWithPriceData, Inttegro::Product::CatalogWithPriceReference]
-    Details = T.type_alias { T.any(Inttegro::Product::InlineDetails, Inttegro::Product::CatalogWithPriceData, Inttegro::Product::CatalogWithPriceReference) }
+    # @return [Inttegro::Product::InlineDetails, Inttegro::Product::CatalogWithPriceData, Inttegro::Product::CatalogWithPriceReference, Inttegro::Product::CatalogWithCustomerSelectedPrice]
+    Details = T.type_alias { T.any(Inttegro::Product::InlineDetails, Inttegro::Product::CatalogWithPriceData, Inttegro::Product::CatalogWithPriceReference, Inttegro::Product::CatalogWithCustomerSelectedPrice) }
   end
 end

data/lib/inttegro/product/line_item.rb

@@ -26,8 +26,8 @@ module Inttegro
     # @!attribute [r] product
     #   Provide either inline product data or a `product_id` reference to an existing catalog
     #   product. Catalog-backed product line items can use an explicit `price` or an existing
-    #   `price_id`. Inttegro never falls back to a product's default unit price during order
-    #   creation.
+    #   `price_id`, or a validated `customer_selected_price`. Inttegro never falls back to a
+    #   product's default unit price during order creation.
     #
     #   Required in the API payload. Wire name: `product`.
     #   @return [Inttegro::Product::Details]

data/lib/inttegro/product/price_summary.rb

@@ -5,6 +5,8 @@
 
 require_relative "base"
 require_relative "../money/amount"
+require_relative "../price/customer_selected_amount"
+require_relative "../price/type"
 
 module Inttegro
   class Product
@@ -34,16 +36,37 @@ module Inttegro
     #   Optional in the API payload; omitted values default to `nil`. Wire name: `label`.
     #   @return [String, nil]
     #
+    # @!attribute [r] type
+    #   Price definition discriminator
+    #
+    #   Required in the API payload. Wire name: `type`.
+    #   @return [Inttegro::Price::Type]
+    #
     # @!attribute [r] nominal
-    #   Price amount
+    #   Legacy fixed price amount. Present only for fixed_amount prices.
+    #
+    #   Optional in the API payload; omitted values default to `nil`. Wire name: `nominal`.
+    #   @return [Inttegro::Money::Amount, nil]
+    #
+    # @!attribute [r] fixed_amount
+    #   Fixed price amount. Present only for fixed_amount prices.
+    #
+    #   Optional in the API payload; omitted values default to `nil`. Wire name: `fixed_amount`.
+    #   @return [Inttegro::Money::Amount, nil]
+    #
+    # @!attribute [r] customer_selected_amount
+    #   Customer-selected amount configuration. Present only for customer_selected_amount prices.
     #
-    #   Required in the API payload. Wire name: `nominal`.
-    #   @return [Inttegro::Money::Amount]
+    #   Optional in the API payload; omitted values default to `nil`. Wire name: `customer_selected_amount`.
+    #   @return [Inttegro::Price::CustomerSelectedAmount, nil]
     class PriceSummary < T::Struct
       const :id, String
       const :active, T::Boolean
       const :label, T.nilable(String), default: nil
-      const :nominal, Inttegro::Money::Amount
+      const :type, Inttegro::Price::Type
+      const :nominal, T.nilable(Inttegro::Money::Amount), default: nil
+      const :fixed_amount, T.nilable(Inttegro::Money::Amount), default: nil
+      const :customer_selected_amount, T.nilable(Inttegro::Price::CustomerSelectedAmount), default: nil
     end
   end
 end

data/lib/inttegro/resources/prices.rb

@@ -14,7 +14,7 @@ module Inttegro
 
       # Create a catalog price.
       #
-      # @param payload [Hash, Inttegro::Price::CatalogPriceParams] amount and optional price metadata
+      # @param payload [Hash, Inttegro::Price::CatalogPriceParams] tagged price definition and optional metadata
       # @return [Inttegro::Price::CatalogPrice] created price
       def create(payload)
         @http.post_resource("/prices/create", Inttegro::Price::CatalogPrice, :price, payload)

data/lib/inttegro/version.rb

@@ -2,5 +2,5 @@
 # typed: strict
 
 module Inttegro
-  VERSION = "9.1.0"
+  VERSION = "9.2.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: inttegro
 version: !ruby/object:Gem::Version
-  version: 9.1.0
+  version: 9.2.0
 platform: ruby
 authors:
 - Inttegro Engineering
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-09-27 00:00:00.000000000 Z
+date: 2026-10-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: sorbet-runtime
@@ -575,6 +575,8 @@ files:
 - lib/inttegro/price/base.rb
 - lib/inttegro/price/catalog_price.rb
 - lib/inttegro/price/catalog_price_params.rb
+- lib/inttegro/price/customer_selected_amount.rb
+- lib/inttegro/price/customer_selected_amount_params.rb
 - lib/inttegro/price/embedded_product.rb
 - lib/inttegro/price/lookup_request.rb
 - lib/inttegro/price/page.rb
@@ -584,15 +586,20 @@ files:
 - lib/inttegro/price/price.rb
 - lib/inttegro/price/price_params.rb
 - lib/inttegro/price/response.rb
+- lib/inttegro/price/suggested_amount.rb
+- lib/inttegro/price/suggested_amount_params.rb
+- lib/inttegro/price/type.rb
 - lib/inttegro/price/update_request.rb
 - lib/inttegro/product/action_request.rb
 - lib/inttegro/product/add_price_request.rb
 - lib/inttegro/product/add_price_response.rb
 - lib/inttegro/product/attribute.rb
 - lib/inttegro/product/base.rb
+- lib/inttegro/product/catalog_with_customer_selected_price.rb
 - lib/inttegro/product/catalog_with_price_data.rb
 - lib/inttegro/product/catalog_with_price_reference.rb
 - lib/inttegro/product/create_request.rb
+- lib/inttegro/product/customer_selected_price_input.rb
 - lib/inttegro/product/delivery.rb
 - lib/inttegro/product/details.rb
 - lib/inttegro/product/dimensions.rb