lithic 0.1.0.pre.alpha.38 → 0.1.0.pre.alpha.40

data/lib/lithic/models/auth_rules/velocity_limit_params_period_window.rb

@@ -3,25 +3,247 @@
 module Lithic
   module Models
     module AuthRules
-      # The window of time to calculate Spend Velocity over.
-      #
-      # - `DAY`: Velocity over the current day since midnight Eastern Time.
-      # - `WEEK`: Velocity over the current week since 00:00 / 12 AM on Monday in
-      #   Eastern Time.
-      # - `MONTH`: Velocity over the current month since 00:00 / 12 AM on the first of
-      #   the month in Eastern Time.
-      # - `YEAR`: Velocity over the current year since 00:00 / 12 AM on January 1st in
-      #   Eastern Time.
+      # The size of the trailing window to calculate Spend Velocity over in seconds. The
+      # minimum value is 10 seconds, and the maximum value is 2678400 seconds (31 days).
       module VelocityLimitParamsPeriodWindow
-        extend Lithic::Internal::Type::Enum
+        extend Lithic::Internal::Type::Union
 
-        DAY = :DAY
-        WEEK = :WEEK
-        MONTH = :MONTH
-        YEAR = :YEAR
+        # The size of the trailing window to calculate Spend Velocity over in seconds. The minimum value is 10 seconds, and the maximum value is 2678400 seconds (31 days).
+        variant Integer
 
