lithic 0.1.0.pre.alpha.56 → 0.2.0

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

@@ -26,7 +26,7 @@ module Lithic
         #
         # @param business_account_tokens [Array<String>] Business Account tokens to which the Auth Rule applies.
         #
-        # @param event_stream [Symbol, Lithic::Models::AuthRules::V2CreateParams::EventStream] The event stream during which the rule will be evaluated.
+        # @param event_stream [Symbol, Lithic::Models::AuthRules::EventStream] The event stream during which the rule will be evaluated.
         #
         # @param name [String, nil] Auth Rule Name
         #
@@ -34,7 +34,7 @@ module Lithic
         #
         # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
         #
-        # @return [Lithic::Models::AuthRules::V2CreateResponse]
+        # @return [Lithic::Models::AuthRules::AuthRule]
         #
         # @see Lithic::Models::AuthRules::V2CreateParams
         def create(params)
@@ -43,7 +43,7 @@ module Lithic
             method: :post,
             path: "v2/auth_rules",
             body: parsed,
-            model: Lithic::Models::AuthRules::V2CreateResponse,
+            model: Lithic::AuthRules::AuthRule,
             options: options
           )
         end
@@ -55,14 +55,14 @@ module Lithic
         # @param auth_rule_token [String]
         # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
         #
-        # @return [Lithic::Models::AuthRules::V2RetrieveResponse]
+        # @return [Lithic::Models::AuthRules::AuthRule]
         #
         # @see Lithic::Models::AuthRules::V2RetrieveParams
         def retrieve(auth_rule_token, params = {})
           @client.request(
             method: :get,
             path: ["v2/auth_rules/%1$s", auth_rule_token],
-            model: Lithic::Models::AuthRules::V2RetrieveResponse,
+            model: Lithic::AuthRules::AuthRule,
             options: params[:request_options]
           )
         end
@@ -96,7 +96,7 @@ module Lithic
         #
         # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
         #
-        # @return [Lithic::Models::AuthRules::V2UpdateResponse]
+        # @return [Lithic::Models::AuthRules::AuthRule]
         #
         # @see Lithic::Models::AuthRules::V2UpdateParams
         def update(auth_rule_token, params = {})
@@ -105,7 +105,7 @@ module Lithic
             method: :patch,
             path: ["v2/auth_rules/%1$s", auth_rule_token],
             body: parsed,
-            model: Lithic::Models::AuthRules::V2UpdateResponse,
+            model: Lithic::AuthRules::AuthRule,
             options: options
           )
         end
@@ -115,7 +115,7 @@ module Lithic
         #
         # Lists V2 Auth rules
         #
-        # @overload list(account_token: nil, business_account_token: nil, card_token: nil, ending_before: nil, event_stream: nil, page_size: nil, scope: nil, starting_after: nil, request_options: {})
+        # @overload list(account_token: nil, business_account_token: nil, card_token: nil, ending_before: nil, event_stream: nil, event_streams: nil, page_size: nil, scope: nil, starting_after: nil, request_options: {})
         #
         # @param account_token [String] Only return Auth Rules that are bound to the provided account token.
         #
@@ -125,7 +125,9 @@ module Lithic
         #
         # @param ending_before [String] A cursor representing an item's token before which a page of results should end.
         #
-        # @param event_stream [Symbol, Lithic::Models::AuthRules::V2ListParams::EventStream] Only return Auth rules that are executed during the provided event stream.
+        # @param event_stream [Symbol, Lithic::Models::AuthRules::EventStream] Deprecated: Use event_streams instead. Only return Auth rules that are executed
+        #
+        # @param event_streams [Array<Symbol, Lithic::Models::AuthRules::EventStream>] Only return Auth rules that are executed during any of the provided event stream
         #
         # @param page_size [Integer] Page size (for pagination).
         #
@@ -135,7 +137,7 @@ module Lithic
         #
         # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
         #
-        # @return [Lithic::Internal::CursorPage<Lithic::Models::AuthRules::V2ListResponse>]
+        # @return [Lithic::Internal::CursorPage<Lithic::Models::AuthRules::AuthRule>]
         #
         # @see Lithic::Models::AuthRules::V2ListParams
         def list(params = {})
