inttegro 4.2.2 → 4.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 898d14cfaa38b878c20565b4522fe67d87147f01850656bf5a7817da99c955a2
-  data.tar.gz: 32a2dc36592ebdfa52c4076687d7b5c4512ac887de57285fccb843815a0e64e7
+  metadata.gz: 86ef8bd75f65151aa6cd1f7d17702bfc1ba9eac446fe8d19196437e50904f561
+  data.tar.gz: e7a15368c96ded7010ccac121a70e8ae57df64503ff0fa470f754217c96efd12
 SHA512:
-  metadata.gz: 5c3dff6b6e94712d541d1c4aabe3ee49227cd35ce1d4decc7656eff992be17ad0fec34177b5e7e3fd84514e0e79558f7ee552bb889f025cacb77b69381d9fbc2
-  data.tar.gz: f55e5ed4ea3703b3ef98042add688bb97224dfcebe5c102455544a9984745bf7d855aa8bd3ae30f9971c3de2af1ecac68f11f5ebadafec2a4212c2b933c68ba1
+  metadata.gz: 64cafa969f9cd2019e88eb3e2d471bf62915bee400a4f8ce5e1ac5ca5347204eb4ce975c345ae017fd5c5be2bb7152c4be6f70e46826ddc4d46290a08dc66a5e
+  data.tar.gz: feb309c70b5ae2c7bf59633df20d79dc51cde49d3c7a6bf69132f3685e7d81721eed0d13a5a3465243a2afac6779dc5fd6f33654eac22ac22937588dd7a3919b

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 ## [Unreleased]
 
+## [4.3.1] - 2026-09-08
+
+- Tightened financial-account and payment-method response models to exclude internal platform fields.
+
+## [4.3.0] - 2026-09-06
+
+- Added opt-in, typed error reporting to application-owned collectors with privacy-safe payloads, stable fingerprints, isolated reporter failures, and no reporting work when unconfigured.
+
 ## [4.2.2] - 2026-09-04
 
 - Constrained OpenTelemetry dependencies to releases that preserve the SDK's Ruby 3.0 runtime support, while declaring `logger` for Ruby 4 compatibility.

data/README.md

@@ -4,6 +4,8 @@
 
 The official Ruby client for building server-side Inttegro integrations.
 
+[API documentation](https://ruby.inttegro.dev/) · [Integration guides](https://studio.inttegro.com/sdks/ruby)
+
 > **Fastest, most modern path:** connect an agent to [Inttegro MCP](https://studio.inttegro.com/inttegro-mcp) at `https://mcp.inttegro.com`, then ask it to run `design_integration`. It will produce an implementation and test plan for your application. Use this SDK when you are ready to connect that plan to your Ruby service.
 
 All official Inttegro SDKs expose the same API capabilities. This gem adds strict Sorbet types and Ruby-native resource methods.
@@ -87,6 +89,21 @@ inttegro = Inttegro::Client.new(api_key: ENV.fetch("INTTEGRO_API_KEY"))
 
 Spans are named after logical operations such as `inttegro.orders.create`. HTTP attempts, response receipt, and decoding are span events. API keys, bodies, resource IDs, dynamic URLs, and exception messages are never recorded. See [SDK observability](https://studio.inttegro.com/sdk-observability) for the complete contract and set `telemetry_enabled: false` when needed.
 
+### Report SDK failures
+
+Provide an application-owned reporter to receive one immutable, typed, privacy-safe report after an SDK operation finally fails. The default `:unexpected` policy reports transport, timeout, decoding, SDK, `unknown_error`, and server-side failures while leaving normal 4xx API errors alone:
+
+```ruby
+inttegro = Inttegro::Client.new(
+  api_key: ENV.fetch("INTTEGRO_API_KEY"),
+  error_reporter: ->(report) { ErrorCollector.enqueue(report.serialize) }
+)
+```
+
+Use `error_reporting_policy: :all` to include expected API failures; cancellations are never reported. Reports contain the logical operation, static route, server host, status and request IDs when available, duration, safe API error codes, SDK identity, stable fingerprint, exception type, and trace IDs when tracing is active. They exclude credentials, headers, bodies, resource IDs, dynamic URLs, exception messages, and stack traces. Reporter failures are isolated and the original SDK error is still raised.
+
+Error reporting is completely opt-in. Without `error_reporter`, the SDK does not calculate report metadata, create an event ID or timestamp, allocate a report, or serialize a payload.
+
 ## Work with the API
 
 The SDK covers orders and checkout, customers, products and prices, purchase intents, payment methods, balances, payouts and refunds, notifications, files, application settings, keys, and country specifications. Resources use snake-case readers such as `purchase_intents` and `payment_methods`.

data/Rakefile

@@ -6,9 +6,22 @@ require "minitest/test_task"
 Minitest::TestTask.create
 
 require "rubocop/rake_task"
+require "yard"
+require "yard/rake/yardoc_task"
 
 RuboCop::RakeTask.new
 
+YARD::Rake::YardocTask.new(:docs) do |task|
+  task.files = ["lib/**/*.rb"]
+  task.options = [
+    "--no-private",
+    "--protected",
+    "--readme", "README.md",
+    "--title", "Inttegro Ruby SDK",
+    "--output-dir", "build/api-docs"
+  ]
+end
+
 namespace :rbi do
   desc "Regenerate Sorbet declarations for models, enums, and resources"
   task :generate do

data/lib/inttegro/client.rb

@@ -111,7 +111,9 @@ module Inttegro
         open_timeout: T.nilable(Numeric),
         adapter: T.nilable(Types::Adapter),
         telemetry_enabled: T::Boolean,
-        tracer_provider: T.nilable(OpenTelemetry::Trace::TracerProvider)
+        tracer_provider: T.nilable(OpenTelemetry::Trace::TracerProvider),
+        error_reporter: T.nilable(ErrorReporter),
+        error_reporting_policy: Symbol
       ).void
     end
     def initialize(
@@ -123,7 +125,9 @@ module Inttegro
       open_timeout: 10,
       adapter: nil,
       telemetry_enabled: true,
-      tracer_provider: nil
+      tracer_provider: nil,
+      error_reporter: nil,
+      error_reporting_policy: :unexpected
     )
       provided_token = token || token_value
       api_key ||= provided_token
@@ -134,7 +138,9 @@ module Inttegro
         open_timeout: open_timeout,
         adapter: adapter,
         telemetry_enabled: telemetry_enabled,
-        tracer_provider: tracer_provider
+        tracer_provider: tracer_provider,
+        error_reporter: error_reporter,
+        error_reporting_policy: error_reporting_policy
       ), HTTPClient)
 
       @orders = T.let(Resources::Orders.new(@http), Resources::Orders)

