inttegro 9.0.0 → 9.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 608a68da5f01abba8df499233779b428564f247ede7b80311b3af48168898519
-  data.tar.gz: 6eed899188c50ed6611cb0f6180dde027c53065ae5f9ea1ebe9613b36e04a725
+  metadata.gz: 192fa0d6bd78a893b0577e6cea06f93a1577b4356176267125090f760c396e7f
+  data.tar.gz: de934a47ffb8c6028236f58560e18e34435c6db06489b7eb8770203cd9b26f88
 SHA512:
-  metadata.gz: b5624cef6cd5474eacb13dba6b2d8ec90b9600383b429c316d2d249a3d4fb97bb80c907890c2670af46f317f386bdd630c1b671f8698cd7ee68cefa8325aacde
-  data.tar.gz: a862487a146d0db29481f0593d77e872f45115d86920314e64f8250284985297fc8ba41a0e523a9548f5e04a62faf3b3a7ad40e3446558cb37d27e129cbe60bb
+  metadata.gz: b706cd2e9276468e0626ad7294e416507846250a1e7fa6d995fde9db98144412db9ceb25072c9f123e7e492b48b76ca62a389aa15941471741c6808e64bd1e40
+  data.tar.gz: 18a789789f0bc32f289910091f918425d84c5832ddaa94064c3d16ef9eba1c71c67eb88f8354375b1582c10f3f49ec1f59a87b8f570cab85c667aa188e9c8d3f

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 ## [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
+  responses for possible duplicate-record detection.
+
 ## [9.0.0] - 2026-09-23
 
 - Breaking: replaced payout `balance_transactions` ID strings with typed

data/lib/inttegro/balance_transaction/available_amount.rb

@@ -7,7 +7,7 @@ require_relative "base"
 
 module Inttegro
   class BalanceTransaction
-    # Amount still available for a refund or payout. Present only when `type` is `payment`.
+    # Amount still available for a refund or payout.
     #
     # 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

data/lib/inttegro/balance_transaction/balance_transaction.rb

@@ -13,12 +13,8 @@ require_relative "spent_amount"
 require_relative "type"
 
 module Inttegro
-  # Merchant balance entry caused by a payment or refund. `type` describes the semantic source,
-  # not direction. A payment transaction contains `payment_id`; a refund transaction contains
-  # `refund_id`. Exactly one matching reference is present. Payment transactions also expose
-  # their complete current allocation state and disjoint available, pending, and spent amounts.
-  # Allocation fields are omitted from refund transactions because refund transactions are
-  # consumers rather than sources.
+  # Merchant balance entry caused by a payment, refund, or payout. `type` is the discriminator
+  # and describes the semantic source rather than the direction.
   #
   # 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
@@ -32,15 +28,32 @@ module Inttegro
   #   Required in the API payload. Wire name: `amount`.
   #   @return [Inttegro::BalanceTransaction::Amount]
   #
+  # @!attribute [r] created_at
+  #   Value of the `created_at` field in the Inttegro API payload.
+  #
+  #   Required in the API payload. Wire name: `created_at`.
+  #   @return [Time]
+  #
+  # @!attribute [r] id
+  #   Value of the `id` field in the Inttegro API payload.
+  #
+  #   Required in the API payload. Wire name: `id`.
+  #   @return [String]
+  #
+  # @!attribute [r] type
+  #   Value of the `type` field in the Inttegro API payload.
+  #
+  #   Required in the API payload. Wire name: `type`.
+  #   @return [Inttegro::BalanceTransaction::Type]
+  #
   # @!attribute [r] allocations
-  #   All current pending and completed allocations of this payment transaction. Released
-  #   allocations are omitted. Present only when `type` is `payment`.
+  #   All current pending and completed allocations. Released allocations are omitted.
   #
   #   Optional in the API payload; omitted values default to `nil`. Wire name: `allocations`.
   #   @return [Array<Inttegro::BalanceTransaction::Allocation>, nil]
   #
   # @!attribute [r] available_amount
