inttegro 4.3.0 → 5.0.0

data/lib/inttegro/generated/operations.rb

@@ -48,7 +48,6 @@ module Inttegro
       "/orders/send_receipt" => Inttegro::OrderDocumentDeliveryResult,
       "/orders/page" => Inttegro::PageOrdersEnvelope,
       "/refunds/create" => Inttegro::RefundResponse,
-      "/orders/refund" => Inttegro::RefundResponse,
       "/refunds/cancel" => Inttegro::RefundResponse,
       "/refunds/lookup" => Inttegro::RefundResponse,
       "/refunds/page" => Inttegro::RefundPageResponse,
@@ -72,7 +71,7 @@ module Inttegro
       "/financial_accounts/reconnect" => Inttegro::ReconnectFinancialAccountResponse,
       "/financial_accounts/enable_pull" => Inttegro::EnableFinancialAccountPullResponse,
       "/financial_accounts/disable_pull" => Inttegro::DisableFinancialAccountPullResponse,
-      "/balances" => Inttegro::BalanceSnapshot,
+      "/balances" => Inttegro::BalanceSnapshotResponse,
       "/balance_transactions/lookup" => Inttegro::BalanceTransactionResponse,
       "/balance_transactions/page" => Inttegro::BalanceTransactionPageResponse,
       "/payouts/schedule" => Inttegro::SchedulePayoutResponse,
@@ -171,7 +170,6 @@ module Inttegro
       "/orders/send_receipt" => "Inttegro::OrderDocumentDeliveryRequest",
       "/orders/page" => "Inttegro::PageOrdersRequest",
       "/refunds/create" => "Inttegro::CreateRefundRequest",
-      "/orders/refund" => "Inttegro::CreateRefundRequest",
       "/refunds/cancel" => "Inttegro::CancelRefundRequest",
       "/refunds/lookup" => "Inttegro::LookupRefundRequest",
       "/refunds/page" => "Inttegro::PageRefundsRequest",
@@ -292,7 +290,6 @@ module Inttegro
       "/orders/send_receipt" => "sendOrderReceipt",
       "/orders/page" => "pageOrders",
       "/refunds/create" => "createRefund",
-      "/orders/refund" => "createRefundAlias",
       "/refunds/cancel" => "cancelRefund",
       "/refunds/lookup" => "lookupRefund",
       "/refunds/page" => "pageRefunds",

data/lib/inttegro/http_client.rb

@@ -4,6 +4,7 @@
 require "json"
 require "net/http"
 require "securerandom"
+require "time"
 require "uri"
 
 require_relative "errors"
@@ -626,8 +627,6 @@ module Inttegro
 
     sig { params(path: String).returns(T.nilable(T::Class[T::Struct])) }
     def response_model_for(path)
-      return T.cast(Inttegro.const_get(:OrderEnvelope), T::Class[T::Struct]) if path == "/orders/new"
-
       Inttegro::Operations::RESPONSE_MODELS[path]
     end
 
@@ -654,11 +653,11 @@ module Inttegro
         require_keys(body, %w[product_id price_id], path)
       when "/products/lookup", "/products/update", "/products/publish", "/products/unpublish", "/products/archive"
         require_keys(body, %w[product_id], path)
-      when "/orders/create", "/orders/new"
+      when "/orders/create"
         require_any(body, %w[customer_data customer_id], path)
         require_keys(body, %w[line_items], path)
       when "/orders/lookup", "/orders/update", "/orders/request_confirmation", "/orders/finalize",
-           "/orders/cancel", "/orders/refund", "/orders/complete"
+           "/orders/cancel", "/orders/complete"
         require_keys(body, %w[order_id], path)
       when "/orders/confirm_payment"
         require_keys(body, %w[order_id token], path)
@@ -727,6 +726,8 @@ module Inttegro
         normalize_payload(value.serialize)
       when T::Enum
         value.serialize
+      when Time
+        value.iso8601(9)
       when Hash
         normalize_payload(value)
       when Array