data/lib/inttegro/error_reporting.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+# typed: strict
+
+require "sorbet-runtime"
+
+module Inttegro
+  # SDK identity included in an ErrorReport.
+  class SDKReportContext < T::Struct
+    const :language, String
+    const :version, String
+  end
+
+  # Bounded HTTP metadata included in an ErrorReport.
+  class HTTPReportContext < T::Struct
+    const :request_method, String
+    const :server_address, String
+    const :duration_ms, Integer
+    const :route, T.nilable(String), default: nil
+    const :status_code, T.nilable(Integer), default: nil
+    const :request_id, T.nilable(String), default: nil
+  end
+
+  # Machine-readable API error metadata included in an ErrorReport.
+  class APIErrorReportContext < T::Struct
+    const :type, T.nilable(String), default: nil
+    const :code, T.nilable(String), default: nil
+    const :fix_code, T.nilable(String), default: nil
+  end
+
+  # Trace identifiers included when application tracing is enabled.
+  class TraceReportContext < T::Struct
+    const :trace_id, String
+    const :span_id, String
+  end
+
+  # Privacy-safe description of a failed Inttegro SDK operation.
+  class ErrorReport < T::Struct
+    const :schema_version, Integer
+    const :event_id, String
+    const :occurred_at, String
+    const :severity, String
+    const :category, String
+    const :operation, String
+    const :sdk, SDKReportContext
+    const :http, HTTPReportContext
+    const :exception_type, String
+    const :fingerprint, String
+    const :api_error, T.nilable(APIErrorReportContext), default: nil
+    const :trace, T.nilable(TraceReportContext), default: nil
+  end
+
+  ErrorReporter = T.type_alias { T.proc.params(report: ErrorReport).void }
+end

data/lib/inttegro/errors.rb

@@ -4,9 +4,21 @@
 require "sorbet-runtime"
 
 require_relative "types"
+require_relative "error_reporting"
 
 module Inttegro
-  class Error < StandardError; end
+  class Error < StandardError
+    extend T::Sig
+
+    sig { returns(T.nilable(ErrorReport)) }
+    attr_accessor :report
+
+    sig { params(message: String).void }
+    def initialize(message)
+      super(message)
+      @report = T.let(nil, T.nilable(ErrorReport))
+    end
+  end
 
   class NetworkError < Error
     extend T::Sig
@@ -30,7 +42,7 @@ module Inttegro
     attr_reader :status
 
     sig { returns(T.nilable(String)) }
-    attr_reader :code, :type, :url, :detail, :fix_code, :cause, :body
+    attr_reader :code, :type, :url, :detail, :fix_code, :cause, :body, :request_id
 
     sig { returns(Types::WireValue) }
     attr_reader :data
@@ -46,7 +58,8 @@ module Inttegro
         fix_code: T.nilable(String),
         cause: T.nilable(String),
         body: T.nilable(String),
-        data: Types::WireValue
+        data: Types::WireValue,
+        request_id: T.nilable(String)
       ).void
     end
     def initialize(
@@ -59,7 +72,8 @@ module Inttegro
       fix_code: nil,
       cause: nil,
       body: nil,
-      data: nil
+      data: nil,
+      request_id: nil
     )
       super(message)
       @status = status
