inttegro 6.0.1 → 7.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9cc1c22273d07aeda36d0c2dde8ec243922c143f6f3e6d74284b493dc092bac5
-  data.tar.gz: 44cf6154faff621ab17d2bb9aff2122db8da10d21430d897eea7cbadf1308c8b
+  metadata.gz: adda77d38b9a0e554414ebbe39ef888ea094306730292b77fd58de017e9dd97c
+  data.tar.gz: 05c8dbae6c8bc9f07fa806b185996a2a8139e08751b59addc64b72813f517b73
 SHA512:
-  metadata.gz: 7cb63e59ae8879e1fc39dc12438ba115e80d7a4cb601f8f611e9daf3a705ba1a08603fcf97ab9c5480ab41c8d9dfde18ff29dd5b1a784a1b708d543b28226d6f
-  data.tar.gz: 2e1a12662acc7239796854ba5b94fce2b50b4176c3373ea5939fbea680cdbd7dbc133fc151321d3b8fa7857a4db3ea343d5f49688aeeb79c046556720014450e
+  metadata.gz: 188d58e4c3cc3731853cb216027e8e7b686e9dd155d258fee4979acbdd56dbf4d0624cfd001a57e1beb6f6e7a53f032f23404b6f52ac3e0eab3f4cd53dcbd33e
+  data.tar.gz: 4bf3019fb67255a0cfe434abf98c8d66ec007c1c634b72965788186f0184c1b9199fb81bddac8719fab7fb171d80fc31733afa71c6eaa12c732880e641c7d2dd

data/CHANGELOG.md

@@ -1,5 +1,20 @@
 ## [Unreleased]
 
+## [7.0.0] - 2026-09-14
+
+- Breaking: replaced payout hashes and generic payloads with named request,
+  response, settings, page, error, and destination objects.
+- Made `ghs` the explicit supported payout-destination accessor and exposed
+  payout timestamps as `Time` values.
+- Removed server-internal purchase-intent activity response models and exposed
+  refund order and cancellation context.
+
+## [6.1.0] - 2026-09-12
+
+- Added opt-in response envelopes that expose status, headers, request IDs,
+  retry hints, and response metadata without changing existing resource return
+  values.
+
 ## [6.0.1] - 2026-09-11
 
 - Corrected the resource-namespace examples to show Ruby's class-backed layout accurately.

data/README.md

@@ -1,6 +1,6 @@
 # Inttegro Ruby SDK
 