data/lib/inttegro/models.rb

@@ -2,6 +2,8 @@
 # typed: strict
 
 require "sorbet-runtime"
+require "set"
+require "time"
 
 require_relative "generated/models"
 require_relative "types"
@@ -9,6 +11,21 @@ require_relative "types"
 module Inttegro
   extend T::Sig
 
+  TEMPORAL_FIELDS = T.let(%w[
+    after archived_at as_of at attempted_at available_at canceled_at checked_at
+    claimed_at completed_at created_after created_at created_before deleted_at
+    delivered_at disconnected_at due_at enabled_at execute_after executed_at
+    expected_at expired_at expires_at expires_on failed_at fulfilled_at inactive_at
+    includes_transactions_before initialized_at initiated_at issued_at last_accessed_at
+    last_attempted_at last_email_event_at last_used_at occurred_at paid_at payment_due_at
+    processing_at published_at queued_at reviewed_at revoked_at scheduled_at sealed_at
+    send_after sent_at succeeded_at supplied_at suppressed_at token_sent_at updated_at
+    uploading_at valid_until verified_at
+  ].to_set.freeze, T::Set[String])
+  OPAQUE_TIMESTAMP_CONTAINERS = T.let(%w[
+    custom_data details headers json_ld mandate metadata variables
+  ].to_set.freeze, T::Set[String])
+
   # Amount primitives live under Money so the namespace can grow to include
   # currency conversion and formatting helpers without treating money as a
   # single value type.
@@ -100,31 +117,42 @@ module Inttegro
 
     sig { returns(T::Boolean) }
     def valid?
-      !id.empty? && !order_id.empty? && !created_at.empty? && valid_source?
+      !id.empty? && !order_id.empty? && valid_source?
     end
   end
 
   sig { params(value: Object, klass: T::Class[T::Struct]).returns(T::Struct) }
   def self.deserialize(value, klass)
-    data = stringify_json_keys(value)
+    data = stringify_json_keys(value, decode_timestamps: true)
     raise TypeError, "expected an object for #{klass}, got #{data.class}" unless data.is_a?(Hash)
 
     T.cast(klass, T.class_of(T::Struct)).from_hash(data)
   end
 
-  sig { params(value: Object).returns(Object) }
-  def self.stringify_json_keys(value)
+  sig { params(value: Object, decode_timestamps: T::Boolean).returns(Object) }
+  def self.stringify_json_keys(value, decode_timestamps: false)
     case value
     when T::Struct
-      stringify_json_keys(value.serialize)
+      stringify_json_keys(value.serialize, decode_timestamps: decode_timestamps)
     when T::Enum
       value.serialize
     when Hash
       value.each_with_object({}) do |(key, item), output|
-        output[key.to_s] = stringify_json_keys(item)
+        field = key.to_s
+        child_decode = decode_timestamps && !OPAQUE_TIMESTAMP_CONTAINERS.include?(field)
+        output[field] = if child_decode && TEMPORAL_FIELDS.include?(field) && item.is_a?(String)
+          unless item.match?(/(?:Z|[+-]\d{2}:\d{2})\z/)
+            raise ArgumentError, "timestamp #{field} must include a UTC offset"
+          end
+          Time.iso8601(item)
+        else
+          stringify_json_keys(item, decode_timestamps: child_decode)
+        end
       end
     when Array
-      value.map { |item| stringify_json_keys(item) }
+      value.map { |item| stringify_json_keys(item, decode_timestamps: decode_timestamps) }
+    when Time
+      value.iso8601(9)
     else
       value
     end

data/lib/inttegro/resources/balances.rb

@@ -9,7 +9,7 @@ module Inttegro
       end
 
       def get
-        @http.post_model("/balances", Inttegro::BalanceSnapshot, {})
+        @http.post_resource("/balances", Inttegro::BalanceSnapshot, :balances, {})
       end
     end
   end

data/lib/inttegro/resources/orders.rb

