lithic 0.3.0 → 0.4.0

data/lib/lithic/resources/cards.rb

@@ -15,47 +15,49 @@ 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, 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: {})
+      # @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, idempotency_key: nil, request_options: {})
       #
-      # @param type [Symbol, Lithic::Models::CardCreateParams::Type] Card types:
+      # @param type [Symbol, Lithic::Models::CardCreateParams::Type] Body param: Card types:
       #
-      # @param account_token [String] Globally unique identifier for the account that the card will be associated with
+      # @param account_token [String] Body param: Globally unique identifier for the account that the card will be ass
       #
-      # @param bulk_order_token [String] Globally unique identifier for an existing bulk order to associate this card wit
+      # @param bulk_order_token [String] Body param: Globally unique identifier for an existing bulk order to associate t
       #
-      # @param card_program_token [String] For card programs with more than one BIN range. This must be configured with Lit
+      # @param card_program_token [String] Body param: For card programs with more than one BIN range. This must be configu
       #
-      # @param carrier [Lithic::Models::Carrier]
+      # @param carrier [Lithic::Models::Carrier] Body param
       #
-      # @param digital_card_art_token [String] Specifies the digital card art to be displayed in the user’s digital wallet afte
+      # @param digital_card_art_token [String] Body param: Specifies the digital card art to be displayed in the user’s digital
       #
-      # @param exp_month [String] Two digit (MM) expiry month. If neither `exp_month` nor `exp_year` is provided,
+      # @param exp_month [String] Body param: Two digit (MM) expiry month. If neither `exp_month` nor `exp_year` i
       #
-      # @param exp_year [String] Four digit (yyyy) expiry year. If neither `exp_month` nor `exp_year` is provided
+      # @param exp_year [String] Body param: Four digit (yyyy) expiry year. If neither `exp_month` nor `exp_year`
       #
-      # @param memo [String] Friendly name to identify the card.
+      # @param memo [String] Body param: Friendly name to identify the card.
       #
-      # @param pin [String] Encrypted PIN block (in base64). Applies to cards of type `PHYSICAL` and `VIRTUA
+      # @param pin [String] Body param: Encrypted PIN block (in base64). Applies to cards of type `PHYSICAL`
       #
-      # @param product_id [String] Only applicable to cards of type `PHYSICAL`. This must be configured with Lithic
+      # @param product_id [String] Body param: Only applicable to cards of type `PHYSICAL`. This must be configured
       #
-      # @param replacement_account_token [String] Restricted field limited to select use cases. Lithic will reach out directly if
+      # @param replacement_account_token [String] Body param: Restricted field limited to select use cases. Lithic will reach out
       #
-      # @param replacement_comment [String] Additional context or information related to the card that this card will replac
+      # @param replacement_comment [String] Body param: Additional context or information related to the card that this card
       #
-      # @param replacement_for [String] Globally unique identifier for the card that this card will replace. If the card
+      # @param replacement_for [String] Body param: Globally unique identifier for the card that this card will replace.
       #
-      # @param replacement_substatus [Symbol, Lithic::Models::CardCreateParams::ReplacementSubstatus] Card state substatus values for the card that this card will replace:
+      # @param replacement_substatus [Symbol, Lithic::Models::CardCreateParams::ReplacementSubstatus] Body param: Card state substatus values for the card that this card will replace
       #
-      # @param shipping_address [Lithic::Models::ShippingAddress]
+      # @param shipping_address [Lithic::Models::ShippingAddress] Body param
       #
-      # @param shipping_method [Symbol, Lithic::Models::CardCreateParams::ShippingMethod] Shipping method for the card. Only applies to cards of type PHYSICAL.
+      # @param shipping_method [Symbol, Lithic::Models::CardCreateParams::ShippingMethod] Body param: Shipping method for the card. Only applies to cards of type PHYSICAL
       #
-      # @param spend_limit [Integer] Amount (in cents) to limit approved authorizations (e.g. 100000 would be a $1,00
+      # @param spend_limit [Integer] Body param: Amount (in cents) to limit approved authorizations (e.g. 100000 woul
       #