@@ -145,7 +147,7 @@ module Lithic
             path: "v2/auth_rules",
             query: parsed,
             page: Lithic::Internal::CursorPage,
-            model: Lithic::Models::AuthRules::V2ListResponse,
+            model: Lithic::AuthRules::AuthRule,
             options: options
           )
         end
@@ -182,7 +184,7 @@ module Lithic
         #
         # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
         #
-        # @return [Lithic::Models::AuthRules::V2DraftResponse]
+        # @return [Lithic::Models::AuthRules::AuthRule]
         #
         # @see Lithic::Models::AuthRules::V2DraftParams
         def draft(auth_rule_token, params = {})
@@ -191,7 +193,7 @@ module Lithic
             method: :post,
             path: ["v2/auth_rules/%1$s/draft", auth_rule_token],
             body: parsed,
-            model: Lithic::Models::AuthRules::V2DraftResponse,
+            model: Lithic::AuthRules::AuthRule,
             options: options
           )
         end
@@ -204,14 +206,14 @@ module Lithic
         # @param auth_rule_token [String]
         # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
         #
-        # @return [Lithic::Models::AuthRules::V2PromoteResponse]
+        # @return [Lithic::Models::AuthRules::AuthRule]
         #
         # @see Lithic::Models::AuthRules::V2PromoteParams
         def promote(auth_rule_token, params = {})
           @client.request(
             method: :post,
             path: ["v2/auth_rules/%1$s/promote", auth_rule_token],
-            model: Lithic::Models::AuthRules::V2PromoteResponse,
+            model: Lithic::AuthRules::AuthRule,
             options: params[:request_options]
           )
         end

data/lib/lithic/resources/card_bulk_orders.rb

@@ -0,0 +1,127 @@
+# frozen_string_literal: true
+
+module Lithic
+  module Resources
+    class CardBulkOrders
+      # Some parameter documentations has been truncated, see
+      # {Lithic::Models::CardBulkOrderCreateParams} for more details.
+      #
+      # 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.
+      #
+      # @overload create(customer_product_id:, shipping_address:, shipping_method:, request_options: {})
+      #
+      # @param customer_product_id [String] Customer-specified product configuration for physical card manufacturing. This m
+      #
+      # @param shipping_address [Object] Shipping address for all cards in this bulk order
+      #
+      # @param shipping_method [Symbol, Lithic::Models::CardBulkOrderCreateParams::ShippingMethod] Shipping method for all cards in this bulk order
+      #
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Lithic::Models::CardBulkOrder]
+      #
+      # @see Lithic::Models::CardBulkOrderCreateParams
+      def create(params)
+        parsed, options = Lithic::CardBulkOrderCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "v1/card_bulk_orders",
+          body: parsed,
+          model: Lithic::CardBulkOrder,
+          options: options
+        )
+      end
+
+      # Retrieve a specific bulk order by token **[BETA]**
+      #
+      # @overload retrieve(bulk_order_token, request_options: {})
+      #
+      # @param bulk_order_token [String] Globally unique identifier for the bulk order
+      #
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Lithic::Models::CardBulkOrder]
+      #
+      # @see Lithic::Models::CardBulkOrderRetrieveParams
+      def retrieve(bulk_order_token, params = {})
+        @client.request(
+          method: :get,
+          path: ["v1/card_bulk_orders/%1$s", bulk_order_token],
+          model: Lithic::CardBulkOrder,
+          options: params[:request_options]
+        )
+      end
+
+      # Update a bulk order **[BETA]**. Primarily used to lock the order, preventing
+      # additional cards from being added
+      #
+      # @overload update(bulk_order_token, status:, request_options: {})
+      #
+      # @param bulk_order_token [String] Globally unique identifier for the bulk order
+      #
+      # @param status [Symbol, Lithic::Models::CardBulkOrderUpdateParams::Status] Status to update the bulk order to. Use LOCKED to finalize the order
+      #
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Lithic::Models::CardBulkOrder]
+      #
+      # @see Lithic::Models::CardBulkOrderUpdateParams
+      def update(bulk_order_token, params)
+        parsed, options = Lithic::CardBulkOrderUpdateParams.dump_request(params)
+        @client.request(
+          method: :patch,
+          path: ["v1/card_bulk_orders/%1$s", bulk_order_token],
+          body: parsed,
+          model: Lithic::CardBulkOrder,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Lithic::Models::CardBulkOrderListParams} for more details.
+      #
+      # List bulk orders for physical card shipments **[BETA]**
+      #
+      # @overload list(begin_: nil, end_: nil, ending_before: nil, page_size: nil, starting_after: nil, request_options: {})
+      #
+      # @param begin_ [Time] Date string in RFC 3339 format. Only entries created after the specified time wi
+      #
+      # @param end_ [Time] Date string in RFC 3339 format. Only entries created before the specified time w
+      #
+      # @param ending_before [String] A cursor representing an item's token before which a page of results should end.
+      #
+      # @param page_size [Integer] Page size (for pagination).
+      #
+      # @param starting_after [String] A cursor representing an item's token after which a page of results should begin
+      #
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Lithic::Internal::CursorPage<Lithic::Models::CardBulkOrder>]
+      #
+      # @see Lithic::Models::CardBulkOrderListParams
+      def list(params = {})
+        parsed, options = Lithic::CardBulkOrderListParams.dump_request(params)
+        @client.request(
+          method: :get,
+          path: "v1/card_bulk_orders",
+          query: parsed.transform_keys(begin_: "begin", end_: "end"),
+          page: Lithic::Internal::CursorPage,
+          model: Lithic::CardBulkOrder,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Lithic::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/lithic/resources/cards/balances.rb

@@ -19,7 +19,7 @@ module Lithic
         #
         # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
         #
-        # @return [Lithic::Internal::SinglePage<Lithic::Models::Cards::BalanceListResponse>]
+        # @return [Lithic::Internal::SinglePage<Lithic::Models::FinancialAccountBalance>]
         #
         # @see Lithic::Models::Cards::BalanceListParams
         def list(card_token, params = {})
@@ -29,7 +29,7 @@ module Lithic
             path: ["v1/cards/%1$s/balances", card_token],
             query: parsed,
             page: Lithic::Internal::SinglePage,
-            model: Lithic::Models::Cards::BalanceListResponse,
+            model: Lithic::FinancialAccountBalance,
             options: options
           )
         end

