lithic 0.1.0 → 0.2.0

data/lib/lithic/models.rb

@@ -49,8 +49,12 @@ module Lithic
 
   AccountHolder = Lithic::Models::AccountHolder
 
+  AccountHolderCreatedWebhookEvent = Lithic::Models::AccountHolderCreatedWebhookEvent
+
   AccountHolderCreateParams = Lithic::Models::AccountHolderCreateParams
 
+  AccountHolderDocumentUpdatedWebhookEvent = Lithic::Models::AccountHolderDocumentUpdatedWebhookEvent
+
   AccountHolderListDocumentsParams = Lithic::Models::AccountHolderListDocumentsParams
 
   AccountHolderListParams = Lithic::Models::AccountHolderListParams
@@ -64,10 +68,14 @@ module Lithic
 
   AccountHolderSimulateEnrollmentReviewParams = Lithic::Models::AccountHolderSimulateEnrollmentReviewParams
 
+  AccountHolderUpdatedWebhookEvent = Lithic::Models::AccountHolderUpdatedWebhookEvent
+
   AccountHolderUpdateParams = Lithic::Models::AccountHolderUpdateParams
 
   AccountHolderUploadDocumentParams = Lithic::Models::AccountHolderUploadDocumentParams
 
+  AccountHolderVerificationWebhookEvent = Lithic::Models::AccountHolderVerificationWebhookEvent
+
   AccountListParams = Lithic::Models::AccountListParams
 
   AccountRetrieveParams = Lithic::Models::AccountRetrieveParams
@@ -88,8 +96,12 @@ module Lithic
 
   APIStatus = Lithic::Models::APIStatus
 
+  AsaRequestWebhookEvent = Lithic::Models::AsaRequestWebhookEvent
+
   AuthRules = Lithic::Models::AuthRules
 
+  AuthRulesBacktestReportCreatedWebhookEvent = Lithic::Models::AuthRulesBacktestReportCreatedWebhookEvent
+
   AuthStreamEnrollmentRetrieveSecretParams = Lithic::Models::AuthStreamEnrollmentRetrieveSecretParams
 
   AuthStreamEnrollmentRotateSecretParams = Lithic::Models::AuthStreamEnrollmentRotateSecretParams
@@ -100,6 +112,8 @@ module Lithic
 
   BalanceListParams = Lithic::Models::BalanceListParams
 
+  BalanceUpdatedWebhookEvent = Lithic::Models::BalanceUpdatedWebhookEvent
+
   BookTransferCreateParams = Lithic::Models::BookTransferCreateParams
 
   BookTransferListParams = Lithic::Models::BookTransferListParams
@@ -110,6 +124,10 @@ module Lithic
 
   BookTransferReverseParams = Lithic::Models::BookTransferReverseParams
 
+  BookTransferTransactionCreatedWebhookEvent = Lithic::Models::BookTransferTransactionCreatedWebhookEvent
+
+  BookTransferTransactionUpdatedWebhookEvent = Lithic::Models::BookTransferTransactionUpdatedWebhookEvent
+
   Card = Lithic::Models::Card
 
   CardBulkOrder = Lithic::Models::CardBulkOrder
@@ -122,8 +140,12 @@ module Lithic
 
   CardBulkOrderUpdateParams = Lithic::Models::CardBulkOrderUpdateParams
 
+  CardConvertedWebhookEvent = Lithic::Models::CardConvertedWebhookEvent
+
   CardConvertPhysicalParams = Lithic::Models::CardConvertPhysicalParams
 
+  CardCreatedWebhookEvent = Lithic::Models::CardCreatedWebhookEvent
+
   CardCreateParams = Lithic::Models::CardCreateParams
 
   CardEmbedParams = Lithic::Models::CardEmbedParams
@@ -140,8 +162,12 @@ module Lithic
 
   CardProvisionParams = Lithic::Models::CardProvisionParams
 
+  CardReissuedWebhookEvent = Lithic::Models::CardReissuedWebhookEvent
+
   CardReissueParams = Lithic::Models::CardReissueParams
 
