feat(api): Add Hold API for financial account fund reservations

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 185
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic%2Flithic-df289940d26615072a7c5c9dd4d32b9bc7a86d977642b377c58abbe7a4cb93d0.yml
-openapi_spec_hash: 836bb078df7ac5f8d2dd5081c2e833be
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic%2Flithic-45bd51c1d7885bde620179da56671e3378571e301528c60975604c4fbaa2c800.yml
+openapi_spec_hash: e1355583b829f269875b6f800078a9e0
 config_hash: fb5070d41fcabdedbc084b83964b592a

lib/lithic/models/payment_create_params.rb

@@ -44,6 +44,12 @@ class PaymentCreateParams < Lithic::Internal::Type::BaseModel
       #   @return [String, nil]
       optional :token, String
 
+      # @!attribute hold
+      #   Optional hold to settle when this payment is initiated.
+      #
+      #   @return [Lithic::Models::PaymentCreateParams::Hold, nil]
+      optional :hold, -> { Lithic::PaymentCreateParams::Hold }
+
       # @!attribute memo
       #
       #   @return [String, nil]
@@ -54,7 +60,7 @@ class PaymentCreateParams < Lithic::Internal::Type::BaseModel
       #   @return [String, nil]
       optional :user_defined_id, String
 
-      # @!method initialize(amount:, external_bank_account_token:, financial_account_token:, method_:, method_attributes:, type:, token: nil, memo: nil, user_defined_id: nil, request_options: {})
+      # @!method initialize(amount:, external_bank_account_token:, financial_account_token:, method_:, method_attributes:, type:, token: nil, hold: nil, memo: nil, user_defined_id: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Lithic::Models::PaymentCreateParams} for more details.
       #
@@ -72,6 +78,8 @@ class PaymentCreateParams < Lithic::Internal::Type::BaseModel
       #
       #   @param token [String] Customer-provided token that will serve as an idempotency token. This token will
       #
+      #   @param hold [Lithic::Models::PaymentCreateParams::Hold] Optional hold to settle when this payment is initiated.
+      #
       #   @param memo [String]
       #
       #   @param user_defined_id [String]
@@ -134,6 +142,19 @@ module Type
         # @!method self.values
         #   @return [Array<Symbol>]
       end
+
+      class Hold < Lithic::Internal::Type::BaseModel
+        # @!attribute token
+        #   Token of the hold to settle when this payment is initiated.
+        #
+        #   @return [String]
+        required :token, String
+
+        # @!method initialize(token:)
+        #   Optional hold to settle when this payment is initiated.
+        #
+        #   @param token [String] Token of the hold to settle when this payment is initiated.
+      end
     end
   end
 end

lib/lithic/resources/payments.rb

@@ -8,7 +8,7 @@ class Payments
       #
       # Initiates a payment between a financial account and an external bank account.
       #
-      # @overload create(amount:, external_bank_account_token:, financial_account_token:, method_:, method_attributes:, type:, token: nil, memo: nil, user_defined_id: nil, request_options: {})
+      # @overload create(amount:, external_bank_account_token:, financial_account_token:, method_:, method_attributes:, type:, token: nil, hold: nil, memo: nil, user_defined_id: nil, request_options: {})
       #
       # @param amount [Integer]
       #
@@ -24,6 +24,8 @@ class Payments
       #
       # @param token [String] Customer-provided token that will serve as an idempotency token. This token will
       #
+      # @param hold [Lithic::Models::PaymentCreateParams::Hold] Optional hold to settle when this payment is initiated.
+      #
       # @param memo [String]
       #
       # @param user_defined_id [String]

rbi/lithic/models/payment_create_params.rbi

@@ -45,6 +45,13 @@ module Lithic
       sig { params(token: String).void }
       attr_writer :token
 
+      # Optional hold to settle when this payment is initiated.
+      sig { returns(T.nilable(Lithic::PaymentCreateParams::Hold)) }
+      attr_reader :hold
+
+      sig { params(hold: Lithic::PaymentCreateParams::Hold::OrHash).void }
+      attr_writer :hold
+
       sig { returns(T.nilable(String)) }
       attr_reader :memo
 
@@ -67,6 +74,7 @@ module Lithic
             Lithic::PaymentCreateParams::MethodAttributes::OrHash,
           type: Lithic::PaymentCreateParams::Type::OrSymbol,
           token: String,
+          hold: Lithic::PaymentCreateParams::Hold::OrHash,
           memo: String,
           user_defined_id: String,
           request_options: Lithic::RequestOptions::OrHash
