lithic 0.18.1 → 0.20.0

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

@@ -102,7 +102,7 @@ module Lithic
         # The type of event that occurred. Possible values:
         #
         # - account_holder_document.updated: Occurs when an account holder's document
-        #   upload status has been updated
+        #   upload status has been updated.
         # - account_holder.created: Occurs when a new account_holder is created.
         # - account_holder.updated: Occurs when an account_holder is updated.
         # - account_holder.verification: Occurs when an asynchronous account_holder's
@@ -166,10 +166,25 @@ module Lithic
         # This event will be deprecated in the future. We recommend using
         # `tokenization.updated` instead.
         #
-        # - dispute_evidence.upload_failed: Occurs when a dispute evidence upload fails.
+        # - dispute_evidence.upload_failed: Occurs when an evidence upload fails for a
+        #   dispute filed through the Chargebacks API (`/v1/disputes`).
+        #
+        # This event is not emitted for Managed Disputes.
+        #
         # - dispute_transaction.created: Occurs when a new dispute transaction is created
-        # - dispute_transaction.updated: Occurs when a dispute transaction is updated
-        # - dispute.updated: Occurs when a dispute is updated.
+        #   for a Managed Disputes case.
+        # - dispute_transaction.updated: Occurs when a dispute transaction for a Managed
+        #   Disputes case is updated.
+        # - dispute.updated: Occurs when a dispute filed through the Chargebacks API
+        #   (`/v1/disputes`) is created or updated.
+        #
+        # This event is not emitted for Managed Disputes. Use
+        # `dispute_transaction.created` and `dispute_transaction.updated` instead.
+        #
+        # - embed.session_generated: Occurs when a card embed session is successfully
+        #   generated.
+        # - embed.viewed: Occurs when a card detail is successfully revealed through an
+        #   embed.
         # - external_bank_account.created: Occurs when an external bank account is
         #   created.
         # - external_bank_account.updated: Occurs when an external bank account is
@@ -191,12 +206,12 @@ module Lithic
         # - payment_transaction.updated: Occurs when a payment transaction is updated.
         # - settlement_report.updated: Occurs when a settlement report is created or
         #   updated.
-        # - statements.created: Occurs when a statement has been created
+        # - statements.created: Occurs when a statement has been created.
         # - three_ds_authentication.challenge: The `three_ds_authentication.challenge`
         #   event. Upon receiving this request, the Card Program should issue its own
         #   challenge to the cardholder. After a cardholder challenge is successfully
         #   completed, the Card Program needs to respond back to Lithic by call to
-        #   [/v1/three_ds_decisioning/challenge_response](https://docs.lithic.com/reference/post_v1-three-ds-decisioning-challenge-response).
+        #   [/v1/three_ds_decisioning/challenge_response](https://docs.lithic.com/reference/postthreedschallengeresponse).
         #   Then the cardholder must navigate back to the merchant checkout flow to
         #   complete the transaction. Some merchants will include an `app_requestor_url`
         #   for app-based purchases; Lithic recommends triggering a redirect to that URL
@@ -381,6 +396,16 @@ module Lithic
               :"dispute.updated",
               Lithic::Events::SubscriptionCreateParams::EventType::TaggedSymbol
             )
+          EMBED_SESSION_GENERATED =
+            T.let(
+              :"embed.session_generated",
+              Lithic::Events::SubscriptionCreateParams::EventType::TaggedSymbol
+            )
+          EMBED_VIEWED =
+            T.let(
+              :"embed.viewed",
+              Lithic::Events::SubscriptionCreateParams::EventType::TaggedSymbol
+            )
           EXTERNAL_BANK_ACCOUNT_CREATED =
             T.let(
               :"external_bank_account.created",

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

@@ -238,6 +238,16 @@ module Lithic
               :"dispute.updated",
               Lithic::Events::SubscriptionSendSimulatedExampleParams::EventType::TaggedSymbol
             )