+  CardRenewedWebhookEvent = Lithic::Models::CardRenewedWebhookEvent
+
   CardRenewParams = Lithic::Models::CardRenewParams
 
   CardRetrieveParams = Lithic::Models::CardRetrieveParams
@@ -152,8 +178,18 @@ module Lithic
 
   CardSearchByPanParams = Lithic::Models::CardSearchByPanParams
 
+  CardShippedWebhookEvent = Lithic::Models::CardShippedWebhookEvent
+
   CardSpendLimits = Lithic::Models::CardSpendLimits
 
+  CardTransactionEnhancedDataCreatedWebhookEvent =
+    Lithic::Models::CardTransactionEnhancedDataCreatedWebhookEvent
+
+  CardTransactionEnhancedDataUpdatedWebhookEvent =
+    Lithic::Models::CardTransactionEnhancedDataUpdatedWebhookEvent
+
+  CardTransactionUpdatedWebhookEvent = Lithic::Models::CardTransactionUpdatedWebhookEvent
+
   CardUpdateParams = Lithic::Models::CardUpdateParams
 
   CardWebProvisionParams = Lithic::Models::CardWebProvisionParams
@@ -176,6 +212,20 @@ module Lithic
 
   DigitalCardArtRetrieveParams = Lithic::Models::DigitalCardArtRetrieveParams
 
+  DigitalWalletTokenizationApprovalRequestWebhookEvent =
+    Lithic::Models::DigitalWalletTokenizationApprovalRequestWebhookEvent
+
+  DigitalWalletTokenizationResultWebhookEvent = Lithic::Models::DigitalWalletTokenizationResultWebhookEvent
+
+  DigitalWalletTokenizationTwoFactorAuthenticationCodeSentWebhookEvent =
+    Lithic::Models::DigitalWalletTokenizationTwoFactorAuthenticationCodeSentWebhookEvent
+
+  DigitalWalletTokenizationTwoFactorAuthenticationCodeWebhookEvent =
+    Lithic::Models::DigitalWalletTokenizationTwoFactorAuthenticationCodeWebhookEvent
+
+  DigitalWalletTokenizationUpdatedWebhookEvent =
+    Lithic::Models::DigitalWalletTokenizationUpdatedWebhookEvent
+
   DigitalWalletTokenMetadata = Lithic::Models::DigitalWalletTokenMetadata
 
   Dispute = Lithic::Models::Dispute
@@ -188,6 +238,8 @@ module Lithic
 
   DisputeEvidence = Lithic::Models::DisputeEvidence
 
+  DisputeEvidenceUploadFailedWebhookEvent = Lithic::Models::DisputeEvidenceUploadFailedWebhookEvent
+
   DisputeInitiateEvidenceUploadParams = Lithic::Models::DisputeInitiateEvidenceUploadParams
 
   DisputeListEvidencesParams = Lithic::Models::DisputeListEvidencesParams
@@ -202,6 +254,12 @@ module Lithic
 
   DisputesV2RetrieveParams = Lithic::Models::DisputesV2RetrieveParams
 
+  DisputeTransactionCreatedWebhookEvent = Lithic::Models::DisputeTransactionCreatedWebhookEvent
+
+  DisputeTransactionUpdatedWebhookEvent = Lithic::Models::DisputeTransactionUpdatedWebhookEvent
+
+  DisputeUpdatedWebhookEvent = Lithic::Models::DisputeUpdatedWebhookEvent
+
   DisputeUpdateParams = Lithic::Models::DisputeUpdateParams
 
   DisputeV2 = Lithic::Models::DisputeV2
@@ -224,6 +282,8 @@ module Lithic
 
   ExternalBankAccountAddress = Lithic::Models::ExternalBankAccountAddress
 
+  ExternalBankAccountCreatedWebhookEvent = Lithic::Models::ExternalBankAccountCreatedWebhookEvent
+
   ExternalBankAccountCreateParams = Lithic::Models::ExternalBankAccountCreateParams
 
   ExternalBankAccountListParams = Lithic::Models::ExternalBankAccountListParams