data/lib/lithic/resources/cards.rb

@@ -18,12 +18,14 @@ module Lithic
       # Create a new virtual or physical card. Parameters `shipping_address` and
       # `product_id` only apply to physical cards.
       #
-      # @overload create(type:, account_token: nil, card_program_token: nil, carrier: nil, digital_card_art_token: nil, exp_month: nil, exp_year: nil, memo: nil, pin: nil, product_id: nil, replacement_account_token: nil, replacement_comment: nil, replacement_for: nil, replacement_substatus: nil, shipping_address: nil, shipping_method: nil, spend_limit: nil, spend_limit_duration: nil, state: nil, request_options: {})
+      # @overload create(type:, account_token: nil, bulk_order_token: nil, card_program_token: nil, carrier: nil, digital_card_art_token: nil, exp_month: nil, exp_year: nil, memo: nil, pin: nil, product_id: nil, replacement_account_token: nil, replacement_comment: nil, replacement_for: nil, replacement_substatus: nil, shipping_address: nil, shipping_method: nil, spend_limit: nil, spend_limit_duration: nil, state: nil, request_options: {})
       #
       # @param type [Symbol, Lithic::Models::CardCreateParams::Type] Card types:
       #
       # @param account_token [String] Globally unique identifier for the account that the card will be associated with
       #
+      # @param bulk_order_token [String] Globally unique identifier for an existing bulk order to associate this card wit
+      #
       # @param card_program_token [String] For card programs with more than one BIN range. This must be configured with Lit
       #
       # @param carrier [Lithic::Models::Carrier]
@@ -441,6 +443,9 @@ module Lithic
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Lithic::Models::CardWebProvisionParams} for more details.
+      #
       # Allow your cardholders to directly add payment cards to the device's digital
       # wallet from a browser on the web. Currently only suported for Apple Pay.
       #
@@ -448,15 +453,21 @@ module Lithic
       # [Contact Us](https://lithic.com/contact) or your Customer Success representative
       # for more information.
       #
