lithic 0.1.0.pre.alpha.39 → 0.1.0.pre.alpha.41

data/lib/lithic/models/book_transfer_response.rb

@@ -36,6 +36,18 @@ module Lithic
       #   @return [Array<Lithic::Models::BookTransferResponse::Event>]
       required :events, -> { Lithic::Internal::Type::ArrayOf[Lithic::BookTransferResponse::Event] }
 
+      # @!attribute external_id
+      #   External ID defined by the customer
+      #
+      #   @return [String, nil]
+      required :external_id, String, nil?: true
+
+      # @!attribute external_resource
+      #   External resource associated with the management operation
+      #
+      #   @return [Lithic::Models::ExternalResource, nil]
+      required :external_resource, -> { Lithic::ExternalResource }, nil?: true
+
       # @!attribute from_financial_account_token
       #   Globally unique identifier for the financial account or card that will send the
       #   funds. Accepted type dependent on the program's use case.
@@ -45,15 +57,15 @@ module Lithic
 
       # @!attribute pending_amount
       #   Pending amount of the transaction in the currency's smallest unit (e.g., cents),
-      #   including any acquirer fees. The value of this field will go to zero over time
-      #   once the financial transaction is settled.
+      #   including any acquirer fees.
+      #
+      #   The value of this field will go to zero over time once the financial transaction
+      #   is settled.
       #
       #   @return [Integer]
       required :pending_amount, Integer
 
       # @!attribute result
-      #   APPROVED transactions were successful while DECLINED transactions were declined
-      #   by user, Lithic, or the network.
       #
       #   @return [Symbol, Lithic::Models::BookTransferResponse::Result]
       required :result, enum: -> { Lithic::BookTransferResponse::Result }
@@ -66,8 +78,11 @@ module Lithic
       required :settled_amount, Integer
 
       # @!attribute status
-      #   Status types: _ `DECLINED` - The transfer was declined. _ `REVERSED` - The
-      #   transfer was reversed \* `SETTLED` - The transfer is completed.
+      #   Status types:
+      #
+      #   - `DECLINED` - The transfer was declined.
+      #   - `REVERSED` - The transfer was reversed
+      #   - `SETTLED` - The transfer is completed.
       #
       #   @return [Symbol, Lithic::Models::BookTransferResponse::Status]
       required :status, enum: -> { Lithic::BookTransferResponse::Status }
@@ -76,8 +91,14 @@ module Lithic
       #   Globally unique identifier for the financial account or card that will receive
       #   the funds. Accepted type dependent on the program's use case.
       #
-      #   @return [Object]
-      required :to_financial_account_token, Lithic::Internal::Type::Unknown
+      #   @return [String]
+      required :to_financial_account_token, String
+
+      # @!attribute transaction_series
+      #   A series of transactions that are grouped together.
+      #
+      #   @return [Lithic::Models::BookTransferResponse::TransactionSeries, nil]
+      required :transaction_series, -> { Lithic::BookTransferResponse::TransactionSeries }, nil?: true
 
       # @!attribute updated
       #   Date and time when the financial transaction was last updated. UTC time zone.
@@ -85,7 +106,7 @@ module Lithic
       #   @return [Time]
       required :updated, Time
 
-      # @!method initialize(token:, category:, created:, currency:, events:, from_financial_account_token:, pending_amount:, result:, settled_amount:, status:, to_financial_account_token:, updated:)
+      # @!method initialize(token:, category:, created:, currency:, events:, external_id:, external_resource:, from_financial_account_token:, pending_amount:, result:, settled_amount:, status:, to_financial_account_token:, transaction_series:, updated:)
       #   Some parameter documentations has been truncated, see
       #   {Lithic::Models::BookTransferResponse} for more details.
       #
@@ -99,17 +120,23 @@ module Lithic
       #
       #   @param events [Array<Lithic::Models::BookTransferResponse::Event>] A list of all financial events that have modified this transfer.
       #