@@ -238,12 +298,16 @@ module Lithic
 
   ExternalBankAccountUnpauseParams = Lithic::Models::ExternalBankAccountUnpauseParams
 
+  ExternalBankAccountUpdatedWebhookEvent = Lithic::Models::ExternalBankAccountUpdatedWebhookEvent
+
   ExternalBankAccountUpdateParams = Lithic::Models::ExternalBankAccountUpdateParams
 
   ExternalPayment = Lithic::Models::ExternalPayment
 
   ExternalPaymentCancelParams = Lithic::Models::ExternalPaymentCancelParams
 
+  ExternalPaymentCreatedWebhookEvent = Lithic::Models::ExternalPaymentCreatedWebhookEvent
+
   ExternalPaymentCreateParams = Lithic::Models::ExternalPaymentCreateParams
 
   ExternalPaymentListParams = Lithic::Models::ExternalPaymentListParams
@@ -256,6 +320,8 @@ module Lithic
 
   ExternalPaymentSettleParams = Lithic::Models::ExternalPaymentSettleParams
 
+  ExternalPaymentUpdatedWebhookEvent = Lithic::Models::ExternalPaymentUpdatedWebhookEvent
+
   ExternalResource = Lithic::Models::ExternalResource
 
   ExternalResourceType = Lithic::Models::ExternalResourceType
@@ -264,6 +330,8 @@ module Lithic
 
   FinancialAccountBalance = Lithic::Models::FinancialAccountBalance
 
+  FinancialAccountCreatedWebhookEvent = Lithic::Models::FinancialAccountCreatedWebhookEvent
+
   FinancialAccountCreateParams = Lithic::Models::FinancialAccountCreateParams
 
   FinancialAccountListParams = Lithic::Models::FinancialAccountListParams
@@ -274,6 +342,8 @@ module Lithic
 
   FinancialAccounts = Lithic::Models::FinancialAccounts
 
+  FinancialAccountUpdatedWebhookEvent = Lithic::Models::FinancialAccountUpdatedWebhookEvent
+
   FinancialAccountUpdateParams = Lithic::Models::FinancialAccountUpdateParams
 
   FinancialAccountUpdateStatusParams = Lithic::Models::FinancialAccountUpdateStatusParams
@@ -286,6 +356,8 @@ module Lithic
 
   FundingEvent = Lithic::Models::FundingEvent
 
+  FundingEventCreatedWebhookEvent = Lithic::Models::FundingEventCreatedWebhookEvent
+
   FundingEventListParams = Lithic::Models::FundingEventListParams
 
   FundingEventRetrieveDetailsParams = Lithic::Models::FundingEventRetrieveDetailsParams
@@ -296,6 +368,10 @@ module Lithic
 
   InternalTransactionAPI = Lithic::Models::InternalTransactionAPI
 
+  InternalTransactionCreatedWebhookEvent = Lithic::Models::InternalTransactionCreatedWebhookEvent
+
+  InternalTransactionUpdatedWebhookEvent = Lithic::Models::InternalTransactionUpdatedWebhookEvent
+
   KYB = Lithic::Models::KYB
 
   KYBBusinessEntity = Lithic::Models::KYBBusinessEntity
@@ -304,6 +380,12 @@ module Lithic
 
   KYCExempt = Lithic::Models::KYCExempt
 
+  LoanTapeCreatedWebhookEvent = Lithic::Models::LoanTapeCreatedWebhookEvent
+
+  LoanTapeUpdatedWebhookEvent = Lithic::Models::LoanTapeUpdatedWebhookEvent
+
+  ManagementOperationCreatedWebhookEvent = Lithic::Models::ManagementOperationCreatedWebhookEvent
+
   ManagementOperationCreateParams = Lithic::Models::ManagementOperationCreateParams
 
   ManagementOperationListParams = Lithic::Models::ManagementOperationListParams