-      # @overload web_provision(card_token, digital_wallet: nil, request_options: {})
+      # @overload web_provision(card_token, client_device_id: nil, client_wallet_account_id: nil, digital_wallet: nil, server_session_id: nil, request_options: {})
       #
       # @param card_token [String] The unique token of the card to add to the device's digital wallet.
       #
+      # @param client_device_id [String] Only applicable if `digital_wallet` is GOOGLE_PAY. Google Pay Web Push Provision
+      #
+      # @param client_wallet_account_id [String] Only applicable if `digital_wallet` is GOOGLE_PAY. Google Pay Web Push Provision
+      #
       # @param digital_wallet [Symbol, Lithic::Models::CardWebProvisionParams::DigitalWallet] Name of digital wallet provider.
       #
+      # @param server_session_id [String] Only applicable if `digital_wallet` is GOOGLE_PAY. Google Pay Web Push Provision
+      #
       # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Lithic::Models::CardWebProvisionResponse]
+      # @return [Lithic::Models::CardWebProvisionResponse::AppleWebPushProvisioningResponse, Lithic::Models::CardWebProvisionResponse::GoogleWebPushProvisioningResponse]
       #
       # @see Lithic::Models::CardWebProvisionParams
       def web_provision(card_token, params = {})

data/lib/lithic/resources/external_bank_accounts.rb

@@ -197,7 +197,7 @@ module Lithic
       # @param financial_account_token [String]
       # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Lithic::Models::ExternalBankAccountRetryPrenoteResponse]
+      # @return [Lithic::Models::ExternalBankAccount]
       #
       # @see Lithic::Models::ExternalBankAccountRetryPrenoteParams
       def retry_prenote(external_bank_account_token, params = {})
@@ -206,7 +206,7 @@ module Lithic
           method: :post,
           path: ["v1/external_bank_accounts/%1$s/retry_prenote", external_bank_account_token],
           body: parsed,
-          model: Lithic::Models::ExternalBankAccountRetryPrenoteResponse,
+          model: Lithic::ExternalBankAccount,
           options: options
         )
       end
@@ -218,14 +218,14 @@ module Lithic
       # @param external_bank_account_token [String]
       # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Lithic::Models::ExternalBankAccountUnpauseResponse]
+      # @return [Lithic::Models::ExternalBankAccount]
       #
       # @see Lithic::Models::ExternalBankAccountUnpauseParams
       def unpause(external_bank_account_token, params = {})
         @client.request(
           method: :post,
           path: ["v1/external_bank_accounts/%1$s/unpause", external_bank_account_token],
-          model: Lithic::Models::ExternalBankAccountUnpauseResponse,
+          model: Lithic::ExternalBankAccount,
           options: params[:request_options]
         )
       end

data/lib/lithic/resources/financial_accounts/balances.rb

@@ -19,7 +19,7 @@ module Lithic
         #
         # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
         #
-        # @return [Lithic::Internal::SinglePage<Lithic::Models::FinancialAccounts::BalanceListResponse>]
+        # @return [Lithic::Internal::SinglePage<Lithic::Models::FinancialAccountBalance>]
         #
         # @see Lithic::Models::FinancialAccounts::BalanceListParams
         def list(financial_account_token, params = {})
@@ -29,7 +29,7 @@ module Lithic
             path: ["v1/financial_accounts/%1$s/balances", financial_account_token],
             query: parsed,
             page: Lithic::Internal::SinglePage,
-            model: Lithic::Models::FinancialAccounts::BalanceListResponse,
+            model: Lithic::FinancialAccountBalance,
             options: options
           )
         end

data/lib/lithic/resources/funding_events.rb

@@ -11,14 +11,14 @@ module Lithic
       #
       # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Lithic::Models::FundingEventRetrieveResponse]
+      # @return [Lithic::Models::FundingEvent]
       #
       # @see Lithic::Models::FundingEventRetrieveParams
       def retrieve(funding_event_token, params = {})
         @client.request(
           method: :get,
           path: ["v1/funding_events/%1$s", funding_event_token],
-          model: Lithic::Models::FundingEventRetrieveResponse,
+          model: Lithic::FundingEvent,
           options: params[:request_options]
         )
       end
@@ -38,7 +38,7 @@ module Lithic
       #
       # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Lithic::Internal::CursorPage<Lithic::Models::FundingEventListResponse>]