-  #   Amount still available for a refund or payout. Present only when `type` is `payment`.
+  #   Amount still available for a refund or payout.
   #
   #   Optional in the API payload; omitted values default to `nil`. Wire name: `available_amount`.
   #   @return [Inttegro::BalanceTransaction::AvailableAmount, nil]
@@ -58,23 +71,11 @@ module Inttegro
   #   Optional in the API payload; omitted values default to `nil`. Wire name: `claimed_at`.
   #   @return [Time, nil]
   #
-  # @!attribute [r] created_at
-  #   Value of the `created_at` field in the Inttegro API payload.
-  #
-  #   Required in the API payload. Wire name: `created_at`.
-  #   @return [Time]
-  #
-  # @!attribute [r] id
-  #   Value of the `id` field in the Inttegro API payload.
-  #
-  #   Required in the API payload. Wire name: `id`.
-  #   @return [String]
-  #
   # @!attribute [r] order_id
   #   Value of the `order_id` field in the Inttegro API payload.
   #
-  #   Required in the API payload. Wire name: `order_id`.
-  #   @return [String]
+  #   Optional in the API payload; omitted values default to `nil`. Wire name: `order_id`.
+  #   @return [String, nil]
   #
   # @!attribute [r] paid_at
   #   Legacy whole-transaction payout completion timestamp. New integrations should inspect
@@ -83,22 +84,14 @@ module Inttegro
   #   Optional in the API payload; omitted values default to `nil`. Wire name: `paid_at`.
   #   @return [Time, nil]
   #
-  # @!attribute [r] pending_amount
-  #   Amount temporarily unavailable because a refund or payout is unresolved. Present only when
-  #   `type` is `payment`.
-  #
-  #   Optional in the API payload; omitted values default to `nil`. Wire name: `pending_amount`.
-  #   @return [Inttegro::BalanceTransaction::PendingAmount, nil]
-  #
   # @!attribute [r] payment_id
-  #   Present when `type` is `payment`; omitted when `type` is `refund`.
+  #   Value of the `payment_id` field in the Inttegro API payload.
   #
   #   Optional in the API payload; omitted values default to `nil`. Wire name: `payment_id`.
   #   @return [String, nil]
   #
   # @!attribute [r] payout_id
-  #   Legacy payout owning the whole transaction remainder. New integrations should inspect
-  #   `allocations` because one transaction can participate in many payouts.
+  #   Payout that created this finalized debit.
   #
   #   Optional in the API payload; omitted values default to `nil`. Wire name: `payout_id`.
   #   @return [String, nil]
@@ -109,41 +102,40 @@ module Inttegro
   #   Optional in the API payload; omitted values default to `nil`. Wire name: `payout_configuration`.
   #   @return [Inttegro::BalanceTransaction::PayoutConfiguration, nil]
   #
-  # @!attribute [r] refund_id
-  #   Present when `type` is `refund`; omitted when `type` is `payment`.
+  # @!attribute [r] pending_amount
+  #   Amount temporarily unavailable because a refund or payout is unresolved.
   #
-  #   Optional in the API payload; omitted values default to `nil`. Wire name: `refund_id`.
-  #   @return [String, nil]
+  #   Optional in the API payload; omitted values default to `nil`. Wire name: `pending_amount`.
+  #   @return [Inttegro::BalanceTransaction::PendingAmount, nil]
   #
   # @!attribute [r] spent_amount
-  #   Amount permanently consumed by completed refunds and payouts. Present only when `type` is
-  #   `payment`.
+  #   Amount permanently consumed by completed refund and payout allocations.
   #
   #   Optional in the API payload; omitted values default to `nil`. Wire name: `spent_amount`.
   #   @return [Inttegro::BalanceTransaction::SpentAmount, nil]
   #
-  # @!attribute [r] type
-  #   Semantic source or cause of the transaction, not its direction.
+  # @!attribute [r] refund_id
+  #   Value of the `refund_id` field in the Inttegro API payload.
   #
-  #   Required in the API payload. Wire name: `type`.
-  #   @return [Inttegro::BalanceTransaction::Type]
+  #   Optional in the API payload; omitted values default to `nil`. Wire name: `refund_id`.
+  #   @return [String, nil]
   class BalanceTransaction
     const :amount, Inttegro::BalanceTransaction::Amount