+          EMBED_SESSION_GENERATED =
+            T.let(
+              :"embed.session_generated",
+              Lithic::Events::SubscriptionSendSimulatedExampleParams::EventType::TaggedSymbol
+            )
+          EMBED_VIEWED =
+            T.let(
+              :"embed.viewed",
+              Lithic::Events::SubscriptionSendSimulatedExampleParams::EventType::TaggedSymbol
+            )
           EXTERNAL_BANK_ACCOUNT_CREATED =
             T.let(
               :"external_bank_account.created",

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

@@ -108,7 +108,7 @@ module Lithic
         # The type of event that occurred. Possible values:
         #
         # - account_holder_document.updated: Occurs when an account holder's document
-        #   upload status has been updated
+        #   upload status has been updated.
         # - account_holder.created: Occurs when a new account_holder is created.
         # - account_holder.updated: Occurs when an account_holder is updated.
         # - account_holder.verification: Occurs when an asynchronous account_holder's
@@ -172,10 +172,25 @@ module Lithic
         # This event will be deprecated in the future. We recommend using
         # `tokenization.updated` instead.
         #
-        # - dispute_evidence.upload_failed: Occurs when a dispute evidence upload fails.
+        # - dispute_evidence.upload_failed: Occurs when an evidence upload fails for a
+        #   dispute filed through the Chargebacks API (`/v1/disputes`).
+        #
+        # This event is not emitted for Managed Disputes.
+        #
         # - dispute_transaction.created: Occurs when a new dispute transaction is created
-        # - dispute_transaction.updated: Occurs when a dispute transaction is updated
-        # - dispute.updated: Occurs when a dispute is updated.
+        #   for a Managed Disputes case.
+        # - dispute_transaction.updated: Occurs when a dispute transaction for a Managed
+        #   Disputes case is updated.
+        # - dispute.updated: Occurs when a dispute filed through the Chargebacks API
+        #   (`/v1/disputes`) is created or updated.
+        #
+        # This event is not emitted for Managed Disputes. Use
+        # `dispute_transaction.created` and `dispute_transaction.updated` instead.
+        #
+        # - embed.session_generated: Occurs when a card embed session is successfully
+        #   generated.
+        # - embed.viewed: Occurs when a card detail is successfully revealed through an
+        #   embed.
         # - external_bank_account.created: Occurs when an external bank account is
         #   created.
         # - external_bank_account.updated: Occurs when an external bank account is
@@ -197,12 +212,12 @@ module Lithic
         # - payment_transaction.updated: Occurs when a payment transaction is updated.
         # - settlement_report.updated: Occurs when a settlement report is created or
         #   updated.
-        # - statements.created: Occurs when a statement has been created
+        # - statements.created: Occurs when a statement has been created.
         # - three_ds_authentication.challenge: The `three_ds_authentication.challenge`
         #   event. Upon receiving this request, the Card Program should issue its own
         #   challenge to the cardholder. After a cardholder challenge is successfully
         #   completed, the Card Program needs to respond back to Lithic by call to
-        #   [/v1/three_ds_decisioning/challenge_response](https://docs.lithic.com/reference/post_v1-three-ds-decisioning-challenge-response).
+        #   [/v1/three_ds_decisioning/challenge_response](https://docs.lithic.com/reference/postthreedschallengeresponse).
         #   Then the cardholder must navigate back to the merchant checkout flow to
         #   complete the transaction. Some merchants will include an `app_requestor_url`
         #   for app-based purchases; Lithic recommends triggering a redirect to that URL
@@ -387,6 +402,16 @@ module Lithic
               :"dispute.updated",
               Lithic::Events::SubscriptionUpdateParams::EventType::TaggedSymbol
             )
