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

data/rbi/lithic/models/non_pci_card.rbi

@@ -106,6 +106,13 @@ module Lithic
       sig { params(cardholder_currency: String).void }
       attr_writer :cardholder_currency
 
+      # Additional context or information related to the card.
+      sig { returns(T.nilable(String)) }
+      attr_reader :comment
+
+      sig { params(comment: String).void }
+      attr_writer :comment
+
       # 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
       # by Lithic to use.
@@ -143,6 +150,12 @@ module Lithic
       sig { params(memo: String).void }
       attr_writer :memo
 
+      # Globally unique identifier for the card's network program. Null if the card is
+      # not associated with a network program. Currently applicable to Visa cards
+      # participating in Account Level Management only
+      sig { returns(T.nilable(String)) }
+      attr_accessor :network_program_token
+
       # Indicates if there are offline PIN changes pending card interaction with an
       # offline PIN terminal. Possible commands are: CHANGE_PIN, UNBLOCK_PIN. Applicable
       # only to cards issued in markets supporting offline PINs.
@@ -166,6 +179,32 @@ module Lithic
       sig { returns(T.nilable(String)) }
       attr_accessor :replacement_for
 
+      # 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 can be provided to specify the reason.
+      sig { returns(T.nilable(Lithic::NonPCICard::Substatus::TaggedSymbol)) }
+      attr_reader :substatus
+
+      sig { params(substatus: Lithic::NonPCICard::Substatus::OrSymbol).void }
+      attr_writer :substatus
+
       # Card details without PCI information
       sig do
         params(
@@ -182,14 +221,17 @@ module Lithic
           type: Lithic::NonPCICard::Type::OrSymbol,
           auth_rule_tokens: T::Array[String],
           cardholder_currency: String,
+          comment: String,
           digital_card_art_token: String,
           exp_month: String,
           exp_year: String,
           hostname: String,
           memo: String,
+          network_program_token: T.nilable(String),
           pending_commands: T::Array[String],
           product_id: String,
-          replacement_for: T.nilable(String)
+          replacement_for: T.nilable(String),
+          substatus: Lithic::NonPCICard::Substatus::OrSymbol
         ).returns(T.attached_class)
       end
       def self.new(
@@ -258,6 +300,8 @@ module Lithic
         auth_rule_tokens: nil,
         # 3-character alphabetic ISO 4217 code for the currency of the cardholder.
         cardholder_currency: nil,
+        # Additional context or information related to the card.
+        comment: nil,
         # 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
         # by Lithic to use.
@@ -270,6 +314,10 @@ module Lithic
         hostname: nil,
         # Friendly name to identify the card.
         memo: nil,
+        # Globally unique identifier for the card's network program. Null if the card is
+        # not associated with a network program. Currently applicable to Visa cards
+        # participating in Account Level Management only
+        network_program_token: nil,
         # Indicates if there are offline PIN changes pending card interaction with an
         # offline PIN terminal. Possible commands are: CHANGE_PIN, UNBLOCK_PIN. Applicable
         # only to cards issued in markets supporting offline PINs.
@@ -280,7 +328,28 @@ module Lithic
         product_id: nil,
         # If the card is a replacement for another card, the globally unique identifier
         # for the card that was replaced.
-        replacement_for: nil
+        replacement_for: nil,
+        # 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 can be provided to specify the reason.
+        substatus: nil
       )
       end
 
@@ -300,14 +369,17 @@ module Lithic
             type: Lithic::NonPCICard::Type::TaggedSymbol,
             auth_rule_tokens: T::Array[String],
             cardholder_currency: String,
+            comment: String,
             digital_card_art_token: String,
             exp_month: String,
             exp_year: String,
             hostname: String,
             memo: String,
+            network_program_token: T.nilable(String),
             pending_commands: T::Array[String],
             product_id: String,
-            replacement_for: T.nilable(String)
+            replacement_for: T.nilable(String),
+            substatus: Lithic::NonPCICard::Substatus::TaggedSymbol
           }
         )
       end
@@ -558,6 +630,64 @@ module Lithic
         def self.values
         end
       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 can be provided to specify the reason.