+    const :created_at, Time
+    const :id, String
+    const :type, Inttegro::BalanceTransaction::Type
     const :allocations, T.nilable(T::Array[Inttegro::BalanceTransaction::Allocation]), default: nil
     const :available_amount, T.nilable(Inttegro::BalanceTransaction::AvailableAmount), default: nil
     const :available_at, T.nilable(Time), default: nil
     const :claimed_at, T.nilable(Time), default: nil
-    const :created_at, Time
-    const :id, String
-    const :order_id, String
+    const :order_id, T.nilable(String), default: nil
     const :paid_at, T.nilable(Time), default: nil
-    const :pending_amount, T.nilable(Inttegro::BalanceTransaction::PendingAmount), default: nil
     const :payment_id, T.nilable(String), default: nil
     const :payout_id, T.nilable(String), default: nil
     const :payout_configuration, T.nilable(Inttegro::BalanceTransaction::PayoutConfiguration), default: nil
-    const :refund_id, T.nilable(String), default: nil
+    const :pending_amount, T.nilable(Inttegro::BalanceTransaction::PendingAmount), default: nil
     const :spent_amount, T.nilable(Inttegro::BalanceTransaction::SpentAmount), default: nil
-    const :type, Inttegro::BalanceTransaction::Type
+    const :refund_id, T.nilable(String), default: nil
 
     extend T::Sig
 

data/lib/inttegro/balance_transaction/pending_amount.rb

@@ -7,8 +7,7 @@ require_relative "base"
 
 module Inttegro
   class BalanceTransaction
-    # Amount temporarily unavailable because a refund or payout is unresolved. Present only when
-    # `type` is `payment`.
+    # Amount temporarily unavailable because a refund or payout is unresolved.
     #
     # 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

data/lib/inttegro/balance_transaction/questions.rb

@@ -42,7 +42,8 @@ module Inttegro
     #
     # @return [Boolean] whether the transaction satisfies the local identity checks
     def valid?
-      !id.empty? && !order_id.empty? && valid_source?
+      order = order_id
+      !id.empty? && !order.nil? && !order.empty? && valid_source?
     end
   end
 end

data/lib/inttegro/balance_transaction/response.rb

@@ -17,12 +17,8 @@ module Inttegro
     # @api public
     #
     # @!attribute [r] transaction
-    #   Merchant balance entry caused by a payment or refund. `type` describes the semantic source,
-    #   not direction. A payment transaction contains `payment_id`; a refund transaction contains
-    #   `refund_id`. Exactly one matching reference is present. Payment transactions also expose
-    #   their complete current allocation state and disjoint available, pending, and spent amounts.
-    #   Allocation fields are omitted from refund transactions because refund transactions are
-    #   consumers rather than sources.
+    #   Merchant balance entry caused by a payment, refund, or payout. `type` is the discriminator
+    #   and describes the semantic source rather than the direction.
     #
     #   Required in the API payload. Wire name: `transaction`.
     #   @return [Inttegro::BalanceTransaction]

data/lib/inttegro/balance_transaction/spent_amount.rb

@@ -7,8 +7,7 @@ require_relative "base"
 
 module Inttegro
   class BalanceTransaction
-    # Amount permanently consumed by completed refunds and payouts. Present only when `type` is
-    # `payment`.
+    # Amount permanently consumed by completed refund and payout allocations.
     #
     # 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

data/lib/inttegro/balance_transaction/type.rb

@@ -7,7 +7,7 @@ require_relative "base"
 
 module Inttegro
   class BalanceTransaction
-    # Semantic source or cause of the transaction, not its direction.
+    # String-backed values accepted by the Inttegro API for Inttegro::BalanceTransaction::Type.
     #
     # Use the constants below when constructing a request. `#serialize` returns the documented
     # string wire value received from or sent to the API.
@@ -21,6 +21,9 @@ module Inttegro
         # Serialized wire value: `refund`.
         # @return [Inttegro::BalanceTransaction::Type]
         REFUND = new("refund")