+          EMBED_SESSION_GENERATED =
+            T.let(
+              :"embed.session_generated",
+              Lithic::Events::SubscriptionUpdateParams::EventType::TaggedSymbol
+            )
+          EMBED_VIEWED =
+            T.let(
+              :"embed.viewed",
+              Lithic::Events::SubscriptionUpdateParams::EventType::TaggedSymbol
+            )
           EXTERNAL_BANK_ACCOUNT_CREATED =
             T.let(
               :"external_bank_account.created",

data/rbi/lithic/models/external_payment_list_params.rbi

@@ -25,7 +25,7 @@ module Lithic
       sig { params(business_account_token: String).void }
       attr_writer :business_account_token
 
-      # External Payment category to be returned.
+      # The external rail the funds moved on
       sig do
         returns(
           T.nilable(Lithic::ExternalPaymentListParams::Category::OrSymbol)
@@ -121,7 +121,7 @@ module Lithic
         # will be included. UTC time zone.
         begin_: nil,
         business_account_token: nil,
-        # External Payment category to be returned.
+        # The external rail the funds moved on
         category: nil,
         # Date string in RFC 3339 format. Only entries created before the specified time
         # will be included. UTC time zone.
@@ -165,7 +165,7 @@ module Lithic
       def to_hash
       end
 
-      # External Payment category to be returned.
+      # The external rail the funds moved on
       module Category
         extend Lithic::Internal::Type::Enum
 

data/rbi/lithic/models/financial_account.rbi

@@ -59,6 +59,12 @@ module Lithic
       sig { returns(T.nilable(String)) }
       attr_accessor :account_number
 
+      # Provisioned blockchain deposit addresses for this financial account, keyed by
+      # the full name of the blockchain network that each address belongs to (e.g.
+      # `ETHEREUM`)
+      sig { returns(T.nilable(T::Hash[Symbol, String])) }
+      attr_accessor :blockchain_addresses
+
       sig { returns(T.nilable(String)) }
       attr_accessor :routing_number
 
@@ -77,6 +83,7 @@ module Lithic
           updated: Time,
           user_defined_status: T.nilable(String),
           account_number: T.nilable(String),
+          blockchain_addresses: T.nilable(T::Hash[Symbol, String]),
           routing_number: T.nilable(String)
         ).returns(T.attached_class)
       end
@@ -98,6 +105,10 @@ module Lithic
         # User-defined status for the financial account
         user_defined_status:,
         account_number: nil,
+        # Provisioned blockchain deposit addresses for this financial account, keyed by
+        # the full name of the blockchain network that each address belongs to (e.g.
+        # `ETHEREUM`)
+        blockchain_addresses: nil,
         routing_number: nil
       )
       end
@@ -119,6 +130,7 @@ module Lithic
             updated: Time,
             user_defined_status: T.nilable(String),
             account_number: T.nilable(String),
+            blockchain_addresses: T.nilable(T::Hash[Symbol, String]),
             routing_number: T.nilable(String)
           }
         )

data/rbi/lithic/models/financial_accounts/balance_list_params.rbi

@@ -25,9 +25,10 @@ module Lithic
         sig { params(balance_date: Time).void }
         attr_writer :balance_date
 
-        # Balance after a given financial event occured. For example, passing the
-        # event_token of a $5 CARD_CLEARING financial event will return a balance
-        # decreased by $5
+        # Balance after a given financial event occured. Note: if an account receives
+        # multiple events around the same time whose financial impacts cancel out, a
+        # balance lookup by one of those event tokens may return 404, since their combined
+        # impact on the account is zero.
         sig { returns(T.nilable(String)) }
         attr_reader :last_transaction_event_token
 
@@ -46,9 +47,10 @@ module Lithic
           financial_account_token:,
           # UTC date of the balance to retrieve. Defaults to latest available balance
           balance_date: nil,
-          # Balance after a given financial event occured. For example, passing the
-          # event_token of a $5 CARD_CLEARING financial event will return a balance
-          # decreased by $5
+          # Balance after a given financial event occured. Note: if an account receives
+          # multiple events around the same time whose financial impacts cancel out, a
+          # balance lookup by one of those event tokens may return 404, since their combined
+          # impact on the account is zero.
           last_transaction_event_token: nil,
           request_options: {}
         )

data/rbi/lithic/models/financial_accounts/statements/statement_line_items.rbi

