feat(api): add route method to transactions

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 213
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic/lithic-6200f208b7ffdb9b4c7dd8468dbfe69f0078f8b8b0fd171ba2edc1c2a641f185.yml
-openapi_spec_hash: 2c396033aca49407378b3982e46d19e6
-config_hash: 126e04f676f61e5871a82889336dbf9d
+configured_endpoints: 214
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic/lithic-a4afc884f86f30a87445552888031ac1ca18aed0476d7120da555bf457627e65.yml
+openapi_spec_hash: ce8d0830986c702f0c7a693b1c3cc5a2
+config_hash: 4b618a1df59e555cebe6aa13e8c0218f

lib/lithic.rb

@@ -479,6 +479,7 @@
 require_relative "lithic/models/transaction_monitoring/queue_update_params"
 require_relative "lithic/models/transaction_monitoring/resolution_outcome"
 require_relative "lithic/models/transaction_retrieve_params"
+require_relative "lithic/models/transaction_route_params"
 require_relative "lithic/models/transactions/enhanced_commercial_data_retrieve_params"
 require_relative "lithic/models/transactions/enhanced_commercial_data_retrieve_response"
 require_relative "lithic/models/transactions/events/enhanced_commercial_data_retrieve_params"

lib/lithic/models.rb

@@ -578,6 +578,8 @@ module Lithic
 
   TransactionRetrieveParams = Lithic::Models::TransactionRetrieveParams
 
+  TransactionRouteParams = Lithic::Models::TransactionRouteParams
+
   Transactions = Lithic::Models::Transactions
 
   TransactionSimulateAuthorizationAdviceParams =

lib/lithic/models/transaction_route_params.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Lithic
+  module Models
+    # @see Lithic::Resources::Transactions#route
+    class TransactionRouteParams < Lithic::Internal::Type::BaseModel
+      extend Lithic::Internal::Type::RequestParameters::Converter
+      include Lithic::Internal::Type::RequestParameters
+
+      # @!attribute transaction_token
+      #
+      #   @return [String]
+      required :transaction_token, String
+
+      # @!attribute financial_account_token
+      #   The token of the financial account to route the transaction to.
+      #
+      #   @return [String]
+      required :financial_account_token, String
+
+      # @!method initialize(transaction_token:, financial_account_token:, request_options: {})
+      #   @param transaction_token [String]
+      #
+      #   @param financial_account_token [String] The token of the financial account to route the transaction to.
+      #
+      #   @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

lib/lithic/resources/transactions.rb

@@ -94,6 +94,31 @@ def expire_authorization(transaction_token, params = {})
         )
       end
 
+      # Route a card transaction to a financial account. Only available for select use
+      # cases and programs.
+      #
+      # @overload route(transaction_token, financial_account_token:, request_options: {})
+      #
+      # @param transaction_token [String] The token of the transaction to route.
+      #
+      # @param financial_account_token [String] The token of the financial account to route the transaction to.
+      #
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [nil]
+      #
+      # @see Lithic::Models::TransactionRouteParams
+      def route(transaction_token, params)
+        parsed, options = Lithic::TransactionRouteParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: ["v1/transactions/%1$s/route", transaction_token],
+          body: parsed,
+          model: NilClass,
+          options: options
+        )
+      end
+
       # Some parameter documentations has been truncated, see
       # {Lithic::Models::TransactionSimulateAuthorizationParams} for more details.
       #

rbi/lithic/models.rbi

@@ -606,6 +606,8 @@ module Lithic
 
   TransactionRetrieveParams = Lithic::Models::TransactionRetrieveParams
 
+  TransactionRouteParams = Lithic::Models::TransactionRouteParams
+
   Transactions = Lithic::Models::Transactions
 
   TransactionSimulateAuthorizationAdviceParams =

rbi/lithic/models/transaction_route_params.rbi

@@ -0,0 +1,49 @@
+# typed: strong
+
+module Lithic
+  module Models
+    class TransactionRouteParams < Lithic::Internal::Type::BaseModel
+      extend Lithic::Internal::Type::RequestParameters::Converter
+      include Lithic::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Lithic::TransactionRouteParams, Lithic::Internal::AnyHash)
+        end
+
+      sig { returns(String) }
+      attr_accessor :transaction_token
+
+      # The token of the financial account to route the transaction to.
+      sig { returns(String) }
+      attr_accessor :financial_account_token
+
+      sig do
+        params(
+          transaction_token: String,
+          financial_account_token: String,
+          request_options: Lithic::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        transaction_token:,
+        # The token of the financial account to route the transaction to.
+        financial_account_token:,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            transaction_token: String,
+            financial_account_token: String,
+            request_options: Lithic::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

rbi/lithic/resources/transactions.rbi

@@ -82,6 +82,24 @@ module Lithic
       )
       end
 
+      # Route a card transaction to a financial account. Only available for select use
+      # cases and programs.
+      sig do
+        params(
+          transaction_token: String,
+          financial_account_token: String,
+          request_options: Lithic::RequestOptions::OrHash
+        ).void
+      end
+      def route(
+        # The token of the transaction to route.
+        transaction_token,
+        # The token of the financial account to route the transaction to.
+        financial_account_token:,
+        request_options: {}
+      )
+      end
+
       # Simulates an authorization request from the card network as if it came from a
       # merchant acquirer. If you are configured for ASA, simulating authorizations
       # requires your ASA client to be set up properly, i.e. be able to respond to the

sig/lithic/models.rbs

@@ -525,6 +525,8 @@ module Lithic
 
   class TransactionRetrieveParams = Lithic::Models::TransactionRetrieveParams
 
+  class TransactionRouteParams = Lithic::Models::TransactionRouteParams
+
   module Transactions = Lithic::Models::Transactions
 
   class TransactionSimulateAuthorizationAdviceParams = Lithic::Models::TransactionSimulateAuthorizationAdviceParams

sig/lithic/models/transaction_route_params.rbs

@@ -0,0 +1,28 @@
+module Lithic
+  module Models
+    type transaction_route_params =
+      { transaction_token: String, financial_account_token: String }
+      & Lithic::Internal::Type::request_parameters
+
+    class TransactionRouteParams < Lithic::Internal::Type::BaseModel
+      extend Lithic::Internal::Type::RequestParameters::Converter
+      include Lithic::Internal::Type::RequestParameters
+
+      attr_accessor transaction_token: String
+
+      attr_accessor financial_account_token: String
+
+      def initialize: (
+        transaction_token: String,
+        financial_account_token: String,
+        ?request_options: Lithic::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        transaction_token: String,
+        financial_account_token: String,
+        request_options: Lithic::RequestOptions
+      }
+    end
+  end
+end