-      # @param spend_limit_duration [Symbol, Lithic::Models::SpendLimitDuration] Spend limit duration values:
+      # @param spend_limit_duration [Symbol, Lithic::Models::SpendLimitDuration] Body param: Spend limit duration values:
+      #
+      # @param state [Symbol, Lithic::Models::CardCreateParams::State] Body param: Card state values:
       #
-      # @param state [Symbol, Lithic::Models::CardCreateParams::State] Card state values:
+      # @param idempotency_key [String] Header param: Idempotency key for the request
       #
       # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -64,7 +66,15 @@ module Lithic
       # @see Lithic::Models::CardCreateParams
       def create(params)
         parsed, options = Lithic::CardCreateParams.dump_request(params)
-        @client.request(method: :post, path: "v1/cards", body: parsed, model: Lithic::Card, options: options)
+        header_params = {idempotency_key: "idempotency-key"}
+        @client.request(
+          method: :post,
+          path: "v1/cards",
+          headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+          body: parsed.except(*header_params.keys),
+          model: Lithic::Card,
+          options: options
+        )
       end
 
       # Get card configuration such as spend limit and state.

data/lib/lithic/resources/financial_accounts.rb

@@ -22,15 +22,15 @@ module Lithic
       #
       # @overload create(nickname:, type:, account_token: nil, is_for_benefit_of: nil, idempotency_key: nil, request_options: {})
       #
-      # @param nickname [String] Body param:
+      # @param nickname [String] Body param
       #
-      # @param type [Symbol, Lithic::Models::FinancialAccountCreateParams::Type] Body param:
+      # @param type [Symbol, Lithic::Models::FinancialAccountCreateParams::Type] Body param
       #
-      # @param account_token [String] Body param:
+      # @param account_token [String] Body param
       #
-      # @param is_for_benefit_of [Boolean] Body param:
+      # @param is_for_benefit_of [Boolean] Body param
       #
-      # @param idempotency_key [String] Header param:
+      # @param idempotency_key [String] Header param: Idempotency key for the request
       #
       # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #

data/lib/lithic/resources/transactions.rb

@@ -105,7 +105,7 @@ module Lithic
       # [update account](https://docs.lithic.com/reference/patchaccountbytoken)
       # endpoint.
       #
-      # @overload simulate_authorization(amount:, descriptor:, pan:, mcc: nil, merchant_acceptor_id: nil, merchant_amount: nil, merchant_currency: nil, partial_approval_capable: nil, pin: nil, status: nil, request_options: {})
+      # @overload simulate_authorization(amount:, descriptor:, pan:, mcc: nil, merchant_acceptor_city: nil, merchant_acceptor_country: nil, merchant_acceptor_id: nil, merchant_acceptor_state: nil, merchant_amount: nil, merchant_currency: nil, partial_approval_capable: nil, pin: nil, status: nil, request_options: {})
       #
       # @param amount [Integer] Amount (in cents) to authorize. For credit authorizations and financial credit a
       #
@@ -115,8 +115,14 @@ module Lithic
       #
       # @param mcc [String] Merchant category code for the transaction to be simulated. A four-digit number
       #
+      # @param merchant_acceptor_city [String] Merchant acceptor city
+      #
+      # @param merchant_acceptor_country [String] Merchant acceptor country code (ISO 3166-1 alpha-3)
+      #
       # @param merchant_acceptor_id [String] Unique identifier to identify the payment card acceptor.
       #
+      # @param merchant_acceptor_state [String] Merchant acceptor state/province (ISO 3166-2 subdivision code)
+      #
       # @param merchant_amount [Integer] Amount of the transaction to be simulated in currency specified in merchant_curr
       #
       # @param merchant_currency [String] 3-character alphabetic ISO 4217 currency code. Note: Simulator only accepts USD,
@@ -211,7 +217,7 @@ module Lithic
       # Simulates a credit authorization advice from the card network. This message
       # indicates that the network approved a credit authorization on your behalf.
       #