+      module Substatus
+        extend Lithic::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, Lithic::NonPCICard::Substatus) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        LOST = T.let(:LOST, Lithic::NonPCICard::Substatus::TaggedSymbol)
+        COMPROMISED =
+          T.let(:COMPROMISED, Lithic::NonPCICard::Substatus::TaggedSymbol)
+        DAMAGED = T.let(:DAMAGED, Lithic::NonPCICard::Substatus::TaggedSymbol)
+        END_USER_REQUEST =
+          T.let(:END_USER_REQUEST, Lithic::NonPCICard::Substatus::TaggedSymbol)
+        ISSUER_REQUEST =
+          T.let(:ISSUER_REQUEST, Lithic::NonPCICard::Substatus::TaggedSymbol)
+        NOT_ACTIVE =
+          T.let(:NOT_ACTIVE, Lithic::NonPCICard::Substatus::TaggedSymbol)
+        SUSPICIOUS_ACTIVITY =
+          T.let(
+            :SUSPICIOUS_ACTIVITY,
+            Lithic::NonPCICard::Substatus::TaggedSymbol
+          )
+        INTERNAL_REVIEW =
+          T.let(:INTERNAL_REVIEW, Lithic::NonPCICard::Substatus::TaggedSymbol)
+        EXPIRED = T.let(:EXPIRED, Lithic::NonPCICard::Substatus::TaggedSymbol)
+        UNDELIVERABLE =
+          T.let(:UNDELIVERABLE, Lithic::NonPCICard::Substatus::TaggedSymbol)
+        OTHER = T.let(:OTHER, Lithic::NonPCICard::Substatus::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[Lithic::NonPCICard::Substatus::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
     end
   end
 end

data/rbi/lithic/models/payment.rbi

@@ -58,6 +58,17 @@ module Lithic
       sig { returns(Integer) }
       attr_accessor :pending_amount
 
+      # Account tokens related to a payment transaction
+      sig { returns(Lithic::Payment::RelatedAccountTokens) }
+      attr_reader :related_account_tokens
+
+      sig do
+        params(
+          related_account_tokens: Lithic::Payment::RelatedAccountTokens::OrHash
+        ).void
+      end
+      attr_writer :related_account_tokens
+
       # APPROVED payments were successful while DECLINED payments were declined by
       # Lithic or returned.
       sig { returns(Lithic::Payment::Result::TaggedSymbol) }
@@ -95,6 +106,13 @@ module Lithic
       sig { params(expected_release_date: Date).void }
       attr_writer :expected_release_date
 
+      # Payment type indicating the specific ACH message or Fedwire transfer type
+      sig { returns(T.nilable(Lithic::Payment::Type::TaggedSymbol)) }
+      attr_reader :type
+
+      sig { params(type: Lithic::Payment::Type::OrSymbol).void }
+      attr_writer :type
+
       sig do
         params(
           token: String,
@@ -109,13 +127,15 @@ module Lithic
           method_: Lithic::Payment::Method::OrSymbol,
           method_attributes: Lithic::Payment::MethodAttributes::OrHash,
           pending_amount: Integer,
+          related_account_tokens: Lithic::Payment::RelatedAccountTokens::OrHash,
           result: Lithic::Payment::Result::OrSymbol,
           settled_amount: Integer,
           source: Lithic::Payment::Source::OrSymbol,
           status: Lithic::Payment::Status::OrSymbol,
           updated: Time,
           user_defined_id: T.nilable(String),
-          expected_release_date: Date
+          expected_release_date: Date,
+          type: Lithic::Payment::Type::OrSymbol
         ).returns(T.attached_class)
       end
       def self.new(
@@ -140,6 +160,8 @@ module Lithic
         # Pending amount of the payment in the currency's smallest unit (e.g., cents). The
         # value of this field will go to zero over time once the payment is settled.
         pending_amount:,
+        # Account tokens related to a payment transaction
+        related_account_tokens:,
         # APPROVED payments were successful while DECLINED payments were declined by
         # Lithic or returned.
         result:,
@@ -159,7 +181,9 @@ module Lithic
         updated:,
         user_defined_id:,
         # Date when the financial transaction expected to be released after settlement
-        expected_release_date: nil
+        expected_release_date: nil,
+        # Payment type indicating the specific ACH message or Fedwire transfer type
+        type: nil
       )
       end
 
@@ -178,13 +202,15 @@ module Lithic
             method_: Lithic::Payment::Method::TaggedSymbol,
             method_attributes: Lithic::Payment::MethodAttributes,
             pending_amount: Integer,
+            related_account_tokens: Lithic::Payment::RelatedAccountTokens,
             result: Lithic::Payment::Result::TaggedSymbol,
             settled_amount: Integer,
             source: Lithic::Payment::Source::TaggedSymbol,
             status: Lithic::Payment::Status::TaggedSymbol,
             updated: Time,
             user_defined_id: T.nilable(String),
-            expected_release_date: Date
+            expected_release_date: Date,
+            type: Lithic::Payment::Type::TaggedSymbol
           }
         )
       end
@@ -289,6 +315,7 @@ module Lithic
         end
         attr_writer :detailed_results
 
