lithic 0.13.0 → 0.15.0

data/lib/lithic/models/signals_response.rb

@@ -0,0 +1,306 @@
+# frozen_string_literal: true
+
+module Lithic
+  module Models
+    class SignalsResponse < Lithic::Internal::Type::BaseModel
+      # @!attribute approved_txn_amount_m2
+      #   The Welford M2 accumulator for lifetime approved transaction amounts. Used
+      #   together with `avg_transaction_amount` and `approved_txn_count` to compute the
+      #   z-score of a new transaction amount (variance = M2 / (count - 1)).
+      #
+      #   @return [Float, nil]
+      required :approved_txn_amount_m2, Float, nil?: true
+
+      # @!attribute approved_txn_amount_m2_30d
+      #   The Welford M2 accumulator for approved transaction amounts over the last 30
+      #   days.
+      #
+      #   @return [Float, nil]
+      required :approved_txn_amount_m2_30d, Float, nil?: true
+
+      # @!attribute approved_txn_amount_m2_7d
+      #   The Welford M2 accumulator for approved transaction amounts over the last 7
+      #   days.
+      #
+      #   @return [Float, nil]
+      required :approved_txn_amount_m2_7d, Float, nil?: true
+
+      # @!attribute approved_txn_amount_m2_90d
+      #   The Welford M2 accumulator for approved transaction amounts over the last 90
+      #   days.
+      #
+      #   @return [Float, nil]
+      required :approved_txn_amount_m2_90d, Float, nil?: true
+
+      # @!attribute approved_txn_count
+      #   The total number of approved transactions over the entity's lifetime.
+      #
+      #   @return [Integer, nil]
+      required :approved_txn_count, Integer, nil?: true
+
+      # @!attribute approved_txn_count_30d
+      #   The number of approved transactions in the last 30 days.
+      #
+      #   @return [Integer, nil]
+      required :approved_txn_count_30d, Integer, nil?: true
+
+      # @!attribute approved_txn_count_7d
+      #   The number of approved transactions in the last 7 days.
+      #
+      #   @return [Integer, nil]
+      required :approved_txn_count_7d, Integer, nil?: true
+
+      # @!attribute approved_txn_count_90d
+      #   The number of approved transactions in the last 90 days.
+      #
+      #   @return [Integer, nil]
+      required :approved_txn_count_90d, Integer, nil?: true
+
+      # @!attribute avg_transaction_amount
+      #   The average approved transaction amount over the entity's lifetime, in cents.
+      #   Null if fewer than 5 approved transactions have been recorded.
+      #
+      #   @return [Float, nil]
+      required :avg_transaction_amount, Float, nil?: true
+
+      # @!attribute avg_transaction_amount_30d
+      #   The average approved transaction amount over the last 30 days, in cents. Null if
+      #   fewer than 5 approved transactions in window.
+      #
+      #   @return [Float, nil]
+      required :avg_transaction_amount_30d, Float, nil?: true
+
+      # @!attribute avg_transaction_amount_7d
+      #   The average approved transaction amount over the last 7 days, in cents. Null if
+      #   fewer than 5 approved transactions in window.
+      #
+      #   @return [Float, nil]
+      required :avg_transaction_amount_7d, Float, nil?: true
+
+      # @!attribute avg_transaction_amount_90d
+      #   The average approved transaction amount over the last 90 days, in cents. Null if
+      #   fewer than 5 approved transactions in window.
+      #
+      #   @return [Float, nil]
+      required :avg_transaction_amount_90d, Float, nil?: true
+
+      # @!attribute distinct_country_count
+      #   The number of distinct merchant countries seen in the entity's transaction
+      #   history.
+      #
+      #   @return [Integer, nil]
+      required :distinct_country_count, Integer, nil?: true
+
+      # @!attribute distinct_mcc_count
+      #   The number of distinct MCCs seen in the entity's transaction history.
+      #
+      #   @return [Integer, nil]
+      required :distinct_mcc_count, Integer, nil?: true
+
+      # @!attribute first_txn_at
+      #   The timestamp of the first approved transaction for the entity, in ISO 8601
+      #   format.
+      #
+      #   @return [Time, nil]
+      required :first_txn_at, Time, nil?: true
+
+      # @!attribute is_first_transaction
+      #   Whether the entity has no prior transaction history. Returns true if no history
+      #   is found. Null if transaction history exists but a first transaction timestamp
+      #   is unavailable.
+      #
+      #   @return [Boolean, nil]
+      required :is_first_transaction, Lithic::Internal::Type::Boolean, nil?: true
+
+      # @!attribute last_cp_country
+      #   The merchant country of the last card-present transaction.
+      #
+      #   @return [String, nil]
+      required :last_cp_country, String, nil?: true
+
+      # @!attribute last_cp_postal_code
+      #   The merchant postal code of the last card-present transaction.
+      #
+      #   @return [String, nil]
+      required :last_cp_postal_code, String, nil?: true
+
+      # @!attribute last_cp_timestamp
+      #   The timestamp of the last card-present transaction, in ISO 8601 format.
+      #
+      #   @return [Time, nil]
+      required :last_cp_timestamp, Time, nil?: true
+
+      # @!attribute last_txn_approved_at
+      #   The timestamp of the most recent approved transaction for the entity, in ISO
+      #   8601 format.
+      #
+      #   @return [Time, nil]
+      required :last_txn_approved_at, Time, nil?: true
+
+      # @!attribute seen_countries
+      #   The set of merchant countries seen in the entity's transaction history. Clients
+      #   can use this to determine whether a new transaction's country is novel (i.e.
+      #   compute `is_new_country`).
+      #
+      #   @return [Array<String>, nil]
+      required :seen_countries, Lithic::Internal::Type::ArrayOf[String], nil?: true
+
+      # @!attribute seen_mccs
+      #   The set of MCCs seen in the entity's transaction history. Clients can use this
+      #   to determine whether a new transaction's MCC is novel (i.e. compute
+      #   `is_new_mcc`).
+      #
+      #   @return [Array<String>, nil]
+      required :seen_mccs, Lithic::Internal::Type::ArrayOf[String], nil?: true
+
+      # @!attribute seen_merchants
+      #   The set of card acceptor IDs seen in the card's approved transaction history,
+      #   capped at the 1000 most recently seen. Null for account responses. Clients can
+      #   use this to determine whether a new transaction's merchant is novel (i.e.
+      #   compute `is_new_merchant`).
+      #
+      #   @return [Array<String>, nil]
+      required :seen_merchants, Lithic::Internal::Type::ArrayOf[String], nil?: true
+
+      # @!attribute stdev_transaction_amount
+      #   The standard deviation of approved transaction amounts over the entity's
+      #   lifetime, in cents. Null if fewer than 30 approved transactions have been
+      #   recorded.
+      #
+      #   @return [Float, nil]
+      required :stdev_transaction_amount, Float, nil?: true
+
+      # @!attribute stdev_transaction_amount_30d
+      #   The standard deviation of approved transaction amounts over the last 30 days, in
+      #   cents. Null if fewer than 30 approved transactions in window.
+      #
+      #   @return [Float, nil]
+      required :stdev_transaction_amount_30d, Float, nil?: true
+
+      # @!attribute stdev_transaction_amount_7d
+      #   The standard deviation of approved transaction amounts over the last 7 days, in
+      #   cents. Null if fewer than 30 approved transactions in window.
+      #
+      #   @return [Float, nil]
+      required :stdev_transaction_amount_7d, Float, nil?: true
+
+      # @!attribute stdev_transaction_amount_90d
+      #   The standard deviation of approved transaction amounts over the last 90 days, in
+      #   cents. Null if fewer than 30 approved transactions in window.
+      #
+      #   @return [Float, nil]
+      required :stdev_transaction_amount_90d, Float, nil?: true
+
+      # @!attribute three_ds_success_count
+      #   The number of successful 3DS authentications for the card. Null for account
+      #   responses.
+      #
+      #   @return [Integer, nil]
+      required :three_ds_success_count, Integer, nil?: true
+
+      # @!attribute three_ds_success_rate
+      #   The 3DS authentication success rate for the card, as a percentage from 0.0 to
+      #   100.0. Null for account responses.
+      #
+      #   @return [Float, nil]
+      required :three_ds_success_rate, Float, nil?: true
+
+      # @!attribute three_ds_total_count
+      #   The total number of 3DS authentication attempts for the card. Null for account
+      #   responses.
+      #
+      #   @return [Integer, nil]
+      required :three_ds_total_count, Integer, nil?: true
+
+      # @!attribute time_since_last_transaction_days
+      #   The number of days since the last approved transaction on the entity.
+      #
+      #   @return [Float, nil]
+      required :time_since_last_transaction_days, Float, nil?: true
+
+      # @!method initialize(approved_txn_amount_m2:, approved_txn_amount_m2_30d:, approved_txn_amount_m2_7d:, approved_txn_amount_m2_90d:, approved_txn_count:, approved_txn_count_30d:, approved_txn_count_7d:, approved_txn_count_90d:, avg_transaction_amount:, avg_transaction_amount_30d:, avg_transaction_amount_7d:, avg_transaction_amount_90d:, distinct_country_count:, distinct_mcc_count:, first_txn_at:, is_first_transaction:, last_cp_country:, last_cp_postal_code:, last_cp_timestamp:, last_txn_approved_at:, seen_countries:, seen_mccs:, seen_merchants:, stdev_transaction_amount:, stdev_transaction_amount_30d:, stdev_transaction_amount_7d:, stdev_transaction_amount_90d:, three_ds_success_count:, three_ds_success_rate:, three_ds_total_count:, time_since_last_transaction_days:)
+      #   Some parameter documentations has been truncated, see
+      #   {Lithic::Models::SignalsResponse} for more details.
+      #
+      #   Behavioral feature state for a card or account derived from its transaction
+      #   history.
+      #
+      #   Derived statistical features (averages, standard deviations, z-scores) are
+      #   computed using Welford's online algorithm over approved transactions. Average
+      #   fields are null when fewer than 5 approved transactions have been recorded.
+      #   Standard deviation fields are null when fewer than 30 approved transactions have
+      #   been recorded.
+      #
+      #   3DS fields (`three_ds_success_rate`, `three_ds_success_count`,
+      #   `three_ds_total_count`) are card-scoped and will be null for account responses.
+      #
+      #   Raw fields (`seen_countries`, `seen_mccs`, `approved_txn_amount_m2`, etc.) are
+      #   included so clients can compute their own transaction-specific derivations, such
+      #   as checking whether a new transaction's country is in `seen_countries` to
+      #   determine `is_new_country`, or computing a z-score using the raw mean and M2
+      #   values.
+      #
+      #   @param approved_txn_amount_m2 [Float, nil] The Welford M2 accumulator for lifetime approved transaction amounts. Used toget
+      #
+      #   @param approved_txn_amount_m2_30d [Float, nil] The Welford M2 accumulator for approved transaction amounts over the last 30 day
+      #
+      #   @param approved_txn_amount_m2_7d [Float, nil] The Welford M2 accumulator for approved transaction amounts over the last 7 days
+      #
+      #   @param approved_txn_amount_m2_90d [Float, nil] The Welford M2 accumulator for approved transaction amounts over the last 90 day
+      #
+      #   @param approved_txn_count [Integer, nil] The total number of approved transactions over the entity's lifetime.
+      #
+      #   @param approved_txn_count_30d [Integer, nil] The number of approved transactions in the last 30 days.
+      #
+      #   @param approved_txn_count_7d [Integer, nil] The number of approved transactions in the last 7 days.
+      #
+      #   @param approved_txn_count_90d [Integer, nil] The number of approved transactions in the last 90 days.
+      #
+      #   @param avg_transaction_amount [Float, nil] The average approved transaction amount over the entity's lifetime, in cents. Nu
+      #
+      #   @param avg_transaction_amount_30d [Float, nil] The average approved transaction amount over the last 30 days, in cents. Null if
+      #
+      #   @param avg_transaction_amount_7d [Float, nil] The average approved transaction amount over the last 7 days, in cents. Null if
+      #
+      #   @param avg_transaction_amount_90d [Float, nil] The average approved transaction amount over the last 90 days, in cents. Null if
+      #
+      #   @param distinct_country_count [Integer, nil] The number of distinct merchant countries seen in the entity's transaction histo
+      #
+      #   @param distinct_mcc_count [Integer, nil] The number of distinct MCCs seen in the entity's transaction history.
+      #
+      #   @param first_txn_at [Time, nil] The timestamp of the first approved transaction for the entity, in ISO 8601 form
+      #
+      #   @param is_first_transaction [Boolean, nil] Whether the entity has no prior transaction history. Returns true if no history
+      #
+      #   @param last_cp_country [String, nil] The merchant country of the last card-present transaction.
+      #
+      #   @param last_cp_postal_code [String, nil] The merchant postal code of the last card-present transaction.
+      #
+      #   @param last_cp_timestamp [Time, nil] The timestamp of the last card-present transaction, in ISO 8601 format.
+      #
+      #   @param last_txn_approved_at [Time, nil] The timestamp of the most recent approved transaction for the entity, in ISO 860
+      #
+      #   @param seen_countries [Array<String>, nil] The set of merchant countries seen in the entity's transaction history. Clients
+      #
+      #   @param seen_mccs [Array<String>, nil] The set of MCCs seen in the entity's transaction history. Clients can use this t
+      #
+      #   @param seen_merchants [Array<String>, nil] The set of card acceptor IDs seen in the card's approved transaction history, ca
+      #
+      #   @param stdev_transaction_amount [Float, nil] The standard deviation of approved transaction amounts over the entity's lifetim
+      #
+      #   @param stdev_transaction_amount_30d [Float, nil] The standard deviation of approved transaction amounts over the last 30 days, in
+      #
+      #   @param stdev_transaction_amount_7d [Float, nil] The standard deviation of approved transaction amounts over the last 7 days, in
+      #
+      #   @param stdev_transaction_amount_90d [Float, nil] The standard deviation of approved transaction amounts over the last 90 days, in
+      #
+      #   @param three_ds_success_count [Integer, nil] The number of successful 3DS authentications for the card. Null for account resp
+      #
+      #   @param three_ds_success_rate [Float, nil] The 3DS authentication success rate for the card, as a percentage from 0.0 to 10
+      #
+      #   @param three_ds_total_count [Integer, nil] The total number of 3DS authentication attempts for the card. Null for account r
+      #
+      #   @param time_since_last_transaction_days [Float, nil] The number of days since the last approved transaction on the entity.
+    end
+  end
+end