@@ -233,6 +233,11 @@ module Lithic
                   :WIRE,
                   Lithic::FinancialAccounts::Statements::StatementLineItems::Data::Category::TaggedSymbol
                 )
+              STABLECOIN =
+                T.let(
+                  :STABLECOIN,
+                  Lithic::FinancialAccounts::Statements::StatementLineItems::Data::Category::TaggedSymbol
+                )
               BALANCE_OR_FUNDING =
                 T.let(
                   :BALANCE_OR_FUNDING,
@@ -333,6 +338,11 @@ module Lithic
                   :PROGRAM_FUNDING,
                   Lithic::FinancialAccounts::Statements::StatementLineItems::Data::Category::TaggedSymbol
                 )
+              PROGRAM_TRANSFER =
+                T.let(
+                  :PROGRAM_TRANSFER,
+                  Lithic::FinancialAccounts::Statements::StatementLineItems::Data::Category::TaggedSymbol
+                )
 
               sig do
                 override.returns(
@@ -762,6 +772,16 @@ module Lithic
                   :LITHIC_NETWORK_PAYMENT,
                   Lithic::FinancialAccounts::Statements::StatementLineItems::Data::EventType::TaggedSymbol
                 )
+              LITHIC_PROGRAM_TRANSFER =
+                T.let(
+                  :LITHIC_PROGRAM_TRANSFER,
+                  Lithic::FinancialAccounts::Statements::StatementLineItems::Data::EventType::TaggedSymbol
+                )
+              BANK_PROGRAM_TRANSFER =
+                T.let(
+                  :BANK_PROGRAM_TRANSFER,
+                  Lithic::FinancialAccounts::Statements::StatementLineItems::Data::EventType::TaggedSymbol
+                )
               ANNUAL =
                 T.let(
                   :ANNUAL,
@@ -797,6 +817,36 @@ module Lithic
                   :ACCOUNT_TO_ACCOUNT,
                   Lithic::FinancialAccounts::Statements::StatementLineItems::Data::EventType::TaggedSymbol
                 )
+              STABLECOIN_RECEIVED =
+                T.let(
+                  :STABLECOIN_RECEIVED,
+                  Lithic::FinancialAccounts::Statements::StatementLineItems::Data::EventType::TaggedSymbol
+                )
+              STABLECOIN_INITIATED =
+                T.let(
+                  :STABLECOIN_INITIATED,
+                  Lithic::FinancialAccounts::Statements::StatementLineItems::Data::EventType::TaggedSymbol
+                )
+              STABLECOIN_REVIEWED =
+                T.let(
+                  :STABLECOIN_REVIEWED,
+                  Lithic::FinancialAccounts::Statements::StatementLineItems::Data::EventType::TaggedSymbol
+                )
+              STABLECOIN_SENT =
+                T.let(
+                  :STABLECOIN_SENT,
+                  Lithic::FinancialAccounts::Statements::StatementLineItems::Data::EventType::TaggedSymbol
+                )
+              STABLECOIN_SETTLED =
+                T.let(
+                  :STABLECOIN_SETTLED,
+                  Lithic::FinancialAccounts::Statements::StatementLineItems::Data::EventType::TaggedSymbol
+                )
+              STABLECOIN_REJECTED =
+                T.let(
+                  :STABLECOIN_REJECTED,
+                  Lithic::FinancialAccounts::Statements::StatementLineItems::Data::EventType::TaggedSymbol
+                )
 
               sig do
                 override.returns(

data/rbi/lithic/models/financial_event.rbi

@@ -447,6 +447,16 @@ module Lithic
             :LITHIC_NETWORK_PAYMENT,
             Lithic::FinancialEvent::Type::TaggedSymbol
           )