@@ -71,6 +85,7 @@ module Inttegro
       @cause = cause
       @body = body
       @data = data
+      @request_id = request_id
     end
   end
 
@@ -94,7 +109,8 @@ module Inttegro
         cause: T.nilable(String),
         body: T.nilable(String),
         data: Types::WireValue,
-        retry_after: T.nilable(Integer)
+        retry_after: T.nilable(Integer),
+        request_id: T.nilable(String)
       ).void
     end
     def initialize(
@@ -108,7 +124,8 @@ module Inttegro
       cause: nil,
       body: nil,
       data: nil,
-      retry_after: nil
+      retry_after: nil,
+      request_id: nil
     )
       super(
         message,
@@ -120,7 +137,8 @@ module Inttegro
         fix_code: fix_code,
         cause: cause,
         body: body,
-        data: data
+        data: data,
+        request_id: request_id
       )
       @retry_after = retry_after
     end

data/lib/inttegro/generated/models.rb

@@ -64,8 +64,6 @@ module Inttegro
 
   class PaymentMethod < T::Struct
     const :active, T::Boolean
-    const :app_customer_local_fingerprint, T.nilable(String), default: nil
-    const :app_local_fingerprint, T.nilable(String), default: nil
     const :archived_at, T.nilable(String), default: nil
     const :bank_account, T.nilable(Inttegro::PaymentMethodBankAccount), default: nil
     const :created_at, String
@@ -78,7 +76,6 @@ module Inttegro
     const :owner, T.nilable(Inttegro::PaymentMethodOwner), default: nil
     const :type, Inttegro::PaymentMethodType
     const :supplied, T.nilable(Inttegro::PaymentMethodSupplied), default: nil
-    const :universal_fingerprint, T.nilable(String), default: nil
     const :verification, T.nilable(Inttegro::PaymentMethodVerification), default: nil
     const :verified_at, T.nilable(String), default: nil
   end
@@ -250,12 +247,8 @@ module Inttegro
     const :reserved, Inttegro::CurrencyBalanceSnapshotReserved
   end
 
-  class BalanceSnapshotBalances < T::Struct
-    const :ghs, Inttegro::CurrencyBalanceSnapshot
-  end
-
   class BalanceSnapshot < T::Struct
-    const :balances, Inttegro::BalanceSnapshotBalances
+    const :balances, T::Hash[String, Inttegro::CurrencyBalanceSnapshot]
   end
 
   class BalanceTransactionAmount < T::Struct
@@ -642,7 +635,7 @@ module Inttegro
 
   class InlineProductDetails < T::Struct
     const :about, T.nilable(String), default: nil
-    const :custom_data, T.nilable(T::Hash[String, Object]), default: nil
+    const :custom_data, T.nilable(T::Hash[String, String]), default: nil
     const :name, String
     const :price, Inttegro::PriceParams
     const :quantity, Integer
@@ -663,7 +656,7 @@ module Inttegro
     const :label, T.nilable(String), default: nil
     const :tax_code, T.nilable(String), default: nil
     const :description, T.nilable(String), default: nil
-    const :custom_data, T.nilable(T::Hash[String, Object]), default: nil
+    const :custom_data, T.nilable(T::Hash[String, String]), default: nil
     const :amount, Inttegro::AmountParams
   end
 
@@ -675,7 +668,7 @@ module Inttegro
   class ShippingDetails < T::Struct
     const :id, T.nilable(String), default: nil
     const :tax_code, T.nilable(String), default: nil
-    const :custom_data, T.nilable(T::Hash[String, Object]), default: nil
+    const :custom_data, T.nilable(T::Hash[String, String]), default: nil
     const :fee, Inttegro::AmountParams
   end
 
@@ -1114,10 +1107,6 @@ module Inttegro
     const :status, T.nilable(String), default: nil
   end
 
-  class PaymentNextActionExecute < T::Struct
-    # This object intentionally has no fields.
-  end
-
   class PaymentNextActionRedirectLatestVisit < T::Struct
     const :user_agent, T.nilable(String), default: nil
     const :ip_address, T.nilable(String), default: nil
@@ -1139,7 +1128,7 @@ module Inttegro
   class PaymentNextAction < T::Struct
     const :type, Inttegro::PaymentNextActionType
     const :confirm_payment, T.nilable(Inttegro::PaymentNextActionConfirmPayment), default: nil
-    const :execute, T.nilable(Inttegro::PaymentNextActionExecute), default: nil
+    const :execute, T.nilable(T::Hash[String, Object]), default: nil
     const :redirect, T.nilable(Inttegro::PaymentNextActionRedirect), default: nil
     const :authorize, T.nilable(Inttegro::PaymentNextActionAuthorize), default: nil
   end