data/lib/lithic/models/statement_totals.rb

@@ -56,19 +56,19 @@ module Lithic
       #   Breakdown of credits
       #
       #   @return [Object, nil]
-      optional :credit_details, Lithic::Internal::Type::Unknown
+      optional :credit_details, Lithic::Internal::Type::Unknown, nil?: true
 
       # @!attribute debit_details
       #   Breakdown of debits
       #
       #   @return [Object, nil]
-      optional :debit_details, Lithic::Internal::Type::Unknown
+      optional :debit_details, Lithic::Internal::Type::Unknown, nil?: true
 
       # @!attribute payment_details
       #   Breakdown of payments
       #
       #   @return [Object, nil]
-      optional :payment_details, Lithic::Internal::Type::Unknown
+      optional :payment_details, Lithic::Internal::Type::Unknown, nil?: true
 
       # @!method initialize(balance_transfers:, cash_advances:, credits:, debits:, fees:, interest:, payments:, purchases:, credit_details: nil, debit_details: nil, payment_details: nil)
       #   Some parameter documentations has been truncated, see
@@ -90,11 +90,11 @@ module Lithic
       #
       #   @param purchases [Integer] Net card transaction volume less any cash advances in cents
       #
-      #   @param credit_details [Object] Breakdown of credits
+      #   @param credit_details [Object, nil] Breakdown of credits
       #