+      # @return [Lithic::Internal::CursorPage<Lithic::Models::FundingEvent>]
       #
       # @see Lithic::Models::FundingEventListParams
       def list(params = {})
@@ -48,7 +48,7 @@ module Lithic
           path: "v1/funding_events",
           query: parsed,
           page: Lithic::Internal::CursorPage,
-          model: Lithic::Models::FundingEventListResponse,
+          model: Lithic::FundingEvent,
           options: options
         )
       end

data/lib/lithic/resources/internal_transaction.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Lithic
+  module Resources
+    class InternalTransaction
+      # @api private
+      #
+      # @param client [Lithic::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

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

@@ -13,14 +13,14 @@ module Lithic
           #
           # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
           #
-          # @return [Lithic::Models::Reports::Settlement::NetworkTotalRetrieveResponse]
+          # @return [Lithic::Models::NetworkTotal]
           #
           # @see Lithic::Models::Reports::Settlement::NetworkTotalRetrieveParams
           def retrieve(token, params = {})
             @client.request(
               method: :get,
               path: ["v1/reports/settlement/network_totals/%1$s", token],
-              model: Lithic::Models::Reports::Settlement::NetworkTotalRetrieveResponse,
+              model: Lithic::NetworkTotal,
               options: params[:request_options]
             )
           end
@@ -56,7 +56,7 @@ module Lithic
           #
           # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
           #
-          # @return [Lithic::Internal::CursorPage<Lithic::Models::Reports::Settlement::NetworkTotalListResponse>]
+          # @return [Lithic::Internal::CursorPage<Lithic::Models::NetworkTotal>]
           #
           # @see Lithic::Models::Reports::Settlement::NetworkTotalListParams
           def list(params = {})
@@ -66,7 +66,7 @@ module Lithic
               path: "v1/reports/settlement/network_totals",
               query: parsed.transform_keys(begin_: "begin", end_: "end"),
               page: Lithic::Internal::CursorPage,
-              model: Lithic::Models::Reports::Settlement::NetworkTotalListResponse,
+              model: Lithic::NetworkTotal,
               options: options
             )
           end

data/lib/lithic/resources/three_ds/authentication.rb

@@ -12,14 +12,14 @@ module Lithic
         #
         # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
         #
-        # @return [Lithic::Models::ThreeDS::AuthenticationRetrieveResponse]
+        # @return [Lithic::Models::ThreeDSAuthentication]
         #
         # @see Lithic::Models::ThreeDS::AuthenticationRetrieveParams
         def retrieve(three_ds_authentication_token, params = {})
           @client.request(
             method: :get,
             path: ["v1/three_ds_authentication/%1$s", three_ds_authentication_token],
-            model: Lithic::Models::ThreeDS::AuthenticationRetrieveResponse,
+            model: Lithic::ThreeDSAuthentication,
             options: params[:request_options]
           )
         end

data/lib/lithic/resources/tokenizations.rb

@@ -207,7 +207,7 @@ module Lithic
       #
       # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Lithic::Models::TokenizationSimulateResponse]
+      # @return [Lithic::Models::Tokenization]
       #
       # @see Lithic::Models::TokenizationSimulateParams
       def simulate(params)
@@ -216,7 +216,7 @@ module Lithic
           method: :post,
           path: "v1/simulate/tokenizations",
           body: parsed,
-          model: Lithic::Models::TokenizationSimulateResponse,
+          model: Lithic::Tokenization,
           options: options
         )
       end
@@ -267,7 +267,7 @@ module Lithic
       #
       # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Lithic::Models::TokenizationUpdateDigitalCardArtResponse]
+      # @return [Lithic::Models::Tokenization]
       #
       # @see Lithic::Models::TokenizationUpdateDigitalCardArtParams
       def update_digital_card_art(tokenization_token, params = {})
@@ -276,7 +276,7 @@ module Lithic
           method: :post,
           path: ["v1/tokenizations/%1$s/update_digital_card_art", tokenization_token],
           body: parsed,
-          model: Lithic::Models::TokenizationUpdateDigitalCardArtResponse,
+          model: Lithic::Tokenization,
           options: options
         )
       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.pre.alpha.56"
+  VERSION = "0.2.0"
 end