@@ -1174,12 +1163,17 @@ module Inttegro
     const :payout_configuration, T.nilable(Inttegro::PaymentPayoutConfiguration), default: nil
   end
 
-  class OrderPayoutSettings < T::Struct
-    # This object intentionally has no fields.
+  class OrderPayoutSettingsRequestDestination < T::Struct
+    const :financial_account_id, String
   end
 
-  class OrderShipping < T::Struct
-    # This object intentionally has no fields.
+  class OrderPayoutSettingsRequest < T::Struct
+    const :destination, T.nilable(Inttegro::OrderPayoutSettingsRequestDestination), default: nil
+    const :enable_fx, T.nilable(T::Boolean), default: nil
+  end
+
+  class Shipping < T::Struct
+    const :address, Inttegro::Address
   end
 
   class Order < T::Struct
@@ -1203,9 +1197,9 @@ module Inttegro
     const :payment, T.nilable(Inttegro::Payment), default: nil
     const :paid_at, T.nilable(String), default: nil
     const :payment_due_at, T.nilable(String), default: nil
-    const :payout_settings, T.nilable(Inttegro::OrderPayoutSettings), default: nil
+    const :payout_settings, T.nilable(Inttegro::OrderPayoutSettingsRequest), default: nil
     const :reference, T.nilable(String), default: nil
-    const :shipping, T.nilable(Inttegro::OrderShipping), default: nil
+    const :shipping, T.nilable(Inttegro::Shipping), default: nil
   end
 
   class CompleteOrderEnvelope < T::Struct
@@ -1251,7 +1245,7 @@ module Inttegro
     const :type, String
   end
 
-  class FinancialAccountPullConfigurationMandate < T::Struct
+  class FinancialAccountMandate < T::Struct
     const :created_at, String
     const :id, String
     const :ip_address, String
@@ -1260,7 +1254,7 @@ module Inttegro
 
   class FinancialAccountPullConfiguration < T::Struct
     const :enabled_at, String
-    const :mandate, Inttegro::FinancialAccountPullConfigurationMandate
+    const :mandate, Inttegro::FinancialAccountMandate
   end
 
   class FinancialAccountPushConfiguration < T::Struct
@@ -1276,8 +1270,16 @@ module Inttegro
     const :supplied_at, String
   end
 
-  class FinancialAccountDetailsVerification < T::Struct
-    # This object intentionally has no fields.
+  class FinancialAccountVerificationRequest < T::Struct
+    const :id, T.nilable(String), default: nil
+    const :mechanism, T.nilable(String), default: nil
+    const :type, T.nilable(String), default: nil
+  end
+
+  class FinancialAccountVerification < T::Struct
+    const :initiated_at, String
+    const :completed_at, T.nilable(String), default: nil
+    const :request, Inttegro::FinancialAccountVerificationRequest
   end
 
   class FinancialAccountAddress < T::Struct
@@ -1310,7 +1312,7 @@ module Inttegro
     const :ghana_bank_account, T.nilable(Inttegro::GhanaBankAccount), default: nil
   end
 
-  class ConnectedFinancialAccountDoshAccount < T::Struct
+  class DoshAccount < T::Struct
     # This object intentionally has no fields.
   end
 
@@ -1326,8 +1328,6 @@ module Inttegro
   end
 
   class ConnectedFinancialAccount < T::Struct
-    const :app_customer_local_fingerprint, T.nilable(String), default: nil
-    const :app_local_fingerprint, T.nilable(String), default: nil
     const :archived_at, T.nilable(String), default: nil
     const :created_at, String
     const :currency, String
@@ -1341,10 +1341,9 @@ module Inttegro
     const :reference, T.nilable(String), default: nil
     const :supplied, T.nilable(Inttegro::ResourceSupply), default: nil
     const :type, Inttegro::FinancialAccountType
-    const :universal_fingerprint, T.nilable(String), default: nil
-    const :verification, T.nilable(Inttegro::FinancialAccountDetailsVerification), default: nil
+    const :verification, T.nilable(Inttegro::FinancialAccountVerification), default: nil
     const :bank_account, T.nilable(Inttegro::FinancialAccountBank), default: nil
-    const :dosh_account, T.nilable(Inttegro::ConnectedFinancialAccountDoshAccount), default: nil
+    const :dosh_account, T.nilable(Inttegro::DoshAccount), default: nil
     const :owner, T.nilable(Inttegro::FinancialAccountOwner), default: nil
     const :wallet, T.nilable(Inttegro::FinancialAccountWallet), default: nil
   end
@@ -1538,8 +1537,6 @@ module Inttegro
   end
 
   class CreatedFinancialAccount < T::Struct
-    const :app_customer_local_fingerprint, T.nilable(String), default: nil
-    const :app_local_fingerprint, T.nilable(String), default: nil
     const :archived_at, T.nilable(String), default: nil
     const :created_at, String
     const :currency, String
