inttegro 8.1.0 → 9.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f8bc4f0b5a2c207f948dfa48b29deeccac6c66ee93dbcbc4dd0c9cea2f139fd7
-  data.tar.gz: a4ea44719929147719cf297a3c59d0f33862c87650d50247afa752d0afe3b7b7
+  metadata.gz: 505bb0fb6560e58fc73e184b3bf9768d264d2788e0fd2cd1c782c73eb004e3eb
+  data.tar.gz: 843c5c156bde85253c0f94843f5de3731b864a3c37b5479130f6a1b7fe6541eb
 SHA512:
-  metadata.gz: 36ceb907d2fce5b241b2773f4e77a4efaec24361bec49c27b1b853f1dd43a894db911394be30db76a756fd4ef3348f8dfbdb01000072cabddc95bdfa6542d4db
-  data.tar.gz: 1d8e7b18fb1183c87f8dea4f62e5c3256d1413c7d8396cc9a7a699fea6f1a09b4a1cc30d3cf46806c4063bb1b954f56378643951164f9f442120f875d87e12e9
+  metadata.gz: 1a008265df9c387cd21da22d01c52a8c4bc7bfda2e3dbe5f7d703c7c593547f75daa5f98458a8b89cf99db99653d55f6d474780f979e31be5eef7114c0a87622
+  data.tar.gz: ca020602b0228107d07a475d380fa5d117f18def87ac131d97303b957f764d348bc85c286eadc3eaaff9228c9d31989e4969b2fc719bd5ddae0e02484ce2508f

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 ## [Unreleased]
 
+## [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
+  contribution values containing the source transaction's original amount and
+  the exact amount allocated to the payout.
+- Added complete payment balance-transaction allocation history together with
+  available, pending, and spent amount partitions.
+
 ## [8.1.0] - 2026-09-21
 
 - Added typed search across customers, financial accounts, orders, payouts, and

data/lib/inttegro/balance_transaction/allocation.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+# typed: strict
+
+# Generated from openapi/commerce.yml by bin/generate-openapi-types. Do not edit.
+
+require_relative "base"
+require_relative "payout_allocation"
+require_relative "refund_allocation"
+
+module Inttegro
+  class BalanceTransaction
+    # A caller-safe allocation of part of a payment balance transaction to a refund or payout.
+    #
+    # @api public
+    # @return [Inttegro::BalanceTransaction::RefundAllocation, Inttegro::BalanceTransaction::PayoutAllocation]
+    Allocation = T.type_alias { T.any(Inttegro::BalanceTransaction::RefundAllocation, Inttegro::BalanceTransaction::PayoutAllocation) }
+  end
+end

data/lib/inttegro/balance_transaction/allocation_base.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+# typed: strict
+
+# Generated from openapi/commerce.yml by bin/generate-openapi-types. Do not edit.
+
+require_relative "base"
+require_relative "allocation_base_type"
+require_relative "allocation_status"
+
+module Inttegro
+  class BalanceTransaction
+    # Typed representation of the allocation base 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] completed_at
+    #   When the allocated amount became permanently consumed. Present only when `status` is
+    #   `completed`.
+    #
+    #   Optional in the API payload; omitted values default to `nil`. Wire name: `completed_at`.
+    #   @return [Time, nil]
+    #
+    # @!attribute [r] created_at
+    #   When the amount first became unavailable for another refund or payout.
+    #
+    #   Required in the API payload. Wire name: `created_at`.
+    #   @return [Time]
+    #
+    # @!attribute [r] id
+    #   Stable public allocation identifier for reconciliation and support.
+    #
+    #   Required in the API payload. Wire name: `id`.
+    #   @return [String]
+    #
+    # @!attribute [r] status
+    #   Public effect of an allocation on the source payment balance transaction. Internal
+    #   reservation and reconciliation states are not exposed.
+    #
+    #   Required in the API payload. Wire name: `status`.
+    #   @return [Inttegro::BalanceTransaction::AllocationStatus]
+    #
+    # @!attribute [r] type
+    #   Value of the `type` field in the Inttegro API payload.
+    #
+    #   Required in the API payload. Wire name: `type`.
+    #   @return [Inttegro::BalanceTransaction::AllocationBaseType]
+    #
+    # @!attribute [r] updated_at
+    #   When the public allocation status last changed.
+    #
+    #   Required in the API payload. Wire name: `updated_at`.
+    #   @return [Time]
+    class AllocationBase < T::Struct
+      const :completed_at, T.nilable(Time), default: nil
+      const :created_at, Time
+      const :id, String
+      const :status, Inttegro::BalanceTransaction::AllocationStatus
+      const :type, Inttegro::BalanceTransaction::AllocationBaseType
+      const :updated_at, Time
+    end
+  end
+end