@@ -82,6 +90,8 @@ module Lithic
         # Customer-provided token that will serve as an idempotency token. This token will
         # become the transaction token.
         token: nil,
+        # Optional hold to settle when this payment is initiated.
+        hold: nil,
         memo: nil,
         user_defined_id: nil,
         request_options: {}
@@ -98,6 +108,7 @@ module Lithic
             method_attributes: Lithic::PaymentCreateParams::MethodAttributes,
             type: Lithic::PaymentCreateParams::Type::OrSymbol,
             token: String,
+            hold: Lithic::PaymentCreateParams::Hold,
             memo: String,
             user_defined_id: String,
             request_options: Lithic::RequestOptions
@@ -249,6 +260,29 @@ module Lithic
         def self.values
         end
       end
+
+      class Hold < Lithic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(Lithic::PaymentCreateParams::Hold, Lithic::Internal::AnyHash)
+          end
+
+        # Token of the hold to settle when this payment is initiated.
+        sig { returns(String) }
+        attr_accessor :token
+
+        # Optional hold to settle when this payment is initiated.
+        sig { params(token: String).returns(T.attached_class) }
+        def self.new(
+          # Token of the hold to settle when this payment is initiated.
+          token:
+        )
+        end
+
+        sig { override.returns({ token: String }) }
+        def to_hash
+        end
+      end
     end
   end
 end

rbi/lithic/resources/payments.rbi

@@ -14,6 +14,7 @@ module Lithic
             Lithic::PaymentCreateParams::MethodAttributes::OrHash,
           type: Lithic::PaymentCreateParams::Type::OrSymbol,
           token: String,
+          hold: Lithic::PaymentCreateParams::Hold::OrHash,
           memo: String,
           user_defined_id: String,
           request_options: Lithic::RequestOptions::OrHash
@@ -29,6 +30,8 @@ module Lithic
         # Customer-provided token that will serve as an idempotency token. This token will
         # become the transaction token.
         token: nil,
+        # Optional hold to settle when this payment is initiated.
+        hold: nil,
         memo: nil,
         user_defined_id: nil,
         request_options: {}

sig/lithic/models/payment_create_params.rbs

@@ -9,6 +9,7 @@ module Lithic
         method_attributes: Lithic::PaymentCreateParams::MethodAttributes,
         type: Lithic::Models::PaymentCreateParams::type_,
         token: String,
+        hold: Lithic::PaymentCreateParams::Hold,
         memo: String,
         user_defined_id: String
       }
@@ -34,6 +35,12 @@ module Lithic
 
       def token=: (String) -> String
 
+      attr_reader hold: Lithic::PaymentCreateParams::Hold?
+
+      def hold=: (
+        Lithic::PaymentCreateParams::Hold
+      ) -> Lithic::PaymentCreateParams::Hold
+
       attr_reader memo: String?
 
       def memo=: (String) -> String
@@ -50,6 +57,7 @@ module Lithic
         method_attributes: Lithic::PaymentCreateParams::MethodAttributes,
         type: Lithic::Models::PaymentCreateParams::type_,
         ?token: String,
+        ?hold: Lithic::PaymentCreateParams::Hold,
         ?memo: String,
         ?user_defined_id: String,
         ?request_options: Lithic::request_opts
@@ -63,6 +71,7 @@ module Lithic
         method_attributes: Lithic::PaymentCreateParams::MethodAttributes,
         type: Lithic::Models::PaymentCreateParams::type_,
         token: String,
+        hold: Lithic::PaymentCreateParams::Hold,
         memo: String,
         user_defined_id: String,
         request_options: Lithic::RequestOptions
@@ -130,6 +139,16 @@ module Lithic
 
         def self?.values: -> ::Array[Lithic::Models::PaymentCreateParams::type_]
       end
+
+      type hold = { token: String }
+
+      class Hold < Lithic::Internal::Type::BaseModel
+        attr_accessor token: String
+
+        def initialize: (token: String) -> void
+
+        def to_hash: -> { token: String }
+      end
     end
   end
 end

sig/lithic/resources/payments.rbs

@@ -9,6 +9,7 @@ module Lithic
         method_attributes: Lithic::PaymentCreateParams::MethodAttributes,
         type: Lithic::Models::PaymentCreateParams::type_,
         ?token: String,
+        ?hold: Lithic::PaymentCreateParams::Hold,
         ?memo: String,
         ?user_defined_id: String,
         ?request_options: Lithic::request_opts