@@ -1553,8 +1550,7 @@ module Inttegro
     const :reference, T.nilable(String), default: nil
     const :supplied, T.nilable(Inttegro::ResourceSupply), default: nil
     const :type, Inttegro::FinancialAccountType
-    const :universal_fingerprint, T.nilable(String), default: nil
-    const :verification, T.nilable(Inttegro::FinancialAccountDetailsVerification), default: nil
+    const :verification, T.nilable(Inttegro::FinancialAccountVerification), default: nil
     const :bank_account, T.nilable(Inttegro::CreatedFinancialAccountBank), default: nil
     const :owner, T.nilable(Inttegro::CreatedFinancialAccountOwner), default: nil
     const :wallet, T.nilable(Inttegro::FinancialAccountWallet), default: nil
@@ -1599,19 +1595,6 @@ module Inttegro
     const :cancel_url, T.nilable(String), default: nil
   end
 
-  class OrderPayoutSettingsRequestDestination < T::Struct
-    const :financial_account_id, String
-  end
-
-  class OrderPayoutSettingsRequest < T::Struct
-    const :destination, T.nilable(Inttegro::OrderPayoutSettingsRequestDestination), default: nil
-    const :enable_fx, T.nilable(T::Boolean), default: nil
-  end
-
-  class Shipping < T::Struct
-    const :address, Inttegro::Address
-  end
-
   class CreateOrderExistingCustomer < T::Struct
     const :customer_id, String
     const :payment_method_id, T.nilable(String), default: nil
@@ -2176,13 +2159,7 @@ module Inttegro
     const :order_id, String
   end
 
-  class FinancialAccountDoshAccount < T::Struct
-    # This object intentionally has no fields.
-  end
-
   class FinancialAccount < T::Struct
-    const :app_customer_local_fingerprint, T.nilable(String), default: nil
-    const :app_local_fingerprint, T.nilable(String), default: nil
     const :archived_at, T.nilable(String), default: nil
     const :created_at, String
     const :currency, String
@@ -2196,11 +2173,10 @@ module Inttegro
     const :reference, T.nilable(String), default: nil
     const :supplied, T.nilable(Inttegro::ResourceSupply), default: nil
     const :type, Inttegro::FinancialAccountType
-    const :universal_fingerprint, T.nilable(String), default: nil
-    const :verification, T.nilable(Inttegro::FinancialAccountDetailsVerification), default: nil
+    const :verification, T.nilable(Inttegro::FinancialAccountVerification), default: nil
     const :bank_account, T.nilable(Inttegro::FinancialAccountBank), default: nil
     const :disconnected_at, T.nilable(String), default: nil
-    const :dosh_account, T.nilable(Inttegro::FinancialAccountDoshAccount), default: nil
+    const :dosh_account, T.nilable(Inttegro::DoshAccount), default: nil
     const :owner, T.nilable(Inttegro::FinancialAccountOwner), default: nil
     const :wallet, T.nilable(Inttegro::FinancialAccountWallet), default: nil
   end
@@ -2277,10 +2253,6 @@ module Inttegro
     const :wallet, Inttegro::FinancialAccountWalletRequestWallet
   end
 
-  class FinancialAccountDoshRequestDoshAccount < T::Struct
-    # This object intentionally has no fields.
-  end
-
   class FinancialAccountDoshRequest < T::Struct
     const :currency, String
     const :custom_data, T.nilable(T::Hash[String, Object]), default: nil
@@ -2291,14 +2263,12 @@ module Inttegro
     const :push_configuration, T.nilable(Inttegro::FinancialAccountRequestBasePushConfiguration), default: nil
     const :reference, String
     const :type, Inttegro::FinancialAccountDoshRequestType
-    const :dosh_account, Inttegro::FinancialAccountDoshRequestDoshAccount
+    const :dosh_account, Inttegro::DoshAccount
   end
 
   FinancialAccountCreateRequest = T.type_alias { T.any(Inttegro::FinancialAccountWalletRequest, Inttegro::FinancialAccountBankRequest, Inttegro::FinancialAccountDoshRequest) }
 
   class FinancialAccountDetails < T::Struct
-    const :app_customer_local_fingerprint, T.nilable(String), default: nil
-    const :app_local_fingerprint, T.nilable(String), default: nil
     const :archived_at, T.nilable(String), default: nil
     const :created_at, String
     const :currency, String
@@ -2312,8 +2282,7 @@ module Inttegro
     const :reference, T.nilable(String), default: nil
     const :supplied, T.nilable(Inttegro::ResourceSupply), default: nil
     const :type, Inttegro::FinancialAccountType
-    const :universal_fingerprint, T.nilable(String), default: nil
-    const :verification, T.nilable(Inttegro::FinancialAccountDetailsVerification), default: nil
+    const :verification, T.nilable(Inttegro::FinancialAccountVerification), default: nil
   end
 
   class FinancialAccountDisableRequest < T::Struct