+      #   @param external_id [String, nil] External ID defined by the customer
+      #
+      #   @param external_resource [Lithic::Models::ExternalResource, nil] External resource associated with the management operation
+      #
       #   @param from_financial_account_token [String] Globally unique identifier for the financial account or card that will send the
       #
       #   @param pending_amount [Integer] Pending amount of the transaction in the currency's smallest unit (e.g., cents),
       #
-      #   @param result [Symbol, Lithic::Models::BookTransferResponse::Result] APPROVED transactions were successful while DECLINED transactions were declined
+      #   @param result [Symbol, Lithic::Models::BookTransferResponse::Result]
       #
       #   @param settled_amount [Integer] Amount of the transaction that has been settled in the currency's smallest unit
       #
-      #   @param status [Symbol, Lithic::Models::BookTransferResponse::Status] Status types: _ `DECLINED` - The transfer was declined. _ `REVERSED` - The trans
+      #   @param status [Symbol, Lithic::Models::BookTransferResponse::Status] Status types:
+      #
+      #   @param to_financial_account_token [String] Globally unique identifier for the financial account or card that will receive t
       #
-      #   @param to_financial_account_token [Object] Globally unique identifier for the financial account or card that will receive t
+      #   @param transaction_series [Lithic::Models::BookTransferResponse::TransactionSeries, nil] A series of transactions that are grouped together.
       #
       #   @param updated [Time] Date and time when the financial transaction was last updated. UTC time zone.
 
@@ -152,13 +179,9 @@ module Lithic
         required :created, Time
 
         # @!attribute detailed_results
-        #   Detailed Results
         #
-        #   @return [Array<Symbol, Lithic::Models::BookTransferResponse::Event::DetailedResult>]
-        required :detailed_results,
-                 -> {
-                   Lithic::Internal::Type::ArrayOf[enum: Lithic::BookTransferResponse::Event::DetailedResult]
-                 }
+        #   @return [Symbol, Lithic::Models::BookTransferResponse::Event::DetailedResults]
+        required :detailed_results, enum: -> { Lithic::BookTransferResponse::Event::DetailedResults }
 
         # @!attribute memo
         #   Memo for the transfer.
@@ -182,20 +205,22 @@ module Lithic
         # @!attribute type
         #   Type of the book transfer
         #
-        #   @return [String]
-        required :type, String
+        #   @return [Symbol, Lithic::Models::BookTransferResponse::Event::Type]
+        required :type, enum: -> { Lithic::BookTransferResponse::Event::Type }
 
         # @!method initialize(token:, amount:, created:, detailed_results:, memo:, result:, subtype:, type:)
         #   Some parameter documentations has been truncated, see
         #   {Lithic::Models::BookTransferResponse::Event} for more details.
         #
+        #   Book transfer Event
+        #
         #   @param token [String] Globally unique identifier.
         #
         #   @param amount [Integer] Amount of the financial event that has been settled in the currency's smallest u
         #
         #   @param created [Time] Date and time when the financial event occurred. UTC time zone.
         #
-        #   @param detailed_results [Array<Symbol, Lithic::Models::BookTransferResponse::Event::DetailedResult>] Detailed Results
+        #   @param detailed_results [Symbol, Lithic::Models::BookTransferResponse::Event::DetailedResults]
         #
         #   @param memo [String] Memo for the transfer.
         #
@@ -203,9 +228,10 @@ module Lithic
         #
         #   @param subtype [String] The program specific subtype code for the specified category/type.
         #
-        #   @param type [String] Type of the book transfer
+        #   @param type [Symbol, Lithic::Models::BookTransferResponse::Event::Type] Type of the book transfer
 
-        module DetailedResult
+        # @see Lithic::Models::BookTransferResponse::Event#detailed_results
+        module DetailedResults
           extend Lithic::Internal::Type::Enum
 
           APPROVED = :APPROVED
