lithic 0.6.0 → 0.8.0

data/rbi/lithic/models/digital_wallet_tokenization_approval_request_webhook_event.rbi

@@ -23,26 +23,6 @@ module Lithic
       sig { returns(Time) }
       attr_accessor :created
 
-      # Contains the metadata for the customer tokenization decision.
-      sig do
-        returns(
-          T.nilable(
-            Lithic::DigitalWalletTokenizationApprovalRequestWebhookEvent::CustomerTokenizationDecision
-          )
-        )
-      end
-      attr_reader :customer_tokenization_decision
-
-      sig do
-        params(
-          customer_tokenization_decision:
-            T.nilable(
-              Lithic::DigitalWalletTokenizationApprovalRequestWebhookEvent::CustomerTokenizationDecision::OrHash
-            )
-        ).void
-      end
-      attr_writer :customer_tokenization_decision
-
       # Contains the metadata for the digital wallet being tokenized.
       sig { returns(Lithic::TokenMetadata) }
       attr_reader :digital_wallet_token_metadata
@@ -93,13 +73,34 @@ module Lithic
       end
       attr_writer :wallet_decisioning_info
 
+      # Contains the metadata for the customer tokenization decision.
+      sig do
+        returns(
+          T.nilable(
+            Lithic::DigitalWalletTokenizationApprovalRequestWebhookEvent::CustomerTokenizationDecision
+          )
+        )
+      end
+      attr_reader :customer_tokenization_decision
+
+      sig do
+        params(
+          customer_tokenization_decision:
+            T.nilable(
+              Lithic::DigitalWalletTokenizationApprovalRequestWebhookEvent::CustomerTokenizationDecision::OrHash
+            )
+        ).void
+      end
+      attr_writer :customer_tokenization_decision
+
       sig { returns(T.nilable(Lithic::Device)) }
       attr_reader :device
 
       sig { params(device: Lithic::Device::OrHash).void }
       attr_writer :device
 
-      # Results from rules that were evaluated for this tokenization
+      # Results from rules that were evaluated for this tokenization. Only populated in
+      # webhook events, not in the initial decisioning request
       sig { returns(T.nilable(T::Array[Lithic::TokenizationRuleResult])) }
       attr_reader :rule_results
 
@@ -110,7 +111,8 @@ module Lithic
       end
       attr_writer :rule_results
 