+        # Serialized wire value: `payout`.
+        # @return [Inttegro::BalanceTransaction::Type]
+        PAYOUT = new("payout")
       end
     end
   end

data/lib/inttegro/customer/customer.rb

@@ -48,6 +48,15 @@ module Inttegro
   #   Optional in the API payload; omitted values default to `nil`. Wire name: `email_address`.
   #   @return [String, nil]
   #
+  # @!attribute [r] fingerprint
+  #   Application-scoped value for spotting possible duplicate customer records. Matching nonempty
+  #   fingerprints within the same application indicate that the records likely belong to the same
+  #   buyer. Compare fingerprints only within that application, and continue to use each customer
+  #   ID for API operations.
+  #
+  #   Required in the API payload. Wire name: `fingerprint`.
+  #   @return [String]
+  #
   # @!attribute [r] guest
   #   Value of the `guest` field in the Inttegro API payload.
   #
@@ -107,6 +116,7 @@ module Inttegro
     const :created_at, Time
     const :custom_data, T.nilable(Inttegro::CustomData), default: nil
     const :email_address, T.nilable(String), default: nil
+    const :fingerprint, String
     const :guest, T::Boolean
     const :id, String
     const :name, String

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"
@@ -54,9 +58,9 @@ require_relative "../balance_transaction/payout_allocation_payout"
 require_relative "../balance_transaction/payout_allocation"
 require_relative "../balance_transaction/allocation"
 require_relative "../balance_transaction/available_amount"
-require_relative "../balance_transaction/pending_amount"
 require_relative "../balance_transaction/payout_configuration_destination"
 require_relative "../balance_transaction/payout_configuration"
+require_relative "../balance_transaction/pending_amount"
 require_relative "../balance_transaction/spent_amount"
 require_relative "../balance_transaction/balance_transaction"
 require_relative "../balance_transaction/allocation_base"
@@ -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/payment/payment.rb

@@ -49,12 +49,8 @@ module Inttegro
   #   @return [Inttegro::Money::Amount]
   #
   # @!attribute [r] balance_transaction
-  #   Merchant balance entry caused by a payment or refund. `type` describes the semantic source,
-  #   not direction. A payment transaction contains `payment_id`; a refund transaction contains
-  #   `refund_id`. Exactly one matching reference is present. Payment transactions also expose
-  #   their complete current allocation state and disjoint available, pending, and spent amounts.
-  #   Allocation fields are omitted from refund transactions because refund transactions are
-  #   consumers rather than sources.
+  #   Merchant balance entry caused by a payment, refund, or payout. `type` is the discriminator
+  #   and describes the semantic source rather than the direction.
   #
   #   Optional in the API payload; omitted values default to `nil`. Wire name: `balance_transaction`.
   #   @return [Inttegro::BalanceTransaction, nil]

data/lib/inttegro/payout/payout.rb

@@ -34,6 +34,12 @@ module Inttegro
   #   Optional in the API payload; omitted values default to `nil`. Wire name: `balance_transactions`.
   #   @return [Array<Inttegro::Payout::BalanceTransaction>, nil]
   #
+  # @!attribute [r] balance_transaction_id
+  #   Immutable debit balance transaction created when this payout succeeds.
+  #
+  #   Optional in the API payload; omitted values default to `nil`. Wire name: `balance_transaction_id`.
+  #   @return [String, nil]
+  #
   # @!attribute [r] canceled_at
   #   When the payout was canceled
   #
@@ -157,6 +163,7 @@ module Inttegro
   class Payout
     const :amount, T.nilable(Inttegro::Money::Amount), default: nil
     const :balance_transactions, T.nilable(T::Array[Inttegro::Payout::BalanceTransaction]), default: nil
+    const :balance_transaction_id, T.nilable(String), default: nil
     const :canceled_at, T.nilable(Time), default: nil
     const :custom_data, T.nilable(Inttegro::CustomData), default: nil
     const :destination_id, String

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.0.0"
+  VERSION = "9.2.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: inttegro
 version: !ruby/object:Gem::Version
-  version: 9.0.0
+  version: 9.2.0
 platform: ruby
 authors:
 - Inttegro Engineering
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-09-23 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