@@ -228,11 +254,53 @@ module Lithic
           # @!method self.values
           #   @return [Array<Symbol>]
         end
+
+        # Type of the book transfer
+        #
+        # @see Lithic::Models::BookTransferResponse::Event#type
+        module Type
+          extend Lithic::Internal::Type::Enum
+
+          ATM_WITHDRAWAL = :ATM_WITHDRAWAL
+          ATM_DECLINE = :ATM_DECLINE
+          INTERNATIONAL_ATM_WITHDRAWAL = :INTERNATIONAL_ATM_WITHDRAWAL
+          INACTIVITY = :INACTIVITY
+          STATEMENT = :STATEMENT
+          MONTHLY = :MONTHLY
+          QUARTERLY = :QUARTERLY
+          ANNUAL = :ANNUAL
+          CUSTOMER_SERVICE = :CUSTOMER_SERVICE
+          ACCOUNT_MAINTENANCE = :ACCOUNT_MAINTENANCE
+          ACCOUNT_ACTIVATION = :ACCOUNT_ACTIVATION
+          ACCOUNT_CLOSURE = :ACCOUNT_CLOSURE
+          CARD_REPLACEMENT = :CARD_REPLACEMENT
+          CARD_DELIVERY = :CARD_DELIVERY
+          CARD_CREATE = :CARD_CREATE
+          CURRENCY_CONVERSION = :CURRENCY_CONVERSION
+          INTEREST = :INTEREST
+          LATE_PAYMENT = :LATE_PAYMENT
+          BILL_PAYMENT = :BILL_PAYMENT
+          CASH_BACK = :CASH_BACK
+          ACCOUNT_TO_ACCOUNT = :ACCOUNT_TO_ACCOUNT
+          CARD_TO_CARD = :CARD_TO_CARD
+          DISBURSE = :DISBURSE
+          BILLING_ERROR = :BILLING_ERROR
+          LOSS_WRITE_OFF = :LOSS_WRITE_OFF
+          EXPIRED_CARD = :EXPIRED_CARD
+          EARLY_DERECOGNITION = :EARLY_DERECOGNITION
+          ESCHEATMENT = :ESCHEATMENT
+          INACTIVITY_FEE_DOWN = :INACTIVITY_FEE_DOWN
+          PROVISIONAL_CREDIT = :PROVISIONAL_CREDIT
+          DISPUTE_WON = :DISPUTE_WON
+          SERVICE = :SERVICE
+          TRANSFER = :TRANSFER
+          COLLECTION = :COLLECTION
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
       end
 
-      # APPROVED transactions were successful while DECLINED transactions were declined
-      # by user, Lithic, or the network.
-      #
       # @see Lithic::Models::BookTransferResponse#result
       module Result
         extend Lithic::Internal::Type::Enum
@@ -244,8 +312,11 @@ module Lithic
         #   @return [Array<Symbol>]
       end
 
-      # Status types: _ `DECLINED` - The transfer was declined. _ `REVERSED` - The
-      # transfer was reversed \* `SETTLED` - The transfer is completed.
+      # Status types:
+      #
+      # - `DECLINED` - The transfer was declined.
+      # - `REVERSED` - The transfer was reversed
+      # - `SETTLED` - The transfer is completed.
       #
       # @see Lithic::Models::BookTransferResponse#status
       module Status
@@ -258,6 +329,31 @@ module Lithic
         # @!method self.values
         #   @return [Array<Symbol>]
       end
+
+      # @see Lithic::Models::BookTransferResponse#transaction_series
+      class TransactionSeries < Lithic::Internal::Type::BaseModel
+        # @!attribute related_transaction_event_token
+        #
+        #   @return [String, nil]
+        required :related_transaction_event_token, String, nil?: true
+
+        # @!attribute related_transaction_token
+        #
+        #   @return [String, nil]
+        required :related_transaction_token, String, nil?: true
+
+        # @!attribute type
+        #
+        #   @return [String]
+        required :type, String
+
+        # @!method initialize(related_transaction_event_token:, related_transaction_token:, type:)
+        #   A series of transactions that are grouped together.
+        #
+        #   @param related_transaction_event_token [String, nil]
+        #   @param related_transaction_token [String, nil]
+        #   @param type [String]
+      end
     end
   end
 end

