inttegro 9.0.0 → 9.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 608a68da5f01abba8df499233779b428564f247ede7b80311b3af48168898519
-  data.tar.gz: 6eed899188c50ed6611cb0f6180dde027c53065ae5f9ea1ebe9613b36e04a725
+  metadata.gz: 505bb0fb6560e58fc73e184b3bf9768d264d2788e0fd2cd1c782c73eb004e3eb
+  data.tar.gz: 843c5c156bde85253c0f94843f5de3731b864a3c37b5479130f6a1b7fe6541eb
 SHA512:
-  metadata.gz: b5624cef6cd5474eacb13dba6b2d8ec90b9600383b429c316d2d249a3d4fb97bb80c907890c2670af46f317f386bdd630c1b671f8698cd7ee68cefa8325aacde
-  data.tar.gz: a862487a146d0db29481f0593d77e872f45115d86920314e64f8250284985297fc8ba41a0e523a9548f5e04a62faf3b3a7ad40e3446558cb37d27e129cbe60bb
+  metadata.gz: 1a008265df9c387cd21da22d01c52a8c4bc7bfda2e3dbe5f7d703c7c593547f75daa5f98458a8b89cf99db99653d55f6d474780f979e31be5eef7114c0a87622
+  data.tar.gz: ca020602b0228107d07a475d380fa5d117f18def87ac131d97303b957f764d348bc85c286eadc3eaaff9228c9d31989e4969b2fc719bd5ddae0e02484ce2508f

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 ## [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

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

@@ -54,9 +54,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"

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

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: inttegro
 version: !ruby/object:Gem::Version
-  version: 9.0.0
+  version: 9.1.0
 platform: ruby
 authors:
 - Inttegro Engineering
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-09-23 00:00:00.000000000 Z
+date: 2026-09-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: sorbet-runtime