lithic 0.20.0 → 0.21.0

data/lib/lithic/resources/payments.rb

@@ -6,7 +6,14 @@ module Lithic
       # Some parameter documentations has been truncated, see
       # {Lithic::Models::PaymentCreateParams} for more details.
       #
-      # Initiates a payment between a financial account and an external bank account.
+      # Initiates an ACH payment between a financial account and an external bank
+      # account.
+      #
+      # This endpoint originates on the ACH rail only. To send a stablecoin payout, use
+      # the
+      # [Create stablecoin payment](https://docs.lithic.com/reference/createstablecoinpayment)
+      # endpoint. Payments on every rail are read back through
+      # [List payments](https://docs.lithic.com/reference/searchpayments).
       #
       # @overload create(amount:, external_bank_account_token:, financial_account_token:, method_:, method_attributes:, type:, token: nil, hold: nil, memo: nil, user_defined_id: nil, request_options: {})
       #
@@ -112,22 +119,83 @@ module Lithic
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Lithic::Models::PaymentCreateStablecoinParams} for more details.
+      #
+      # Initiates a stablecoin payout from a financial account to a registered
+      # blockchain recipient.
+      #
+      # The recipient must have been registered with
+      # [Create blockchain recipient](https://docs.lithic.com/reference/createblockchainrecipient)
+      # and have completed address screening — only a recipient in the `ENABLED`
+      # verification state can receive a payout. The destination address and chain come
+      # from the recipient, so they are not supplied here.
+      #
+      # Only payouts are initiated through this endpoint. Stablecoin pay-ins are
+      # credited from on-chain deposits to a financial account's deposit address and are
+      # not created through the API. Funds are placed on hold when the payout is
+      # initiated, and a payout that fails on chain reverses that hold. A payout cannot
+      # be cancelled once it has been submitted on chain.
+      #
+      # This endpoint is only available to stablecoin-enabled programs. Contact your
+      # customer success manager to learn more.
+      #
+      # @overload create_stablecoin(amount:, blockchain_recipient_token:, financial_account_token:, type:, token: nil, hold: nil, memo: nil, request_options: {})
+      #
+      # @param amount [Integer] Payout amount in cents
+      #
+      # @param blockchain_recipient_token [String] Token of the blockchain recipient to send the payout to. The recipient must be i
+      #
+      # @param financial_account_token [String] Token of the financial account the payout is funded from
+      #
+      # @param type [Symbol, Lithic::Models::PaymentCreateStablecoinParams::Type] Direction of the payment. Stablecoin supports payouts only
+      #
+      # @param token [String] Customer-provided token that will serve as an idempotency token. This token will
+      #
+      # @param hold [Lithic::Models::PaymentCreateStablecoinParams::Hold] Optional hold to settle when this payout is initiated
+      #
+      # @param memo [String] Memo recorded on the payout. Defaults to `Stablecoin payout on <chain>` when omi
+      #
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Lithic::Models::PaymentCreateStablecoinResponse]
+      #
+      # @see Lithic::Models::PaymentCreateStablecoinParams
+      def create_stablecoin(params)
+        parsed, options = Lithic::PaymentCreateStablecoinParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "v1/payments/stablecoin",
+          body: parsed,
+          model: Lithic::Models::PaymentCreateStablecoinResponse,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Lithic::Models::PaymentRetryParams} for more details.
+      #
       # Retry an origination which has been returned.
       #
-      # @overload retry_(payment_token, request_options: {})
+      # @overload retry_(payment_token, method_: nil, request_options: {})
       #
       # @param payment_token [String]
+      #
+      # @param method_ [Symbol, Lithic::Models::PaymentRetryParams::Method] Settlement speed to retry the payment at. Defaults to the original payment's met
+      #
       # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Lithic::Models::PaymentRetryResponse]
       #
       # @see Lithic::Models::PaymentRetryParams
       def retry_(payment_token, params = {})
+        parsed, options = Lithic::PaymentRetryParams.dump_request(params)
         @client.request(
           method: :post,
           path: ["v1/payments/%1$s/retry", payment_token],
+          body: parsed,
           model: Lithic::Models::PaymentRetryResponse,
-          options: params[:request_options]
+          options: options
         )
       end
 

data/lib/lithic/version.rb

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

data/lib/lithic.rb