data/lib/lithic/models/card_create_params.rb

@@ -108,6 +108,13 @@ module Lithic
       #   @return [String, nil]
       optional :replacement_account_token, String
 
+      # @!attribute replacement_comment
+      #   Additional context or information related to the card that this card will
+      #   replace.
+      #
+      #   @return [String, nil]
+      optional :replacement_comment, String
+
       # @!attribute replacement_for
       #   Globally unique identifier for the card that this card will replace. If the card
       #   type is `PHYSICAL` it will be replaced by a `PHYSICAL` card. If the card type is
@@ -116,6 +123,38 @@ module Lithic
       #   @return [String, nil]
       optional :replacement_for, String
 
+      # @!attribute replacement_substatus
+      #   Card state substatus values for the card that this card will replace:
+      #
+      #   - `LOST` - The physical card is no longer in the cardholder's possession due to
+      #     being lost or never received by the cardholder.
+      #   - `COMPROMISED` - Card information has been exposed, potentially leading to
+      #     unauthorized access. This may involve physical card theft, cloning, or online
+      #     data breaches.
+      #   - `DAMAGED` - The physical card is not functioning properly, such as having chip
+      #     failures or a demagnetized magnetic stripe.
+      #   - `END_USER_REQUEST` - The cardholder requested the closure of the card for
+      #     reasons unrelated to fraud or damage, such as switching to a different product
+      #     or closing the account.
+      #   - `ISSUER_REQUEST` - The issuer closed the card for reasons unrelated to fraud
+      #     or damage, such as account inactivity, product or policy changes, or
+      #     technology upgrades.
+      #   - `NOT_ACTIVE` - The card hasn’t had any transaction activity for a specified
+      #     period, applicable to statuses like `PAUSED` or `CLOSED`.
+      #   - `SUSPICIOUS_ACTIVITY` - The card has one or more suspicious transactions or
+      #     activities that require review. This can involve prompting the cardholder to
+      #     confirm legitimate use or report confirmed fraud.
+      #   - `INTERNAL_REVIEW` - The card is temporarily paused pending further internal
+      #     review.
+      #   - `EXPIRED` - The card has expired and has been closed without being reissued.
+      #   - `UNDELIVERABLE` - The card cannot be delivered to the cardholder and has been
+      #     returned.
+      #   - `OTHER` - The reason for the status does not fall into any of the above
+      #     categories. A comment should be provided to specify the reason.
+      #
+      #   @return [Symbol, Lithic::Models::CardCreateParams::ReplacementSubstatus, nil]
+      optional :replacement_substatus, enum: -> { Lithic::CardCreateParams::ReplacementSubstatus }
+
       # @!attribute shipping_address
       #
       #   @return [Lithic::Models::ShippingAddress, nil]
@@ -178,7 +217,7 @@ module Lithic
       #   @return [Symbol, Lithic::Models::CardCreateParams::State, nil]
       optional :state, enum: -> { Lithic::CardCreateParams::State }
 
-      # @!method initialize(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_for: nil, shipping_address: nil, shipping_method: nil, spend_limit: nil, spend_limit_duration: nil, state: nil, request_options: {})
+      # @!method initialize(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: {})
       #   Some parameter documentations has been truncated, see
       #   {Lithic::Models::CardCreateParams} for more details.
       #
@@ -204,8 +243,12 @@ module Lithic
       #
       #   @param replacement_account_token [String] Restricted field limited to select use cases. Lithic will reach out directly if
       #
+      #   @param replacement_comment [String] Additional context or information related to the card that this card will replac
+      #
       #   @param replacement_for [String] Globally unique identifier for the card that this card will replace. If the card
       #
