lithic 0.10.0 → 0.12.0

data/rbi/lithic/models/event_subscription.rbi

@@ -86,6 +86,8 @@ module Lithic
       #   created.
       # - book_transfer_transaction.updated: Occurs when a book transfer transaction is
       #   updated.
+      # - card_authorization.challenge_response: Occurs when a cardholder responds to an
+      #   SMS challenge during card authorization.
       # - card_transaction.enhanced_data.created: Occurs when L2/L3 enhanced commercial
       #   data is processed for a transaction event.
       # - card_transaction.enhanced_data.updated: Occurs when L2/L3 enhanced commercial
@@ -217,6 +219,11 @@ module Lithic
             :"book_transfer_transaction.updated",
             Lithic::EventSubscription::EventType::TaggedSymbol
           )
+        CARD_AUTHORIZATION_CHALLENGE_RESPONSE =
+          T.let(
+            :"card_authorization.challenge_response",
+            Lithic::EventSubscription::EventType::TaggedSymbol
+          )
         CARD_TRANSACTION_ENHANCED_DATA_CREATED =
           T.let(
             :"card_transaction.enhanced_data.created",

data/rbi/lithic/models/events/subscription_create_params.rbi

@@ -113,6 +113,8 @@ module Lithic
         #   created.
         # - book_transfer_transaction.updated: Occurs when a book transfer transaction is
         #   updated.
+        # - card_authorization.challenge_response: Occurs when a cardholder responds to an
+        #   SMS challenge during card authorization.
         # - card_transaction.enhanced_data.created: Occurs when L2/L3 enhanced commercial
         #   data is processed for a transaction event.
         # - card_transaction.enhanced_data.updated: Occurs when L2/L3 enhanced commercial
@@ -246,6 +248,11 @@ module Lithic
               :"book_transfer_transaction.updated",
               Lithic::Events::SubscriptionCreateParams::EventType::TaggedSymbol
             )
+          CARD_AUTHORIZATION_CHALLENGE_RESPONSE =
+            T.let(
+              :"card_authorization.challenge_response",
+              Lithic::Events::SubscriptionCreateParams::EventType::TaggedSymbol
+            )
           CARD_TRANSACTION_ENHANCED_DATA_CREATED =
             T.let(
               :"card_transaction.enhanced_data.created",

data/rbi/lithic/models/events/subscription_send_simulated_example_params.rbi

@@ -118,6 +118,11 @@ module Lithic
               :"book_transfer_transaction.updated",
               Lithic::Events::SubscriptionSendSimulatedExampleParams::EventType::TaggedSymbol
             )
+          CARD_AUTHORIZATION_CHALLENGE_RESPONSE =
+            T.let(
+              :"card_authorization.challenge_response",
+              Lithic::Events::SubscriptionSendSimulatedExampleParams::EventType::TaggedSymbol
+            )
           CARD_TRANSACTION_ENHANCED_DATA_CREATED =
             T.let(
               :"card_transaction.enhanced_data.created",

data/rbi/lithic/models/events/subscription_update_params.rbi

@@ -119,6 +119,8 @@ module Lithic
         #   created.
         # - book_transfer_transaction.updated: Occurs when a book transfer transaction is
         #   updated.
+        # - card_authorization.challenge_response: Occurs when a cardholder responds to an
+        #   SMS challenge during card authorization.
         # - card_transaction.enhanced_data.created: Occurs when L2/L3 enhanced commercial
         #   data is processed for a transaction event.
         # - card_transaction.enhanced_data.updated: Occurs when L2/L3 enhanced commercial
@@ -252,6 +254,11 @@ module Lithic
               :"book_transfer_transaction.updated",
               Lithic::Events::SubscriptionUpdateParams::EventType::TaggedSymbol
             )