+        LITHIC_PROGRAM_TRANSFER =
+          T.let(
+            :LITHIC_PROGRAM_TRANSFER,
+            Lithic::FinancialEvent::Type::TaggedSymbol
+          )
+        BANK_PROGRAM_TRANSFER =
+          T.let(
+            :BANK_PROGRAM_TRANSFER,
+            Lithic::FinancialEvent::Type::TaggedSymbol
+          )
         ANNUAL = T.let(:ANNUAL, Lithic::FinancialEvent::Type::TaggedSymbol)
         ANNUAL_REVERSAL =
           T.let(:ANNUAL_REVERSAL, Lithic::FinancialEvent::Type::TaggedSymbol)
@@ -459,6 +469,30 @@ module Lithic
           T.let(:MONTHLY_REVERSAL, Lithic::FinancialEvent::Type::TaggedSymbol)
         ACCOUNT_TO_ACCOUNT =
           T.let(:ACCOUNT_TO_ACCOUNT, Lithic::FinancialEvent::Type::TaggedSymbol)
+        STABLECOIN_RECEIVED =
+          T.let(
+            :STABLECOIN_RECEIVED,
+            Lithic::FinancialEvent::Type::TaggedSymbol
+          )
+        STABLECOIN_INITIATED =
+          T.let(
+            :STABLECOIN_INITIATED,
+            Lithic::FinancialEvent::Type::TaggedSymbol
+          )
+        STABLECOIN_REVIEWED =
+          T.let(
+            :STABLECOIN_REVIEWED,
+            Lithic::FinancialEvent::Type::TaggedSymbol
+          )
+        STABLECOIN_SENT =
+          T.let(:STABLECOIN_SENT, Lithic::FinancialEvent::Type::TaggedSymbol)
+        STABLECOIN_SETTLED =
+          T.let(:STABLECOIN_SETTLED, Lithic::FinancialEvent::Type::TaggedSymbol)
+        STABLECOIN_REJECTED =
+          T.let(
+            :STABLECOIN_REJECTED,
+            Lithic::FinancialEvent::Type::TaggedSymbol
+          )
 
         sig do
           override.returns(T::Array[Lithic::FinancialEvent::Type::TaggedSymbol])

data/rbi/lithic/models/fraud/transaction_report_response.rbi

@@ -40,17 +40,11 @@ module Lithic
 
         # Provides additional context or details about the fraud report.
         sig { returns(T.nilable(String)) }
-        attr_reader :comment
-
-        sig { params(comment: String).void }
-        attr_writer :comment
+        attr_accessor :comment
 
         # Timestamp representing when the fraud report was created.
         sig { returns(T.nilable(Time)) }
-        attr_reader :created_at
-
-        sig { params(created_at: Time).void }
-        attr_writer :created_at
+        attr_accessor :created_at
 
         # Specifies the type or category of fraud that the transaction is suspected or
         # confirmed to involve, string (enum) supporting the following values:
@@ -80,33 +74,24 @@ module Lithic
             )
           )
         end
-        attr_reader :fraud_type
-
-        sig do
-          params(
-            fraud_type:
-              Lithic::Models::Fraud::TransactionReportResponse::FraudType::OrSymbol
-          ).void
-        end
-        attr_writer :fraud_type
+        attr_accessor :fraud_type
 
         # Timestamp representing the last update to the fraud report.
         sig { returns(T.nilable(Time)) }
-        attr_reader :updated_at
-
-        sig { params(updated_at: Time).void }
-        attr_writer :updated_at
+        attr_accessor :updated_at
 
         sig do
           params(
             fraud_status:
               Lithic::Models::Fraud::TransactionReportResponse::FraudStatus::OrSymbol,
             transaction_token: String,
-            comment: String,
-            created_at: Time,
+            comment: T.nilable(String),
+            created_at: T.nilable(Time),
             fraud_type:
-              Lithic::Models::Fraud::TransactionReportResponse::FraudType::OrSymbol,
-            updated_at: Time
+              T.nilable(
+                Lithic::Models::Fraud::TransactionReportResponse::FraudType::OrSymbol
+              ),
+            updated_at: T.nilable(Time)
           ).returns(T.attached_class)
         end
         def self.new(
@@ -165,11 +150,13 @@ module Lithic
               fraud_status:
                 Lithic::Models::Fraud::TransactionReportResponse::FraudStatus::TaggedSymbol,
               transaction_token: String,
-              comment: String,
-              created_at: Time,
+              comment: T.nilable(String),
+              created_at: T.nilable(Time),
               fraud_type:
-                Lithic::Models::Fraud::TransactionReportResponse::FraudType::TaggedSymbol,
-              updated_at: Time
+                T.nilable(
+                  Lithic::Models::Fraud::TransactionReportResponse::FraudType::TaggedSymbol
+                ),
+              updated_at: T.nilable(Time)
             }
           )
         end