@@ -103,10 +103,6 @@ module Inttegro
         @http.post_resource("/orders/create", Inttegro::Order, :order, payload)
       end
 
-      def new(payload)
-        @http.post_resource("/orders/new", Inttegro::Order, :order, payload)
-      end
-
       # Retrieve an existing order by its ID.
       #
       # Returns full order details including customer, line items, payment state, and invoice information.
@@ -358,32 +354,6 @@ module Inttegro
         )
       end
 
-      # Create a refund through the /orders/refund compatibility alias.
-      #
-      # This accepts the same line-item payload as client.refunds.create and returns
-      # the created Refund directly. New integrations should use that canonical method.
-      #
-      # @param payload [Hash] Create-refund payload containing order_id, reason, and line_items
-      #
-      # @return [Inttegro::Refund] Created refund
-      #
-      # @example Refund an order
-      #   refund = client.orders.refund(
-      #     order_id: 'or_0123456789abcdefghijklmnopqrstuvwxyzABCD',
-      #     reason: 'requested_by_customer',
-      #     line_items: [{
-      #       order_line_item_id: 'oli_abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMN',
-      #       refund_amount: { currency: 'ghs', value: 2500 }
-      #     }]
-      #   )
-      #
-      #   puts "Refund created: #{refund.id}"
-      #
-      # @see https://studio.inttegro.com/refunds
-      def refund(payload)
-        @http.post_resource("/orders/refund", Inttegro::Refund, :refund, payload)
-      end
-
       # Retrieve a paginated list of orders.
       #
       # Returns orders in reverse chronological order (most recent first).

data/lib/inttegro/resources/payouts.rb

@@ -144,8 +144,8 @@ module Inttegro
       # @option payload [Integer] :page Page number to retrieve (minimum 1, default: 1)
       # @option payload [Integer] :per_page Number of results per page (minimum 1, maximum 100, default: 10)
       # @option payload [String] :status Filter by payout status (e.g., 'pending', 'paid', 'failed')
-      # @option payload [String] :created_after Filter payouts created after this timestamp (ISO 8601)
-      # @option payload [String] :created_before Filter payouts created before this timestamp (ISO 8601)
+      # @option payload [Time] :created_after Filter payouts created after this timestamp
+      # @option payload [Time] :created_before Filter payouts created before this timestamp
       #
       # @return [Inttegro::PayoutPage] Paginated list of payouts
       #

data/lib/inttegro/version.rb

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

data/rbi/inttegro/generated.rbi

@@ -256,18 +256,12 @@ module Inttegro
       sig { params(order_id: String, options: Inttegro::Types::Payload).returns(Inttegro::Order) }
       def lookup(order_id:, **options); end
 
-      sig { params(payload: T.any(T.any(Inttegro::CreateOrderNewCustomer, Inttegro::CreateOrderExistingCustomer), Inttegro::Types::Payload)).returns(Inttegro::Order) }
-      def new(payload); end
-
       sig { params(payload: T.nilable(T.any(Inttegro::PageOrdersRequest, Inttegro::Types::Payload))).returns(Inttegro::OrderPage) }
       def page(payload = nil); end
 
       sig { params(payload: T.any(Inttegro::PayOrderRequest, Inttegro::Types::Payload)).returns(Inttegro::Order) }
       def pay(payload); end
 
-      sig { params(payload: T.any(Inttegro::CreateRefundRequest, Inttegro::Types::Payload)).returns(Inttegro::Refund) }
-      def refund(payload); end
-
       sig { params(order_id: String, request_meta: T.nilable(Inttegro::Types::Payload)).returns(Inttegro::Order) }
       def request_confirmation(order_id:, request_meta: nil); end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: inttegro
 version: !ruby/object:Gem::Version
-  version: 4.3.0
+  version: 5.0.0
 platform: ruby
 authors:
 - Inttegro Engineering
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-09-06 00:00:00.000000000 Z
+date: 2026-09-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: sorbet-runtime
@@ -126,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'