+      #   @param replacement_substatus [Symbol, Lithic::Models::CardCreateParams::ReplacementSubstatus] Card state substatus values for the card that this card will replace:
+      #
       #   @param shipping_address [Lithic::Models::ShippingAddress]
       #
       #   @param shipping_method [Symbol, Lithic::Models::CardCreateParams::ShippingMethod] Shipping method for the card. Only applies to cards of type PHYSICAL.
@@ -248,6 +291,52 @@ module Lithic
         #   @return [Array<Symbol>]
       end
 
+      # Card state substatus values for the card that this card will replace:
+      #
+      # - `LOST` - The physical card is no longer in the cardholder's possession due to
+      #   being lost or never received by the cardholder.
+      # - `COMPROMISED` - Card information has been exposed, potentially leading to
+      #   unauthorized access. This may involve physical card theft, cloning, or online
+      #   data breaches.
+      # - `DAMAGED` - The physical card is not functioning properly, such as having chip
+      #   failures or a demagnetized magnetic stripe.
+      # - `END_USER_REQUEST` - The cardholder requested the closure of the card for
+      #   reasons unrelated to fraud or damage, such as switching to a different product
+      #   or closing the account.
+      # - `ISSUER_REQUEST` - The issuer closed the card for reasons unrelated to fraud
+      #   or damage, such as account inactivity, product or policy changes, or
+      #   technology upgrades.
+      # - `NOT_ACTIVE` - The card hasn’t had any transaction activity for a specified
+      #   period, applicable to statuses like `PAUSED` or `CLOSED`.
+      # - `SUSPICIOUS_ACTIVITY` - The card has one or more suspicious transactions or
+      #   activities that require review. This can involve prompting the cardholder to
+      #   confirm legitimate use or report confirmed fraud.
+      # - `INTERNAL_REVIEW` - The card is temporarily paused pending further internal
+      #   review.
+      # - `EXPIRED` - The card has expired and has been closed without being reissued.
+      # - `UNDELIVERABLE` - The card cannot be delivered to the cardholder and has been
+      #   returned.
+      # - `OTHER` - The reason for the status does not fall into any of the above
+      #   categories. A comment should be provided to specify the reason.
+      module ReplacementSubstatus
+        extend Lithic::Internal::Type::Enum
+
+        LOST = :LOST
+        COMPROMISED = :COMPROMISED
+        DAMAGED = :DAMAGED
+        END_USER_REQUEST = :END_USER_REQUEST
+        ISSUER_REQUEST = :ISSUER_REQUEST
+        NOT_ACTIVE = :NOT_ACTIVE
+        SUSPICIOUS_ACTIVITY = :SUSPICIOUS_ACTIVITY
+        INTERNAL_REVIEW = :INTERNAL_REVIEW
+        EXPIRED = :EXPIRED
+        UNDELIVERABLE = :UNDELIVERABLE
+        OTHER = :OTHER
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
       # Shipping method for the card. Only applies to cards of type PHYSICAL. Use of
       # options besides `STANDARD` require additional permissions.
       #

data/lib/lithic/models/card_program.rb

@@ -34,6 +34,13 @@ module Lithic
       #   @return [String]
       required :pan_range_start, String
 
+      # @!attribute account_level_management_enabled
+      #   Whether the card program is participating in Account Level Management. Currently
+      #   applicable to Visa card programs only.
+      #
+      #   @return [Boolean, nil]
+      optional :account_level_management_enabled, Lithic::Internal::Type::Boolean
+
       # @!attribute cardholder_currency
       #   3-character alphabetic ISO 4217 code for the currency of the cardholder.
       #
@@ -47,7 +54,7 @@ module Lithic
       #   @return [Array<String>, nil]
       optional :settlement_currencies, Lithic::Internal::Type::ArrayOf[String]
 