data/rbi/lithic/models/fraud/transaction_retrieve_response.rbi

@@ -40,17 +40,11 @@ module Lithic
 
         # Provides additional context or details about the fraud report.
         sig { returns(T.nilable(String)) }
-        attr_reader :comment
-
-        sig { params(comment: String).void }
-        attr_writer :comment
+        attr_accessor :comment
 
         # Timestamp representing when the fraud report was created.
         sig { returns(T.nilable(Time)) }
-        attr_reader :created_at
-
-        sig { params(created_at: Time).void }
-        attr_writer :created_at
+        attr_accessor :created_at
 
         # Specifies the type or category of fraud that the transaction is suspected or
         # confirmed to involve, string (enum) supporting the following values:
@@ -80,33 +74,24 @@ module Lithic
             )
           )
         end
-        attr_reader :fraud_type
-
-        sig do
-          params(
-            fraud_type:
-              Lithic::Models::Fraud::TransactionRetrieveResponse::FraudType::OrSymbol
-          ).void
-        end
-        attr_writer :fraud_type
+        attr_accessor :fraud_type
 
         # Timestamp representing the last update to the fraud report.
         sig { returns(T.nilable(Time)) }
-        attr_reader :updated_at
-
-        sig { params(updated_at: Time).void }
-        attr_writer :updated_at
+        attr_accessor :updated_at
 
         sig do
           params(
             fraud_status:
               Lithic::Models::Fraud::TransactionRetrieveResponse::FraudStatus::OrSymbol,
             transaction_token: String,
-            comment: String,
-            created_at: Time,
+            comment: T.nilable(String),
+            created_at: T.nilable(Time),
             fraud_type:
-              Lithic::Models::Fraud::TransactionRetrieveResponse::FraudType::OrSymbol,
-            updated_at: Time
+              T.nilable(
+                Lithic::Models::Fraud::TransactionRetrieveResponse::FraudType::OrSymbol
+              ),
+            updated_at: T.nilable(Time)
           ).returns(T.attached_class)
         end
         def self.new(
@@ -165,11 +150,13 @@ module Lithic
               fraud_status:
                 Lithic::Models::Fraud::TransactionRetrieveResponse::FraudStatus::TaggedSymbol,
               transaction_token: String,
-              comment: String,
-              created_at: Time,
+              comment: T.nilable(String),
+              created_at: T.nilable(Time),
               fraud_type:
-                Lithic::Models::Fraud::TransactionRetrieveResponse::FraudType::TaggedSymbol,
-              updated_at: Time
+                T.nilable(
+                  Lithic::Models::Fraud::TransactionRetrieveResponse::FraudType::TaggedSymbol
+                ),
+              updated_at: T.nilable(Time)
             }
           )
         end

data/rbi/lithic/models/parsed_webhook_event.rbi

@@ -43,6 +43,8 @@ module Lithic
             Lithic::DigitalWalletTokenizationUpdatedWebhookEvent,
             Lithic::DisputeUpdatedWebhookEvent,
             Lithic::DisputeEvidenceUploadFailedWebhookEvent,
+            Lithic::EmbedSessionGeneratedWebhookEvent,
+            Lithic::EmbedViewedWebhookEvent,
             Lithic::ExternalBankAccountCreatedWebhookEvent,
             Lithic::ExternalBankAccountUpdatedWebhookEvent,
             Lithic::ExternalPaymentCreatedWebhookEvent,