-      # List of reasons why the tokenization was declined
+      # List of reasons why the tokenization was declined. Only populated in webhook
+      # events, not in the initial decisioning request
       sig do
         returns(
           T.nilable(T::Array[Lithic::TokenizationDeclineReason::TaggedSymbol])
@@ -144,7 +146,8 @@ module Lithic
       end
       attr_writer :tokenization_source
 
-      # List of reasons why two-factor authentication was required
+      # List of reasons why two-factor authentication was required. Only populated in
+      # webhook events, not in the initial decisioning request
       sig do
         returns(
           T.nilable(T::Array[Lithic::TokenizationTfaReason::TaggedSymbol])
@@ -160,15 +163,17 @@ module Lithic
       end
       attr_writer :tokenization_tfa_reasons
 
+      # Payload for digital wallet tokenization approval requests. Used for both the
+      # decisioning responder request (sent to the customer's endpoint for a real-time
+      # decision) and the subsequent webhook event (sent after the decision is made).
+      # Fields like customer_tokenization_decision, tokenization_decline_reasons,
+      # tokenization_tfa_reasons, and rule_results are only populated in the webhook
+      # event, not in the initial decisioning request.
       sig do
         params(
           account_token: String,
           card_token: String,
           created: Time,
-          customer_tokenization_decision:
-            T.nilable(
-              Lithic::DigitalWalletTokenizationApprovalRequestWebhookEvent::CustomerTokenizationDecision::OrHash
-            ),
           digital_wallet_token_metadata: Lithic::TokenMetadata::OrHash,
           event_type:
             Lithic::DigitalWalletTokenizationApprovalRequestWebhookEvent::EventType::OrSymbol,
@@ -178,6 +183,10 @@ module Lithic
             Lithic::DigitalWalletTokenizationApprovalRequestWebhookEvent::TokenizationChannel::OrSymbol,
           tokenization_token: String,
           wallet_decisioning_info: Lithic::WalletDecisioningInfo::OrHash,
+          customer_tokenization_decision:
+            T.nilable(
+              Lithic::DigitalWalletTokenizationApprovalRequestWebhookEvent::CustomerTokenizationDecision::OrHash
+            ),
           device: Lithic::Device::OrHash,
           rule_results: T::Array[Lithic::TokenizationRuleResult::OrHash],
           tokenization_decline_reasons:
@@ -195,8 +204,6 @@ module Lithic
         card_token:,
         # Indicate when the request was received from Mastercard or Visa
         created:,
-        # Contains the metadata for the customer tokenization decision.
-        customer_tokenization_decision:,
         # Contains the metadata for the digital wallet being tokenized.
         digital_wallet_token_metadata:,
         # The name of this event
@@ -209,14 +216,19 @@ module Lithic
         # Unique identifier for the digital wallet token attempt
         tokenization_token:,
         wallet_decisioning_info:,
+        # Contains the metadata for the customer tokenization decision.
+        customer_tokenization_decision: nil,
         device: nil,
-        # Results from rules that were evaluated for this tokenization
+        # Results from rules that were evaluated for this tokenization. Only populated in
+        # webhook events, not in the initial decisioning request
         rule_results: nil,
-        # List of reasons why the tokenization was declined
+        # List of reasons why the tokenization was declined. Only populated in webhook
+        # events, not in the initial decisioning request
         tokenization_decline_reasons: nil,
         # The source of the tokenization.
         tokenization_source: nil,
-        # List of reasons why two-factor authentication was required
+        # List of reasons why two-factor authentication was required. Only populated in
+        # webhook events, not in the initial decisioning request
         tokenization_tfa_reasons: nil
       )
       end
@@ -227,10 +239,6 @@ module Lithic
             account_token: String,
             card_token: String,
             created: Time,
-            customer_tokenization_decision:
-              T.nilable(
-                Lithic::DigitalWalletTokenizationApprovalRequestWebhookEvent::CustomerTokenizationDecision
-              ),
             digital_wallet_token_metadata: Lithic::TokenMetadata,
             event_type:
               Lithic::DigitalWalletTokenizationApprovalRequestWebhookEvent::EventType::TaggedSymbol,
@@ -240,6 +248,10 @@ module Lithic
               Lithic::DigitalWalletTokenizationApprovalRequestWebhookEvent::TokenizationChannel::TaggedSymbol,
             tokenization_token: String,
             wallet_decisioning_info: Lithic::WalletDecisioningInfo,
+            customer_tokenization_decision:
+              T.nilable(
+                Lithic::DigitalWalletTokenizationApprovalRequestWebhookEvent::CustomerTokenizationDecision
+              ),
             device: Lithic::Device,
             rule_results: T::Array[Lithic::TokenizationRuleResult],
             tokenization_decline_reasons:
@@ -254,6 +266,112 @@ module Lithic
       def to_hash
       end
 
+      # The name of this event
+      module EventType
+        extend Lithic::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(
+              Symbol,
+              Lithic::DigitalWalletTokenizationApprovalRequestWebhookEvent::EventType
+            )
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        DIGITAL_WALLET_TOKENIZATION_APPROVAL_REQUEST =
+          T.let(
+            :"digital_wallet.tokenization_approval_request",
+            Lithic::DigitalWalletTokenizationApprovalRequestWebhookEvent::EventType::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Lithic::DigitalWalletTokenizationApprovalRequestWebhookEvent::EventType::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+
+      # Whether Lithic decisioned on the token, and if so, what the decision was.
+      # APPROVED/VERIFICATION_REQUIRED/DENIED.
+      module IssuerDecision
+        extend Lithic::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(
+              Symbol,
+              Lithic::DigitalWalletTokenizationApprovalRequestWebhookEvent::IssuerDecision
+            )
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        APPROVED =
+          T.let(
+            :APPROVED,
+            Lithic::DigitalWalletTokenizationApprovalRequestWebhookEvent::IssuerDecision::TaggedSymbol
+          )
+        DENIED =
+          T.let(
+            :DENIED,
+            Lithic::DigitalWalletTokenizationApprovalRequestWebhookEvent::IssuerDecision::TaggedSymbol
+          )
+        VERIFICATION_REQUIRED =
+          T.let(
+            :VERIFICATION_REQUIRED,
+            Lithic::DigitalWalletTokenizationApprovalRequestWebhookEvent::IssuerDecision::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Lithic::DigitalWalletTokenizationApprovalRequestWebhookEvent::IssuerDecision::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+
+      # The channel through which the tokenization was made.
+      module TokenizationChannel
+        extend Lithic::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(
+              Symbol,
+              Lithic::DigitalWalletTokenizationApprovalRequestWebhookEvent::TokenizationChannel
+            )
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        DIGITAL_WALLET =
+          T.let(
+            :DIGITAL_WALLET,
+            Lithic::DigitalWalletTokenizationApprovalRequestWebhookEvent::TokenizationChannel::TaggedSymbol
+          )
+        MERCHANT =
+          T.let(
+            :MERCHANT,
+            Lithic::DigitalWalletTokenizationApprovalRequestWebhookEvent::TokenizationChannel::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Lithic::DigitalWalletTokenizationApprovalRequestWebhookEvent::TokenizationChannel::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+
       class CustomerTokenizationDecision < Lithic::Internal::Type::BaseModel
         OrHash =
           T.type_alias do
@@ -381,112 +499,6 @@ module Lithic
         end
       end
 
-      # The name of this event
-      module EventType
-        extend Lithic::Internal::Type::Enum
-
-        TaggedSymbol =
-          T.type_alias do
-            T.all(
-              Symbol,
-              Lithic::DigitalWalletTokenizationApprovalRequestWebhookEvent::EventType
-            )
-          end
-        OrSymbol = T.type_alias { T.any(Symbol, String) }
-
-        DIGITAL_WALLET_TOKENIZATION_APPROVAL_REQUEST =
-          T.let(
-            :"digital_wallet.tokenization_approval_request",
-            Lithic::DigitalWalletTokenizationApprovalRequestWebhookEvent::EventType::TaggedSymbol
-          )
-
-        sig do
-          override.returns(
-            T::Array[
-              Lithic::DigitalWalletTokenizationApprovalRequestWebhookEvent::EventType::TaggedSymbol
-            ]
-          )
-        end
-        def self.values
-        end
-      end
-
-      # Whether Lithic decisioned on the token, and if so, what the decision was.
-      # APPROVED/VERIFICATION_REQUIRED/DENIED.
-      module IssuerDecision
-        extend Lithic::Internal::Type::Enum
-
-        TaggedSymbol =
-          T.type_alias do
-            T.all(
-              Symbol,
-              Lithic::DigitalWalletTokenizationApprovalRequestWebhookEvent::IssuerDecision
-            )
-          end
-        OrSymbol = T.type_alias { T.any(Symbol, String) }
-
-        APPROVED =
-          T.let(
-            :APPROVED,
-            Lithic::DigitalWalletTokenizationApprovalRequestWebhookEvent::IssuerDecision::TaggedSymbol
-          )
-        DENIED =
-          T.let(
-            :DENIED,
-            Lithic::DigitalWalletTokenizationApprovalRequestWebhookEvent::IssuerDecision::TaggedSymbol
-          )
-        VERIFICATION_REQUIRED =
-          T.let(
-            :VERIFICATION_REQUIRED,
-            Lithic::DigitalWalletTokenizationApprovalRequestWebhookEvent::IssuerDecision::TaggedSymbol
-          )
-
-        sig do
-          override.returns(
-            T::Array[
-              Lithic::DigitalWalletTokenizationApprovalRequestWebhookEvent::IssuerDecision::TaggedSymbol
-            ]
-          )
-        end
-        def self.values
-        end
-      end
-
-      # The channel through which the tokenization was made.
-      module TokenizationChannel
-        extend Lithic::Internal::Type::Enum
-
-        TaggedSymbol =
-          T.type_alias do
-            T.all(
-              Symbol,
-              Lithic::DigitalWalletTokenizationApprovalRequestWebhookEvent::TokenizationChannel
-            )
-          end
-        OrSymbol = T.type_alias { T.any(Symbol, String) }
-
-        DIGITAL_WALLET =
-          T.let(
-            :DIGITAL_WALLET,
-            Lithic::DigitalWalletTokenizationApprovalRequestWebhookEvent::TokenizationChannel::TaggedSymbol
-          )
-        MERCHANT =
-          T.let(
-            :MERCHANT,
-            Lithic::DigitalWalletTokenizationApprovalRequestWebhookEvent::TokenizationChannel::TaggedSymbol
-          )
-
-        sig do
-          override.returns(
-            T::Array[
-              Lithic::DigitalWalletTokenizationApprovalRequestWebhookEvent::TokenizationChannel::TaggedSymbol
-            ]
-          )
-        end
-        def self.values
-        end
-      end
-
       # The source of the tokenization.
       module TokenizationSource
         extend Lithic::Internal::Type::Enum

data/rbi/lithic/models/dispute_create_params.rbi

@@ -11,26 +11,26 @@ module Lithic
           T.any(Lithic::DisputeCreateParams, Lithic::Internal::AnyHash)
         end
 
-      # Amount to dispute
+      # Amount for chargeback
       sig { returns(Integer) }
       attr_accessor :amount
 
-      # Reason for dispute
+      # Reason for chargeback
       sig { returns(Lithic::DisputeCreateParams::Reason::OrSymbol) }
       attr_accessor :reason
 
-      # Transaction to dispute
+      # Transaction for chargeback
       sig { returns(String) }
       attr_accessor :transaction_token
 
-      # Date the customer filed the dispute
+      # Date the customer filed the chargeback request
       sig { returns(T.nilable(Time)) }
       attr_reader :customer_filed_date
 
       sig { params(customer_filed_date: Time).void }
       attr_writer :customer_filed_date
 
-      # Customer description of dispute
+      # Customer description
       sig { returns(T.nilable(String)) }
       attr_reader :customer_note
 
@@ -48,15 +48,15 @@ module Lithic
         ).returns(T.attached_class)
       end
       def self.new(
-        # Amount to dispute
+        # Amount for chargeback
         amount:,
-        # Reason for dispute
+        # Reason for chargeback
         reason:,
-        # Transaction to dispute
+        # Transaction for chargeback
         transaction_token:,
-        # Date the customer filed the dispute
+        # Date the customer filed the chargeback request
         customer_filed_date: nil,
-        # Customer description of dispute
+        # Customer description
         customer_note: nil,
         request_options: {}
       )
@@ -77,7 +77,7 @@ module Lithic
       def to_hash
       end
 
-      # Reason for dispute
+      # Reason for chargeback
       module Reason
         extend Lithic::Internal::Type::Enum
 

data/rbi/lithic/models/dispute_delete_evidence_params.rbi

@@ -14,18 +14,26 @@ module Lithic
       sig { returns(String) }
       attr_accessor :dispute_token
 
+      sig { returns(String) }
+      attr_accessor :evidence_token
+
       sig do
         params(
           dispute_token: String,
+          evidence_token: String,
           request_options: Lithic::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
-      def self.new(dispute_token:, request_options: {})
+      def self.new(dispute_token:, evidence_token:, request_options: {})
       end
 
       sig do
         override.returns(
-          { dispute_token: String, request_options: Lithic::RequestOptions }
+          {
+            dispute_token: String,
+            evidence_token: String,
+            request_options: Lithic::RequestOptions
+          }
         )
       end
       def to_hash

data/rbi/lithic/models/dispute_delete_params.rbi

@@ -11,15 +11,23 @@ module Lithic
           T.any(Lithic::DisputeDeleteParams, Lithic::Internal::AnyHash)
         end
 
+      sig { returns(String) }
+      attr_accessor :dispute_token
+
       sig do
-        params(request_options: Lithic::RequestOptions::OrHash).returns(
-          T.attached_class
-        )
+        params(
+          dispute_token: String,
+          request_options: Lithic::RequestOptions::OrHash
+        ).returns(T.attached_class)
       end
-      def self.new(request_options: {})
+      def self.new(dispute_token:, request_options: {})
       end
 
-      sig { override.returns({ request_options: Lithic::RequestOptions }) }
+      sig do
+        override.returns(
+          { dispute_token: String, request_options: Lithic::RequestOptions }
+        )
+      end
       def to_hash
       end
     end

data/rbi/lithic/models/dispute_initiate_evidence_upload_params.rbi

@@ -14,6 +14,9 @@ module Lithic
           )
         end
 
+      sig { returns(String) }
+      attr_accessor :dispute_token
+
       # Filename of the evidence.
       sig { returns(T.nilable(String)) }
       attr_reader :filename
@@ -23,11 +26,13 @@ module Lithic
 
       sig do
         params(
+          dispute_token: String,
           filename: String,
           request_options: Lithic::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
       def self.new(
+        dispute_token:,
         # Filename of the evidence.
         filename: nil,
         request_options: {}
@@ -36,7 +41,11 @@ module Lithic
 
       sig do
         override.returns(
-          { filename: String, request_options: Lithic::RequestOptions }
+          {
+            dispute_token: String,
+            filename: String,
+            request_options: Lithic::RequestOptions
+          }
         )
       end
       def to_hash

data/rbi/lithic/models/dispute_list_evidences_params.rbi

@@ -11,6 +11,9 @@ module Lithic
           T.any(Lithic::DisputeListEvidencesParams, Lithic::Internal::AnyHash)
         end
 
+      sig { returns(String) }
+      attr_accessor :dispute_token
+
       # Date string in RFC 3339 format. Only entries created after the specified time
       # will be included. UTC time zone.
       sig { returns(T.nilable(Time)) }
@@ -52,6 +55,7 @@ module Lithic
 
       sig do
         params(
+          dispute_token: String,
           begin_: Time,
           end_: Time,
           ending_before: String,
@@ -61,6 +65,7 @@ module Lithic
         ).returns(T.attached_class)
       end
       def self.new(
+        dispute_token:,
         # Date string in RFC 3339 format. Only entries created after the specified time
         # will be included. UTC time zone.
         begin_: nil,
@@ -82,6 +87,7 @@ module Lithic
       sig do
         override.returns(
           {
+            dispute_token: String,
             begin_: Time,
             end_: Time,
             ending_before: String,

data/rbi/lithic/models/dispute_list_params.rbi

@@ -50,7 +50,7 @@ module Lithic
       sig { params(starting_after: String).void }
       attr_writer :starting_after
 
-      # List disputes of a specific status.
+      # Filter by status.
       sig { returns(T.nilable(Lithic::DisputeListParams::Status::OrSymbol)) }
       attr_reader :status
 
@@ -91,7 +91,7 @@ module Lithic
         # 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.
         starting_after: nil,
-        # List disputes of a specific status.
+        # Filter by status.
         status: nil,
         # Transaction tokens to filter by.
         transaction_tokens: nil,
@@ -116,7 +116,7 @@ module Lithic
       def to_hash
       end
 
-      # List disputes of a specific status.
+      # Filter by status.
       module Status
         extend Lithic::Internal::Type::Enum
 

data/rbi/lithic/models/dispute_retrieve_evidence_params.rbi

@@ -17,18 +17,26 @@ module Lithic
       sig { returns(String) }
       attr_accessor :dispute_token
 
+      sig { returns(String) }
+      attr_accessor :evidence_token
+
       sig do
         params(
           dispute_token: String,
+          evidence_token: String,
           request_options: Lithic::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
-      def self.new(dispute_token:, request_options: {})
+      def self.new(dispute_token:, evidence_token:, request_options: {})
       end
 
       sig do
         override.returns(
-          { dispute_token: String, request_options: Lithic::RequestOptions }
+          {
+            dispute_token: String,
+            evidence_token: String,
+            request_options: Lithic::RequestOptions
+          }
         )
       end
       def to_hash

data/rbi/lithic/models/dispute_retrieve_params.rbi

@@ -11,15 +11,23 @@ module Lithic
           T.any(Lithic::DisputeRetrieveParams, Lithic::Internal::AnyHash)
         end
 
+      sig { returns(String) }
+      attr_accessor :dispute_token
+
       sig do
-        params(request_options: Lithic::RequestOptions::OrHash).returns(
-          T.attached_class
-        )
+        params(
+          dispute_token: String,
+          request_options: Lithic::RequestOptions::OrHash
+        ).returns(T.attached_class)
       end
-      def self.new(request_options: {})
+      def self.new(dispute_token:, request_options: {})
       end
 
-      sig { override.returns({ request_options: Lithic::RequestOptions }) }
+      sig do
+        override.returns(
+          { dispute_token: String, request_options: Lithic::RequestOptions }
+        )
+      end
       def to_hash
       end
     end