@@ -314,6 +396,8 @@ module Lithic
 
   ManagementOperationTransaction = Lithic::Models::ManagementOperationTransaction
 
+  ManagementOperationUpdatedWebhookEvent = Lithic::Models::ManagementOperationUpdatedWebhookEvent
+
   Merchant = Lithic::Models::Merchant
 
   MessageAttempt = Lithic::Models::MessageAttempt
@@ -326,10 +410,16 @@ module Lithic
 
   NetworkTotal = Lithic::Models::NetworkTotal
 
+  NetworkTotalCreatedWebhookEvent = Lithic::Models::NetworkTotalCreatedWebhookEvent
+
+  NetworkTotalUpdatedWebhookEvent = Lithic::Models::NetworkTotalUpdatedWebhookEvent
+
   NonPCICard = Lithic::Models::NonPCICard
 
   OwnerType = Lithic::Models::OwnerType
 
+  ParsedWebhookEvent = Lithic::Models::ParsedWebhookEvent
+
   Payment = Lithic::Models::Payment
 
   PaymentCreateParams = Lithic::Models::PaymentCreateParams
@@ -350,6 +440,10 @@ module Lithic
 
   PaymentSimulateReturnParams = Lithic::Models::PaymentSimulateReturnParams
 
+  PaymentTransactionCreatedWebhookEvent = Lithic::Models::PaymentTransactionCreatedWebhookEvent
+
+  PaymentTransactionUpdatedWebhookEvent = Lithic::Models::PaymentTransactionUpdatedWebhookEvent
+
   ProvisionResponse = Lithic::Models::ProvisionResponse
 
   Reports = Lithic::Models::Reports
@@ -368,26 +462,40 @@ module Lithic
 
   SettlementReport = Lithic::Models::SettlementReport
 
+  SettlementReportUpdatedWebhookEvent = Lithic::Models::SettlementReportUpdatedWebhookEvent
+
   SettlementSummaryDetails = Lithic::Models::SettlementSummaryDetails
 
   ShippingAddress = Lithic::Models::ShippingAddress
 
   SpendLimitDuration = Lithic::Models::SpendLimitDuration
 
+  StatementsCreatedWebhookEvent = Lithic::Models::StatementsCreatedWebhookEvent
+
   StatementTotals = Lithic::Models::StatementTotals
 
   ThreeDS = Lithic::Models::ThreeDS
 
   ThreeDSAuthentication = Lithic::Models::ThreeDSAuthentication
 
+  ThreeDSAuthenticationChallengeWebhookEvent = Lithic::Models::ThreeDSAuthenticationChallengeWebhookEvent
+
+  ThreeDSAuthenticationCreatedWebhookEvent = Lithic::Models::ThreeDSAuthenticationCreatedWebhookEvent
+
+  ThreeDSAuthenticationUpdatedWebhookEvent = Lithic::Models::ThreeDSAuthenticationUpdatedWebhookEvent
+
   TokenInfo = Lithic::Models::TokenInfo
 
   Tokenization = Lithic::Models::Tokenization
 
   TokenizationActivateParams = Lithic::Models::TokenizationActivateParams
 
+  TokenizationApprovalRequestWebhookEvent = Lithic::Models::TokenizationApprovalRequestWebhookEvent
+
   TokenizationDeactivateParams = Lithic::Models::TokenizationDeactivateParams
 
+  TokenizationDecisioningRequestWebhookEvent = Lithic::Models::TokenizationDecisioningRequestWebhookEvent
+
   TokenizationDecisioningRetrieveSecretParams = Lithic::Models::TokenizationDecisioningRetrieveSecretParams
 
   TokenizationDecisioningRotateSecretParams = Lithic::Models::TokenizationDecisioningRotateSecretParams
@@ -400,6 +508,8 @@ module Lithic
 
   TokenizationResendActivationCodeParams = Lithic::Models::TokenizationResendActivationCodeParams
 
+  TokenizationResultWebhookEvent = Lithic::Models::TokenizationResultWebhookEvent
+
   TokenizationRetrieveParams = Lithic::Models::TokenizationRetrieveParams
 
   TokenizationRuleResult = Lithic::Models::TokenizationRuleResult