-      #   @param debit_details [Object] Breakdown of debits
+      #   @param debit_details [Object, nil] Breakdown of debits
       #
-      #   @param payment_details [Object] Breakdown of payments
+      #   @param payment_details [Object, nil] Breakdown of payments
     end
   end
 end

data/lib/lithic/models/tokenization_decline_reason.rb

@@ -19,6 +19,7 @@ module Lithic
       NETWORK_FAILURE = :NETWORK_FAILURE
       GENERIC_DECLINE = :GENERIC_DECLINE
       DIGITAL_CARD_ART_REQUIRED = :DIGITAL_CARD_ART_REQUIRED
+      INVALID_PAN = :INVALID_PAN
 
       # @!method self.values
       #   @return [Array<Symbol>]

data/lib/lithic/models/transaction.rb

@@ -874,7 +874,7 @@ module Lithic
         # @!attribute network_specific_data
         #
         #   @return [Lithic::Models::Transaction::Event::NetworkSpecificData, nil]
-        optional :network_specific_data, -> { Lithic::Transaction::Event::NetworkSpecificData }
+        optional :network_specific_data, -> { Lithic::Transaction::Event::NetworkSpecificData }, nil?: true
 
         # @!method initialize(token:, amount:, amounts:, created:, detailed_results:, effective_polarity:, network_info:, result:, rule_results:, type:, account_type: nil, network_specific_data: nil)
         #   Some parameter documentations has been truncated, see