+          CARD_AUTHORIZATION_CHALLENGE_RESPONSE =
+            T.let(
+              :"card_authorization.challenge_response",
+              Lithic::Events::SubscriptionUpdateParams::EventType::TaggedSymbol
+            )
           CARD_TRANSACTION_ENHANCED_DATA_CREATED =
             T.let(
               :"card_transaction.enhanced_data.created",

data/rbi/lithic/models/external_bank_account_set_verification_method_params.rbi

@@ -0,0 +1,111 @@
+# typed: strong
+
+module Lithic
+  module Models
+    class ExternalBankAccountSetVerificationMethodParams < Lithic::Internal::Type::BaseModel
+      extend Lithic::Internal::Type::RequestParameters::Converter
+      include Lithic::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(
+            Lithic::ExternalBankAccountSetVerificationMethodParams,
+            Lithic::Internal::AnyHash
+          )
+        end
+
+      sig { returns(String) }
+      attr_accessor :external_bank_account_token
+
+      # The verification method to set for the external bank account
+      sig do
+        returns(
+          Lithic::ExternalBankAccountSetVerificationMethodParams::VerificationMethod::OrSymbol
+        )
+      end
+      attr_accessor :verification_method
+
+      # The financial account token of the operating account to fund the micro deposits.
+      # Required when verification_method is MICRO_DEPOSIT or PRENOTE.
+      sig { returns(T.nilable(String)) }
+      attr_reader :financial_account_token
+
+      sig { params(financial_account_token: String).void }
+      attr_writer :financial_account_token
+
+      sig do
+        params(
+          external_bank_account_token: String,
+          verification_method:
+            Lithic::ExternalBankAccountSetVerificationMethodParams::VerificationMethod::OrSymbol,
+          financial_account_token: String,
+          request_options: Lithic::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        external_bank_account_token:,
+        # The verification method to set for the external bank account
+        verification_method:,
+        # The financial account token of the operating account to fund the micro deposits.
+        # Required when verification_method is MICRO_DEPOSIT or PRENOTE.
+        financial_account_token: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            external_bank_account_token: String,
+            verification_method:
+              Lithic::ExternalBankAccountSetVerificationMethodParams::VerificationMethod::OrSymbol,
+            financial_account_token: String,
+            request_options: Lithic::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+
+      # The verification method to set for the external bank account
+      module VerificationMethod
+        extend Lithic::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(
+              Symbol,
+              Lithic::ExternalBankAccountSetVerificationMethodParams::VerificationMethod
+            )
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        MICRO_DEPOSIT =
+          T.let(
+            :MICRO_DEPOSIT,
+            Lithic::ExternalBankAccountSetVerificationMethodParams::VerificationMethod::TaggedSymbol
+          )
+        PRENOTE =
+          T.let(
+            :PRENOTE,
+            Lithic::ExternalBankAccountSetVerificationMethodParams::VerificationMethod::TaggedSymbol
+          )
+        EXTERNALLY_VERIFIED =
+          T.let(
+            :EXTERNALLY_VERIFIED,
+            Lithic::ExternalBankAccountSetVerificationMethodParams::VerificationMethod::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Lithic::ExternalBankAccountSetVerificationMethodParams::VerificationMethod::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/lithic/models/financial_account.rbi

@@ -349,6 +349,11 @@ module Lithic
             :EARLY_DIRECT_DEPOSIT_FLOAT,
             Lithic::FinancialAccount::Type::TaggedSymbol
           )
+        PROVISIONAL_CREDIT_ACCOUNT =
+          T.let(
+            :PROVISIONAL_CREDIT_ACCOUNT,
+            Lithic::FinancialAccount::Type::TaggedSymbol
+          )
 
         sig do
           override.returns(

data/rbi/lithic/models/financial_account_update_status_params.rbi

@@ -159,6 +159,11 @@ module Lithic
             :INTEREST_AND_FEES_PAUSED,
             Lithic::FinancialAccountUpdateStatusParams::Substatus::TaggedSymbol
           )
+        DELINQUENT =
+          T.let(
+            :DELINQUENT,
+            Lithic::FinancialAccountUpdateStatusParams::Substatus::TaggedSymbol
+          )
 
         sig do
           override.returns(

data/rbi/lithic/models/financial_accounts/statement.rbi

@@ -50,7 +50,7 @@ module Lithic
         attr_accessor :credit_limit
 
         # Globally unique identifier for a credit product
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :credit_product_token
 
         # Number of days in the billing cycle
@@ -154,6 +154,12 @@ module Lithic
         end
         attr_writer :payoff_details
 
+        sig { returns(T.nilable(Lithic::StatementTotals)) }
+        attr_reader :statement_totals
+
+        sig { params(statement_totals: Lithic::StatementTotals::OrHash).void }
+        attr_writer :statement_totals
+
         sig do
           params(
             token: String,
@@ -163,7 +169,7 @@ module Lithic
             available_credit: Integer,
             created: Time,
             credit_limit: Integer,
-            credit_product_token: String,
+            credit_product_token: T.nilable(String),
             days_in_billing_cycle: Integer,
             ending_balance: Integer,
             financial_account_token: String,
@@ -185,7 +191,8 @@ module Lithic
             payoff_details:
               T.nilable(
                 Lithic::FinancialAccounts::Statement::PayoffDetails::OrHash
-              )
+              ),
+            statement_totals: Lithic::StatementTotals::OrHash
           ).returns(T.attached_class)
         end
         def self.new(
@@ -227,7 +234,8 @@ module Lithic
           # Date when the next billing period will end
           next_statement_end_date: nil,
           # Details on number and size of payments to pay off balance
-          payoff_details: nil
+          payoff_details: nil,
+          statement_totals: nil
         )
         end
 
@@ -241,7 +249,7 @@ module Lithic
               available_credit: Integer,
               created: Time,
               credit_limit: Integer,
-              credit_product_token: String,
+              credit_product_token: T.nilable(String),
               days_in_billing_cycle: Integer,
               ending_balance: Integer,
               financial_account_token: String,
@@ -261,7 +269,8 @@ module Lithic
               next_payment_due_date: Date,
               next_statement_end_date: Date,
               payoff_details:
-                T.nilable(Lithic::FinancialAccounts::Statement::PayoffDetails)
+                T.nilable(Lithic::FinancialAccounts::Statement::PayoffDetails),
+              statement_totals: Lithic::StatementTotals
             }
           )
         end