data/lib/inttegro/balance_transaction/allocation_base_type.rb

@@ -0,0 +1,28 @@
+# 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 BalanceTransaction
+    # String-backed values accepted by the Inttegro API for
+    # Inttegro::BalanceTransaction::AllocationBaseType.
+    #
+    # 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 AllocationBaseType < T::Enum
+      enums do
+        # Serialized wire value: `payout`.
+        # @return [Inttegro::BalanceTransaction::AllocationBaseType]
+        PAYOUT = new("payout")
+        # Serialized wire value: `refund`.
+        # @return [Inttegro::BalanceTransaction::AllocationBaseType]
+        REFUND = new("refund")
+      end
+    end
+  end
+end

data/lib/inttegro/balance_transaction/allocation_status.rb

@@ -0,0 +1,28 @@
+# 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 BalanceTransaction
+    # Public effect of an allocation on the source payment balance transaction. Internal
+    # reservation and reconciliation states are not exposed.
+    #
+    # 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 AllocationStatus < T::Enum
+      enums do
+        # Serialized wire value: `pending`.
+        # @return [Inttegro::BalanceTransaction::AllocationStatus]
+        PENDING = new("pending")
+        # Serialized wire value: `completed`.
+        # @return [Inttegro::BalanceTransaction::AllocationStatus]
+        COMPLETED = new("completed")
+      end
+    end
+  end
+end

data/lib/inttegro/balance_transaction/available_amount.rb

@@ -0,0 +1,34 @@
+# 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 BalanceTransaction
+    # 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
+    # field names and serialized enum values.
+    #
+    # @api public
+    #
+    # @!attribute [r] currency
+    #   Currency code as stored on the transaction
+    #
+    #   Required in the API payload. Wire name: `currency`.
+    #   @return [String]
+    #
+    # @!attribute [r] value
+    #   Unsigned amount in the currency's smallest unit
+    #
+    #   Required in the API payload. Wire name: `value`.
+    #   @return [Integer]
+    class AvailableAmount < T::Struct
+      const :currency, String
+      const :value, Integer
+    end
+  end
+end

data/lib/inttegro/balance_transaction/balance_transaction.rb

@@ -4,14 +4,17 @@
 # Generated from openapi/commerce.yml by bin/generate-openapi-types. Do not edit.
 
 require_relative "base"
+require_relative "allocation"
 require_relative "amount"
+require_relative "available_amount"
 require_relative "payout_configuration"
+require_relative "pending_amount"
+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.
+  # 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
@@ -25,18 +28,6 @@ module Inttegro
   #   Required in the API payload. Wire name: `amount`.
   #   @return [Inttegro::BalanceTransaction::Amount]
   #
-  # @!attribute [r] available_at
-  #   Value of the `available_at` field in the Inttegro API payload.
-  #
-  #   Optional in the API payload; omitted values default to `nil`. Wire name: `available_at`.
-  #   @return [Time, nil]
-  #
-  # @!attribute [r] claimed_at
-  #   Value of the `claimed_at` field in the Inttegro API payload.
-  #
-  #   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.
   #