@@ -902,7 +902,7 @@ module Lithic
         #
         #   @param account_type [Symbol, Lithic::Models::Transaction::Event::AccountType]
         #
-        #   @param network_specific_data [Lithic::Models::Transaction::Event::NetworkSpecificData]
+        #   @param network_specific_data [Lithic::Models::Transaction::Event::NetworkSpecificData, nil]
 
         # @see Lithic::Models::Transaction::Event#amounts
         class Amounts < Lithic::Internal::Type::BaseModel

data/lib/lithic/models/transfer_limits_response.rb

@@ -104,14 +104,14 @@ module Lithic
             #   Amount originated towards limit
             #
             #   @return [Integer, nil]
-            optional :amount_originated, Integer
+            optional :amount_originated, Integer, nil?: true
 
             # @!method initialize(limit:, amount_originated: nil)
             #   Credit limits
             #
             #   @param limit [Integer] The limit amount
             #
-            #   @param amount_originated [Integer] Amount originated towards limit
+            #   @param amount_originated [Integer, nil] Amount originated towards limit
           end
 
           # @see Lithic::Models::TransferLimitsResponse::Data::DailyLimit#debit
@@ -126,14 +126,14 @@ module Lithic
             #   Amount originated towards limit
             #
             #   @return [Integer, nil]