-        # @!method self.values
-        #   @return [Array<Symbol>]
+        # The window of time to calculate Spend Velocity over.
+        #
+        # * `DAY`: Velocity over the current day since midnight Eastern Time.
+        # * `WEEK`: Velocity over the current week since 00:00 / 12 AM on Monday in Eastern Time.
+        # * `MONTH`: Velocity over the current month since 00:00 / 12 AM on the first of the month in Eastern Time.
+        # * `YEAR`: Velocity over the current year since 00:00 / 12 AM on January 1st in Eastern Time.
+        variant enum: -> { Lithic::AuthRules::VelocityLimitParamsPeriodWindow::FixedWindow }
+
+        variant -> { Lithic::AuthRules::VelocityLimitParamsPeriodWindow::TrailingWindowObject }
+
+        # Velocity over the current day since 00:00 / 12 AM in Eastern Time
+        variant -> { Lithic::AuthRules::VelocityLimitParamsPeriodWindow::FixedWindowDay }
+
+        # Velocity over the current week since 00:00 / 12 AM in Eastern Time on specified `day_of_week`
+        variant -> { Lithic::AuthRules::VelocityLimitParamsPeriodWindow::FixedWindowWeek }
+
+        # Velocity over the current month since 00:00 / 12 AM in Eastern Time on specified `day_of_month`.
+        variant -> { Lithic::AuthRules::VelocityLimitParamsPeriodWindow::FixedWindowMonth }
+
+        # Velocity over the current year since 00:00 / 12 AM in Eastern Time on specified `month` and `day_of_month`. This validates the month and day of the year to start from is a real date. In the event that February 29th is selected, in non-leap years, the window will start from February 28th.
+        variant -> { Lithic::AuthRules::VelocityLimitParamsPeriodWindow::FixedWindowYear }
+
+        # The window of time to calculate Spend Velocity over.
+        #
+        # - `DAY`: Velocity over the current day since midnight Eastern Time.
+        # - `WEEK`: Velocity over the current week since 00:00 / 12 AM on Monday in
+        #   Eastern Time.
+        # - `MONTH`: Velocity over the current month since 00:00 / 12 AM on the first of
+        #   the month in Eastern Time.
+        # - `YEAR`: Velocity over the current year since 00:00 / 12 AM on January 1st in
+        #   Eastern Time.
+        module FixedWindow
+          extend Lithic::Internal::Type::Enum
+
+          DAY = :DAY
+          WEEK = :WEEK
+          MONTH = :MONTH
+          YEAR = :YEAR
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        class TrailingWindowObject < Lithic::Internal::Type::BaseModel
+          # @!attribute duration
+          #   The size of the trailing window to calculate Spend Velocity over in seconds. The
+          #   minimum value is 10 seconds, and the maximum value is 2678400 seconds (31 days).
+          #
+          #   @return [Integer, nil]
+          optional :duration, Integer
+
+          # @!attribute type
+          #
+          #   @return [Symbol, Lithic::Models::AuthRules::VelocityLimitParamsPeriodWindow::TrailingWindowObject::Type, nil]
+          optional :type,
+                   enum: -> { Lithic::AuthRules::VelocityLimitParamsPeriodWindow::TrailingWindowObject::Type }
+
+          # @!method initialize(duration: nil, type: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Lithic::Models::AuthRules::VelocityLimitParamsPeriodWindow::TrailingWindowObject}
+          #   for more details.
+          #
+          #   @param duration [Integer] The size of the trailing window to calculate Spend Velocity over in seconds. The
+          #
+          #   @param type [Symbol, Lithic::Models::AuthRules::VelocityLimitParamsPeriodWindow::TrailingWindowObject::Type]
+
+          # @see Lithic::Models::AuthRules::VelocityLimitParamsPeriodWindow::TrailingWindowObject#type
+          module Type
+            extend Lithic::Internal::Type::Enum
+
+            CUSTOM = :CUSTOM
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
+        class FixedWindowDay < Lithic::Internal::Type::BaseModel
+          # @!attribute type
+          #
+          #   @return [Symbol, Lithic::Models::AuthRules::VelocityLimitParamsPeriodWindow::FixedWindowDay::Type, nil]
+          optional :type,
+                   enum: -> {
+                     Lithic::AuthRules::VelocityLimitParamsPeriodWindow::FixedWindowDay::Type
+                   }
+
+          # @!method initialize(type: nil)
+          #   Velocity over the current day since 00:00 / 12 AM in Eastern Time
+          #
+          #   @param type [Symbol, Lithic::Models::AuthRules::VelocityLimitParamsPeriodWindow::FixedWindowDay::Type]
+
+          # @see Lithic::Models::AuthRules::VelocityLimitParamsPeriodWindow::FixedWindowDay#type
+          module Type
+            extend Lithic::Internal::Type::Enum
+
+            DAY = :DAY
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
+        class FixedWindowWeek < Lithic::Internal::Type::BaseModel
+          # @!attribute day_of_week
+          #   The day of the week to start the week from. Following ISO-8601, 1 is Monday and
+          #   7 is Sunday. Defaults to Monday if not specified.
+          #
+          #   @return [Integer, nil]
+          optional :day_of_week, Integer
+
+          # @!attribute type
+          #
+          #   @return [Symbol, Lithic::Models::AuthRules::VelocityLimitParamsPeriodWindow::FixedWindowWeek::Type, nil]
+          optional :type,
+                   enum: -> {
+                     Lithic::AuthRules::VelocityLimitParamsPeriodWindow::FixedWindowWeek::Type
+                   }
+
+          # @!method initialize(day_of_week: nil, type: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Lithic::Models::AuthRules::VelocityLimitParamsPeriodWindow::FixedWindowWeek}
+          #   for more details.
+          #
+          #   Velocity over the current week since 00:00 / 12 AM in Eastern Time on specified
+          #   `day_of_week`
+          #
+          #   @param day_of_week [Integer] The day of the week to start the week from. Following ISO-8601, 1 is Monday and
+          #
+          #   @param type [Symbol, Lithic::Models::AuthRules::VelocityLimitParamsPeriodWindow::FixedWindowWeek::Type]
+
+          # @see Lithic::Models::AuthRules::VelocityLimitParamsPeriodWindow::FixedWindowWeek#type
+          module Type
+            extend Lithic::Internal::Type::Enum
+
+            WEEK = :WEEK
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
+        class FixedWindowMonth < Lithic::Internal::Type::BaseModel
+          # @!attribute day_of_month
+          #   The day of the month to start from. Accepts values from 1 to 31, and will reset
+          #   at the end of the month if the day exceeds the number of days in the month.
+          #   Defaults to the 1st of the month if not specified.
+          #
+          #   @return [Integer, nil]
+          optional :day_of_month, Integer
+
+          # @!attribute type
+          #
+          #   @return [Symbol, Lithic::Models::AuthRules::VelocityLimitParamsPeriodWindow::FixedWindowMonth::Type, nil]
+          optional :type,
+                   enum: -> {
+                     Lithic::AuthRules::VelocityLimitParamsPeriodWindow::FixedWindowMonth::Type
+                   }
+
+          # @!method initialize(day_of_month: nil, type: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Lithic::Models::AuthRules::VelocityLimitParamsPeriodWindow::FixedWindowMonth}
+          #   for more details.
+          #
+          #   Velocity over the current month since 00:00 / 12 AM in Eastern Time on specified
+          #   `day_of_month`.
+          #
+          #   @param day_of_month [Integer] The day of the month to start from. Accepts values from 1 to 31, and will reset
+          #
+          #   @param type [Symbol, Lithic::Models::AuthRules::VelocityLimitParamsPeriodWindow::FixedWindowMonth::Type]
+
+          # @see Lithic::Models::AuthRules::VelocityLimitParamsPeriodWindow::FixedWindowMonth#type
+          module Type
+            extend Lithic::Internal::Type::Enum
+
+            MONTH = :MONTH
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
+        class FixedWindowYear < Lithic::Internal::Type::BaseModel
+          # @!attribute day_of_month
+          #   The day of the month to start from. Defaults to the 1st of the month if not
+          #   specified.
+          #
+          #   @return [Integer, nil]
+          optional :day_of_month, Integer
+
+          # @!attribute month
+          #   The month to start from. 1 is January and 12 is December. Defaults to January if
+          #   not specified.
+          #
+          #   @return [Integer, nil]
+          optional :month, Integer
+
+          # @!attribute type
+          #
+          #   @return [Symbol, Lithic::Models::AuthRules::VelocityLimitParamsPeriodWindow::FixedWindowYear::Type, nil]
+          optional :type,
+                   enum: -> {
+                     Lithic::AuthRules::VelocityLimitParamsPeriodWindow::FixedWindowYear::Type
+                   }
+
+          # @!method initialize(day_of_month: nil, month: nil, type: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Lithic::Models::AuthRules::VelocityLimitParamsPeriodWindow::FixedWindowYear}
+          #   for more details.
+          #
+          #   Velocity over the current year since 00:00 / 12 AM in Eastern Time on specified
+          #   `month` and `day_of_month`. This validates the month and day of the year to
+          #   start from is a real date. In the event that February 29th is selected, in
+          #   non-leap years, the window will start from February 28th.
+          #
+          #   @param day_of_month [Integer] The day of the month to start from. Defaults to the 1st of the month if not spec
+          #
+          #   @param month [Integer] The month to start from. 1 is January and 12 is December. Defaults to January if
+          #
+          #   @param type [Symbol, Lithic::Models::AuthRules::VelocityLimitParamsPeriodWindow::FixedWindowYear::Type]
+
+          # @see Lithic::Models::AuthRules::VelocityLimitParamsPeriodWindow::FixedWindowYear#type
+          module Type
+            extend Lithic::Internal::Type::Enum
+
+            YEAR = :YEAR
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
+        # @!method self.variants
+        #   @return [Array(Integer, Symbol, Lithic::Models::AuthRules::VelocityLimitParamsPeriodWindow::FixedWindow, Lithic::Models::AuthRules::VelocityLimitParamsPeriodWindow::TrailingWindowObject, Lithic::Models::AuthRules::VelocityLimitParamsPeriodWindow::FixedWindowDay, Lithic::Models::AuthRules::VelocityLimitParamsPeriodWindow::FixedWindowWeek, Lithic::Models::AuthRules::VelocityLimitParamsPeriodWindow::FixedWindowMonth, Lithic::Models::AuthRules::VelocityLimitParamsPeriodWindow::FixedWindowYear)]
       end
     end
   end