@@ -2893,33 +2862,13 @@ module Inttegro
     const :nominal, Inttegro::Amount
   end
 
-  class ProductShipmentDelivery < T::Struct
-    # This object intentionally has no fields.
-  end
-
-  class ProductShipmentDownload < T::Struct
-    # This object intentionally has no fields.
-  end
-
-  class ProductShipmentRender < T::Struct
-    # This object intentionally has no fields.
-  end
-
-  class ProductShipmentService < T::Struct
-    # This object intentionally has no fields.
-  end
-
-  class ProductShipmentStream < T::Struct
-    # This object intentionally has no fields.
-  end
-
   class ProductShipment < T::Struct
     const :type, Inttegro::ProductShipmentType
-    const :delivery, T.nilable(Inttegro::ProductShipmentDelivery), default: nil
-    const :download, T.nilable(Inttegro::ProductShipmentDownload), default: nil
-    const :render, T.nilable(Inttegro::ProductShipmentRender), default: nil
-    const :service, T.nilable(Inttegro::ProductShipmentService), default: nil
-    const :stream, T.nilable(Inttegro::ProductShipmentStream), default: nil
+    const :delivery, T.nilable(T::Hash[String, Object]), default: nil
+    const :download, T.nilable(T::Hash[String, Object]), default: nil
+    const :render, T.nilable(T::Hash[String, Object]), default: nil
+    const :service, T.nilable(T::Hash[String, Object]), default: nil
+    const :stream, T.nilable(T::Hash[String, Object]), default: nil
   end
 
   class Product < T::Struct
@@ -3008,7 +2957,6 @@ module Inttegro
   end
 
   class PurchaseIntentMerchant < T::Struct
-    const :app_id, T.nilable(String), default: nil
     const :app_name, T.nilable(String), default: nil
     const :organization_id, T.nilable(String), default: nil
     const :organization_name, T.nilable(String), default: nil
@@ -3098,7 +3046,6 @@ module Inttegro
   class PurchaseIntent < T::Struct
     const :activity, T.nilable(Inttegro::PurchaseIntentActivityInline), default: nil
     const :allow_variants, T::Boolean
-    const :application_id, String
     const :created_at, String
     const :expires_at, T.nilable(String), default: nil
     const :id, String
@@ -3533,10 +3480,6 @@ module Inttegro
     const :ghana_bank_account, T.nilable(Inttegro::UpdatedGhanaBankAccount), default: nil
   end
 
-  class UpdatedFinancialAccountDoshAccount < T::Struct
-    # This object intentionally has no fields.
-  end
-
   class UpdatedFinancialAccountAddress < T::Struct
     const :city, String
     const :country, String
@@ -3561,8 +3504,6 @@ module Inttegro
   end
 
   class UpdatedFinancialAccount < T::Struct
-    const :app_customer_local_fingerprint, T.nilable(String), default: nil
-    const :app_local_fingerprint, T.nilable(String), default: nil
     const :archived_at, T.nilable(String), default: nil
     const :created_at, String
     const :currency, String
@@ -3576,11 +3517,10 @@ module Inttegro
     const :reference, T.nilable(String), default: nil
     const :supplied, T.nilable(Inttegro::ResourceSupply), default: nil
     const :type, Inttegro::FinancialAccountType
-    const :universal_fingerprint, T.nilable(String), default: nil
-    const :verification, T.nilable(Inttegro::FinancialAccountDetailsVerification), default: nil
+    const :verification, T.nilable(Inttegro::FinancialAccountVerification), default: nil
     const :bank_account, T.nilable(Inttegro::UpdatedFinancialAccountBank), default: nil
     const :disconnected_at, T.nilable(String), default: nil
-    const :dosh_account, T.nilable(Inttegro::UpdatedFinancialAccountDoshAccount), default: nil
+    const :dosh_account, T.nilable(Inttegro::DoshAccount), default: nil
     const :owner, T.nilable(Inttegro::UpdatedFinancialAccountOwner), default: nil
     const :wallet, T.nilable(Inttegro::UpdatedFinancialAccountWallet), default: nil
   end
@@ -3640,7 +3580,7 @@ module Inttegro
 
   class UpdatePaymentMethodRequest < T::Struct
     const :payment_method_id, String
-    const :custom_data, T.nilable(T::Hash[String, T.nilable(String)]), default: nil
+    const :custom_data, T.nilable(T::Hash[String, Object]), default: nil
     const :active, T.nilable(T::Boolean), default: nil
     const :archived, T.nilable(T::Boolean), default: nil
     const :owner, T.nilable(Inttegro::UpdatePaymentMethodRequestOwner), default: nil

data/lib/inttegro/http_client.rb

@@ -37,7 +37,9 @@ module Inttegro
         open_timeout: T.nilable(Numeric),
         adapter: T.nilable(Types::Adapter),
         telemetry_enabled: T::Boolean,