@@ -169,6 +169,7 @@ require_relative "lithic/models/balance_list_params"
 require_relative "lithic/models/balance_updated_webhook_event"
 require_relative "lithic/models/blockchain_recipient"
 require_relative "lithic/models/blockchain_recipient_create_params"
+require_relative "lithic/models/blockchain_recipient_retrieve_params"
 require_relative "lithic/models/book_transfer_create_params"
 require_relative "lithic/models/book_transfer_list_params"
 require_relative "lithic/models/book_transfer_retrieve_params"
@@ -194,6 +195,7 @@ require_relative "lithic/models/card_embed_params"
 require_relative "lithic/models/card_embed_response"
 require_relative "lithic/models/cardholder_authentication"
 require_relative "lithic/models/card_list_params"
+require_relative "lithic/models/card_pin_updated_webhook_event"
 require_relative "lithic/models/card_program"
 require_relative "lithic/models/card_program_list_params"
 require_relative "lithic/models/card_program_retrieve_params"
@@ -322,9 +324,13 @@ require_relative "lithic/models/financial_accounts/credit_configuration_retrieve
 require_relative "lithic/models/financial_accounts/credit_configuration_update_params"
 require_relative "lithic/models/financial_accounts/financial_account_credit_config"
 require_relative "lithic/models/financial_accounts/loan_tape_configuration"
+require_relative "lithic/models/financial_accounts/open_to_buy"
 require_relative "lithic/models/financial_accounts/statements"
 require_relative "lithic/models/financial_accounts/financial_transaction_list_params"
 require_relative "lithic/models/financial_accounts/financial_transaction_retrieve_params"
+require_relative "lithic/models/financial_accounts/installment_plan"
+require_relative "lithic/models/financial_accounts/installment_plan_list_params"
+require_relative "lithic/models/financial_accounts/installment_plan_retrieve_params"
 require_relative "lithic/models/financial_accounts/interest_tier_schedule_create_params"
 require_relative "lithic/models/financial_accounts/interest_tier_schedule_delete_params"
 require_relative "lithic/models/financial_accounts/interest_tier_schedule_list_params"
@@ -334,10 +340,13 @@ require_relative "lithic/models/financial_accounts/loan_tape_configuration_retri
 require_relative "lithic/models/financial_accounts/loan_tape_list_params"
 require_relative "lithic/models/financial_accounts/loan_tape_rebuild_configuration"
 require_relative "lithic/models/financial_accounts/loan_tape_retrieve_params"
+require_relative "lithic/models/financial_accounts/open_to_buy_retrieve_params"
+require_relative "lithic/models/financial_accounts/open_to_buy_summary"
 require_relative "lithic/models/financial_accounts/statement_list_params"
 require_relative "lithic/models/financial_accounts/statement_retrieve_params"
 require_relative "lithic/models/financial_accounts/statements/line_item_list_params"
 require_relative "lithic/models/financial_accounts/statements/statement_line_items"
+require_relative "lithic/models/financial_accounts/transaction_category_balances"
 require_relative "lithic/models/financial_account_updated_webhook_event"
 require_relative "lithic/models/financial_account_update_params"
 require_relative "lithic/models/financial_account_update_status_params"
@@ -383,6 +392,8 @@ require_relative "lithic/models/owner_type"
 require_relative "lithic/models/parsed_webhook_event"
 require_relative "lithic/models/payment_create_params"
 require_relative "lithic/models/payment_create_response"
+require_relative "lithic/models/payment_create_stablecoin_params"
+require_relative "lithic/models/payment_create_stablecoin_response"
 require_relative "lithic/models/payment_list_params"
 require_relative "lithic/models/payment_retrieve_params"
 require_relative "lithic/models/payment_retry_params"
@@ -550,9 +561,11 @@ require_relative "lithic/resources/financial_accounts"
 require_relative "lithic/resources/financial_accounts/balances"
 require_relative "lithic/resources/financial_accounts/credit_configuration"
 require_relative "lithic/resources/financial_accounts/financial_transactions"
+require_relative "lithic/resources/financial_accounts/installment_plans"
 require_relative "lithic/resources/financial_accounts/interest_tier_schedule"
 require_relative "lithic/resources/financial_accounts/loan_tape_configuration"
 require_relative "lithic/resources/financial_accounts/loan_tapes"