-      # @!method initialize(token:, created:, name:, pan_range_end:, pan_range_start:, cardholder_currency: nil, settlement_currencies: nil)
+      # @!method initialize(token:, created:, name:, pan_range_end:, pan_range_start:, account_level_management_enabled: nil, cardholder_currency: nil, settlement_currencies: nil)
       #   Some parameter documentations has been truncated, see
       #   {Lithic::Models::CardProgram} for more details.
       #
@@ -61,6 +68,8 @@ module Lithic
       #
       #   @param pan_range_start [String] The first digits of the card number that this card program starts with.
       #
+      #   @param account_level_management_enabled [Boolean] Whether the card program is participating in Account Level Management. Currently
+      #
       #   @param cardholder_currency [String] 3-character alphabetic ISO 4217 code for the currency of the cardholder.
       #
       #   @param settlement_currencies [Array<String>] List of 3-character alphabetic ISO 4217 codes for the currencies that the card p

data/lib/lithic/models/card_update_params.rb

@@ -7,6 +7,12 @@ module Lithic
       extend Lithic::Internal::Type::RequestParameters::Converter
       include Lithic::Internal::Type::RequestParameters
 
+      # @!attribute comment
+      #   Additional context or information related to the card.
+      #
+      #   @return [String, nil]
+      optional :comment, String
+
       # @!attribute digital_card_art_token
       #   Specifies the digital card art to be displayed in the user’s digital wallet
       #   after tokenization. This artwork must be approved by Mastercard and configured
@@ -22,6 +28,13 @@ module Lithic
       #   @return [String, nil]
       optional :memo, String
 
+      # @!attribute network_program_token
+      #   Globally unique identifier for the card's network program. Currently applicable
+      #   to Visa cards participating in Account Level Management only.
+      #
+      #   @return [String, nil]
+      optional :network_program_token, String
+
       # @!attribute pin
       #   Encrypted PIN block (in base64). Only applies to cards of type `PHYSICAL` and
       #   `VIRTUAL`. Changing PIN also resets PIN status to `OK`. See
@@ -77,14 +90,50 @@ module Lithic
       #   @return [Symbol, Lithic::Models::CardUpdateParams::State, nil]
       optional :state, enum: -> { Lithic::CardUpdateParams::State }
 
-      # @!method initialize(digital_card_art_token: nil, memo: nil, pin: nil, pin_status: nil, spend_limit: nil, spend_limit_duration: nil, state: nil, request_options: {})
+      # @!attribute substatus
+      #   Card state substatus values:
+      #
+      #   - `LOST` - The physical card is no longer in the cardholder's possession due to
+      #     being lost or never received by the cardholder.
+      #   - `COMPROMISED` - Card information has been exposed, potentially leading to
+      #     unauthorized access. This may involve physical card theft, cloning, or online
+      #     data breaches.
+      #   - `DAMAGED` - The physical card is not functioning properly, such as having chip
+      #     failures or a demagnetized magnetic stripe.
+      #   - `END_USER_REQUEST` - The cardholder requested the closure of the card for
+      #     reasons unrelated to fraud or damage, such as switching to a different product
+      #     or closing the account.
+      #   - `ISSUER_REQUEST` - The issuer closed the card for reasons unrelated to fraud
+      #     or damage, such as account inactivity, product or policy changes, or
+      #     technology upgrades.
+      #   - `NOT_ACTIVE` - The card hasn’t had any transaction activity for a specified
+      #     period, applicable to statuses like `PAUSED` or `CLOSED`.
+      #   - `SUSPICIOUS_ACTIVITY` - The card has one or more suspicious transactions or
+      #     activities that require review. This can involve prompting the cardholder to
+      #     confirm legitimate use or report confirmed fraud.
+      #   - `INTERNAL_REVIEW` - The card is temporarily paused pending further internal
+      #     review.
+      #   - `EXPIRED` - The card has expired and has been closed without being reissued.
+      #   - `UNDELIVERABLE` - The card cannot be delivered to the cardholder and has been
+      #     returned.
+      #   - `OTHER` - The reason for the status does not fall into any of the above
+      #     categories. A comment should be provided to specify the reason.
+      #
+      #   @return [Symbol, Lithic::Models::CardUpdateParams::Substatus, nil]
+      optional :substatus, enum: -> { Lithic::CardUpdateParams::Substatus }
+
+      # @!method initialize(comment: nil, digital_card_art_token: nil, memo: nil, network_program_token: nil, pin: nil, pin_status: nil, spend_limit: nil, spend_limit_duration: nil, state: nil, substatus: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Lithic::Models::CardUpdateParams} for more details.
       #
