lithic 0.6.0 → 0.8.0

data/lib/lithic/resources/holds.rb

@@ -0,0 +1,132 @@
+# frozen_string_literal: true
+
+module Lithic
+  module Resources
+    class Holds
+      # Create a hold on a financial account. Holds reserve funds by moving them from
+      # available to pending balance. They can be resolved via settlement (linked to a
+      # payment or book transfer), voiding, or expiration.
+      #
+      # @overload create(financial_account_token, amount:, token: nil, expiration_datetime: nil, memo: nil, user_defined_id: nil, request_options: {})
+      #
+      # @param financial_account_token [String] Globally unique identifier for the financial account.
+      #
+      # @param amount [Integer] Amount to hold in cents
+      #
+      # @param token [String] Customer-provided token for idempotency. Becomes the hold token.
+      #
+      # @param expiration_datetime [Time] When the hold should auto-expire
+      #
+      # @param memo [String, nil] Reason for the hold
+      #
+      # @param user_defined_id [String] User-provided identifier for the hold
+      #
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Lithic::Models::Hold]
+      #
+      # @see Lithic::Models::HoldCreateParams
+      def create(financial_account_token, params)
+        parsed, options = Lithic::HoldCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: ["v1/financial_accounts/%1$s/holds", financial_account_token],
+          body: parsed,
+          model: Lithic::Hold,
+          options: options
+        )
+      end
+
+      # Get hold by token.
+      #
+      # @overload retrieve(hold_token, request_options: {})
+      #
+      # @param hold_token [String] Globally unique identifier for the hold.
+      #
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Lithic::Models::Hold]
+      #
+      # @see Lithic::Models::HoldRetrieveParams
+      def retrieve(hold_token, params = {})
+        @client.request(
+          method: :get,
+          path: ["v1/holds/%1$s", hold_token],
+          model: Lithic::Hold,
+          options: params[:request_options]
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Lithic::Models::HoldListParams} for more details.
+      #
+      # List holds for a financial account.
+      #
+      # @overload list(financial_account_token, begin_: nil, end_: nil, ending_before: nil, page_size: nil, starting_after: nil, status: nil, request_options: {})
+      #
+      # @param financial_account_token [String] Globally unique identifier for the financial account.
+      #
+      # @param begin_ [Time] Date string in RFC 3339 format. Only entries created after the specified time wi
+      #
+      # @param end_ [Time] Date string in RFC 3339 format. Only entries created before the specified time w
+      #
+      # @param ending_before [String] A cursor representing an item's token before which a page of results should end.
+      #
+      # @param page_size [Integer] Page size (for pagination).
+      #
+      # @param starting_after [String] A cursor representing an item's token after which a page of results should begin
+      #
+      # @param status [Symbol, Lithic::Models::HoldListParams::Status] Hold status to filter by.
+      #
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Lithic::Internal::CursorPage<Lithic::Models::Hold>]
+      #
+      # @see Lithic::Models::HoldListParams
+      def list(financial_account_token, params = {})
+        parsed, options = Lithic::HoldListParams.dump_request(params)
+        query = Lithic::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: ["v1/financial_accounts/%1$s/holds", financial_account_token],
+          query: query.transform_keys(begin_: "begin", end_: "end"),
+          page: Lithic::Internal::CursorPage,
+          model: Lithic::Hold,
+          options: options
+        )
+      end
+
+      # Void an active hold. This returns the held funds from pending back to available
+      # balance. Only holds in PENDING status can be voided.
+      #
+      # @overload void(hold_token, memo: nil, request_options: {})
+      #
+      # @param hold_token [String] Globally unique identifier for the hold.
+      #
+      # @param memo [String, nil] Reason for voiding the hold
+      #
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Lithic::Models::Hold]
+      #
+      # @see Lithic::Models::HoldVoidParams
+      def void(hold_token, params = {})
+        parsed, options = Lithic::HoldVoidParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: ["v1/holds/%1$s/void", hold_token],
+          body: parsed,
+          model: Lithic::Hold,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Lithic::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/lithic/resources/management_operations.rb

@@ -100,10 +100,11 @@ module Lithic
       # @see Lithic::Models::ManagementOperationListParams
       def list(params = {})
         parsed, options = Lithic::ManagementOperationListParams.dump_request(params)