@@ -49,26 +40,58 @@ module Inttegro
   #   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. 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.
+  #
+  #   Optional in the API payload; omitted values default to `nil`. Wire name: `available_amount`.
+  #   @return [Inttegro::BalanceTransaction::AvailableAmount, nil]
+  #
+  # @!attribute [r] available_at
+  #   Value of the `available_at` field in the Inttegro API payload.
+  #
+  #   Optional in the API payload; omitted values default to `nil`. Wire name: `available_at`.
+  #   @return [Time, nil]
+  #
+  # @!attribute [r] claimed_at
+  #   Legacy whole-transaction payout claim timestamp. New integrations should inspect
+  #   `allocations`.
+  #
+  #   Optional in the API payload; omitted values default to `nil`. Wire name: `claimed_at`.
+  #   @return [Time, nil]
+  #
   # @!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
-  #   Value of the `paid_at` field in the Inttegro API payload.
+  #   Legacy whole-transaction payout completion timestamp. New integrations should inspect
+  #   `allocations`.
   #
   #   Optional in the API payload; omitted values default to `nil`. Wire name: `paid_at`.
   #   @return [Time, 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
-  #   Value of the `payout_id` field in the Inttegro API payload.
+  #   Payout that created this finalized debit.
   #
   #   Optional in the API payload; omitted values default to `nil`. Wire name: `payout_id`.
   #   @return [String, nil]
@@ -79,29 +102,60 @@ module Inttegro
   #   Optional in the API payload; omitted values default to `nil`. Wire name: `payout_configuration`.
   #   @return [Inttegro::BalanceTransaction::PayoutConfiguration, nil]
   #
+  # @!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: `pending_amount`.
+  #   @return [Inttegro::BalanceTransaction::PendingAmount, nil]
+  #
+  # @!attribute [r] spent_amount
+  #   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] refund_id
-  #   Present when `type` is `refund`; omitted when `type` is `payment`.
+  #   Value of the `refund_id` field in the Inttegro API payload.
   #
   #   Optional in the API payload; omitted values default to `nil`. Wire name: `refund_id`.
   #   @return [String, nil]
-  #
-  # @!attribute [r] type
-  #   Semantic source or cause of the transaction, not its direction.
-  #
-  #   Required in the API payload. Wire name: `type`.
-  #   @return [Inttegro::BalanceTransaction::Type]
   class BalanceTransaction
     const :amount, Inttegro::BalanceTransaction::Amount
-    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 :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 :order_id, T.nilable(String), default: nil
     const :paid_at, T.nilable(Time), 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 :pending_amount, T.nilable(Inttegro::BalanceTransaction::PendingAmount), default: nil
+    const :spent_amount, T.nilable(Inttegro::BalanceTransaction::SpentAmount), default: nil
     const :refund_id, T.nilable(String), default: nil
-    const :type, Inttegro::BalanceTransaction::Type
+
+    extend T::Sig
+
+    sig { params(hash: T::Hash[String, Object], strict: T::Boolean).returns(T.attached_class) }
+    def self.from_hash(hash, strict = false)
+      data = hash.dup
+      if (allocations_value = data["allocations"]).is_a?(Array)
+        data["allocations"] = allocations_value.map do |item|
+          next item unless item.is_a?(Hash)
+          case item["type"]
+          when "payout"
+            Inttegro::BalanceTransaction::PayoutAllocation.from_hash(item)
+          when "refund"
+            Inttegro::BalanceTransaction::RefundAllocation.from_hash(item)
+          else
+            item
+          end
+        end
+      end
+      super(data, strict)
+    end
   end
 end