-            optional :amount_originated, Integer
+            optional :amount_originated, Integer, nil?: true
 
             # @!method initialize(limit:, amount_originated: nil)
             #   Debit limits
             #
             #   @param limit [Integer] The limit amount
             #
-            #   @param amount_originated [Integer] Amount originated towards limit
+            #   @param amount_originated [Integer, nil] Amount originated towards limit
           end
         end
 
@@ -170,14 +170,14 @@ module Lithic
             #   Amount originated towards limit
             #
             #   @return [Integer, nil]
-            optional :amount_originated, Integer
+            optional :amount_originated, Integer, nil?: true
 
             # @!method initialize(limit:, amount_originated: nil)
             #   Credit limits
             #
             #   @param limit [Integer] The limit amount
             #
-            #   @param amount_originated [Integer] Amount originated towards limit
+            #   @param amount_originated [Integer, nil] Amount originated towards limit
           end
 
           # @see Lithic::Models::TransferLimitsResponse::Data::MonthlyLimit#debit
@@ -192,14 +192,14 @@ module Lithic
             #   Amount originated towards limit
             #
             #   @return [Integer, nil]
-            optional :amount_originated, Integer
+            optional :amount_originated, Integer, nil?: true
 
             # @!method initialize(limit:, amount_originated: nil)
             #   Debit limits
             #
             #   @param limit [Integer] The limit amount
             #
-            #   @param amount_originated [Integer] Amount originated towards limit
+            #   @param amount_originated [Integer, nil] Amount originated towards limit
           end
         end
 
@@ -236,14 +236,14 @@ module Lithic
             #   Amount originated towards limit
             #
             #   @return [Integer, nil]
-            optional :amount_originated, Integer
+            optional :amount_originated, Integer, nil?: true
 
             # @!method initialize(limit:, amount_originated: nil)
             #   Credit limits
             #
             #   @param limit [Integer] The limit amount
             #
-            #   @param amount_originated [Integer] Amount originated towards limit
+            #   @param amount_originated [Integer, nil] Amount originated towards limit
           end
 
           # @see Lithic::Models::TransferLimitsResponse::Data::ProgramLimitPerTransaction#debit
@@ -258,14 +258,14 @@ module Lithic
             #   Amount originated towards limit
             #
             #   @return [Integer, nil]
-            optional :amount_originated, Integer
+            optional :amount_originated, Integer, nil?: true
 
             # @!method initialize(limit:, amount_originated: nil)
             #   Debit limits
             #
             #   @param limit [Integer] The limit amount
             #
-            #   @param amount_originated [Integer] Amount originated towards limit
+            #   @param amount_originated [Integer, nil] Amount originated towards limit
           end
         end
       end

data/lib/lithic/models.rb

@@ -82,6 +82,8 @@ module Lithic
 
   AccountRetrieveParams = Lithic::Models::AccountRetrieveParams
 