-      # @overload simulate_credit_authorization_advice(amount:, descriptor:, pan:, mcc: nil, merchant_acceptor_id: nil, request_options: {})
+      # @overload simulate_credit_authorization_advice(amount:, descriptor:, pan:, mcc: nil, merchant_acceptor_city: nil, merchant_acceptor_country: nil, merchant_acceptor_id: nil, merchant_acceptor_state: nil, request_options: {})
       #
       # @param amount [Integer] Amount (in cents). Any value entered will be converted into a negative amount in
       #
@@ -221,8 +227,14 @@ module Lithic
       #
       # @param mcc [String] Merchant category code for the transaction to be simulated. A four-digit number
       #
+      # @param merchant_acceptor_city [String] Merchant acceptor city
+      #
+      # @param merchant_acceptor_country [String] Merchant acceptor country code (ISO 3166-1 alpha-3)
+      #
       # @param merchant_acceptor_id [String] Unique identifier to identify the payment card acceptor.
       #
+      # @param merchant_acceptor_state [String] Merchant acceptor state/province (ISO 3166-2 subdivision code)
+      #
       # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Lithic::Models::TransactionSimulateCreditAuthorizationAdviceResponse]

data/lib/lithic/resources/webhooks.rb

@@ -32,7 +32,7 @@ module Lithic
       #
       # @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::CardAuthorizationApprovalRequestWebhookEvent, 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::ThreeDSAuthenticationApprovalRequestWebhookEvent, Lithic::Models::DisputeTransactionCreatedWebhookEvent, Lithic::Models::DisputeTransactionUpdatedWebhookEvent]
+      # @return [Lithic::Models::AccountHolderCreatedWebhookEvent, Lithic::Models::ParsedWebhookEvent::KYBPayload, Lithic::Models::ParsedWebhookEvent::KYCPayload, Lithic::Models::ParsedWebhookEvent::LegacyPayload, Lithic::Models::AccountHolderVerificationWebhookEvent, Lithic::Models::AccountHolderDocumentUpdatedWebhookEvent, Lithic::Models::CardAuthorizationApprovalRequestWebhookEvent, 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::CardUpdatedWebhookEvent, 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::ThreeDSAuthenticationApprovalRequestWebhookEvent, 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)

data/lib/lithic/version.rb

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

data/lib/lithic.rb

@@ -185,6 +185,7 @@ require_relative "lithic/models/card_spend_limits"
 require_relative "lithic/models/card_transaction_enhanced_data_created_webhook_event"
 require_relative "lithic/models/card_transaction_enhanced_data_updated_webhook_event"
 require_relative "lithic/models/card_transaction_updated_webhook_event"
+require_relative "lithic/models/card_updated_webhook_event"
 require_relative "lithic/models/card_update_params"
 require_relative "lithic/models/card_web_provision_params"
 require_relative "lithic/models/card_web_provision_response"

data/rbi/lithic/models/auth_rules/velocity_limit_params.rbi

@@ -12,16 +12,6 @@ module Lithic
             )
           end
 