+        # Payment Event
         sig do
           params(
             token: String,
@@ -639,6 +666,50 @@ module Lithic
         end
       end
 
+      class RelatedAccountTokens < Lithic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Lithic::Payment::RelatedAccountTokens,
+              Lithic::Internal::AnyHash
+            )
+          end
+
+        # Globally unique identifier for the account
+        sig { returns(T.nilable(String)) }
+        attr_accessor :account_token
+
+        # Globally unique identifier for the business account
+        sig { returns(T.nilable(String)) }
+        attr_accessor :business_account_token
+
+        # Account tokens related to a payment transaction
+        sig do
+          params(
+            account_token: T.nilable(String),
+            business_account_token: T.nilable(String)
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Globally unique identifier for the account
+          account_token:,
+          # Globally unique identifier for the business account
+          business_account_token:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              account_token: T.nilable(String),
+              business_account_token: T.nilable(String)
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+
       # APPROVED payments were successful while DECLINED payments were declined by
       # Lithic or returned.
       module Result
@@ -697,6 +768,35 @@ module Lithic
         def self.values
         end
       end
+
+      # Payment type indicating the specific ACH message or Fedwire transfer type
+      module Type
+        extend Lithic::Internal::Type::Enum
+
+        TaggedSymbol = T.type_alias { T.all(Symbol, Lithic::Payment::Type) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        ORIGINATION_CREDIT =
+          T.let(:ORIGINATION_CREDIT, Lithic::Payment::Type::TaggedSymbol)
+        ORIGINATION_DEBIT =
+          T.let(:ORIGINATION_DEBIT, Lithic::Payment::Type::TaggedSymbol)
+        RECEIPT_CREDIT =
+          T.let(:RECEIPT_CREDIT, Lithic::Payment::Type::TaggedSymbol)
+        RECEIPT_DEBIT =
+          T.let(:RECEIPT_DEBIT, Lithic::Payment::Type::TaggedSymbol)
+        WIRE_INBOUND_PAYMENT =
+          T.let(:WIRE_INBOUND_PAYMENT, Lithic::Payment::Type::TaggedSymbol)
+        WIRE_INBOUND_ADMIN =
+          T.let(:WIRE_INBOUND_ADMIN, Lithic::Payment::Type::TaggedSymbol)
+        WIRE_OUTBOUND_PAYMENT =
+          T.let(:WIRE_OUTBOUND_PAYMENT, Lithic::Payment::Type::TaggedSymbol)
+        WIRE_OUTBOUND_ADMIN =
+          T.let(:WIRE_OUTBOUND_ADMIN, Lithic::Payment::Type::TaggedSymbol)
+
+        sig { override.returns(T::Array[Lithic::Payment::Type::TaggedSymbol]) }
+        def self.values
+        end
+      end
     end
   end
 end

data/rbi/lithic/models/payment_simulate_action_params.rbi

@@ -110,6 +110,11 @@ module Lithic
             :ACH_RECEIPT_SETTLED,
             Lithic::PaymentSimulateActionParams::EventType::TaggedSymbol
           )
+        ACH_RECEIPT_RELEASED =
+          T.let(
+            :ACH_RECEIPT_RELEASED,
+            Lithic::PaymentSimulateActionParams::EventType::TaggedSymbol
+          )
         ACH_RETURN_INITIATED =
           T.let(
             :ACH_RETURN_INITIATED,

data/rbi/lithic/models/reports/settlement_list_details_params.rbi

@@ -23,7 +23,7 @@ module Lithic
         sig { params(ending_before: String).void }
         attr_writer :ending_before
 
-        # Page size (for pagination).
+        # Number of records per page.
         sig { returns(T.nilable(Integer)) }
         attr_reader :page_size
 
@@ -50,7 +50,7 @@ module Lithic
           # A cursor representing an item's token before which a page of results should end.
           # Used to retrieve the previous page of results before this item.
           ending_before: nil,
-          # Page size (for pagination).
+          # Number of records per page.
           page_size: nil,
           # A cursor representing an item's token after which a page of results should
           # begin. Used to retrieve the next page of results after this item.

data/rbi/lithic/models/settlement_detail.rbi

@@ -286,6 +286,8 @@ module Lithic
           T.let(:CHARGEBACK, Lithic::SettlementDetail::Type::TaggedSymbol)
         CLEARING =
           T.let(:CLEARING, Lithic::SettlementDetail::Type::TaggedSymbol)
+        COLLABORATION =
+          T.let(:COLLABORATION, Lithic::SettlementDetail::Type::TaggedSymbol)
         FEE = T.let(:FEE, Lithic::SettlementDetail::Type::TaggedSymbol)
         FINANCIAL =
           T.let(:FINANCIAL, Lithic::SettlementDetail::Type::TaggedSymbol)