+        query = Lithic::Internal::Util.encode_query_params(parsed)
         @client.request(
           method: :get,
           path: "v1/management_operations",
-          query: parsed.transform_keys(begin_: "begin", end_: "end"),
+          query: query.transform_keys(begin_: "begin", end_: "end"),
           page: Lithic::Internal::CursorPage,
           model: Lithic::ManagementOperationTransaction,
           options: options

data/lib/lithic/resources/network_programs.rb

@@ -43,10 +43,11 @@ module Lithic
       # @see Lithic::Models::NetworkProgramListParams
       def list(params = {})
         parsed, options = Lithic::NetworkProgramListParams.dump_request(params)
+        query = Lithic::Internal::Util.encode_query_params(parsed)
         @client.request(
           method: :get,
           path: "v1/network_programs",
-          query: parsed.transform_keys(begin_: "begin", end_: "end"),
+          query: query.transform_keys(begin_: "begin", end_: "end"),
           page: Lithic::Internal::SinglePage,
           model: Lithic::NetworkProgram,
           options: options

data/lib/lithic/resources/payments.rb

@@ -8,7 +8,7 @@ module Lithic
       #
       # 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 @@ module Lithic
       #
       # @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]
@@ -99,10 +101,11 @@ module Lithic
       # @see Lithic::Models::PaymentListParams
       def list(params = {})
         parsed, options = Lithic::PaymentListParams.dump_request(params)
+        query = Lithic::Internal::Util.encode_query_params(parsed)
         @client.request(
           method: :get,
           path: "v1/payments",
-          query: parsed.transform_keys(begin_: "begin", end_: "end"),
+          query: query.transform_keys(begin_: "begin", end_: "end"),
           page: Lithic::Internal::CursorPage,
           model: Lithic::Payment,
           options: options

data/lib/lithic/resources/reports/settlement/network_totals.rb

@@ -61,10 +61,11 @@ module Lithic
           # @see Lithic::Models::Reports::Settlement::NetworkTotalListParams
           def list(params = {})
             parsed, options = Lithic::Reports::Settlement::NetworkTotalListParams.dump_request(params)
+            query = Lithic::Internal::Util.encode_query_params(parsed)
             @client.request(
               method: :get,
               path: "v1/reports/settlement/network_totals",
-              query: parsed.transform_keys(begin_: "begin", end_: "end"),
+              query: query.transform_keys(begin_: "begin", end_: "end"),
               page: Lithic::Internal::CursorPage,
               model: Lithic::NetworkTotal,
               options: options

data/lib/lithic/resources/reports/settlement.rb

@@ -29,10 +29,11 @@ module Lithic
         # @see Lithic::Models::Reports::SettlementListDetailsParams
         def list_details(report_date, params = {})
           parsed, options = Lithic::Reports::SettlementListDetailsParams.dump_request(params)
+          query = Lithic::Internal::Util.encode_query_params(parsed)
           @client.request(
             method: :get,
             path: ["v1/reports/settlement/details/%1$s", report_date],
-            query: parsed,
+            query: query,
             page: Lithic::Internal::CursorPage,
             model: Lithic::SettlementDetail,
             options: options

data/lib/lithic/resources/responder_endpoints.rb

@@ -40,10 +40,11 @@ module Lithic
       # @see Lithic::Models::ResponderEndpointDeleteParams
       def delete(params)
         parsed, options = Lithic::ResponderEndpointDeleteParams.dump_request(params)
+        query = Lithic::Internal::Util.encode_query_params(parsed)
         @client.request(
           method: :delete,
           path: "v1/responder_endpoints",
-          query: parsed,
+          query: query,
           model: NilClass,
           options: options
         )
@@ -62,10 +63,11 @@ module Lithic
       # @see Lithic::Models::ResponderEndpointCheckStatusParams
       def check_status(params)
         parsed, options = Lithic::ResponderEndpointCheckStatusParams.dump_request(params)
+        query = Lithic::Internal::Util.encode_query_params(parsed)
         @client.request(
           method: :get,
           path: "v1/responder_endpoints",
-          query: parsed,
+          query: query,
           model: Lithic::ResponderEndpointStatus,
           options: options
         )

data/lib/lithic/resources/tokenizations.rb

@@ -53,10 +53,11 @@ module Lithic
       # @see Lithic::Models::TokenizationListParams
       def list(params = {})
         parsed, options = Lithic::TokenizationListParams.dump_request(params)
+        query = Lithic::Internal::Util.encode_query_params(parsed)
         @client.request(
           method: :get,
           path: "v1/tokenizations",
-          query: parsed.transform_keys(begin_: "begin", end_: "end"),
+          query: query.transform_keys(begin_: "begin", end_: "end"),
           page: Lithic::Internal::CursorPage,
           model: Lithic::Tokenization,
           options: options

data/lib/lithic/resources/transactions.rb

@@ -63,10 +63,11 @@ module Lithic
       # @see Lithic::Models::TransactionListParams
       def list(params = {})
         parsed, options = Lithic::TransactionListParams.dump_request(params)
+        query = Lithic::Internal::Util.encode_query_params(parsed)
         @client.request(
           method: :get,
           path: "v1/transactions",
-          query: parsed.transform_keys(begin_: "begin", end_: "end"),
+          query: query.transform_keys(begin_: "begin", end_: "end"),
           page: Lithic::Internal::CursorPage,
           model: Lithic::Transaction,
           options: options

data/lib/lithic/resources/transfer_limits.rb

@@ -16,10 +16,11 @@ module Lithic
       # @see Lithic::Models::TransferLimitListParams
       def list(params = {})
         parsed, options = Lithic::TransferLimitListParams.dump_request(params)
+        query = Lithic::Internal::Util.encode_query_params(parsed)
         @client.request(
           method: :get,
           path: "v1/transfer_limits",
-          query: parsed,
+          query: query,
           page: Lithic::Internal::SinglePage,
           model: Lithic::TransferLimitsResponse::Data,
           options: options

data/lib/lithic/resources/webhooks.rb

@@ -9,8 +9,7 @@ module Lithic
       # @param headers [Hash{String => String}] The webhook request headers
       # @param secret [String, nil] The webhook secret. If not provided, reads from LITHIC_WEBHOOK_SECRET environment variable.
       #
-      # @return [Lithic::Models::AccountHolderCreatedWebhookEvent, Lithic::Models::ParsedWebhookEvent::KYBPayload, Lithic::Models::ParsedWebhookEvent::KYCPayload, Lithic::Models::ParsedWebhookEvent::LegacyPayload, Lithic::Models::AccountHolderVerificationWebhookEvent, Lithic::Models::AccountHolderDocumentUpdatedWebhookEvent, Lithic::Models::AsaRequestWebhookEvent, Lithic::Models::TokenizationDecisioningRequestWebhookEvent, Lithic::Models::AuthRulesBacktestReportCreatedWebhookEvent, Lithic::Models::BalanceUpdatedWebhookEvent, Lithic::Models::BookTransferTransactionCreatedWebhookEvent, Lithic::Models::BookTransferTransactionUpdatedWebhookEvent, Lithic::Models::CardCreatedWebhookEvent, Lithic::Models::CardConvertedWebhookEvent, Lithic::Models::CardRenewedWebhookEvent, Lithic::Models::CardReissuedWebhookEvent, Lithic::Models::CardShippedWebhookEvent, Lithic::Models::CardTransactionUpdatedWebhookEvent, Lithic::Models::CardTransactionEnhancedDataCreatedWebhookEvent, Lithic::Models::CardTransactionEnhancedDataUpdatedWebhookEvent, Lithic::Models::DigitalWalletTokenizationApprovalRequestWebhookEvent, Lithic::Models::DigitalWalletTokenizationResultWebhookEvent, Lithic::Models::DigitalWalletTokenizationTwoFactorAuthenticationCodeWebhookEvent, Lithic::Models::DigitalWalletTokenizationTwoFactorAuthenticationCodeSentWebhookEvent, Lithic::Models::DigitalWalletTokenizationUpdatedWebhookEvent, Lithic::Models::DisputeUpdatedWebhookEvent, Lithic::Models::DisputeEvidenceUploadFailedWebhookEvent, Lithic::Models::ExternalBankAccountCreatedWebhookEvent, Lithic::Models::ExternalBankAccountUpdatedWebhookEvent, Lithic::Models::ExternalPaymentCreatedWebhookEvent, Lithic::Models::ExternalPaymentUpdatedWebhookEvent, Lithic::Models::FinancialAccountCreatedWebhookEvent, Lithic::Models::FinancialAccountUpdatedWebhookEvent, Lithic::Models::FundingEventCreatedWebhookEvent, Lithic::Models::LoanTapeCreatedWebhookEvent, Lithic::Models::LoanTapeUpdatedWebhookEvent, Lithic::Models::ManagementOperationCreatedWebhookEvent, Lithic::Models::ManagementOperationUpdatedWebhookEvent, Lithic::Models::InternalTransactionCreatedWebhookEvent, Lithic::Models::InternalTransactionUpdatedWebhookEvent, Lithic::Models::NetworkTotalCreatedWebhookEvent, Lithic::Models::NetworkTotalUpdatedWebhookEvent, Lithic::Models::PaymentTransactionCreatedWebhookEvent, Lithic::Models::PaymentTransactionUpdatedWebhookEvent, Lithic::Models::SettlementReportUpdatedWebhookEvent, Lithic::Models::StatementsCreatedWebhookEvent, Lithic::Models::ThreeDSAuthenticationCreatedWebhookEvent, Lithic::Models::ThreeDSAuthenticationUpdatedWebhookEvent, Lithic::Models::ThreeDSAuthenticationChallengeWebhookEvent, Lithic::Models::TokenizationApprovalRequestWebhookEvent, Lithic::Models::TokenizationResultWebhookEvent, Lithic::Models::TokenizationTwoFactorAuthenticationCodeWebhookEvent, Lithic::Models::TokenizationTwoFactorAuthenticationCodeSentWebhookEvent, Lithic::Models::TokenizationUpdatedWebhookEvent, Lithic::Models::ThreeDSAuthentication, Lithic::Models::DisputeTransactionCreatedWebhookEvent, Lithic::Models::DisputeTransactionUpdatedWebhookEvent]
-      #
+      # @return [Lithic::Models::AccountHolderCreatedWebhookEvent, Lithic::Models::ParsedWebhookEvent::KYBPayload, Lithic::Models::ParsedWebhookEvent::KYCPayload, Lithic::Models::ParsedWebhookEvent::LegacyPayload, Lithic::Models::AccountHolderVerificationWebhookEvent, Lithic::Models::AccountHolderDocumentUpdatedWebhookEvent, Lithic::Models::CardAuthorizationApprovalRequestWebhookEvent, Lithic::Models::AuthRulesBacktestReportCreatedWebhookEvent, Lithic::Models::BalanceUpdatedWebhookEvent, Lithic::Models::BookTransferTransactionCreatedWebhookEvent, Lithic::Models::BookTransferTransactionUpdatedWebhookEvent, Lithic::Models::CardCreatedWebhookEvent, Lithic::Models::CardConvertedWebhookEvent, Lithic::Models::CardRenewedWebhookEvent, Lithic::Models::CardReissuedWebhookEvent, Lithic::Models::CardShippedWebhookEvent, Lithic::Models::CardUpdatedWebhookEvent, Lithic::Models::CardTransactionUpdatedWebhookEvent, Lithic::Models::CardTransactionEnhancedDataCreatedWebhookEvent, Lithic::Models::CardTransactionEnhancedDataUpdatedWebhookEvent, Lithic::Models::DigitalWalletTokenizationApprovalRequestWebhookEvent, Lithic::Models::DigitalWalletTokenizationResultWebhookEvent, Lithic::Models::DigitalWalletTokenizationTwoFactorAuthenticationCodeWebhookEvent, Lithic::Models::DigitalWalletTokenizationTwoFactorAuthenticationCodeSentWebhookEvent, Lithic::Models::DigitalWalletTokenizationUpdatedWebhookEvent, Lithic::Models::DisputeUpdatedWebhookEvent, Lithic::Models::DisputeEvidenceUploadFailedWebhookEvent, Lithic::Models::ExternalBankAccountCreatedWebhookEvent, Lithic::Models::ExternalBankAccountUpdatedWebhookEvent, Lithic::Models::ExternalPaymentCreatedWebhookEvent, Lithic::Models::ExternalPaymentUpdatedWebhookEvent, Lithic::Models::FinancialAccountCreatedWebhookEvent, Lithic::Models::FinancialAccountUpdatedWebhookEvent, Lithic::Models::FundingEventCreatedWebhookEvent, Lithic::Models::LoanTapeCreatedWebhookEvent, Lithic::Models::LoanTapeUpdatedWebhookEvent, Lithic::Models::ManagementOperationCreatedWebhookEvent, Lithic::Models::ManagementOperationUpdatedWebhookEvent, Lithic::Models::InternalTransactionCreatedWebhookEvent, Lithic::Models::InternalTransactionUpdatedWebhookEvent, Lithic::Models::NetworkTotalCreatedWebhookEvent, Lithic::Models::NetworkTotalUpdatedWebhookEvent, Lithic::Models::PaymentTransactionCreatedWebhookEvent, Lithic::Models::PaymentTransactionUpdatedWebhookEvent, Lithic::Models::SettlementReportUpdatedWebhookEvent, Lithic::Models::StatementsCreatedWebhookEvent, Lithic::Models::ThreeDSAuthenticationCreatedWebhookEvent, Lithic::Models::ThreeDSAuthenticationUpdatedWebhookEvent, Lithic::Models::ThreeDSAuthenticationChallengeWebhookEvent, Lithic::Models::TokenizationApprovalRequestWebhookEvent, Lithic::Models::TokenizationResultWebhookEvent, Lithic::Models::TokenizationTwoFactorAuthenticationCodeWebhookEvent, Lithic::Models::TokenizationTwoFactorAuthenticationCodeSentWebhookEvent, Lithic::Models::TokenizationUpdatedWebhookEvent, Lithic::Models::ThreeDSAuthenticationApprovalRequestWebhookEvent, Lithic::Models::DisputeTransactionCreatedWebhookEvent, Lithic::Models::DisputeTransactionUpdatedWebhookEvent]      #
       # @raise [ArgumentError] if secret is not provided and LITHIC_WEBHOOK_SECRET env var is not set
       # @raise [Lithic::Errors::MissingDependencyError] if the standardwebhooks gem is not installed
       # @raise [StandardWebhooks::WebhookVerificationError] if the signature is invalid
@@ -32,7 +31,7 @@ module Lithic
       #
       # @param payload [String] The raw webhook payload as a string
       #
-      # @return [Lithic::Models::AccountHolderCreatedWebhookEvent, Lithic::Models::ParsedWebhookEvent::KYBPayload, Lithic::Models::ParsedWebhookEvent::KYCPayload, Lithic::Models::ParsedWebhookEvent::LegacyPayload, Lithic::Models::AccountHolderVerificationWebhookEvent, Lithic::Models::AccountHolderDocumentUpdatedWebhookEvent, Lithic::Models::CardAuthorizationApprovalRequestWebhookEvent, Lithic::Models::TokenizationDecisioningRequestWebhookEvent, Lithic::Models::AuthRulesBacktestReportCreatedWebhookEvent, Lithic::Models::BalanceUpdatedWebhookEvent, Lithic::Models::BookTransferTransactionCreatedWebhookEvent, Lithic::Models::BookTransferTransactionUpdatedWebhookEvent, Lithic::Models::CardCreatedWebhookEvent, Lithic::Models::CardConvertedWebhookEvent, Lithic::Models::CardRenewedWebhookEvent, Lithic::Models::CardReissuedWebhookEvent, Lithic::Models::CardShippedWebhookEvent, Lithic::Models::CardUpdatedWebhookEvent, Lithic::Models::CardTransactionUpdatedWebhookEvent, Lithic::Models::CardTransactionEnhancedDataCreatedWebhookEvent, Lithic::Models::CardTransactionEnhancedDataUpdatedWebhookEvent, Lithic::Models::DigitalWalletTokenizationApprovalRequestWebhookEvent, Lithic::Models::DigitalWalletTokenizationResultWebhookEvent, Lithic::Models::DigitalWalletTokenizationTwoFactorAuthenticationCodeWebhookEvent, Lithic::Models::DigitalWalletTokenizationTwoFactorAuthenticationCodeSentWebhookEvent, Lithic::Models::DigitalWalletTokenizationUpdatedWebhookEvent, Lithic::Models::DisputeUpdatedWebhookEvent, Lithic::Models::DisputeEvidenceUploadFailedWebhookEvent, Lithic::Models::ExternalBankAccountCreatedWebhookEvent, Lithic::Models::ExternalBankAccountUpdatedWebhookEvent, Lithic::Models::ExternalPaymentCreatedWebhookEvent, Lithic::Models::ExternalPaymentUpdatedWebhookEvent, Lithic::Models::FinancialAccountCreatedWebhookEvent, Lithic::Models::FinancialAccountUpdatedWebhookEvent, Lithic::Models::FundingEventCreatedWebhookEvent, Lithic::Models::LoanTapeCreatedWebhookEvent, Lithic::Models::LoanTapeUpdatedWebhookEvent, Lithic::Models::ManagementOperationCreatedWebhookEvent, Lithic::Models::ManagementOperationUpdatedWebhookEvent, Lithic::Models::InternalTransactionCreatedWebhookEvent, Lithic::Models::InternalTransactionUpdatedWebhookEvent, Lithic::Models::NetworkTotalCreatedWebhookEvent, Lithic::Models::NetworkTotalUpdatedWebhookEvent, Lithic::Models::PaymentTransactionCreatedWebhookEvent, Lithic::Models::PaymentTransactionUpdatedWebhookEvent, Lithic::Models::SettlementReportUpdatedWebhookEvent, Lithic::Models::StatementsCreatedWebhookEvent, Lithic::Models::ThreeDSAuthenticationCreatedWebhookEvent, Lithic::Models::ThreeDSAuthenticationUpdatedWebhookEvent, Lithic::Models::ThreeDSAuthenticationChallengeWebhookEvent, Lithic::Models::TokenizationApprovalRequestWebhookEvent, Lithic::Models::TokenizationResultWebhookEvent, Lithic::Models::TokenizationTwoFactorAuthenticationCodeWebhookEvent, Lithic::Models::TokenizationTwoFactorAuthenticationCodeSentWebhookEvent, Lithic::Models::TokenizationUpdatedWebhookEvent, Lithic::Models::ThreeDSAuthenticationApprovalRequestWebhookEvent, Lithic::Models::DisputeTransactionCreatedWebhookEvent, Lithic::Models::DisputeTransactionUpdatedWebhookEvent]
+      # @return [Lithic::ParsedWebhookEvent::Variants]
       def parse_unsafe(payload)
         parsed = JSON.parse(payload, symbolize_names: true)
         Lithic::Internal::Type::Converter.coerce(Lithic::Models::ParsedWebhookEvent, parsed)

data/lib/lithic/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Lithic
-  VERSION = "0.6.0"
+  VERSION = "0.8.0"
 end

data/lib/lithic.rb

@@ -30,6 +30,7 @@ end
 
 # Gems.
 require "connection_pool"
+require "standardwebhooks"
 
 # Package files.
 require_relative "lithic/version"
@@ -114,6 +115,8 @@ require_relative "lithic/models/address_update"
 require_relative "lithic/models/api_status"
 require_relative "lithic/models/auth_rules/auth_rule"
 require_relative "lithic/models/auth_rules/auth_rule_condition"
+require_relative "lithic/models/auth_rules/auth_rule_version"
+require_relative "lithic/models/auth_rules/backtest_stats"
 require_relative "lithic/models/auth_rules/conditional_3ds_action_parameters"
 require_relative "lithic/models/auth_rules/conditional_ach_action_parameters"
 require_relative "lithic/models/auth_rules/conditional_attribute"
@@ -124,7 +127,9 @@ require_relative "lithic/models/auth_rules/conditional_tokenization_action_param
 require_relative "lithic/models/auth_rules/conditional_value"
 require_relative "lithic/models/auth_rules/event_stream"
 require_relative "lithic/models/auth_rules/merchant_lock_parameters"
-require_relative "lithic/models/auth_rules/rule_stats"
+require_relative "lithic/models/auth_rules/report_stats"
+require_relative "lithic/models/auth_rules/rule_feature"
+require_relative "lithic/models/auth_rules/typescript_code_parameters"
 require_relative "lithic/models/auth_rules/v2/backtest_create_params"
 require_relative "lithic/models/auth_rules/v2/backtest_create_response"
 require_relative "lithic/models/auth_rules/v2/backtest_retrieve_params"
@@ -134,6 +139,8 @@ require_relative "lithic/models/auth_rules/v2_draft_params"
 require_relative "lithic/models/auth_rules/v2_list_params"
 require_relative "lithic/models/auth_rules/v2_list_results_params"
 require_relative "lithic/models/auth_rules/v2_list_results_response"
+require_relative "lithic/models/auth_rules/v2_list_versions_params"
+require_relative "lithic/models/auth_rules/v2_list_versions_response"
 require_relative "lithic/models/auth_rules/v2_promote_params"
 require_relative "lithic/models/auth_rules/v2_retrieve_features_params"
 require_relative "lithic/models/auth_rules/v2_retrieve_features_response"
@@ -141,6 +148,7 @@ require_relative "lithic/models/auth_rules/v2_retrieve_params"
 require_relative "lithic/models/auth_rules/v2_retrieve_report_params"
 require_relative "lithic/models/auth_rules/v2_retrieve_report_response"
 require_relative "lithic/models/auth_rules/v2_update_params"
+require_relative "lithic/models/auth_rules/velocity_limit_filters"
 require_relative "lithic/models/auth_rules/velocity_limit_params"
 require_relative "lithic/models/auth_rules/velocity_limit_period"
 require_relative "lithic/models/auth_rules_backtest_report_created_webhook_event"
@@ -319,6 +327,12 @@ require_relative "lithic/models/funding_event_list_params"
 require_relative "lithic/models/funding_event_retrieve_details_params"
 require_relative "lithic/models/funding_event_retrieve_details_response"
 require_relative "lithic/models/funding_event_retrieve_params"
+require_relative "lithic/models/hold"
+require_relative "lithic/models/hold_create_params"
+require_relative "lithic/models/hold_event"
+require_relative "lithic/models/hold_list_params"
+require_relative "lithic/models/hold_retrieve_params"
+require_relative "lithic/models/hold_void_params"
 require_relative "lithic/models/instance_financial_account_type"
 require_relative "lithic/models/internal_transaction_created_webhook_event"
 require_relative "lithic/models/internal_transaction_updated_webhook_event"
@@ -396,7 +410,6 @@ require_relative "lithic/models/tokenization"
 require_relative "lithic/models/tokenization_activate_params"
 require_relative "lithic/models/tokenization_approval_request_webhook_event"
 require_relative "lithic/models/tokenization_deactivate_params"
-require_relative "lithic/models/tokenization_decisioning_request_webhook_event"
 require_relative "lithic/models/tokenization_decisioning_retrieve_secret_params"
 require_relative "lithic/models/tokenization_decisioning_rotate_secret_params"
 require_relative "lithic/models/tokenization_decisioning_rotate_secret_response"
@@ -484,6 +497,7 @@ require_relative "lithic/resources/financial_accounts/statements/line_items"
 require_relative "lithic/resources/fraud"
 require_relative "lithic/resources/fraud/transactions"
 require_relative "lithic/resources/funding_events"
+require_relative "lithic/resources/holds"
 require_relative "lithic/resources/internal_transaction"
 require_relative "lithic/resources/management_operations"
 require_relative "lithic/resources/network_programs"

data/rbi/lithic/client.rbi

@@ -22,6 +22,9 @@ module Lithic
     sig { returns(String) }
     attr_reader :api_key
 
+    sig { returns(T.nilable(String)) }
+    attr_reader :webhook_secret
+
     sig { returns(Lithic::Resources::Accounts) }
     attr_reader :accounts
 
@@ -112,6 +115,9 @@ module Lithic
     sig { returns(Lithic::Resources::NetworkPrograms) }
     attr_reader :network_programs
 
+    sig { returns(Lithic::Resources::Holds) }
+    attr_reader :holds
+
     sig { returns(Lithic::Resources::AccountActivity) }
     attr_reader :account_activity
 
@@ -139,6 +145,7 @@ module Lithic
     sig do
       params(
         api_key: T.nilable(String),
+        webhook_secret: T.nilable(String),
         environment: T.nilable(T.any(Symbol, String)),
         base_url: T.nilable(String),
         max_retries: Integer,
@@ -150,6 +157,8 @@ module Lithic
     def self.new(
       # Defaults to `ENV["LITHIC_API_KEY"]`
       api_key: ENV["LITHIC_API_KEY"],
+      # Defaults to `ENV["LITHIC_WEBHOOK_SECRET"]`
+      webhook_secret: ENV["LITHIC_WEBHOOK_SECRET"],
       # Specifies the environment to use for the API.
       #
       # Each environment maps to a different base URL:

data/rbi/lithic/internal/util.rbi

@@ -301,6 +301,26 @@ module Lithic
         T.let(%r{^application/(:?x-(?:n|l)djson)|(:?(?:x-)?jsonl)}, Regexp)
 
       class << self
+        # @api private
+        sig do
+          params(query: Lithic::Internal::AnyHash).returns(
+            Lithic::Internal::AnyHash
+          )
+        end
+        def encode_query_params(query)
+        end
+
+        # @api private
+        sig do
+          params(
+            collection: Lithic::Internal::AnyHash,
+            key: String,
+            element: T.anything
+          ).void
+        end
+        private def write_query_param_element!(collection, key, element)
+        end
+
         # @api private
         sig do
           params(

data/rbi/lithic/models/account_activity_list_params.rbi

@@ -188,6 +188,11 @@ module Lithic
 
         ACH =
           T.let(:ACH, Lithic::AccountActivityListParams::Category::TaggedSymbol)
+        WIRE =
+          T.let(
+            :WIRE,
+            Lithic::AccountActivityListParams::Category::TaggedSymbol
+          )
         BALANCE_OR_FUNDING =
           T.let(
             :BALANCE_OR_FUNDING,
@@ -275,6 +280,11 @@ module Lithic
             :MANAGEMENT_DISBURSEMENT,
             Lithic::AccountActivityListParams::Category::TaggedSymbol
           )
+        HOLD =
+          T.let(
+            :HOLD,
+            Lithic::AccountActivityListParams::Category::TaggedSymbol
+          )
         PROGRAM_FUNDING =
           T.let(
             :PROGRAM_FUNDING,

data/rbi/lithic/models/account_activity_list_response.rbi

@@ -6,7 +6,8 @@ module Lithic
     # which transaction type is returned: INTERNAL returns FinancialTransaction,
     # TRANSFER returns BookTransferTransaction, CARD returns CardTransaction, PAYMENT
     # returns PaymentTransaction, EXTERNAL_PAYMENT returns ExternalPaymentResponse,
-    # and MANAGEMENT_OPERATION returns ManagementOperationTransaction
+    # MANAGEMENT_OPERATION returns ManagementOperationTransaction, and HOLD returns
+    # HoldTransaction
     module AccountActivityListResponse
       extend Lithic::Internal::Type::Union
 
@@ -18,7 +19,8 @@ module Lithic
             Lithic::Models::AccountActivityListResponse::Card,
             Lithic::Payment,
             Lithic::ExternalPayment,
-            Lithic::ManagementOperationTransaction
+            Lithic::ManagementOperationTransaction,
+            Lithic::Hold
           )
         end
 
@@ -189,6 +191,11 @@ module Lithic
               :ACH,
               Lithic::Models::AccountActivityListResponse::Internal::Category::TaggedSymbol
             )
+          WIRE =
+            T.let(
+              :WIRE,
+              Lithic::Models::AccountActivityListResponse::Internal::Category::TaggedSymbol
+            )
           BALANCE_OR_FUNDING =
             T.let(
               :BALANCE_OR_FUNDING,
@@ -279,6 +286,11 @@ module Lithic
               :MANAGEMENT_DISBURSEMENT,
               Lithic::Models::AccountActivityListResponse::Internal::Category::TaggedSymbol
             )
+          HOLD =
+            T.let(
+              :HOLD,
+              Lithic::Models::AccountActivityListResponse::Internal::Category::TaggedSymbol
+            )
           PROGRAM_FUNDING =
             T.let(
               :PROGRAM_FUNDING,

data/rbi/lithic/models/account_activity_retrieve_transaction_params.rbi

@@ -14,15 +14,23 @@ module Lithic
           )
         end
 
+      sig { returns(String) }
+      attr_accessor :transaction_token
+
       sig do
-        params(request_options: Lithic::RequestOptions::OrHash).returns(
-          T.attached_class
-        )
+        params(
+          transaction_token: String,
+          request_options: Lithic::RequestOptions::OrHash
+        ).returns(T.attached_class)
       end
-      def self.new(request_options: {})
+      def self.new(transaction_token:, request_options: {})
       end
 
-      sig { override.returns({ request_options: Lithic::RequestOptions }) }
+      sig do
+        override.returns(
+          { transaction_token: String, request_options: Lithic::RequestOptions }
+        )
+      end
       def to_hash
       end
     end

data/rbi/lithic/models/account_activity_retrieve_transaction_response.rbi

@@ -6,7 +6,8 @@ module Lithic
     # which transaction type is returned: INTERNAL returns FinancialTransaction,
     # TRANSFER returns BookTransferTransaction, CARD returns CardTransaction, PAYMENT
     # returns PaymentTransaction, EXTERNAL_PAYMENT returns ExternalPaymentResponse,
-    # and MANAGEMENT_OPERATION returns ManagementOperationTransaction
+    # MANAGEMENT_OPERATION returns ManagementOperationTransaction, and HOLD returns
+    # HoldTransaction
     module AccountActivityRetrieveTransactionResponse
       extend Lithic::Internal::Type::Union
 
@@ -18,7 +19,8 @@ module Lithic
             Lithic::Models::AccountActivityRetrieveTransactionResponse::Card,
             Lithic::Payment,
             Lithic::ExternalPayment,
-            Lithic::ManagementOperationTransaction
+            Lithic::ManagementOperationTransaction,
+            Lithic::Hold
           )
         end
 
@@ -189,6 +191,11 @@ module Lithic
               :ACH,
               Lithic::Models::AccountActivityRetrieveTransactionResponse::Internal::Category::TaggedSymbol
             )
+          WIRE =
+            T.let(
+              :WIRE,
+              Lithic::Models::AccountActivityRetrieveTransactionResponse::Internal::Category::TaggedSymbol
+            )
           BALANCE_OR_FUNDING =
             T.let(
               :BALANCE_OR_FUNDING,
@@ -279,6 +286,11 @@ module Lithic
               :MANAGEMENT_DISBURSEMENT,
               Lithic::Models::AccountActivityRetrieveTransactionResponse::Internal::Category::TaggedSymbol
             )
+          HOLD =
+            T.let(
+              :HOLD,
+              Lithic::Models::AccountActivityRetrieveTransactionResponse::Internal::Category::TaggedSymbol
+            )
           PROGRAM_FUNDING =
             T.let(
               :PROGRAM_FUNDING,