+  AccountRetrieveSignalsParams = Lithic::Models::AccountRetrieveSignalsParams
+
   AccountRetrieveSpendLimitsParams = Lithic::Models::AccountRetrieveSpendLimitsParams
 
   AccountSpendLimits = Lithic::Models::AccountSpendLimits
@@ -128,12 +130,18 @@ module Lithic
 
   Card = Lithic::Models::Card
 
+  CardAuthorization = Lithic::Models::CardAuthorization
+
   CardAuthorizationApprovalRequestWebhookEvent =
     Lithic::Models::CardAuthorizationApprovalRequestWebhookEvent
 
+  CardAuthorizationChallengeResponseParams = Lithic::Models::CardAuthorizationChallengeResponseParams
+
   CardAuthorizationChallengeResponseWebhookEvent =
     Lithic::Models::CardAuthorizationChallengeResponseWebhookEvent
 
+  CardAuthorizationChallengeWebhookEvent = Lithic::Models::CardAuthorizationChallengeWebhookEvent
+
   CardBulkOrder = Lithic::Models::CardBulkOrder
 
   CardBulkOrderCreateParams = Lithic::Models::CardBulkOrderCreateParams
@@ -176,6 +184,8 @@ module Lithic
 
   CardRetrieveParams = Lithic::Models::CardRetrieveParams
 
+  CardRetrieveSignalsParams = Lithic::Models::CardRetrieveSignalsParams
+
   CardRetrieveSpendLimitsParams = Lithic::Models::CardRetrieveSpendLimitsParams
 
   Cards = Lithic::Models::Cards
@@ -292,6 +302,8 @@ module Lithic
 
   ExternalBankAccountListParams = Lithic::Models::ExternalBankAccountListParams
 
+  ExternalBankAccountPauseParams = Lithic::Models::ExternalBankAccountPauseParams
+
   ExternalBankAccountRetrieveParams = Lithic::Models::ExternalBankAccountRetrieveParams
 
   ExternalBankAccountRetryMicroDepositsParams = Lithic::Models::ExternalBankAccountRetryMicroDepositsParams
@@ -487,6 +499,8 @@ module Lithic
 
   ShippingAddress = Lithic::Models::ShippingAddress
 
+  SignalsResponse = Lithic::Models::SignalsResponse
+
   SpendLimitDuration = Lithic::Models::SpendLimitDuration
 
   StatementsCreatedWebhookEvent = Lithic::Models::StatementsCreatedWebhookEvent

data/lib/lithic/resources/accounts.rb

@@ -99,6 +99,33 @@ module Lithic
         )
       end
 
+      # Returns behavioral feature state derived from an account's transaction history.
+      #
+      # These signals expose the same data used by behavioral rule attributes (e.g.
+      # `AMOUNT_Z_SCORE` with `scope: ACCOUNT`, `IS_NEW_COUNTRY` with `scope: ACCOUNT`)
+      # and custom code `TRANSACTION_HISTORY_SIGNALS` features, allowing clients to
+      # inspect feature values before writing rules and debug rule behavior.
+      #
+      # Note: 3DS fields are not available at the account scope and will be null.
+      #
+      # @overload retrieve_signals(account_token, request_options: {})
+      #
+      # @param account_token [String] The token of the account to fetch signals for.
+      #
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Lithic::Models::SignalsResponse]
+      #
+      # @see Lithic::Models::AccountRetrieveSignalsParams
+      def retrieve_signals(account_token, params = {})
+        @client.request(
+          method: :get,
+          path: ["v1/accounts/%1$s/signals", account_token],
+          model: Lithic::SignalsResponse,
+          options: params[:request_options]
+        )
+      end
+
       # Get an Account's available spend limits, which is based on the spend limit
       # configured on the Account and the amount already spent over the spend limit's
       # duration. For example, if the Account has a daily spend limit of $1000

data/lib/lithic/resources/auth_rules/v2.rb

@@ -144,7 +144,7 @@ module Lithic
         #
         # @param auth_rule_token [String]
         #