@@ -410,10 +520,18 @@ module Lithic
 
   TokenizationTfaReason = Lithic::Models::TokenizationTfaReason
 
+  TokenizationTwoFactorAuthenticationCodeSentWebhookEvent =
+    Lithic::Models::TokenizationTwoFactorAuthenticationCodeSentWebhookEvent
+
+  TokenizationTwoFactorAuthenticationCodeWebhookEvent =
+    Lithic::Models::TokenizationTwoFactorAuthenticationCodeWebhookEvent
+
   TokenizationUnpauseParams = Lithic::Models::TokenizationUnpauseParams
 
   TokenizationUpdateDigitalCardArtParams = Lithic::Models::TokenizationUpdateDigitalCardArtParams
 
+  TokenizationUpdatedWebhookEvent = Lithic::Models::TokenizationUpdatedWebhookEvent
+
   Transaction = Lithic::Models::Transaction
 
   TransactionExpireAuthorizationParams = Lithic::Models::TransactionExpireAuthorizationParams
@@ -448,5 +566,7 @@ module Lithic
 
   WalletDecisioningInfo = Lithic::Models::WalletDecisioningInfo
 
+  WebhookParsedParams = Lithic::Models::WebhookParsedParams
+
   WirePartyDetails = Lithic::Models::WirePartyDetails
 end

data/lib/lithic/resources/webhooks.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+module Lithic
+  module Resources
+    class Webhooks
+      # Parses and verifies a webhook payload. Verifies the signature before parsing.
+      #
+      # @param payload [String] The raw webhook payload as a string
+      # @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]
+      #
+      # @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
+      #
+      # @example
+      #   event = lithic.webhooks.parse(
+      #     request.body.read,
+      #     headers: request.headers
+      #   )
+      def parse(payload, headers:, secret: nil)
+        verified_json = verify_signature(payload: payload, headers: headers, secret: secret)
+        Lithic::Internal::Type::Converter.coerce(Lithic::Models::ParsedWebhookEvent, verified_json)
+      end
+
+      # Parses a webhook payload without verifying the signature.
+      #
+      # WARNING: This method does not verify the webhook signature. Use only for testing or when
+      # signature verification is not required.
+      #
+      # @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::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]
+      def parse_unsafe(payload)
+        parsed = JSON.parse(payload, symbolize_names: true)
+        Lithic::Internal::Type::Converter.coerce(Lithic::Models::ParsedWebhookEvent, parsed)
+      end
+
+      # Verifies the signature of a webhook payload using the Standard Webhooks specification.
+      #
+      # @param payload [String] The raw webhook payload as a string
+      # @param headers [Hash{String => String}] The webhook request headers
+      # @param secret [String, nil] The webhook secret (with or without the "whsec_" prefix).
+      #   If not provided, reads from LITHIC_WEBHOOK_SECRET environment variable.
+      #
+      # @return [Hash] The parsed webhook payload with symbolized keys
+      #
+      # @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
+      #
+      # @example
+      #   json = lithic.webhooks.verify_signature(
+      #     payload: request.body.read,
+      #     headers: request.headers
+      #   )
+      #   puts json[:event_type]
+      def verify_signature(payload:, headers:, secret: nil)
+        secret ||= ENV["LITHIC_WEBHOOK_SECRET"]
+        if secret.nil? || secret.empty?
+          raise ArgumentError, "Webhook secret must be provided or set in LITHIC_WEBHOOK_SECRET environment variable"
+        end
+
+        begin
+          require("standardwebhooks")
+        rescue LoadError
+          raise Lithic::Errors::MissingDependencyError.new(
+            gem_name: "standardwebhooks",
+            feature: "webhook signature verification"
+          )
+        end
+
+        wh = StandardWebhooks::Webhook.new(secret)
+        wh.verify(payload, headers)
+      end
+
+      # @api private
+      #
+      # @param client [Lithic::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/lithic/version.rb

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