-        tracer_provider: T.nilable(OpenTelemetry::Trace::TracerProvider)
+        tracer_provider: T.nilable(OpenTelemetry::Trace::TracerProvider),
+        error_reporter: T.nilable(ErrorReporter),
+        error_reporting_policy: Symbol
       ).void
     end
     def initialize(
@@ -47,7 +49,9 @@ module Inttegro
       open_timeout: 10,
       adapter: nil,
       telemetry_enabled: true,
-      tracer_provider: nil
+      tracer_provider: nil,
+      error_reporter: nil,
+      error_reporting_policy: :unexpected
     )
       @api_key = T.let(api_key || "", String)
       raise ArgumentError, "api_key is required" if @api_key.strip.empty?
@@ -60,7 +64,13 @@ module Inttegro
       @open_timeout = T.let(open_timeout, T.nilable(Numeric))
       @adapter = T.let(adapter, T.nilable(Types::Adapter))
       @telemetry = T.let(
-        Telemetry.new(Inttegro::VERSION, enabled: telemetry_enabled, tracer_provider: tracer_provider),
+        Telemetry.new(
+          Inttegro::VERSION,
+          enabled: telemetry_enabled,
+          tracer_provider: tracer_provider,
+          error_reporter: error_reporter,
+          error_reporting_policy: error_reporting_policy
+        ),
         Telemetry
       )
     end
@@ -504,6 +514,7 @@ module Inttegro
       detail = payload[:detail]
       fix_code = payload[:fix_code]
       cause = payload[:cause]
+      request_id = response["x-request-id"] || response["X-Request-Id"]
 
       case status
       when 401
@@ -517,7 +528,8 @@ module Inttegro
           fix_code: fix_code,
           cause: cause,
           body: body,
-          data: data
+          data: data,
+          request_id: request_id
         )
       when 429
         retry_after = response["Retry-After"]&.to_i
@@ -532,7 +544,8 @@ module Inttegro
           cause: cause,
           body: body,
           data: data,
-          retry_after: retry_after
+          retry_after: retry_after,
+          request_id: request_id
         )
       else
         raise APIError.new(
@@ -545,7 +558,8 @@ module Inttegro
           fix_code: fix_code,
           cause: cause,
           body: body,
-          data: data
+          data: data,
+          request_id: request_id
         )
       end
     end

data/lib/inttegro/telemetry.rb

@@ -3,9 +3,12 @@
 
 require "opentelemetry-api"
 require "sorbet-runtime"
+require "securerandom"
+require "time"
 require "uri"
 
 require_relative "errors"
+require_relative "error_reporting"
 
 module Inttegro
   # Emits redacted SDK spans to the application's OpenTelemetry provider.
@@ -30,11 +33,17 @@ module Inttegro
       params(
         version: String,
         enabled: T::Boolean,
-        tracer_provider: T.nilable(OpenTelemetry::Trace::TracerProvider)
+        tracer_provider: T.nilable(OpenTelemetry::Trace::TracerProvider),
+        error_reporter: T.nilable(ErrorReporter),
+        error_reporting_policy: Symbol
       ).void
     end
-    def initialize(version, enabled: true, tracer_provider: nil)
+    def initialize(version, enabled: true, tracer_provider: nil, error_reporter: nil, error_reporting_policy: :unexpected)
       @enabled = T.let(enabled, T::Boolean)
+      raise ArgumentError, "error_reporting_policy must be :unexpected or :all" unless %i[unexpected all].include?(error_reporting_policy)
+
+      @error_reporter = T.let(error_reporter, T.nilable(ErrorReporter))
+      @error_reporting_policy = T.let(error_reporting_policy, Symbol)
       provider = tracer_provider || OpenTelemetry.tracer_provider
       @tracer = T.let(provider.tracer("inttegro", version), OpenTelemetry::Trace::Tracer)
     end
@@ -52,9 +61,18 @@ module Inttegro
         .returns(T.type_parameter(:Result))
     end
     def in_span(path_or_url, method, base_url, version, operation_override = nil, &block)
-      return yield(nil) unless @enabled
+      return yield(nil) unless @enabled || @error_reporter
 
       operation, route, server_address = request_details(path_or_url, base_url, operation_override)