-[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/zebodotdev/inttegro-sdk-ruby/badge)](https://scorecard.dev/viewer/?uri=github.com/zebodotdev/inttegro-sdk-ruby)
+[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/inttegro/inttegro-sdk-ruby/badge)](https://scorecard.dev/viewer/?uri=github.com/inttegro/inttegro-sdk-ruby)
 
 The official Ruby client for building server-side Inttegro integrations.
 
@@ -163,7 +163,7 @@ The GitHub release for each version is the canonical record. It contains the exa
 ```bash
 sha256sum --check SHA256SUMS
 gh attestation verify inttegro-4.2.2.gem \
-  --repo zebodotdev/inttegro-sdk-ruby
+  --repo inttegro/inttegro-sdk-ruby
 ```
 
 ## Develop

data/SECURITY.md

@@ -6,6 +6,6 @@ Security fixes are released for the latest published version of the SDK. Users s
 
 ## Reporting a vulnerability
 
-Do not open a public issue for a suspected vulnerability. Use [GitHub's private vulnerability reporting](https://github.com/zebodotdev/inttegro-sdk-ruby/security/advisories/new) and include the affected version, impact, reproduction steps, and any suggested remediation.
+Do not open a public issue for a suspected vulnerability. Use [GitHub's private vulnerability reporting](https://github.com/inttegro/inttegro-sdk-ruby/security/advisories/new) and include the affected version, impact, reproduction steps, and any suggested remediation.
 
 We will acknowledge the report, investigate it privately, and coordinate disclosure after a fix is available.

data/lib/inttegro/api_response.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+# typed: strict
+
+require "sorbet-runtime"
+
+require_relative "types"
+
+module Inttegro
+  # Decoded SDK value plus response-only HTTP metadata.
+  class APIResponse < T::Struct
+    extend T::Sig
+
+    const :data, Object
+    const :status, Integer
+    const :headers, Types::ResponseHeaders
+    const :meta, T.nilable(Types::Payload), default: nil
+
+    sig { returns(T.nilable(String)) }
+    def request_id
+      header("x-request-id")
+    end
+
+    sig { returns(T.nilable(String)) }
+    def retry_after
+      header("retry-after")
+    end
+
+    sig { params(data: Object).returns(APIResponse) }
+    def with_data(data)
+      APIResponse.new(data: data, status: status, headers: headers, meta: meta)
+    end
+
+    private
+
+    sig { params(name: String).returns(T.nilable(String)) }
+    def header(name)
+      pair = headers.find { |key, _values| key.casecmp?(name) }
+      pair&.last&.first
+    end
+  end
+end

data/lib/inttegro/generated/enums.rb

@@ -66,7 +66,6 @@ require_relative "../product/line_item_type"
 require_relative "../product/shipment_input_type"
 require_relative "../product/shipment_type"
 require_relative "../product/type"
-require_relative "../purchase_intent/activity_type"
 require_relative "../purchase_intent/status"
 require_relative "../refund/reason"
 require_relative "../refund/status"

data/lib/inttegro/generated/models.rb

@@ -81,9 +81,6 @@ require_relative "../broadcast/response"
 require_relative "../broadcast/cancel_request"
 require_relative "../order/cancel_request"
 require_relative "../payout/cancel_request"
-require_relative "../payout/error"
-require_relative "../payout/payout"
-require_relative "../payout/cancel_response"
 require_relative "../purchase_intent/cancel_request"
 require_relative "../refund/request_meta"
 require_relative "../refund/cancel_request"
@@ -275,6 +272,7 @@ require_relative "../secret_key/destroy_request"
 require_relative "../secret_key/secret_key"
 require_relative "../secret_key/destroy_response"
 require_relative "../payout/disable_automatic_request"
+require_relative "../payout/destinations"
 require_relative "../payout/settings_mutation_schedule_spec"
 require_relative "../payout/settings_mutation_schedule"
 require_relative "../payout/settings_mutation"
@@ -285,7 +283,6 @@ require_relative "../payment_method/disactivate_request"
 require_relative "../payment_method/disactivate_response"
 require_relative "../financial_account/disconnect_response"
 require_relative "../payout/enable_automatic_request"
-require_relative "../payout/enable_automatic_response"
 require_relative "../financial_account/enable_pull_response"
 require_relative "../financial_account/enable_push_response"
 require_relative "../shared/error_envelope"
@@ -350,10 +347,6 @@ require_relative "../payment_method/type_setting"
 require_relative "../payment_method/settings"
 require_relative "../payment_method/get_settings_response"
 require_relative "../payout/get_settings_request"
-require_relative "../payout/settings_lookup_schedule_aging_spec"
-require_relative "../payout/settings_lookup_schedule"
-require_relative "../payout/settings_lookup"
-require_relative "../payout/get_settings_response"
 require_relative "../otp/initiate_request"
 require_relative "../otp/transmission"
 require_relative "../otp/transaction"
@@ -376,7 +369,6 @@ require_relative "../order/lookup_request"
 require_relative "../payment_method/lookup_request"
 require_relative "../payment_method/lookup_response"
 require_relative "../payout/lookup_request"
-require_relative "../payout/lookup_response"
 require_relative "../price/lookup_request"
 require_relative "../product/lookup_request"
 require_relative "../purchase_intent/lookup_request"
@@ -424,18 +416,12 @@ require_relative "../message_template/page_request"
 require_relative "../order/page_envelope"
 require_relative "../order/page_request"
 require_relative "../payout/page_request"
-require_relative "../payout/page"
-require_relative "../payout/page_response"
 require_relative "../product/page_request"
 require_relative "../product/price_summary"
 require_relative "../product/product"
 require_relative "../product/page"
 require_relative "../product/page_response"
 require_relative "../purchase_intent/page_request"
-require_relative "../purchase_intent/activity_attribution"
-require_relative "../purchase_intent/activity_visitor"
-require_relative "../purchase_intent/activity"
-require_relative "../purchase_intent/activity_log"
 require_relative "../purchase_intent/merchant"
 require_relative "../purchase_intent/original_price"
 require_relative "../purchase_intent/price"
@@ -462,6 +448,16 @@ 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/error"
+require_relative "../payout/payout"
+require_relative "../payout/page"
+require_relative "../payout/page_response"
+require_relative "../payout/response"
+require_relative "../payout/settings_lookup_schedule_aging_spec"
+require_relative "../payout/settings_lookup_schedule"
+require_relative "../payout/settings_lookup"
+require_relative "../payout/settings_lookup_response"
+require_relative "../payout/settings_mutation_response"
 require_relative "../price/action_request"
 require_relative "../price/page_item"
 require_relative "../price/page"
@@ -477,6 +473,7 @@ require_relative "../refund/page_response"
 require_relative "../refund/response"
 require_relative "../message_template/render_preview_request"
 require_relative "../shared/request_confirmation_request"
+require_relative "../shared/response_meta"
 require_relative "../upload_request/review_reason_input"
 require_relative "../upload_request/review_attempt_by_id_request"
 require_relative "../upload_request/review_attempt_by_ordinal_request"
@@ -491,7 +488,6 @@ require_relative "../schedule/creation_detail"
 require_relative "../schedule/detail"
 require_relative "../schedule/lookup_response"
 require_relative "../schedule/payout_request"
-require_relative "../schedule/payout_response"
 require_relative "../schedule/response"
 require_relative "../secret_key/usage_row"
 require_relative "../secret_key/usage_page"
@@ -500,7 +496,6 @@ require_relative "../secret_key/usage_request"
 require_relative "../chime/send_request_request_meta"
 require_relative "../chime/send_request"
 require_relative "../payout/set_destinations_request"
-require_relative "../payout/set_destinations_response"
 require_relative "../payment_method/tokenize_mobile_money_request_mobile_money"
 require_relative "../payment_method/tokenize_mobile_money_request"
 require_relative "../payment_method/tokenize_response"

data/lib/inttegro/generated/operations.rb

@@ -74,14 +74,14 @@ module Inttegro
       "/balances" => Inttegro::Balance::SnapshotResponse,
       "/balance_transactions/lookup" => Inttegro::BalanceTransaction::Response,
       "/balance_transactions/page" => Inttegro::BalanceTransaction::PageResponse,
-      "/payouts/schedule" => Inttegro::Schedule::PayoutResponse,
-      "/payouts/lookup" => Inttegro::Payout::LookupResponse,
-      "/payouts/set_destinations" => Inttegro::Payout::SetDestinationsResponse,
-      "/payouts/settings" => Inttegro::Payout::GetSettingsResponse,
+      "/payouts/schedule" => Inttegro::Payout::Response,
+      "/payouts/lookup" => Inttegro::Payout::Response,
+      "/payouts/set_destinations" => Inttegro::Payout::SettingsMutationResponse,
+      "/payouts/settings" => Inttegro::Payout::SettingsLookupResponse,
       "/payouts/disable" => Inttegro::Payout::DisableAutomaticResponse,
-      "/payouts/enable" => Inttegro::Payout::EnableAutomaticResponse,
+      "/payouts/enable" => Inttegro::Payout::SettingsMutationResponse,
       "/payouts/page" => Inttegro::Payout::PageResponse,
-      "/payouts/cancel" => Inttegro::Payout::CancelResponse,
+      "/payouts/cancel" => Inttegro::Payout::Response,
       "/files/create" => Inttegro::File::Response,
       "/files/lookup" => Inttegro::File::Response,
       "/files/page" => Inttegro::File::PageResponse,

data/lib/inttegro/http_client.rb

@@ -8,6 +8,7 @@ require "time"
 require "uri"
 
 require_relative "errors"
+require_relative "api_response"
 require_relative "file_download"
 require_relative "models"
 require_relative "generated/operations"
@@ -148,6 +149,31 @@ module Inttegro
       raise TypeError, "expected #{model} in #{field} from #{path}, got #{decoded.class}"
     end
 
+    sig do
+      type_parameters(:Model)
+        .params(
+          path: String,
+          model: T::Class[T.type_parameter(:Model)],
+          field: Symbol,
+          body: Types::RequestBody,
+          headers: Types::Headers,
+          query: T.nilable(Types::Query)
+        )
+        .returns(APIResponse)
+    end
+    def post_resource_with_response(path, model, field, body, headers: {}, query: nil)
+      response = request_with_response(:post, path, body: body, headers: headers, query: query)
+      envelope = expect_response_object(T.cast(response.data, ResponseValue), path)
+      value = envelope.public_send(field)
+      value = value.to_h if value.is_a?(ResponseObject)
+      return response.with_data(T.cast(value, Object)) if value.is_a?(model)
+
+      decoded = Inttegro.deserialize(value, T.cast(model, T::Class[T::Struct]))
+      return response.with_data(decoded) if decoded.is_a?(model)
+
+      raise TypeError, "expected #{model} in #{field} from #{path}, got #{decoded.class}"
+    end
+
     sig do
       params(
         path: String,
@@ -328,6 +354,30 @@ module Inttegro
       ).returns(ResponseValue)
     end
     def request(method, path, body: nil, headers: {}, query: nil, response_model: nil)
+      T.cast(
+        request_with_response(
+          method,
+          path,
+          body: body,
+          headers: headers,
+          query: query,
+          response_model: response_model
+        ).data,
+        ResponseValue
+      )
+    end
+
+    sig do
+      params(
+        method: T.any(String, Symbol),
+        path: String,
+        body: T.nilable(Types::RequestBody),
+        headers: Types::Headers,
+        query: T.nilable(Types::Query),
+        response_model: T.nilable(T::Class[T::Struct])
+      ).returns(APIResponse)
+    end
+    def request_with_response(method, path, body: nil, headers: {}, query: nil, response_model: nil)
       @telemetry.in_span(path, method, @base_url, Inttegro::VERSION) do |span|
         uri = build_uri(path, query)
         body = validate_body(path, coerce_body(body))
@@ -346,7 +396,12 @@ module Inttegro
         @telemetry.response(span, response, decoded: false)
         result = handle_response(path, response, response_model)
         @telemetry.decoded(span)
-        result
+        APIResponse.new(
+          data: result,
+          status: response.code.to_i,
+          headers: response.headers,
+          meta: response_meta(response.body)
+        )
       end
     rescue Timeout::Error, Errno::ETIMEDOUT => e
       raise TimeoutError.new("Request timed out", e)
@@ -574,6 +629,15 @@ module Inttegro
       body
     end
 
+    sig { params(body: String).returns(T.nilable(Types::Payload)) }
+    def response_meta(body)
+      data = parse_json(body)
+      return nil unless data.is_a?(Hash)
+
+      meta = data["response_meta"] || data[:response_meta]
+      meta.is_a?(Hash) ? normalize_payload(meta) : nil
+    end
+
     sig { params(data: Object, response: TransportResponse).returns(String) }
     def extract_error_message(data, response)
       return "HTTP #{response.code} #{response.message}" unless data.is_a?(Hash)

data/lib/inttegro/payout/cancel_request.rb

@@ -7,7 +7,7 @@ require_relative "base"
 
 module Inttegro
   class Payout
-    # Typed representation of the cancel request object in the Inttegro API.
+    # Parameters for canceling a scheduled 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
@@ -16,7 +16,7 @@ module Inttegro
     # @api public
     #
     # @!attribute [r] payout_id
-    #   Scheduled payout ID
+    #   Scheduled payout identifier.
     #
     #   Required in the API payload. Wire name: `payout_id`.
     #   @return [String]

data/lib/inttegro/payout/{lookup_response.rb → destinations.rb}

@@ -4,11 +4,10 @@
 # Generated from openapi/commerce.yml by bin/generate-openapi-types. Do not edit.
 
 require_relative "base"
-require_relative "payout"
 
 module Inttegro
   class Payout
-    # Typed representation of the lookup response object in the Inttegro API.
+    # Supported currency-to-financial-account destination assignments.
     #
     # 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
@@ -16,13 +15,14 @@ module Inttegro
     #
     # @api public
     #
-    # @!attribute [r] payout
-    #   A payout scheduled from your Inttegro balance to a destination financial account
+    # @!attribute [r] ghs
+    #   Financial account that receives Ghana cedi payouts. Send an empty string to remove the
+    #   assignment.
     #
-    #   Optional in the API payload; omitted values default to `nil`. Wire name: `payout`.
-    #   @return [Inttegro::Payout, nil]
-    class LookupResponse < T::Struct
-      const :payout, T.nilable(Inttegro::Payout), default: nil
+    #   Optional in the API payload; omitted values default to `nil`. Wire name: `ghs`.
+    #   @return [String, nil]
+    class Destinations < T::Struct
+      const :ghs, T.nilable(String), default: nil
     end
   end
 end

data/lib/inttegro/payout/disable_automatic_response.rb

@@ -8,7 +8,7 @@ require_relative "settings_mutation"
 
 module Inttegro
   class Payout
-    # Typed representation of the disable automatic response object in the Inttegro API.
+    # Response envelope containing updated payout settings.
     #
     # 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/payout/error.rb

@@ -7,7 +7,7 @@ require_relative "base"
 
 module Inttegro
   class Payout
-    # Public failure details when execution fails
+    # Public failure details returned when payout execution fails.
     #
     # 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
@@ -16,25 +16,25 @@ module Inttegro
     # @api public
     #
     # @!attribute [r] cause
-    #   Value of the `cause` field in the Inttegro API payload.
+    #   Public explanation of the underlying failure cause.
     #
     #   Required in the API payload. Wire name: `cause`.
     #   @return [String]
     #
     # @!attribute [r] message
-    #   Value of the `message` field in the Inttegro API payload.
+    #   Human-readable failure message.
     #
     #   Required in the API payload. Wire name: `message`.
     #   @return [String]
     #
     # @!attribute [r] occurred_at
-    #   Value of the `occurred_at` field in the Inttegro API payload.
+    #   When the failure occurred.
     #
     #   Required in the API payload. Wire name: `occurred_at`.
     #   @return [Time]
     #
     # @!attribute [r] type
-    #   Value of the `type` field in the Inttegro API payload.
+    #   Stable machine-readable failure category.
     #
     #   Required in the API payload. Wire name: `type`.
     #   @return [String]

data/lib/inttegro/payout/lookup_request.rb

@@ -7,7 +7,7 @@ require_relative "base"
 
 module Inttegro
   class Payout
-    # Typed representation of the lookup request object in the Inttegro API.
+    # Parameters for retrieving 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
@@ -16,7 +16,7 @@ module Inttegro
     # @api public
     #
     # @!attribute [r] payout_id
-    #   Payout identifier returned when the payout was created
+    #   Payout identifier returned when the payout was created.
     #
     #   Required in the API payload. Wire name: `payout_id`.
     #   @return [String]

data/lib/inttegro/payout/page.rb

@@ -8,7 +8,7 @@ require_relative "payout"
 
 module Inttegro
   class Payout
-    # Typed representation of the page object in the Inttegro API.
+    # A page of payouts ordered from newest to oldest.
     #
     # 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
@@ -17,13 +17,13 @@ module Inttegro
     # @api public
     #
     # @!attribute [r] number
-    #   Page number returned
+    #   Page number returned.
     #
     #   Required in the API payload. Wire name: `number`.
     #   @return [Integer]
     #
     # @!attribute [r] size
-    #   Number of payouts returned
+    #   Number of payouts returned.
     #
     #   Required in the API payload. Wire name: `size`.
     #   @return [Integer]

data/lib/inttegro/payout/page_request.rb

@@ -7,7 +7,7 @@ require_relative "base"
 
 module Inttegro
   class Payout
-    # Typed representation of the page request object in the Inttegro API.
+    # Pagination parameters for payouts.
     #
     # 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
@@ -16,13 +16,13 @@ module Inttegro
     # @api public
     #
     # @!attribute [r] page_number
-    #   1-based page index to fetch (1-10 inclusive)
+    #   1-based page index to fetch (1-10 inclusive).
     #
     #   Required in the API payload. Wire name: `page_number`.
     #   @return [Integer]
     #
     # @!attribute [r] page_size
-    #   Maximum number of payouts to return (1-256)
+    #   Maximum number of payouts to return (1-256).
     #
     #   Optional in the API payload; omitted values default to `nil`. Wire name: `page_size`.
     #   @return [Integer, nil]

data/lib/inttegro/payout/page_response.rb

@@ -8,7 +8,7 @@ require_relative "page"
 
 module Inttegro
   class Payout
-    # Typed representation of the page response object in the Inttegro API.
+    # Response envelope containing a page of payouts.
     #
     # 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
@@ -17,7 +17,7 @@ module Inttegro
     # @api public
     #
     # @!attribute [r] page
-    #   Value of the `page` field in the Inttegro API payload.
+    #   A page of payouts ordered from newest to oldest.
     #
     #   Optional in the API payload; omitted values default to `nil`. Wire name: `page`.
     #   @return [Inttegro::Payout::Page, nil]

data/lib/inttegro/payout/payout.rb

@@ -49,7 +49,7 @@ module Inttegro
   #   @return [String]
   #
   # @!attribute [r] error
-  #   Public failure details when execution fails
+  #   Public failure details returned when payout execution fails.
   #
   #   Optional in the API payload; omitted values default to `nil`. Wire name: `error`.
   #   @return [Inttegro::Payout::Error, nil]

data/lib/inttegro/payout/{cancel_response.rb → response.rb}

@@ -8,7 +8,7 @@ require_relative "payout"
 
 module Inttegro
   class Payout
-    # Typed representation of the cancel response object in the Inttegro API.
+    # Response envelope containing 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
@@ -21,7 +21,7 @@ module Inttegro
     #
     #   Optional in the API payload; omitted values default to `nil`. Wire name: `payout`.
     #   @return [Inttegro::Payout, nil]
-    class CancelResponse < T::Struct
+    class Response < T::Struct
       const :payout, T.nilable(Inttegro::Payout), default: nil
     end
   end

data/lib/inttegro/payout/set_destinations_request.rb

@@ -4,10 +4,11 @@
 # Generated from openapi/commerce.yml by bin/generate-openapi-types. Do not edit.
 
 require_relative "base"
+require_relative "destinations"
 
 module Inttegro
   class Payout
-    # Typed representation of the set destinations request object in the Inttegro API.
+    # Supported payout destination assignments to update.
     #
     # 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
@@ -16,12 +17,12 @@ module Inttegro
     # @api public
     #
     # @!attribute [r] destinations
-    #   Currency-to-financial-account destination assignments.
+    #   Supported currency-to-financial-account destination assignments.
     #
     #   Required in the API payload. Wire name: `destinations`.
-    #   @return [Hash{String => String}]
+    #   @return [Inttegro::Payout::Destinations]
     class SetDestinationsRequest < T::Struct
-      const :destinations, T::Hash[String, String]
+      const :destinations, Inttegro::Payout::Destinations
     end
   end
 end

data/lib/inttegro/payout/settings_lookup.rb

@@ -4,6 +4,7 @@
 # Generated from openapi/commerce.yml by bin/generate-openapi-types. Do not edit.
 
 require_relative "base"
+require_relative "destinations"
 require_relative "settings_lookup_schedule"
 
 module Inttegro
@@ -17,10 +18,10 @@ module Inttegro
     # @api public
     #
     # @!attribute [r] destinations
-    #   Currency-to-financial-account destination assignments.
+    #   Supported currency-to-financial-account destination assignments.
     #
     #   Required in the API payload. Wire name: `destinations`.
-    #   @return [Hash{String => String}]
+    #   @return [Inttegro::Payout::Destinations]
     #
     # @!attribute [r] fx_enabled
     #   Present only when foreign exchange is enabled in stored settings
@@ -29,12 +30,12 @@ module Inttegro
     #   @return [Boolean, nil]
     #
     # @!attribute [r] schedule
-    #   Active payout schedule
+    #   Active payout schedule returned when settings are retrieved.
     #
     #   Optional in the API payload; omitted values default to `nil`. Wire name: `schedule`.
     #   @return [Inttegro::Payout::SettingsLookupSchedule, nil]
     class SettingsLookup < T::Struct
-      const :destinations, T::Hash[String, String]
+      const :destinations, Inttegro::Payout::Destinations
       const :fx_enabled, T.nilable(T::Boolean), default: nil
       const :schedule, T.nilable(Inttegro::Payout::SettingsLookupSchedule), default: nil
     end

data/lib/inttegro/payout/{get_settings_response.rb → settings_lookup_response.rb}

@@ -8,7 +8,7 @@ require_relative "settings_lookup"
 
 module Inttegro
   class Payout
-    # Typed representation of the get settings response object in the Inttegro API.
+    # Response envelope containing complete payout settings.
     #
     # 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
@@ -21,7 +21,7 @@ module Inttegro
     #
     #   Optional in the API payload; omitted values default to `nil`. Wire name: `settings`.
     #   @return [Inttegro::Payout::SettingsLookup, nil]
-    class GetSettingsResponse < T::Struct
+    class SettingsLookupResponse < T::Struct
       const :settings, T.nilable(Inttegro::Payout::SettingsLookup), default: nil
     end
   end