data/lib/lithic/models/balance.rb

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

data/lib/lithic/models/balance_list_params.rb

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

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/event.rb

@@ -137,6 +137,8 @@ module Lithic
         LOAN_TAPE_UPDATED = :"loan_tape.updated"
         MANAGEMENT_OPERATION_CREATED = :"management_operation.created"
         MANAGEMENT_OPERATION_UPDATED = :"management_operation.updated"
+        NETWORK_TOTAL_CREATED = :"network_total.created"
+        NETWORK_TOTAL_UPDATED = :"network_total.updated"
         PAYMENT_TRANSACTION_CREATED = :"payment_transaction.created"
         PAYMENT_TRANSACTION_UPDATED = :"payment_transaction.updated"
         INTERNAL_TRANSACTION_CREATED = :"internal_transaction.created"

data/lib/lithic/models/event_list_params.rb

@@ -108,6 +108,8 @@ module Lithic
         LOAN_TAPE_UPDATED = :"loan_tape.updated"
         MANAGEMENT_OPERATION_CREATED = :"management_operation.created"
         MANAGEMENT_OPERATION_UPDATED = :"management_operation.updated"
+        NETWORK_TOTAL_CREATED = :"network_total.created"
+        NETWORK_TOTAL_UPDATED = :"network_total.updated"
         PAYMENT_TRANSACTION_CREATED = :"payment_transaction.created"
         PAYMENT_TRANSACTION_UPDATED = :"payment_transaction.updated"
         INTERNAL_TRANSACTION_CREATED = :"internal_transaction.created"