+require_relative "lithic/resources/financial_accounts/open_to_buy"
 require_relative "lithic/resources/financial_accounts/statements"
 require_relative "lithic/resources/financial_accounts/statements/line_items"
 require_relative "lithic/resources/fraud"

data/rbi/lithic/models/account_activity_list_params.rbi

@@ -250,6 +250,11 @@ module Lithic
             :EXTERNAL_RTP,
             Lithic::AccountActivityListParams::Category::TaggedSymbol
           )
+        EXTERNAL_STABLECOIN =
+          T.let(
+            :EXTERNAL_STABLECOIN,
+            Lithic::AccountActivityListParams::Category::TaggedSymbol
+          )
         EXTERNAL_TRANSFER =
           T.let(
             :EXTERNAL_TRANSFER,

data/rbi/lithic/models/account_activity_list_response.rbi

@@ -256,6 +256,11 @@ module Lithic
               :EXTERNAL_RTP,
               Lithic::Models::AccountActivityListResponse::Internal::Category::TaggedSymbol
             )
+          EXTERNAL_STABLECOIN =
+            T.let(
+              :EXTERNAL_STABLECOIN,
+              Lithic::Models::AccountActivityListResponse::Internal::Category::TaggedSymbol
+            )
           EXTERNAL_TRANSFER =
             T.let(
               :EXTERNAL_TRANSFER,

data/rbi/lithic/models/account_activity_retrieve_transaction_response.rbi

@@ -256,6 +256,11 @@ module Lithic
               :EXTERNAL_RTP,
               Lithic::Models::AccountActivityRetrieveTransactionResponse::Internal::Category::TaggedSymbol
             )
+          EXTERNAL_STABLECOIN =
+            T.let(
+              :EXTERNAL_STABLECOIN,
+              Lithic::Models::AccountActivityRetrieveTransactionResponse::Internal::Category::TaggedSymbol
+            )
           EXTERNAL_TRANSFER =
             T.let(
               :EXTERNAL_TRANSFER,

data/rbi/lithic/models/auth_rules/auth_rule.rbi

@@ -85,6 +85,8 @@ module Lithic
         # - `TYPESCRIPT_CODE`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
         #   ACH_CREDIT_RECEIPT, ACH_DEBIT_RECEIPT, CARD_TRANSACTION_UPDATE, or
         #   ACH_PAYMENT_UPDATE event stream.
+        # - `OTHER`: A rule whose type is not exposed through this API. Rules of this type
+        #   are read-only; `OTHER` cannot be used when creating a rule.
         sig { returns(Lithic::AuthRules::AuthRule::Type::TaggedSymbol) }
         attr_accessor :type
 
@@ -167,6 +169,8 @@ module Lithic
           # - `TYPESCRIPT_CODE`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
           #   ACH_CREDIT_RECEIPT, ACH_DEBIT_RECEIPT, CARD_TRANSACTION_UPDATE, or
           #   ACH_PAYMENT_UPDATE event stream.
+          # - `OTHER`: A rule whose type is not exposed through this API. Rules of this type
+          #   are read-only; `OTHER` cannot be used when creating a rule.
           type:,
           # Account tokens to which the Auth Rule does not apply.
           excluded_account_tokens: nil,
@@ -517,6 +521,8 @@ module Lithic
         # - `TYPESCRIPT_CODE`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
         #   ACH_CREDIT_RECEIPT, ACH_DEBIT_RECEIPT, CARD_TRANSACTION_UPDATE, or
         #   ACH_PAYMENT_UPDATE event stream.
+        # - `OTHER`: A rule whose type is not exposed through this API. Rules of this type
+        #   are read-only; `OTHER` cannot be used when creating a rule.
         module Type
           extend Lithic::Internal::Type::Enum
 
@@ -549,6 +555,7 @@ module Lithic
               :TYPESCRIPT_CODE,
               Lithic::AuthRules::AuthRule::Type::TaggedSymbol
             )
+          OTHER = T.let(:OTHER, Lithic::AuthRules::AuthRule::Type::TaggedSymbol)
 
           sig do
             override.returns(

data/rbi/lithic/models/auth_rules/report_stats.rbi

@@ -453,6 +453,11 @@ module Lithic
                     :REVERSAL_UNMATCHED,
                     Lithic::AuthRules::ReportStats::Example::Action::DeclineActionAuthorization::Code::TaggedSymbol
                   )