data/lib/inttegro/balance_transaction/payout_allocation.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+# typed: strict
+
+# Generated from openapi/commerce.yml by bin/generate-openapi-types. Do not edit.
+
+require_relative "base"
+require_relative "allocation_status"
+require_relative "payout_allocation_payout"
+require_relative "payout_allocation_type"
+
+module Inttegro
+  class BalanceTransaction
+    # Typed representation of the payout allocation 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] completed_at
+    #   When the allocated amount became permanently consumed. Present only when `status` is
+    #   `completed`.
+    #
+    #   Optional in the API payload; omitted values default to `nil`. Wire name: `completed_at`.
+    #   @return [Time, nil]
+    #
+    # @!attribute [r] created_at
+    #   When the amount first became unavailable for another refund or payout.
+    #
+    #   Required in the API payload. Wire name: `created_at`.
+    #   @return [Time]
+    #
+    # @!attribute [r] id
+    #   Stable public allocation identifier for reconciliation and support.
+    #
+    #   Required in the API payload. Wire name: `id`.
+    #   @return [String]
+    #
+    # @!attribute [r] status
+    #   Public effect of an allocation on the source payment balance transaction. Internal
+    #   reservation and reconciliation states are not exposed.
+    #
+    #   Required in the API payload. Wire name: `status`.
+    #   @return [Inttegro::BalanceTransaction::AllocationStatus]
+    #
+    # @!attribute [r] type
+    #   Value of the `type` field in the Inttegro API payload.
+    #
+    #   Required in the API payload. Wire name: `type`.
+    #   @return [Inttegro::BalanceTransaction::PayoutAllocationType]
+    #
+    # @!attribute [r] updated_at
+    #   When the public allocation status last changed.
+    #
+    #   Required in the API payload. Wire name: `updated_at`.
+    #   @return [Time]
+    #
+    # @!attribute [r] payout
+    #   Value of the `payout` field in the Inttegro API payload.
+    #
+    #   Required in the API payload. Wire name: `payout`.
+    #   @return [Inttegro::BalanceTransaction::PayoutAllocationPayout]
+    class PayoutAllocation < T::Struct
+      const :completed_at, T.nilable(Time), default: nil
+      const :created_at, Time
+      const :id, String
+      const :status, Inttegro::BalanceTransaction::AllocationStatus
+      const :type, Inttegro::BalanceTransaction::PayoutAllocationType
+      const :updated_at, Time
+      const :payout, Inttegro::BalanceTransaction::PayoutAllocationPayout
+    end
+  end
+end

data/lib/inttegro/balance_transaction/payout_allocation_payout.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+# typed: strict
+
+# Generated from openapi/commerce.yml by bin/generate-openapi-types. Do not edit.
+
+require_relative "base"
+require_relative "amount"
+
+module Inttegro
+  class BalanceTransaction
+    # Typed representation of the payout allocation payout 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] amount
+    #   Value of the `amount` field in the Inttegro API payload.
+    #
+    #   Required in the API payload. Wire name: `amount`.
+    #   @return [Inttegro::BalanceTransaction::Amount]
+    #
+    # @!attribute [r] id
+    #   Value of the `id` field in the Inttegro API payload.
+    #
+    #   Required in the API payload. Wire name: `id`.
+    #   @return [String]
+    class PayoutAllocationPayout < T::Struct
+      const :amount, Inttegro::BalanceTransaction::Amount
+      const :id, String
+    end
+  end
+end

data/lib/inttegro/balance_transaction/payout_allocation_type.rb

@@ -0,0 +1,25 @@
+# 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 BalanceTransaction
+    # String-backed values accepted by the Inttegro API for
+    # Inttegro::BalanceTransaction::PayoutAllocationType.
+    #
+    # 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 PayoutAllocationType < T::Enum
+      enums do
+        # Serialized wire value: `payout`.
+        # @return [Inttegro::BalanceTransaction::PayoutAllocationType]
+        PAYOUT = new("payout")
+      end
+    end
+  end
+end

data/lib/inttegro/balance_transaction/pending_amount.rb