data/lib/lithic/models/event_subscription.rb

@@ -81,6 +81,8 @@ module Lithic
         LOAN_TAPE_UPDATED = :"loan_tape.updated"
         MANAGEMENT_OPERATION_CREATED = :"management_operation.created"
         MANAGEMENT_OPERATION_UPDATED = :"management_operation.updated"
+        NETWORK_TOTAL_CREATED = :"network_total.created"
+        NETWORK_TOTAL_UPDATED = :"network_total.updated"
         PAYMENT_TRANSACTION_CREATED = :"payment_transaction.created"
         PAYMENT_TRANSACTION_UPDATED = :"payment_transaction.updated"
         INTERNAL_TRANSACTION_CREATED = :"internal_transaction.created"

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

@@ -85,6 +85,8 @@ module Lithic
           LOAN_TAPE_UPDATED = :"loan_tape.updated"
           MANAGEMENT_OPERATION_CREATED = :"management_operation.created"
           MANAGEMENT_OPERATION_UPDATED = :"management_operation.updated"
+          NETWORK_TOTAL_CREATED = :"network_total.created"
+          NETWORK_TOTAL_UPDATED = :"network_total.updated"
           PAYMENT_TRANSACTION_CREATED = :"payment_transaction.created"
           PAYMENT_TRANSACTION_UPDATED = :"payment_transaction.updated"
           INTERNAL_TRANSACTION_CREATED = :"internal_transaction.created"

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

@@ -55,6 +55,8 @@ module Lithic
           LOAN_TAPE_UPDATED = :"loan_tape.updated"
           MANAGEMENT_OPERATION_CREATED = :"management_operation.created"
           MANAGEMENT_OPERATION_UPDATED = :"management_operation.updated"
+          NETWORK_TOTAL_CREATED = :"network_total.created"
+          NETWORK_TOTAL_UPDATED = :"network_total.updated"
           PAYMENT_TRANSACTION_CREATED = :"payment_transaction.created"
           PAYMENT_TRANSACTION_UPDATED = :"payment_transaction.updated"
           INTERNAL_TRANSACTION_CREATED = :"internal_transaction.created"

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

@@ -85,6 +85,8 @@ module Lithic
           LOAN_TAPE_UPDATED = :"loan_tape.updated"
           MANAGEMENT_OPERATION_CREATED = :"management_operation.created"
           MANAGEMENT_OPERATION_UPDATED = :"management_operation.updated"
+          NETWORK_TOTAL_CREATED = :"network_total.created"
+          NETWORK_TOTAL_UPDATED = :"network_total.updated"
           PAYMENT_TRANSACTION_CREATED = :"payment_transaction.created"
           PAYMENT_TRANSACTION_UPDATED = :"payment_transaction.updated"
           INTERNAL_TRANSACTION_CREATED = :"internal_transaction.created"