+      #   @param comment [String] Additional context or information related to the card.
+      #
       #   @param digital_card_art_token [String] Specifies the digital card art to be displayed in the user’s digital wallet afte
       #
       #   @param memo [String] Friendly name to identify the card.
       #
+      #   @param network_program_token [String] Globally unique identifier for the card's network program. Currently applicable
+      #
       #   @param pin [String] Encrypted PIN block (in base64). Only applies to cards of type `PHYSICAL` and `V
       #
       #   @param pin_status [Symbol, Lithic::Models::CardUpdateParams::PinStatus] Indicates if a card is blocked due a PIN status issue (e.g. excessive incorrect
@@ -95,6 +144,8 @@ module Lithic
       #
       #   @param state [Symbol, Lithic::Models::CardUpdateParams::State] Card state values:
       #
+      #   @param substatus [Symbol, Lithic::Models::CardUpdateParams::Substatus] Card state substatus values:
+      #
       #   @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}]
 
       # Indicates if a card is blocked due a PIN status issue (e.g. excessive incorrect
@@ -126,6 +177,52 @@ module Lithic
         # @!method self.values
         #   @return [Array<Symbol>]
       end
+
+      # Card state substatus values:
+      #
+      # - `LOST` - The physical card is no longer in the cardholder's possession due to
+      #   being lost or never received by the cardholder.
+      # - `COMPROMISED` - Card information has been exposed, potentially leading to
+      #   unauthorized access. This may involve physical card theft, cloning, or online
+      #   data breaches.
+      # - `DAMAGED` - The physical card is not functioning properly, such as having chip
+      #   failures or a demagnetized magnetic stripe.
+      # - `END_USER_REQUEST` - The cardholder requested the closure of the card for
+      #   reasons unrelated to fraud or damage, such as switching to a different product
+      #   or closing the account.
+      # - `ISSUER_REQUEST` - The issuer closed the card for reasons unrelated to fraud
+      #   or damage, such as account inactivity, product or policy changes, or
+      #   technology upgrades.
+      # - `NOT_ACTIVE` - The card hasn’t had any transaction activity for a specified
+      #   period, applicable to statuses like `PAUSED` or `CLOSED`.
+      # - `SUSPICIOUS_ACTIVITY` - The card has one or more suspicious transactions or
+      #   activities that require review. This can involve prompting the cardholder to
+      #   confirm legitimate use or report confirmed fraud.
+      # - `INTERNAL_REVIEW` - The card is temporarily paused pending further internal
+      #   review.
+      # - `EXPIRED` - The card has expired and has been closed without being reissued.
+      # - `UNDELIVERABLE` - The card cannot be delivered to the cardholder and has been
+      #   returned.
+      # - `OTHER` - The reason for the status does not fall into any of the above
+      #   categories. A comment should be provided to specify the reason.
+      module Substatus
+        extend Lithic::Internal::Type::Enum
+
+        LOST = :LOST
+        COMPROMISED = :COMPROMISED
+        DAMAGED = :DAMAGED
+        END_USER_REQUEST = :END_USER_REQUEST
+        ISSUER_REQUEST = :ISSUER_REQUEST
+        NOT_ACTIVE = :NOT_ACTIVE
+        SUSPICIOUS_ACTIVITY = :SUSPICIOUS_ACTIVITY
+        INTERNAL_REVIEW = :INTERNAL_REVIEW
+        EXPIRED = :EXPIRED
+        UNDELIVERABLE = :UNDELIVERABLE
+        OTHER = :OTHER
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
     end
   end
 end