@@ -0,0 +1,34 @@
+# 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 BalanceTransaction
+    # 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
+    # field names and serialized enum values.
+    #
+    # @api public
+    #
+    # @!attribute [r] currency
+    #   Currency code as stored on the transaction
+    #
+    #   Required in the API payload. Wire name: `currency`.
+    #   @return [String]
+    #
+    # @!attribute [r] value
+    #   Unsigned amount in the currency's smallest unit
+    #
+    #   Required in the API payload. Wire name: `value`.
+    #   @return [Integer]
+    class PendingAmount < T::Struct
+      const :currency, String
+      const :value, Integer
+    end
+  end
+end

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/refund_allocation.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+# typed: strict
+
+# Generated from openapi/commerce.yml by bin/generate-openapi-types. Do not edit.
+
+require_relative "base"
+require_relative "allocation_status"
+require_relative "refund_allocation_refund"
+require_relative "refund_allocation_type"
+
+module Inttegro
+  class BalanceTransaction
+    # Typed representation of the refund allocation 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] completed_at
+    #   When the allocated amount became permanently consumed. Present only when `status` is
+    #   `completed`.
+    #
+    #   Optional in the API payload; omitted values default to `nil`. Wire name: `completed_at`.
+    #   @return [Time, nil]
+    #
+    # @!attribute [r] created_at
+    #   When the amount first became unavailable for another refund or payout.
+    #
+    #   Required in the API payload. Wire name: `created_at`.
+    #   @return [Time]
+    #
+    # @!attribute [r] id
+    #   Stable public allocation identifier for reconciliation and support.
+    #
+    #   Required in the API payload. Wire name: `id`.
+    #   @return [String]
+    #
+    # @!attribute [r] status
+    #   Public effect of an allocation on the source payment balance transaction. Internal
+    #   reservation and reconciliation states are not exposed.
+    #
+    #   Required in the API payload. Wire name: `status`.
+    #   @return [Inttegro::BalanceTransaction::AllocationStatus]
+    #
+    # @!attribute [r] type
+    #   Value of the `type` field in the Inttegro API payload.
+    #
+    #   Required in the API payload. Wire name: `type`.
+    #   @return [Inttegro::BalanceTransaction::RefundAllocationType]
+    #
+    # @!attribute [r] updated_at
+    #   When the public allocation status last changed.
+    #
+    #   Required in the API payload. Wire name: `updated_at`.
+    #   @return [Time]
+    #
+    # @!attribute [r] refund
+    #   Value of the `refund` field in the Inttegro API payload.
+    #
+    #   Required in the API payload. Wire name: `refund`.
+    #   @return [Inttegro::BalanceTransaction::RefundAllocationRefund]
+    class RefundAllocation < T::Struct
+      const :completed_at, T.nilable(Time), default: nil
+      const :created_at, Time
+      const :id, String
+      const :status, Inttegro::BalanceTransaction::AllocationStatus
+      const :type, Inttegro::BalanceTransaction::RefundAllocationType
+      const :updated_at, Time
+      const :refund, Inttegro::BalanceTransaction::RefundAllocationRefund
+    end
+  end
+end

data/lib/inttegro/balance_transaction/refund_allocation_refund.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+# typed: strict
+
+# Generated from openapi/commerce.yml by bin/generate-openapi-types. Do not edit.
+
+require_relative "base"
+require_relative "amount"
+
+module Inttegro
+  class BalanceTransaction
+    # Typed representation of the refund allocation refund 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] amount
+    #   Value of the `amount` field in the Inttegro API payload.
+    #
+    #   Required in the API payload. Wire name: `amount`.
+    #   @return [Inttegro::BalanceTransaction::Amount]
+    #
+    # @!attribute [r] id
+    #   Value of the `id` field in the Inttegro API payload.
+    #
+    #   Required in the API payload. Wire name: `id`.
+    #   @return [String]
+    class RefundAllocationRefund < T::Struct
+      const :amount, Inttegro::BalanceTransaction::Amount
+      const :id, String
+    end
+  end
+end