data/rbi/lithic/models/instance_financial_account_type.rbi

@@ -50,6 +50,11 @@ module Lithic
           :EARLY_DIRECT_DEPOSIT_FLOAT,
           Lithic::InstanceFinancialAccountType::TaggedSymbol
         )
+      PROVISIONAL_CREDIT_ACCOUNT =
+        T.let(
+          :PROVISIONAL_CREDIT_ACCOUNT,
+          Lithic::InstanceFinancialAccountType::TaggedSymbol
+        )
 
       sig do
         override.returns(

data/rbi/lithic/models/parsed_webhook_event.rbi

@@ -16,6 +16,7 @@ module Lithic
             Lithic::AccountHolderVerificationWebhookEvent,
             Lithic::AccountHolderDocumentUpdatedWebhookEvent,
             Lithic::CardAuthorizationApprovalRequestWebhookEvent,
+            Lithic::CardAuthorizationChallengeResponseWebhookEvent,
             Lithic::AuthRulesBacktestReportCreatedWebhookEvent,
             Lithic::BalanceUpdatedWebhookEvent,
             Lithic::BookTransferTransactionCreatedWebhookEvent,

data/rbi/lithic/models/payment_create_params.rbi

@@ -171,19 +171,28 @@ module Lithic
         sig { returns(T.nilable(String)) }
         attr_accessor :addenda
 
+        # Value to override the configured company name with. Can only be used if allowed
+        # to override
+        sig { returns(T.nilable(String)) }
+        attr_accessor :override_company_name
+
         sig do
           params(
             sec_code:
               Lithic::PaymentCreateParams::MethodAttributes::SecCode::OrSymbol,
             ach_hold_period: Integer,
-            addenda: T.nilable(String)
+            addenda: T.nilable(String),
+            override_company_name: T.nilable(String)
           ).returns(T.attached_class)
         end
         def self.new(
           sec_code:,
           # Number of days to hold the ACH payment
           ach_hold_period: nil,
-          addenda: nil
+          addenda: nil,
+          # Value to override the configured company name with. Can only be used if allowed
+          # to override
+          override_company_name: nil
         )
         end
 
@@ -193,7 +202,8 @@ module Lithic
               sec_code:
                 Lithic::PaymentCreateParams::MethodAttributes::SecCode::OrSymbol,
               ach_hold_period: Integer,
-              addenda: T.nilable(String)
+              addenda: T.nilable(String),
+              override_company_name: T.nilable(String)
             }
           )
         end