+                SCA_REQUIRED =
+                  T.let(
+                    :SCA_REQUIRED,
+                    Lithic::AuthRules::ReportStats::Example::Action::DeclineActionAuthorization::Code::TaggedSymbol
+                  )
                 SECURITY_VIOLATION =
                   T.let(
                     :SECURITY_VIOLATION,

data/rbi/lithic/models/auth_rules/v2_create_params.rbi

@@ -109,6 +109,8 @@ module Lithic
             # - `TYPESCRIPT_CODE`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
             #   ACH_CREDIT_RECEIPT, ACH_DEBIT_RECEIPT, CARD_TRANSACTION_UPDATE, or
             #   ACH_PAYMENT_UPDATE event stream.
+            # - `OTHER`: A rule whose type is not exposed through this API. Rules of this type
+            #   are read-only; `OTHER` cannot be used when creating a rule.
             sig do
               returns(
                 Lithic::AuthRules::V2CreateParams::Body::AccountLevelRule::Type::OrSymbol
@@ -187,6 +189,8 @@ module Lithic
               # - `TYPESCRIPT_CODE`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
               #   ACH_CREDIT_RECEIPT, ACH_DEBIT_RECEIPT, CARD_TRANSACTION_UPDATE, or
               #   ACH_PAYMENT_UPDATE event stream.
+              # - `OTHER`: A rule whose type is not exposed through this API. Rules of this type
+              #   are read-only; `OTHER` cannot be used when creating a rule.
               type:,
               # Account tokens to which the Auth Rule applies.
               account_tokens: nil,
@@ -275,6 +279,8 @@ module Lithic
             # - `TYPESCRIPT_CODE`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
             #   ACH_CREDIT_RECEIPT, ACH_DEBIT_RECEIPT, CARD_TRANSACTION_UPDATE, or
             #   ACH_PAYMENT_UPDATE event stream.
+            # - `OTHER`: A rule whose type is not exposed through this API. Rules of this type
+            #   are read-only; `OTHER` cannot be used when creating a rule.
             module Type
               extend Lithic::Internal::Type::Enum
 
@@ -312,6 +318,11 @@ module Lithic
                   :TYPESCRIPT_CODE,
                   Lithic::AuthRules::V2CreateParams::Body::AccountLevelRule::Type::TaggedSymbol
                 )
+              OTHER =
+                T.let(
+                  :OTHER,
+                  Lithic::AuthRules::V2CreateParams::Body::AccountLevelRule::Type::TaggedSymbol
+                )
 
               sig do
                 override.returns(
@@ -373,6 +384,8 @@ module Lithic
             # - `TYPESCRIPT_CODE`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
             #   ACH_CREDIT_RECEIPT, ACH_DEBIT_RECEIPT, CARD_TRANSACTION_UPDATE, or
             #   ACH_PAYMENT_UPDATE event stream.
+            # - `OTHER`: A rule whose type is not exposed through this API. Rules of this type
+            #   are read-only; `OTHER` cannot be used when creating a rule.
             sig do
               returns(
                 Lithic::AuthRules::V2CreateParams::Body::CardLevelRule::Type::OrSymbol
@@ -438,6 +451,8 @@ module Lithic
               # - `TYPESCRIPT_CODE`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
               #   ACH_CREDIT_RECEIPT, ACH_DEBIT_RECEIPT, CARD_TRANSACTION_UPDATE, or
               #   ACH_PAYMENT_UPDATE event stream.
+              # - `OTHER`: A rule whose type is not exposed through this API. Rules of this type
+              #   are read-only; `OTHER` cannot be used when creating a rule.
               type:,
               # The event stream during which the rule will be evaluated.
               event_stream: nil,
@@ -521,6 +536,8 @@ module Lithic
             # - `TYPESCRIPT_CODE`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
             #   ACH_CREDIT_RECEIPT, ACH_DEBIT_RECEIPT, CARD_TRANSACTION_UPDATE, or
             #   ACH_PAYMENT_UPDATE event stream.
+            # - `OTHER`: A rule whose type is not exposed through this API. Rules of this type
+            #   are read-only; `OTHER` cannot be used when creating a rule.
             module Type
               extend Lithic::Internal::Type::Enum
 
@@ -558,6 +575,11 @@ module Lithic
                   :TYPESCRIPT_CODE,
                   Lithic::AuthRules::V2CreateParams::Body::CardLevelRule::Type::TaggedSymbol
                 )
+              OTHER =
+                T.let(
+                  :OTHER,
+                  Lithic::AuthRules::V2CreateParams::Body::CardLevelRule::Type::TaggedSymbol
+                )
 
               sig do
                 override.returns(
@@ -619,6 +641,8 @@ module Lithic
             # - `TYPESCRIPT_CODE`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
             #   ACH_CREDIT_RECEIPT, ACH_DEBIT_RECEIPT, CARD_TRANSACTION_UPDATE, or
             #   ACH_PAYMENT_UPDATE event stream.
+            # - `OTHER`: A rule whose type is not exposed through this API. Rules of this type
+            #   are read-only; `OTHER` cannot be used when creating a rule.
             sig do
               returns(
                 Lithic::AuthRules::V2CreateParams::Body::ProgramLevelRule::Type::OrSymbol
@@ -710,6 +734,8 @@ module Lithic
               # - `TYPESCRIPT_CODE`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
               #   ACH_CREDIT_RECEIPT, ACH_DEBIT_RECEIPT, CARD_TRANSACTION_UPDATE, or
               #   ACH_PAYMENT_UPDATE event stream.
+              # - `OTHER`: A rule whose type is not exposed through this API. Rules of this type
+              #   are read-only; `OTHER` cannot be used when creating a rule.
               type:,
               # The event stream during which the rule will be evaluated.
               event_stream: nil,
@@ -802,6 +828,8 @@ module Lithic
             # - `TYPESCRIPT_CODE`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
             #   ACH_CREDIT_RECEIPT, ACH_DEBIT_RECEIPT, CARD_TRANSACTION_UPDATE, or
             #   ACH_PAYMENT_UPDATE event stream.
+            # - `OTHER`: A rule whose type is not exposed through this API. Rules of this type
+            #   are read-only; `OTHER` cannot be used when creating a rule.
             module Type
               extend Lithic::Internal::Type::Enum
 
@@ -839,6 +867,11 @@ module Lithic
                   :TYPESCRIPT_CODE,
                   Lithic::AuthRules::V2CreateParams::Body::ProgramLevelRule::Type::TaggedSymbol
                 )
+              OTHER =
+                T.let(
+                  :OTHER,
+                  Lithic::AuthRules::V2CreateParams::Body::ProgramLevelRule::Type::TaggedSymbol
+                )
 
               sig do
                 override.returns(

data/rbi/lithic/models/auth_rules/v2_list_results_response.rbi

@@ -455,6 +455,11 @@ module Lithic
                     :REVERSAL_UNMATCHED,
                     Lithic::Models::AuthRules::V2ListResultsResponse::AuthorizationResult::Action::DeclineActionAuthorization::Code::TaggedSymbol
                   )
+                SCA_REQUIRED =
+                  T.let(
+                    :SCA_REQUIRED,
+                    Lithic::Models::AuthRules::V2ListResultsResponse::AuthorizationResult::Action::DeclineActionAuthorization::Code::TaggedSymbol
+                  )
                 SECURITY_VIOLATION =
                   T.let(
                     :SECURITY_VIOLATION,

data/rbi/lithic/models/blockchain_recipient_retrieve_params.rbi

@@ -0,0 +1,41 @@
+# typed: strong
+
+module Lithic
+  module Models
+    class BlockchainRecipientRetrieveParams < Lithic::Internal::Type::BaseModel
+      extend Lithic::Internal::Type::RequestParameters::Converter
+      include Lithic::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(
+            Lithic::BlockchainRecipientRetrieveParams,
+            Lithic::Internal::AnyHash
+          )
+        end
+
+      sig { returns(String) }
+      attr_accessor :blockchain_recipient_token
+
+      sig do
+        params(
+          blockchain_recipient_token: String,
+          request_options: Lithic::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(blockchain_recipient_token:, request_options: {})
+      end
+
+      sig do
+        override.returns(
+          {
+            blockchain_recipient_token: String,
+            request_options: Lithic::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/lithic/models/card_pin_updated_webhook_event.rbi

@@ -0,0 +1,166 @@
+# typed: strong
+
+module Lithic
+  module Models
+    class CardPinUpdatedWebhookEvent < Lithic::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Lithic::CardPinUpdatedWebhookEvent, Lithic::Internal::AnyHash)
+        end
+
+      # The token of the card whose PIN or PIN status was updated
+      sig { returns(String) }
+      attr_accessor :card_token
+
+      # The type of event that occurred.
+      sig { returns(Symbol) }
+      attr_accessor :event_type
+
+      # The card's PIN status after the update
+      sig do
+        returns(Lithic::CardPinUpdatedWebhookEvent::PinStatus::TaggedSymbol)
+      end
+      attr_accessor :pin_status
+
+      # The reason for the PIN update:
+      #
+      # - `PIN_SET` - The PIN was set for the first time; `pin_status` is `OK`
+      # - `PIN_CHANGED` - The PIN was changed, including when changing a blocked PIN;
+      #   `pin_status` is `OK`
+      # - `PIN_UNBLOCKED` - The PIN was unblocked without changing it; `pin_status` is
+      #   `OK`
+      # - `EXCESSIVE_PIN_ATTEMPTS` - The PIN was blocked due to excessive incorrect PIN
+      #   attempts; `pin_status` is `BLOCKED`
+      sig do
+        returns(Lithic::CardPinUpdatedWebhookEvent::StatusReason::TaggedSymbol)
+      end
+      attr_accessor :status_reason
+
+      sig do
+        params(
+          card_token: String,
+          pin_status: Lithic::CardPinUpdatedWebhookEvent::PinStatus::OrSymbol,
+          status_reason:
+            Lithic::CardPinUpdatedWebhookEvent::StatusReason::OrSymbol,
+          event_type: Symbol
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The token of the card whose PIN or PIN status was updated
+        card_token:,
+        # The card's PIN status after the update
+        pin_status:,
+        # The reason for the PIN update:
+        #
+        # - `PIN_SET` - The PIN was set for the first time; `pin_status` is `OK`
+        # - `PIN_CHANGED` - The PIN was changed, including when changing a blocked PIN;
+        #   `pin_status` is `OK`
+        # - `PIN_UNBLOCKED` - The PIN was unblocked without changing it; `pin_status` is
+        #   `OK`
+        # - `EXCESSIVE_PIN_ATTEMPTS` - The PIN was blocked due to excessive incorrect PIN
+        #   attempts; `pin_status` is `BLOCKED`
+        status_reason:,
+        # The type of event that occurred.
+        event_type: :"card.pin_updated"
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            card_token: String,
+            event_type: Symbol,
+            pin_status:
+              Lithic::CardPinUpdatedWebhookEvent::PinStatus::TaggedSymbol,
+            status_reason:
+              Lithic::CardPinUpdatedWebhookEvent::StatusReason::TaggedSymbol
+          }
+        )
+      end
+      def to_hash
+      end
+
+      # The card's PIN status after the update
+      module PinStatus
+        extend Lithic::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Lithic::CardPinUpdatedWebhookEvent::PinStatus)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        OK =
+          T.let(
+            :OK,
+            Lithic::CardPinUpdatedWebhookEvent::PinStatus::TaggedSymbol
+          )
+        BLOCKED =
+          T.let(
+            :BLOCKED,
+            Lithic::CardPinUpdatedWebhookEvent::PinStatus::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Lithic::CardPinUpdatedWebhookEvent::PinStatus::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+
+      # The reason for the PIN update:
+      #
+      # - `PIN_SET` - The PIN was set for the first time; `pin_status` is `OK`
+      # - `PIN_CHANGED` - The PIN was changed, including when changing a blocked PIN;
+      #   `pin_status` is `OK`
+      # - `PIN_UNBLOCKED` - The PIN was unblocked without changing it; `pin_status` is
+      #   `OK`
+      # - `EXCESSIVE_PIN_ATTEMPTS` - The PIN was blocked due to excessive incorrect PIN
+      #   attempts; `pin_status` is `BLOCKED`
+      module StatusReason
+        extend Lithic::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Lithic::CardPinUpdatedWebhookEvent::StatusReason)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        PIN_SET =
+          T.let(
+            :PIN_SET,
+            Lithic::CardPinUpdatedWebhookEvent::StatusReason::TaggedSymbol
+          )
+        PIN_CHANGED =
+          T.let(
+            :PIN_CHANGED,
+            Lithic::CardPinUpdatedWebhookEvent::StatusReason::TaggedSymbol
+          )
+        PIN_UNBLOCKED =
+          T.let(
+            :PIN_UNBLOCKED,
+            Lithic::CardPinUpdatedWebhookEvent::StatusReason::TaggedSymbol
+          )
+        EXCESSIVE_PIN_ATTEMPTS =
+          T.let(
+            :EXCESSIVE_PIN_ATTEMPTS,
+            Lithic::CardPinUpdatedWebhookEvent::StatusReason::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Lithic::CardPinUpdatedWebhookEvent::StatusReason::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/lithic/models/event.rbi

@@ -43,6 +43,8 @@ module Lithic
       # - card.converted: Occurs when a card is converted from virtual to physical
       #   cards.
       # - card.created: Occurs when a new card is created.
+      # - card.pin_updated: Occurs when a card's PIN is set, changed, unblocked, or
+      #   blocked due to excessive incorrect PIN attempts.
       # - card.reissued: Occurs when a card is reissued.
       # - card.renewed: Occurs when a card is renewed.
       # - card.shipped: Occurs when a card is shipped.
@@ -193,6 +195,8 @@ module Lithic
         # - card.converted: Occurs when a card is converted from virtual to physical
         #   cards.
         # - card.created: Occurs when a new card is created.
+        # - card.pin_updated: Occurs when a card's PIN is set, changed, unblocked, or
+        #   blocked due to excessive incorrect PIN attempts.
         # - card.reissued: Occurs when a card is reissued.
         # - card.renewed: Occurs when a card is renewed.
         # - card.shipped: Occurs when a card is shipped.
@@ -339,6 +343,8 @@ module Lithic
       # - card.converted: Occurs when a card is converted from virtual to physical
       #   cards.
       # - card.created: Occurs when a new card is created.
+      # - card.pin_updated: Occurs when a card's PIN is set, changed, unblocked, or
+      #   blocked due to excessive incorrect PIN attempts.
       # - card.reissued: Occurs when a card is reissued.
       # - card.renewed: Occurs when a card is renewed.
       # - card.shipped: Occurs when a card is shipped.
@@ -511,6 +517,8 @@ module Lithic
           T.let(:"card.converted", Lithic::Event::EventType::TaggedSymbol)
         CARD_CREATED =
           T.let(:"card.created", Lithic::Event::EventType::TaggedSymbol)
+        CARD_PIN_UPDATED =
+          T.let(:"card.pin_updated", Lithic::Event::EventType::TaggedSymbol)
         CARD_REISSUED =
           T.let(:"card.reissued", Lithic::Event::EventType::TaggedSymbol)
         CARD_RENEWED =

data/rbi/lithic/models/event_list_params.rbi

@@ -152,6 +152,8 @@ module Lithic
       # - card.converted: Occurs when a card is converted from virtual to physical
       #   cards.
       # - card.created: Occurs when a new card is created.
+      # - card.pin_updated: Occurs when a card's PIN is set, changed, unblocked, or
+      #   blocked due to excessive incorrect PIN attempts.
       # - card.reissued: Occurs when a card is reissued.
       # - card.renewed: Occurs when a card is renewed.
       # - card.shipped: Occurs when a card is shipped.
@@ -334,6 +336,11 @@ module Lithic
             :"card.created",
             Lithic::EventListParams::EventType::TaggedSymbol
           )
+        CARD_PIN_UPDATED =
+          T.let(
+            :"card.pin_updated",
+            Lithic::EventListParams::EventType::TaggedSymbol
+          )
         CARD_REISSUED =
           T.let(
             :"card.reissued",

data/rbi/lithic/models/event_subscription.rbi

@@ -100,6 +100,8 @@ module Lithic
       # - card.converted: Occurs when a card is converted from virtual to physical
       #   cards.
       # - card.created: Occurs when a new card is created.
+      # - card.pin_updated: Occurs when a card's PIN is set, changed, unblocked, or
+      #   blocked due to excessive incorrect PIN attempts.
       # - card.reissued: Occurs when a card is reissued.
       # - card.renewed: Occurs when a card is renewed.
       # - card.shipped: Occurs when a card is shipped.
@@ -282,6 +284,11 @@ module Lithic
             :"card.created",
             Lithic::EventSubscription::EventType::TaggedSymbol
           )
+        CARD_PIN_UPDATED =
+          T.let(
+            :"card.pin_updated",
+            Lithic::EventSubscription::EventType::TaggedSymbol
+          )
         CARD_REISSUED =
           T.let(
             :"card.reissued",