-        sig { returns(Lithic::AuthRules::VelocityLimitParams::Filters) }
-        attr_reader :filters
-
-        sig do
-          params(
-            filters: Lithic::AuthRules::VelocityLimitParams::Filters::OrHash
-          ).void
-        end
-        attr_writer :filters
-
         # Velocity over the current day since 00:00 / 12 AM in Eastern Time
         sig do
           returns(
@@ -40,6 +30,18 @@ module Lithic
         sig { returns(Lithic::AuthRules::VelocityLimitParams::Scope::OrSymbol) }
         attr_accessor :scope
 
+        sig do
+          returns(T.nilable(Lithic::AuthRules::VelocityLimitParams::Filters))
+        end
+        attr_reader :filters
+
+        sig do
+          params(
+            filters: Lithic::AuthRules::VelocityLimitParams::Filters::OrHash
+          ).void
+        end
+        attr_writer :filters
+
         # The maximum amount of spend velocity allowed in the period in minor units (the
         # smallest unit of a currency, e.g. cents for USD). Transactions exceeding this
         # limit will be declined.
@@ -56,7 +58,6 @@ module Lithic
 
         sig do
           params(
-            filters: Lithic::AuthRules::VelocityLimitParams::Filters::OrHash,
             period:
               T.any(
                 Lithic::AuthRules::VelocityLimitPeriod::TrailingWindowObject::OrHash,
@@ -66,16 +67,17 @@ module Lithic
                 Lithic::AuthRules::VelocityLimitPeriod::FixedWindowYear::OrHash
               ),
             scope: Lithic::AuthRules::VelocityLimitParams::Scope::OrSymbol,
+            filters: Lithic::AuthRules::VelocityLimitParams::Filters::OrHash,
             limit_amount: T.nilable(Integer),
             limit_count: T.nilable(Integer)
           ).returns(T.attached_class)
         end
         def self.new(
-          filters:,
           # Velocity over the current day since 00:00 / 12 AM in Eastern Time
           period:,
           # The scope the velocity is calculated for
           scope:,
+          filters: nil,
           # The maximum amount of spend velocity allowed in the period in minor units (the
           # smallest unit of a currency, e.g. cents for USD). Transactions exceeding this
           # limit will be declined.
@@ -92,7 +94,6 @@ module Lithic
         sig do
           override.returns(
             {
-              filters: Lithic::AuthRules::VelocityLimitParams::Filters,
               period:
                 T.any(
                   Lithic::AuthRules::VelocityLimitPeriod::TrailingWindowObject,
@@ -102,6 +103,7 @@ module Lithic
                   Lithic::AuthRules::VelocityLimitPeriod::FixedWindowYear
                 ),
               scope: Lithic::AuthRules::VelocityLimitParams::Scope::OrSymbol,
+              filters: Lithic::AuthRules::VelocityLimitParams::Filters,
               limit_amount: T.nilable(Integer),
               limit_count: T.nilable(Integer)
             }
@@ -110,6 +112,38 @@ module Lithic
         def to_hash
         end
 
+        # The scope the velocity is calculated for
+        module Scope
+          extend Lithic::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, Lithic::AuthRules::VelocityLimitParams::Scope)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          CARD =
+            T.let(
+              :CARD,
+              Lithic::AuthRules::VelocityLimitParams::Scope::TaggedSymbol
+            )
+          ACCOUNT =
+            T.let(
+              :ACCOUNT,
+              Lithic::AuthRules::VelocityLimitParams::Scope::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                Lithic::AuthRules::VelocityLimitParams::Scope::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+
         class Filters < Lithic::Internal::Type::BaseModel
           OrHash =
             T.type_alias do
@@ -307,38 +341,6 @@ module Lithic
             end
           end
         end
-
-        # The scope the velocity is calculated for
-        module Scope
-          extend Lithic::Internal::Type::Enum
-
-          TaggedSymbol =
-            T.type_alias do
-              T.all(Symbol, Lithic::AuthRules::VelocityLimitParams::Scope)
-            end
-          OrSymbol = T.type_alias { T.any(Symbol, String) }
-
-          CARD =
-            T.let(
-              :CARD,
-              Lithic::AuthRules::VelocityLimitParams::Scope::TaggedSymbol
-            )
-          ACCOUNT =
-            T.let(
-              :ACCOUNT,
-              Lithic::AuthRules::VelocityLimitParams::Scope::TaggedSymbol
-            )
-
-          sig do
-            override.returns(
-              T::Array[
-                Lithic::AuthRules::VelocityLimitParams::Scope::TaggedSymbol
-              ]
-            )
-          end
-          def self.values
-          end
-        end
       end
     end
   end

data/rbi/lithic/models/card_create_params.rbi

@@ -21,8 +21,8 @@ module Lithic
       #   Reach out at [lithic.com/contact](https://lithic.com/contact) for more
       #   information.
       # - `SINGLE_USE` - Card is closed upon first successful authorization.
-      # - `MERCHANT_LOCKED` - _[Deprecated]_ Card is locked to the first merchant that
-      #   successfully authorizes the card.
+      # - `MERCHANT_LOCKED` - Card is locked to the first merchant that successfully
+      #   authorizes the card.
       # - `UNLOCKED` - _[Deprecated]_ Similar behavior to VIRTUAL cards, please use
       #   VIRTUAL instead.
       # - `DIGITAL_WALLET` - _[Deprecated]_ Similar behavior to VIRTUAL cards, please
@@ -264,6 +264,12 @@ module Lithic
       sig { params(state: Lithic::CardCreateParams::State::OrSymbol).void }
       attr_writer :state
 
+      sig { returns(T.nilable(String)) }
+      attr_reader :idempotency_key
+
+      sig { params(idempotency_key: String).void }
+      attr_writer :idempotency_key
+
       sig do
         params(
           type: Lithic::CardCreateParams::Type::OrSymbol,
@@ -287,6 +293,7 @@ module Lithic
           spend_limit: Integer,
           spend_limit_duration: Lithic::SpendLimitDuration::OrSymbol,
           state: Lithic::CardCreateParams::State::OrSymbol,
+          idempotency_key: String,
           request_options: Lithic::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
@@ -301,8 +308,8 @@ module Lithic
         #   Reach out at [lithic.com/contact](https://lithic.com/contact) for more
         #   information.
         # - `SINGLE_USE` - Card is closed upon first successful authorization.
-        # - `MERCHANT_LOCKED` - _[Deprecated]_ Card is locked to the first merchant that
-        #   successfully authorizes the card.
+        # - `MERCHANT_LOCKED` - Card is locked to the first merchant that successfully
+        #   authorizes the card.
         # - `UNLOCKED` - _[Deprecated]_ Similar behavior to VIRTUAL cards, please use
         #   VIRTUAL instead.
         # - `DIGITAL_WALLET` - _[Deprecated]_ Similar behavior to VIRTUAL cards, please
@@ -430,6 +437,7 @@ module Lithic
         # - `PAUSED` - Card will decline authorizations, but can be resumed at a later
         #   time.
         state: nil,
+        idempotency_key: nil,
         request_options: {}
       )
       end
@@ -458,6 +466,7 @@ module Lithic
             spend_limit: Integer,
             spend_limit_duration: Lithic::SpendLimitDuration::OrSymbol,
             state: Lithic::CardCreateParams::State::OrSymbol,
+            idempotency_key: String,
             request_options: Lithic::RequestOptions
           }
         )
@@ -475,8 +484,8 @@ module Lithic
       #   Reach out at [lithic.com/contact](https://lithic.com/contact) for more
       #   information.
       # - `SINGLE_USE` - Card is closed upon first successful authorization.
-      # - `MERCHANT_LOCKED` - _[Deprecated]_ Card is locked to the first merchant that
-      #   successfully authorizes the card.
+      # - `MERCHANT_LOCKED` - Card is locked to the first merchant that successfully
+      #   authorizes the card.
       # - `UNLOCKED` - _[Deprecated]_ Similar behavior to VIRTUAL cards, please use
       #   VIRTUAL instead.
       # - `DIGITAL_WALLET` - _[Deprecated]_ Similar behavior to VIRTUAL cards, please

data/rbi/lithic/models/card_updated_webhook_event.rbi

@@ -0,0 +1,61 @@
+# typed: strong
+
+module Lithic
+  module Models
+    class CardUpdatedWebhookEvent < Lithic::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Lithic::CardUpdatedWebhookEvent, Lithic::Internal::AnyHash)
+        end
+
+      # The token of the card that was updated.
+      sig { returns(String) }
+      attr_accessor :card_token
+
+      # The type of event that occurred.
+      sig { returns(Symbol) }
+      attr_accessor :event_type
+
+      # The previous values of the fields that were updated.
+      sig { returns(T.anything) }
+      attr_accessor :previous_fields
+
+      # The current state of the card.
+      sig { returns(String) }
+      attr_accessor :state
+
+      sig do
+        params(
+          card_token: String,
+          previous_fields: T.anything,
+          state: String,
+          event_type: Symbol
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The token of the card that was updated.
+        card_token:,
+        # The previous values of the fields that were updated.
+        previous_fields:,
+        # The current state of the card.
+        state:,
+        # The type of event that occurred.
+        event_type: :"card.updated"
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            card_token: String,
+            event_type: Symbol,
+            previous_fields: T.anything,
+            state: String
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/lithic/models/card_web_provision_response.rbi

@@ -25,9 +25,7 @@ module Lithic
         # JWS object required for handoff to Apple's script.
         sig do
           returns(
-            T.nilable(
-              Lithic::Models::CardWebProvisionResponse::AppleWebPushProvisioningResponse::Jws
-            )
+            Lithic::Models::CardWebProvisionResponse::AppleWebPushProvisioningResponse::Jws
           )
         end
         attr_reader :jws
@@ -41,11 +39,8 @@ module Lithic
         attr_writer :jws
 
         # A unique identifier for the JWS object.
-        sig { returns(T.nilable(String)) }
-        attr_reader :state
-
-        sig { params(state: String).void }
-        attr_writer :state
+        sig { returns(String) }
+        attr_accessor :state
 
         sig do
           params(
@@ -56,9 +51,9 @@ module Lithic
         end
         def self.new(
           # JWS object required for handoff to Apple's script.
-          jws: nil,
+          jws:,
           # A unique identifier for the JWS object.
-          state: nil
+          state:
         )
         end
 

data/rbi/lithic/models/event.rbi

@@ -40,6 +40,7 @@ module Lithic
       # - card.reissued: Occurs when a card is reissued.
       # - card.renewed: Occurs when a card is renewed.
       # - card.shipped: Occurs when a card is shipped.
+      # - card.updated: Occurs when a card is updated.
       # - digital_wallet.tokenization_approval_request: Occurs when a tokenization
       #   approval request is made. This event will be deprecated in the future. We
       #   recommend using `tokenization.approval_request` instead.
@@ -162,6 +163,7 @@ module Lithic
         # - card.reissued: Occurs when a card is reissued.
         # - card.renewed: Occurs when a card is renewed.
         # - card.shipped: Occurs when a card is shipped.
+        # - card.updated: Occurs when a card is updated.
         # - digital_wallet.tokenization_approval_request: Occurs when a tokenization
         #   approval request is made. This event will be deprecated in the future. We
         #   recommend using `tokenization.approval_request` instead.
@@ -280,6 +282,7 @@ module Lithic
       # - card.reissued: Occurs when a card is reissued.
       # - card.renewed: Occurs when a card is renewed.
       # - card.shipped: Occurs when a card is shipped.
+      # - card.updated: Occurs when a card is updated.
       # - digital_wallet.tokenization_approval_request: Occurs when a tokenization
       #   approval request is made. This event will be deprecated in the future. We
       #   recommend using `tokenization.approval_request` instead.
@@ -423,6 +426,8 @@ module Lithic
           T.let(:"card.renewed", Lithic::Event::EventType::TaggedSymbol)
         CARD_SHIPPED =
           T.let(:"card.shipped", Lithic::Event::EventType::TaggedSymbol)
+        CARD_UPDATED =
+          T.let(:"card.updated", Lithic::Event::EventType::TaggedSymbol)
         DIGITAL_WALLET_TOKENIZATION_APPROVAL_REQUEST =
           T.let(
             :"digital_wallet.tokenization_approval_request",

data/rbi/lithic/models/event_list_params.rbi

@@ -149,6 +149,7 @@ module Lithic
       # - card.reissued: Occurs when a card is reissued.
       # - card.renewed: Occurs when a card is renewed.
       # - card.shipped: Occurs when a card is shipped.
+      # - card.updated: Occurs when a card is updated.
       # - digital_wallet.tokenization_approval_request: Occurs when a tokenization
       #   approval request is made. This event will be deprecated in the future. We
       #   recommend using `tokenization.approval_request` instead.
@@ -311,6 +312,11 @@ module Lithic
             :"card.shipped",
             Lithic::EventListParams::EventType::TaggedSymbol
           )
+        CARD_UPDATED =
+          T.let(
+            :"card.updated",
+            Lithic::EventListParams::EventType::TaggedSymbol
+          )
         DIGITAL_WALLET_TOKENIZATION_APPROVAL_REQUEST =
           T.let(
             :"digital_wallet.tokenization_approval_request",

data/rbi/lithic/models/event_subscription.rbi

@@ -97,6 +97,7 @@ module Lithic
       # - card.reissued: Occurs when a card is reissued.
       # - card.renewed: Occurs when a card is renewed.
       # - card.shipped: Occurs when a card is shipped.
+      # - card.updated: Occurs when a card is updated.
       # - digital_wallet.tokenization_approval_request: Occurs when a tokenization
       #   approval request is made. This event will be deprecated in the future. We
       #   recommend using `tokenization.approval_request` instead.
@@ -259,6 +260,11 @@ module Lithic
             :"card.shipped",
             Lithic::EventSubscription::EventType::TaggedSymbol
           )
+        CARD_UPDATED =
+          T.let(
+            :"card.updated",
+            Lithic::EventSubscription::EventType::TaggedSymbol
+          )
         DIGITAL_WALLET_TOKENIZATION_APPROVAL_REQUEST =
           T.let(
             :"digital_wallet.tokenization_approval_request",

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

@@ -124,6 +124,7 @@ module Lithic
         # - card.reissued: Occurs when a card is reissued.
         # - card.renewed: Occurs when a card is renewed.
         # - card.shipped: Occurs when a card is shipped.
+        # - card.updated: Occurs when a card is updated.
         # - digital_wallet.tokenization_approval_request: Occurs when a tokenization
         #   approval request is made. This event will be deprecated in the future. We
         #   recommend using `tokenization.approval_request` instead.
@@ -288,6 +289,11 @@ module Lithic
               :"card.shipped",
               Lithic::Events::SubscriptionCreateParams::EventType::TaggedSymbol
             )
+          CARD_UPDATED =
+            T.let(
+              :"card.updated",
+              Lithic::Events::SubscriptionCreateParams::EventType::TaggedSymbol
+            )
           DIGITAL_WALLET_TOKENIZATION_APPROVAL_REQUEST =
             T.let(
               :"digital_wallet.tokenization_approval_request",

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

@@ -152,6 +152,11 @@ module Lithic
               :"card.shipped",
               Lithic::Events::SubscriptionSendSimulatedExampleParams::EventType::TaggedSymbol
             )
+          CARD_UPDATED =
+            T.let(
+              :"card.updated",
+              Lithic::Events::SubscriptionSendSimulatedExampleParams::EventType::TaggedSymbol
+            )
           DIGITAL_WALLET_TOKENIZATION_APPROVAL_REQUEST =
             T.let(
               :"digital_wallet.tokenization_approval_request",

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

@@ -124,6 +124,7 @@ module Lithic
         # - card.reissued: Occurs when a card is reissued.
         # - card.renewed: Occurs when a card is renewed.
         # - card.shipped: Occurs when a card is shipped.
+        # - card.updated: Occurs when a card is updated.
         # - digital_wallet.tokenization_approval_request: Occurs when a tokenization
         #   approval request is made. This event will be deprecated in the future. We
         #   recommend using `tokenization.approval_request` instead.
@@ -288,6 +289,11 @@ module Lithic
               :"card.shipped",
               Lithic::Events::SubscriptionUpdateParams::EventType::TaggedSymbol
             )
+          CARD_UPDATED =
+            T.let(
+              :"card.updated",
+              Lithic::Events::SubscriptionUpdateParams::EventType::TaggedSymbol
+            )
           DIGITAL_WALLET_TOKENIZATION_APPROVAL_REQUEST =
             T.let(
               :"digital_wallet.tokenization_approval_request",