+      started_at = T.let(@error_reporter ? monotonic_milliseconds : nil, T.nilable(Float))
+      unless @enabled
+        begin
+          return yield(nil)
+        rescue StandardError => e
+          report_failure(e, operation, route, server_address, method, version, started_at, nil)
+          raise
+        end
+      end
       attributes = {
         "inttegro.operation.name" => operation,
         "inttegro.sdk.language" => "ruby",
@@ -72,6 +90,7 @@ module Inttegro
         span.set_attribute("error.type", error_type)
         span.status = OpenTelemetry::Trace::Status.error
         span.add_event("inttegro.request.failed", attributes: { "error.type" => error_type })
+        report_failure(e, operation, route, server_address, method, version, started_at, span)
         raise
       ensure
         span.finish
@@ -125,6 +144,71 @@ module Inttegro
 
     private
 
+    sig do
+      params(
+        error: StandardError,
+        operation: String,
+        route: T.nilable(String),
+        server_address: String,
+        method: T.any(String, Symbol),
+        version: String,
+        started_at: T.nilable(Float),
+        span: T.nilable(OpenTelemetry::Trace::Span)
+      ).void
+    end
+    def report_failure(error, operation, route, server_address, method, version, started_at, span)
+      reporter = @error_reporter
+      return unless reporter
+
+      begin
+        category = classify_error(error)
+        return if category == "canceled"
+        if @error_reporting_policy == :unexpected && error.is_a?(APIError)
+          return unless error.status >= 500 || error.type == "unknown_error"
+        end
+
+        api_error = T.let(error.is_a?(APIError) ? error : nil, T.nilable(APIError))
+        api_context = if api_error && (api_error.type || api_error.code || api_error.fix_code)
+          APIErrorReportContext.new(type: api_error.type, code: api_error.code, fix_code: api_error.fix_code)
+        end
+        span_context = span&.context
+        trace_context = if span_context&.valid?
+          TraceReportContext.new(trace_id: span_context.hex_trace_id, span_id: span_context.hex_span_id)
+        end
+        status_code = api_error&.status
+        report = ErrorReport.new(
+          schema_version: 1,
+          event_id: SecureRandom.uuid,
+          occurred_at: Time.now.utc.iso8601(6),
+          severity: "error",
+          category: category,
+          operation: operation,
+          sdk: SDKReportContext.new(language: "ruby", version: version),
+          http: HTTPReportContext.new(
+            request_method: method.to_s.upcase,
+            route: route,
+            server_address: server_address,
+            status_code: status_code,
+            request_id: api_error&.request_id,
+            duration_ms: [(monotonic_milliseconds - (started_at || monotonic_milliseconds)).round, 0].max
+          ),
+          api_error: api_context,
+          trace: trace_context,
+          exception_type: (error.class.name || "StandardError").split("::").last || "StandardError",
+          fingerprint: ["inttegro", "ruby", operation, category, status_code || "none"].join(":")
+        )
+        error.report = report if error.is_a?(Error)
+        reporter.call(report)
+      rescue StandardError
+        # Report preparation and delivery must never replace the original failure.
+      end
+    end
+
+    sig { returns(Float) }
+    def monotonic_milliseconds
+      Process.clock_gettime(Process::CLOCK_MONOTONIC, :millisecond).to_f
+    end
+
     sig do
       params(path_or_url: String, base_url: String, override: T.nilable(String))
         .returns([String, T.nilable(String), String])

data/lib/inttegro/version.rb

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

data/lib/inttegro.rb

@@ -6,6 +6,7 @@ require "sorbet-runtime"
 require_relative "inttegro/types"
 require_relative "inttegro/client"
 require_relative "inttegro/errors"
+require_relative "inttegro/error_reporting"
 require_relative "inttegro/enums"
 require_relative "inttegro/models"
 require_relative "inttegro/version"

data/rbi/opentelemetry-api.rbi

@@ -56,6 +56,9 @@ module OpenTelemetry
     end
 
     class Span
+      sig { returns(SpanContext) }
+      def context; end
+
       sig { params(key: String, value: Object).returns(Span) }
       def set_attribute(key, value); end
 
@@ -69,6 +72,17 @@ module OpenTelemetry
       def finish; end
     end
 
+    class SpanContext
+      sig { returns(T::Boolean) }
+      def valid?; end
+
+      sig { returns(String) }
+      def hex_trace_id; end
+
+      sig { returns(String) }
+      def hex_span_id; end
+    end
+
     class Status
       sig { params(description: String).returns(Status) }
       def self.error(description = ""); end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: inttegro
 version: !ruby/object:Gem::Version
-  version: 4.2.2
+  version: 4.3.1
 platform: ruby
 authors:
 - Inttegro Engineering
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-09-04 00:00:00.000000000 Z
+date: 2026-09-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: sorbet-runtime
@@ -82,6 +82,7 @@ files:
 - lib/inttegro.rb
 - lib/inttegro/client.rb
 - lib/inttegro/enums.rb
+- lib/inttegro/error_reporting.rb
 - lib/inttegro/errors.rb
 - lib/inttegro/file_download.rb
 - lib/inttegro/generated/enums.rb
@@ -125,6 +126,7 @@ licenses:
 metadata:
   homepage_uri: https://studio.inttegro.com
   source_code_uri: https://github.com/zebodotdev/inttegro-sdk-ruby
+  documentation_uri: https://ruby.inttegro.dev/
   changelog_uri: https://github.com/zebodotdev/inttegro-sdk-ruby/blob/master/CHANGELOG.md
   github_repo: ssh://github.com/zebodotdev/inttegro-sdk-ruby
   rubygems_mfa_required: 'true'