-        # @param parameters [Lithic::Models::AuthRules::ConditionalBlockParameters, Lithic::Models::AuthRules::VelocityLimitParams, Lithic::Models::AuthRules::MerchantLockParameters, Lithic::Models::AuthRules::Conditional3DSActionParameters, Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters, Lithic::Models::AuthRules::ConditionalACHActionParameters, Lithic::Models::AuthRules::ConditionalTokenizationActionParameters, Lithic::Models::AuthRules::ConditionalCardTransactionUpdateActionParameters, Lithic::Models::AuthRules::TypescriptCodeParameters, nil] Parameters for the Auth Rule
+        # @param parameters [Lithic::Models::AuthRules::ConditionalBlockParameters, Lithic::Models::AuthRules::VelocityLimitParams, Lithic::Models::AuthRules::MerchantLockParameters, Lithic::Models::AuthRules::Conditional3DSActionParameters, Lithic::Models::AuthRules::ConditionalAuthorizationActionParameters, Lithic::Models::AuthRules::ConditionalACHActionParameters, Lithic::Models::AuthRules::ConditionalTokenizationActionParameters, Lithic::Models::AuthRules::ConditionalCardTransactionUpdateActionParameters, Lithic::Models::AuthRules::TypescriptCodeParameters, Lithic::Models::AuthRules::ConditionalAuthorizationAdjustmentParameters, nil] Parameters for the Auth Rule
         #
         # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
         #

data/lib/lithic/resources/card_authorizations.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Lithic
+  module Resources
+    class CardAuthorizations
+      # Some parameter documentations has been truncated, see
+      # {Lithic::Models::CardAuthorizationChallengeResponseParams} for more details.
+      #
+      # Card program's response to Authorization Challenge. Programs that have
+      # Authorization Challenges configured as Out of Band receive a
+      # [card_authorization.challenge](https://docs.lithic.com/reference/post_card-authorization-challenge)
+      # webhook when an authorization attempt triggers a challenge. The card program
+      # should respond using this endpoint after the cardholder completes the challenge.
+      #
+      # @overload challenge_response(event_token, response:, request_options: {})
+      #
+      # @param event_token [String] Globally unique identifier for the authorization event that triggered the challe
+      #
+      # @param response [Symbol, Lithic::Models::CardAuthorizationChallengeResponseParams::Response] Whether the cardholder has approved or declined the issued challenge
+      #
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [nil]
+      #
+      # @see Lithic::Models::CardAuthorizationChallengeResponseParams
+      def challenge_response(event_token, params)
+        parsed, options = Lithic::CardAuthorizationChallengeResponseParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: ["v1/card_authorizations/%1$s/challenge_response", event_token],
+          body: parsed,
+          model: NilClass,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Lithic::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/lithic/resources/cards.rb

@@ -404,6 +404,31 @@ module Lithic
         )
       end
 
+      # Returns behavioral feature state derived from a card's transaction history.
+      #
+      # These signals expose the same data used by behavioral rule attributes (e.g.
+      # `AMOUNT_Z_SCORE` with `scope: CARD`, `IS_NEW_COUNTRY` with `scope: CARD`) and
+      # custom code `TRANSACTION_HISTORY_SIGNALS` features, allowing clients to inspect
+      # feature values before writing rules and debug rule behavior.
+      #
+      # @overload retrieve_signals(card_token, request_options: {})
+      #
+      # @param card_token [String] The token of the card to fetch signals for.
+      #
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Lithic::Models::SignalsResponse]
+      #
+      # @see Lithic::Models::CardRetrieveSignalsParams
+      def retrieve_signals(card_token, params = {})
+        @client.request(
+          method: :get,
+          path: ["v1/cards/%1$s/signals", card_token],
+          model: Lithic::SignalsResponse,
+          options: params[:request_options]
+        )
+      end
+
       # Get a Card's available spend limit, which is based on the spend limit configured
       # on the Card and the amount already spent over the spend limit's duration. For
       # example, if the Card has a monthly spend limit of $1000 configured, and has

data/lib/lithic/resources/external_bank_accounts.rb

@@ -132,6 +132,25 @@ module Lithic
         )
       end
 
+      # Pause an external bank account
+      #
+      # @overload pause(external_bank_account_token, request_options: {})
+      #
+      # @param external_bank_account_token [String]
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Lithic::Models::ExternalBankAccount]
+      #
+      # @see Lithic::Models::ExternalBankAccountPauseParams
+      def pause(external_bank_account_token, params = {})
+        @client.request(
+          method: :post,
+          path: ["v1/external_bank_accounts/%1$s/pause", external_bank_account_token],
+          model: Lithic::ExternalBankAccount,
+          options: params[:request_options]
+        )
+      end
+
       # Retry external bank account micro deposit verification.
       #
       # @overload retry_micro_deposits(external_bank_account_token, financial_account_token: nil, request_options: {})