data/lib/lithic/models/cards/balance_list_response.rb

@@ -104,6 +104,7 @@ module Lithic
           ISSUING = :ISSUING
           OPERATING = :OPERATING
           RESERVE = :RESERVE
+          SECURITY = :SECURITY
 
           # @!method self.values
           #   @return [Array<Symbol>]

data/lib/lithic/models/document.rb

@@ -122,9 +122,7 @@ module Lithic
         #
         #   @return [Array<Symbol, Lithic::Models::Document::RequiredDocumentUpload::StatusReason>]
         required :status_reasons,
-                 -> {
-                   Lithic::Internal::Type::ArrayOf[enum: Lithic::Document::RequiredDocumentUpload::StatusReason]
-                 }
+                 -> { Lithic::Internal::Type::ArrayOf[enum: Lithic::Document::RequiredDocumentUpload::StatusReason] }
 
         # @!attribute updated
         #   When the document upload was last updated

data/lib/lithic/models/events/subscription_create_params.rb

@@ -32,9 +32,7 @@ module Lithic
         #
         #   @return [Array<Symbol, Lithic::Models::Events::SubscriptionCreateParams::EventType>, nil]
         optional :event_types,
-                 -> {
-                   Lithic::Internal::Type::ArrayOf[enum: Lithic::Events::SubscriptionCreateParams::EventType]
-                 }
+                 -> { Lithic::Internal::Type::ArrayOf[enum: Lithic::Events::SubscriptionCreateParams::EventType] }
 
         # @!method initialize(url:, description: nil, disabled: nil, event_types: nil, request_options: {})
         #   Some parameter documentations has been truncated, see

data/lib/lithic/models/events/subscription_update_params.rb

@@ -32,9 +32,7 @@ module Lithic
         #
         #   @return [Array<Symbol, Lithic::Models::Events::SubscriptionUpdateParams::EventType>, nil]
         optional :event_types,
-                 -> {
-                   Lithic::Internal::Type::ArrayOf[enum: Lithic::Events::SubscriptionUpdateParams::EventType]
-                 }
+                 -> { Lithic::Internal::Type::ArrayOf[enum: Lithic::Events::SubscriptionUpdateParams::EventType] }
 
         # @!method initialize(url:, description: nil, disabled: nil, event_types: nil, request_options: {})
         #   Some parameter documentations has been truncated, see

data/lib/lithic/models/external_bank_account_list_params.rb

@@ -16,9 +16,7 @@ module Lithic
       #
       #   @return [Array<Symbol, Lithic::Models::ExternalBankAccountListParams::AccountType>, nil]
       optional :account_types,
-               -> {
-                 Lithic::Internal::Type::ArrayOf[enum: Lithic::ExternalBankAccountListParams::AccountType]
-               }
+               -> { Lithic::Internal::Type::ArrayOf[enum: Lithic::ExternalBankAccountListParams::AccountType] }
 
       # @!attribute countries
       #
@@ -60,9 +58,7 @@ module Lithic
       #
       #   @return [Array<Symbol, Lithic::Models::ExternalBankAccountListParams::VerificationState>, nil]
       optional :verification_states,
-               -> {
-                 Lithic::Internal::Type::ArrayOf[enum: Lithic::ExternalBankAccountListParams::VerificationState]
-               }
+               -> { Lithic::Internal::Type::ArrayOf[enum: Lithic::ExternalBankAccountListParams::VerificationState] }
 
       # @!method initialize(account_token: nil, account_types: nil, countries: nil, ending_before: nil, owner_types: nil, page_size: nil, starting_after: nil, states: nil, verification_states: nil, request_options: {})
       #   Some parameter documentations has been truncated, see