data/rbi/lithic/models.rbi

@@ -108,6 +108,9 @@ module Lithic
   CardAuthorizationApprovalRequestWebhookEvent =
     Lithic::Models::CardAuthorizationApprovalRequestWebhookEvent
 
+  CardAuthorizationChallengeResponseWebhookEvent =
+    Lithic::Models::CardAuthorizationChallengeResponseWebhookEvent
+
   CardBulkOrder = Lithic::Models::CardBulkOrder
 
   CardBulkOrderCreateParams = Lithic::Models::CardBulkOrderCreateParams
@@ -285,6 +288,9 @@ module Lithic
 
   ExternalBankAccounts = Lithic::Models::ExternalBankAccounts
 
+  ExternalBankAccountSetVerificationMethodParams =
+    Lithic::Models::ExternalBankAccountSetVerificationMethodParams
+
   ExternalBankAccountUnpauseParams =
     Lithic::Models::ExternalBankAccountUnpauseParams
 

data/rbi/lithic/resources/card_bulk_orders.rbi

@@ -3,12 +3,11 @@
 module Lithic
   module Resources
     class CardBulkOrders
-      # Create a new bulk order for physical card shipments **[BETA]**. Cards can be
-      # added to the order via the POST /v1/cards endpoint by specifying the
-      # bulk_order_token. Lock the order via PATCH
-      # /v1/card_bulk_orders/{bulk_order_token} to prepare for shipment. Please work
-      # with your Customer Success Manager and card personalization bureau to ensure
-      # bulk shipping is supported for your program.
+      # Create a new bulk order for physical card shipments. Cards can be added to the
+      # order via the POST /v1/cards endpoint by specifying the bulk_order_token. Lock
+      # the order via PATCH /v1/card_bulk_orders/{bulk_order_token} to prepare for
+      # shipment. Please work with your Customer Success Manager and card
+      # personalization bureau to ensure bulk shipping is supported for your program.
       sig do
         params(
           customer_product_id: String,
@@ -24,13 +23,14 @@ module Lithic
         customer_product_id:,
         # Shipping address for all cards in this bulk order
         shipping_address:,
-        # Shipping method for all cards in this bulk order
+        # Shipping method for all cards in this bulk order. BULK_PRIORITY, BULK_2_DAY, and
+        # BULK_EXPRESS are only available with Perfect Plastic Printing
         shipping_method:,
         request_options: {}
       )
       end
 
-      # Retrieve a specific bulk order by token **[BETA]**
+      # Retrieve a specific bulk order by token
       sig do
         params(
           bulk_order_token: String,
@@ -44,8 +44,8 @@ module Lithic
       )
       end
 
-      # Update a bulk order **[BETA]**. Primarily used to lock the order, preventing
-      # additional cards from being added
+      # Update a bulk order. Primarily used to lock the order, preventing additional
+      # cards from being added
       sig do
         params(
           bulk_order_token: String,
@@ -62,7 +62,7 @@ module Lithic
       )
       end
 
-      # List bulk orders for physical card shipments **[BETA]**
+      # List bulk orders for physical card shipments
       sig do
         params(
           begin_: Time,

data/rbi/lithic/resources/cards.rbi

@@ -153,7 +153,8 @@ module Lithic
         #   tracking
         # - `EXPEDITED` - FedEx or UPS depending on card manufacturer, Standard Overnight
         #   or similar international option, with tracking
-        # - `BULK_EXPEDITED` - Bulk shipment with Expedited shipping
+        # - `BULK` - Card will be shipped as part of a bulk fulfillment order. The
+        #   shipping method and timeline are inherited from the parent bulk order.
         shipping_method: nil,
         # Body param: Amount (in cents) to limit approved authorizations (e.g. 100000
         # would be a $1,000 limit). Transaction requests above the spend limit will be
@@ -383,7 +384,8 @@ module Lithic
         #   tracking
         # - `EXPEDITED` - FedEx or UPS depending on card manufacturer, Standard Overnight
         #   or similar international option, with tracking
-        # - `BULK_EXPEDITED` - Bulk shipment with Expedited shipping
+        # - `BULK` - Card will be shipped as part of a bulk fulfillment order. The
+        #   shipping method and timeline are inherited from the parent bulk order.
         shipping_method: nil,
         request_options: {}
       )