data/lib/inttegro/balance_transaction/refund_allocation_type.rb

@@ -0,0 +1,25 @@
+# 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 BalanceTransaction
+    # String-backed values accepted by the Inttegro API for
+    # Inttegro::BalanceTransaction::RefundAllocationType.
+    #
+    # 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 RefundAllocationType < T::Enum
+      enums do
+        # Serialized wire value: `refund`.
+        # @return [Inttegro::BalanceTransaction::RefundAllocationType]
+        REFUND = new("refund")
+      end
+    end
+  end
+end

data/lib/inttegro/balance_transaction/response.rb

@@ -17,9 +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.
+    #   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

@@ -0,0 +1,34 @@
+# 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 BalanceTransaction
+    # 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
+    # field names and serialized enum values.
+    #
+    # @api public
+    #
+    # @!attribute [r] currency
+    #   Currency code as stored on the transaction
+    #
+    #   Required in the API payload. Wire name: `currency`.
+    #   @return [String]
+    #
+    # @!attribute [r] value
+    #   Unsigned amount in the currency's smallest unit
+    #
+    #   Required in the API payload. Wire name: `value`.
+    #   @return [Integer]
+    class SpentAmount < T::Struct
+      const :currency, String
+      const :value, Integer
+    end
+  end
+end

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

@@ -7,6 +7,10 @@ require_relative "../app/credential_owner"
 require_relative "../app/management_role"
 require_relative "../app/relationship_kind"
 require_relative "../app/relationship_status"
+require_relative "../balance_transaction/allocation_base_type"
+require_relative "../balance_transaction/allocation_status"
+require_relative "../balance_transaction/payout_allocation_type"
+require_relative "../balance_transaction/refund_allocation_type"
 require_relative "../balance_transaction/type"
 require_relative "../bank_account/type"
 require_relative "../checkout/invoice_view_status"

data/lib/inttegro/generated/models.rb

@@ -48,9 +48,18 @@ require_relative "../balance/currency_snapshot"
 require_relative "../balance/snapshot"
 require_relative "../balance/snapshot_response"
 require_relative "../balance_transaction/amount"
+require_relative "../balance_transaction/refund_allocation_refund"
+require_relative "../balance_transaction/refund_allocation"
+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/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"
 require_relative "../balance_transaction/page"
 require_relative "../balance_transaction/page_response"
 require_relative "../balance_transaction/response"
@@ -469,6 +478,7 @@ require_relative "../payment_method/page_request"
 require_relative "../payment_method/page_response"
 require_relative "../payment_method/tokenize_base"
 require_relative "../payment/result"
+require_relative "../payout/balance_transaction"
 require_relative "../payout/error"
 require_relative "../payout/payout"
 require_relative "../payout/page"

data/lib/inttegro/payment/payment.rb

@@ -49,9 +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.
+  #   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/balance_transaction.rb

@@ -0,0 +1,42 @@
+# 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"
+
+module Inttegro
+  class Payout
+    # A sparse view of one balance transaction's contribution to a 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
+    # field names and serialized enum values.
+    #
+    # @api public
+    #
+    # @!attribute [r] allocated_amount
+    #   Value of the `allocated_amount` field in the Inttegro API payload.
+    #
+    #   Required in the API payload. Wire name: `allocated_amount`.
+    #   @return [Inttegro::Money::Amount]
+    #
+    # @!attribute [r] amount
+    #   Value of the `amount` field in the Inttegro API payload.
+    #
+    #   Required in the API payload. Wire name: `amount`.
+    #   @return [Inttegro::Money::Amount]
+    #
+    # @!attribute [r] id
+    #   Unique balance transaction identifier.
+    #
+    #   Required in the API payload. Wire name: `id`.
+    #   @return [String]
+    class BalanceTransaction < T::Struct
+      const :allocated_amount, Inttegro::Money::Amount
+      const :amount, Inttegro::Money::Amount
+      const :id, String
+    end
+  end
+end