@@ -519,7 +521,8 @@ module Lithic
         #   tracking
         # - `EXPEDITED` - FedEx or UPS depending on card manufacturer, Standard Overnight
         #   or similar international option, with tracking
-        # - `BULK_EXPEDITED` - Bulk shipment with Expedited shipping
+        # - `BULK` - Card will be shipped as part of a bulk fulfillment order. The
+        #   shipping method and timeline are inherited from the parent bulk order.
         shipping_method: nil,
         request_options: {}
       )
@@ -576,7 +579,8 @@ module Lithic
         #   tracking
         # - `EXPEDITED` - FedEx or UPS depending on card manufacturer, Standard Overnight
         #   or similar international option, with tracking
-        # - `BULK_EXPEDITED` - Bulk shipment with Expedited shipping
+        # - `BULK` - Card will be shipped as part of a bulk fulfillment order. The
+        #   shipping method and timeline are inherited from the parent bulk order.
         shipping_method: nil,
         request_options: {}
       )

data/rbi/lithic/resources/external_bank_accounts.rbi

@@ -146,6 +146,28 @@ module Lithic
       )
       end
 
+      # Update the verification method for an external bank account. Verification method
+      # can only be updated if the `verification_state` is `PENDING`.
+      sig do
+        params(
+          external_bank_account_token: String,
+          verification_method:
+            Lithic::ExternalBankAccountSetVerificationMethodParams::VerificationMethod::OrSymbol,
+          financial_account_token: String,
+          request_options: Lithic::RequestOptions::OrHash
+        ).returns(Lithic::ExternalBankAccount)
+      end
+      def set_verification_method(
+        external_bank_account_token,
+        # The verification method to set for the external bank account
+        verification_method:,
+        # The financial account token of the operating account to fund the micro deposits.
+        # Required when verification_method is MICRO_DEPOSIT or PRENOTE.
+        financial_account_token: nil,
+        request_options: {}
+      )
+      end
+
       # Unpause an external bank account
       sig do
         params(

data/rbi/lithic/resources/webhooks.rbi

@@ -17,6 +17,7 @@ module Lithic
             Lithic::AccountHolderVerificationWebhookEvent,
             Lithic::AccountHolderDocumentUpdatedWebhookEvent,
             Lithic::CardAuthorizationApprovalRequestWebhookEvent,
+            Lithic::CardAuthorizationChallengeResponseWebhookEvent,
             Lithic::AuthRulesBacktestReportCreatedWebhookEvent,
             Lithic::BalanceUpdatedWebhookEvent,
             Lithic::BookTransferTransactionCreatedWebhookEvent,

data/sig/lithic/internal/util.rbs

@@ -45,8 +45,12 @@ module Lithic
         -> top?
       } -> top?
 
+      RFC_3986_NOT_PCHARS: Regexp
+
       def self?.uri_origin: (URI::Generic uri) -> String
 
+      def self?.encode_path: (String | Integer path) -> String
+
       def self?.interpolate_path: (String | ::Array[String] path) -> String
 
       def self?.decode_query: (String? query) -> ::Hash[String, ::Array[String]]

data/sig/lithic/models/auth_rules/backtest_stats.rbs

@@ -53,7 +53,8 @@ module Lithic
           {
             decision: Lithic::Models::AuthRules::BacktestStats::Example::decision,
             event_token: String,
-            timestamp: Time
+            timestamp: Time,
+            transaction_token: String?
           }
 
         class Example < Lithic::Internal::Type::BaseModel
@@ -71,16 +72,20 @@ module Lithic
 
           def timestamp=: (Time) -> Time
 
+          attr_accessor transaction_token: String?
+
           def initialize: (
             ?decision: Lithic::Models::AuthRules::BacktestStats::Example::decision,
             ?event_token: String,
-            ?timestamp: Time
+            ?timestamp: Time,
+            ?transaction_token: String?
           ) -> void
 
           def to_hash: -> {
             decision: Lithic::Models::AuthRules::BacktestStats::Example::decision,
             event_token: String,
-            timestamp: Time
+            timestamp: Time,
+            transaction_token: String?
           }
 
           type decision = :APPROVED | :DECLINED | :CHALLENGED