data/lib/inttegro/payout/payout.rb

@@ -6,6 +6,7 @@
 require_relative "base"
 require_relative "../custom_data"
 require_relative "../money/amount"
+require_relative "balance_transaction"
 require_relative "error"
 require_relative "status"
 
@@ -25,10 +26,19 @@ module Inttegro
   #   @return [Inttegro::Money::Amount, nil]
   #
   # @!attribute [r] balance_transactions
-  #   Balance transaction IDs linked to this payout
+  #   Balance transactions that contributed to this payout. Each item includes the source
+  #   transaction's original amount and the exact portion allocated to this payout. The difference
+  #   between those two amounts is not necessarily still available because refunds or other
+  #   payouts may also consume the source.
   #
   #   Optional in the API payload; omitted values default to `nil`. Wire name: `balance_transactions`.
-  #   @return [Array<String>, nil]
+  #   @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
@@ -152,7 +162,8 @@ module Inttegro
   #   @return [Time, nil]
   class Payout
     const :amount, T.nilable(Inttegro::Money::Amount), default: nil
-    const :balance_transactions, T.nilable(T::Array[String]), 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/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: inttegro
 version: !ruby/object:Gem::Version
-  version: 8.1.0
+  version: 9.1.0
 platform: ruby
 authors:
 - Inttegro Engineering
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-09-21 00:00:00.000000000 Z
+date: 2026-09-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: sorbet-runtime
@@ -106,17 +106,30 @@ files:
 - lib/inttegro/balance/snapshot.rb
 - lib/inttegro/balance/snapshot_response.rb
 - lib/inttegro/balance/value.rb
+- lib/inttegro/balance_transaction/allocation.rb
+- lib/inttegro/balance_transaction/allocation_base.rb
+- lib/inttegro/balance_transaction/allocation_base_type.rb
+- lib/inttegro/balance_transaction/allocation_status.rb
 - lib/inttegro/balance_transaction/amount.rb
+- lib/inttegro/balance_transaction/available_amount.rb
 - lib/inttegro/balance_transaction/balance_transaction.rb
 - lib/inttegro/balance_transaction/base.rb
 - lib/inttegro/balance_transaction/lookup_request.rb
 - lib/inttegro/balance_transaction/page.rb
 - lib/inttegro/balance_transaction/page_request.rb
 - lib/inttegro/balance_transaction/page_response.rb
+- lib/inttegro/balance_transaction/payout_allocation.rb
+- lib/inttegro/balance_transaction/payout_allocation_payout.rb
+- lib/inttegro/balance_transaction/payout_allocation_type.rb
 - lib/inttegro/balance_transaction/payout_configuration.rb
 - lib/inttegro/balance_transaction/payout_configuration_destination.rb
+- lib/inttegro/balance_transaction/pending_amount.rb
 - lib/inttegro/balance_transaction/questions.rb
+- lib/inttegro/balance_transaction/refund_allocation.rb
+- lib/inttegro/balance_transaction/refund_allocation_refund.rb
+- lib/inttegro/balance_transaction/refund_allocation_type.rb
 - lib/inttegro/balance_transaction/response.rb
+- lib/inttegro/balance_transaction/spent_amount.rb
 - lib/inttegro/balance_transaction/type.rb
 - lib/inttegro/bank_account/base.rb
 - lib/inttegro/bank_account/created.rb
@@ -533,6 +546,7 @@ files:
 - lib/inttegro/payment_method/update_request_owner_address.rb
 - lib/inttegro/payment_method/update_response.rb
 - lib/inttegro/payment_method/verification.rb
+- lib/inttegro/payout/balance_transaction.rb
 - lib/inttegro/payout/base.rb
 - lib/inttegro/payout/cancel_request.rb
 - lib/inttegro/payout/destinations.rb