lithic 0.20.0 → 0.21.0

data/lib/lithic/models/parsed_webhook_event.rb

@@ -42,6 +42,8 @@ module Lithic
 
       variant -> { Lithic::CardConvertedWebhookEvent }
 
+      variant -> { Lithic::CardPinUpdatedWebhookEvent }
+
       variant -> { Lithic::CardRenewedWebhookEvent }
 
       variant -> { Lithic::CardReissuedWebhookEvent }
@@ -830,7 +832,7 @@ module Lithic
       end
 
       # @!method self.variants
-      #   @return [Array(Lithic::Models::AccountHolderCreatedWebhookEvent, Lithic::Models::ParsedWebhookEvent::KYBPayload, Lithic::Models::ParsedWebhookEvent::KYCPayload, Lithic::Models::ParsedWebhookEvent::LegacyPayload, Lithic::Models::AccountHolderVerificationWebhookEvent, Lithic::Models::AccountHolderDocumentUpdatedWebhookEvent, Lithic::Models::CardAuthorizationApprovalRequestWebhookEvent, Lithic::Models::CardAuthorizationChallengeWebhookEvent, Lithic::Models::CardAuthorizationChallengeResponseWebhookEvent, Lithic::Models::AuthRulesBacktestReportCreatedWebhookEvent, Lithic::Models::BalanceUpdatedWebhookEvent, Lithic::Models::BookTransferTransactionCreatedWebhookEvent, Lithic::Models::BookTransferTransactionUpdatedWebhookEvent, Lithic::Models::CardCreatedWebhookEvent, Lithic::Models::CardConvertedWebhookEvent, Lithic::Models::CardRenewedWebhookEvent, Lithic::Models::CardReissuedWebhookEvent, Lithic::Models::CardShippedWebhookEvent, Lithic::Models::CardUpdatedWebhookEvent, Lithic::Models::CardTransactionUpdatedWebhookEvent, Lithic::Models::CardTransactionEnhancedDataCreatedWebhookEvent, Lithic::Models::CardTransactionEnhancedDataUpdatedWebhookEvent, Lithic::Models::ClaimCreatedWebhookEvent, Lithic::Models::ClaimUpdatedWebhookEvent, Lithic::Models::ClaimDocumentUploadedWebhookEvent, Lithic::Models::ClaimDocumentAcceptedWebhookEvent, Lithic::Models::ClaimDocumentRejectedWebhookEvent, Lithic::Models::DigitalWalletTokenizationApprovalRequestWebhookEvent, Lithic::Models::DigitalWalletTokenizationResultWebhookEvent, Lithic::Models::DigitalWalletTokenizationTwoFactorAuthenticationCodeWebhookEvent, Lithic::Models::DigitalWalletTokenizationTwoFactorAuthenticationCodeSentWebhookEvent, Lithic::Models::DigitalWalletTokenizationUpdatedWebhookEvent, Lithic::Models::DisputeUpdatedWebhookEvent, Lithic::Models::DisputeEvidenceUploadFailedWebhookEvent, Lithic::Models::EmbedSessionGeneratedWebhookEvent, Lithic::Models::EmbedViewedWebhookEvent, Lithic::Models::ExternalBankAccountCreatedWebhookEvent, Lithic::Models::ExternalBankAccountUpdatedWebhookEvent, Lithic::Models::ExternalPaymentCreatedWebhookEvent, Lithic::Models::ExternalPaymentUpdatedWebhookEvent, Lithic::Models::FinancialAccountCreatedWebhookEvent, Lithic::Models::FinancialAccountUpdatedWebhookEvent, Lithic::Models::FundingEventCreatedWebhookEvent, Lithic::Models::LoanTapeCreatedWebhookEvent, Lithic::Models::LoanTapeUpdatedWebhookEvent, Lithic::Models::ManagementOperationCreatedWebhookEvent, Lithic::Models::ManagementOperationUpdatedWebhookEvent, Lithic::Models::InternalTransactionCreatedWebhookEvent, Lithic::Models::InternalTransactionUpdatedWebhookEvent, Lithic::Models::NetworkTotalCreatedWebhookEvent, Lithic::Models::NetworkTotalUpdatedWebhookEvent, Lithic::Models::PaymentTransactionCreatedWebhookEvent, Lithic::Models::PaymentTransactionUpdatedWebhookEvent, Lithic::Models::SettlementReportUpdatedWebhookEvent, Lithic::Models::StatementsCreatedWebhookEvent, Lithic::Models::ThreeDSAuthenticationCreatedWebhookEvent, Lithic::Models::ThreeDSAuthenticationUpdatedWebhookEvent, Lithic::Models::ThreeDSAuthenticationChallengeWebhookEvent, Lithic::Models::TokenizationApprovalRequestWebhookEvent, Lithic::Models::TokenizationResultWebhookEvent, Lithic::Models::TokenizationTwoFactorAuthenticationCodeWebhookEvent, Lithic::Models::TokenizationTwoFactorAuthenticationCodeSentWebhookEvent, Lithic::Models::TokenizationUpdatedWebhookEvent, Lithic::Models::ThreeDSAuthenticationApprovalRequestWebhookEvent, Lithic::Models::DisputeTransactionCreatedWebhookEvent, Lithic::Models::DisputeTransactionUpdatedWebhookEvent)]
+      #   @return [Array(Lithic::Models::AccountHolderCreatedWebhookEvent, Lithic::Models::ParsedWebhookEvent::KYBPayload, Lithic::Models::ParsedWebhookEvent::KYCPayload, Lithic::Models::ParsedWebhookEvent::LegacyPayload, Lithic::Models::AccountHolderVerificationWebhookEvent, Lithic::Models::AccountHolderDocumentUpdatedWebhookEvent, Lithic::Models::CardAuthorizationApprovalRequestWebhookEvent, Lithic::Models::CardAuthorizationChallengeWebhookEvent, Lithic::Models::CardAuthorizationChallengeResponseWebhookEvent, Lithic::Models::AuthRulesBacktestReportCreatedWebhookEvent, Lithic::Models::BalanceUpdatedWebhookEvent, Lithic::Models::BookTransferTransactionCreatedWebhookEvent, Lithic::Models::BookTransferTransactionUpdatedWebhookEvent, Lithic::Models::CardCreatedWebhookEvent, Lithic::Models::CardConvertedWebhookEvent, Lithic::Models::CardPinUpdatedWebhookEvent, Lithic::Models::CardRenewedWebhookEvent, Lithic::Models::CardReissuedWebhookEvent, Lithic::Models::CardShippedWebhookEvent, Lithic::Models::CardUpdatedWebhookEvent, Lithic::Models::CardTransactionUpdatedWebhookEvent, Lithic::Models::CardTransactionEnhancedDataCreatedWebhookEvent, Lithic::Models::CardTransactionEnhancedDataUpdatedWebhookEvent, Lithic::Models::ClaimCreatedWebhookEvent, Lithic::Models::ClaimUpdatedWebhookEvent, Lithic::Models::ClaimDocumentUploadedWebhookEvent, Lithic::Models::ClaimDocumentAcceptedWebhookEvent, Lithic::Models::ClaimDocumentRejectedWebhookEvent, Lithic::Models::DigitalWalletTokenizationApprovalRequestWebhookEvent, Lithic::Models::DigitalWalletTokenizationResultWebhookEvent, Lithic::Models::DigitalWalletTokenizationTwoFactorAuthenticationCodeWebhookEvent, Lithic::Models::DigitalWalletTokenizationTwoFactorAuthenticationCodeSentWebhookEvent, Lithic::Models::DigitalWalletTokenizationUpdatedWebhookEvent, Lithic::Models::DisputeUpdatedWebhookEvent, Lithic::Models::DisputeEvidenceUploadFailedWebhookEvent, Lithic::Models::EmbedSessionGeneratedWebhookEvent, Lithic::Models::EmbedViewedWebhookEvent, Lithic::Models::ExternalBankAccountCreatedWebhookEvent, Lithic::Models::ExternalBankAccountUpdatedWebhookEvent, Lithic::Models::ExternalPaymentCreatedWebhookEvent, Lithic::Models::ExternalPaymentUpdatedWebhookEvent, Lithic::Models::FinancialAccountCreatedWebhookEvent, Lithic::Models::FinancialAccountUpdatedWebhookEvent, Lithic::Models::FundingEventCreatedWebhookEvent, Lithic::Models::LoanTapeCreatedWebhookEvent, Lithic::Models::LoanTapeUpdatedWebhookEvent, Lithic::Models::ManagementOperationCreatedWebhookEvent, Lithic::Models::ManagementOperationUpdatedWebhookEvent, Lithic::Models::InternalTransactionCreatedWebhookEvent, Lithic::Models::InternalTransactionUpdatedWebhookEvent, Lithic::Models::NetworkTotalCreatedWebhookEvent, Lithic::Models::NetworkTotalUpdatedWebhookEvent, Lithic::Models::PaymentTransactionCreatedWebhookEvent, Lithic::Models::PaymentTransactionUpdatedWebhookEvent, Lithic::Models::SettlementReportUpdatedWebhookEvent, Lithic::Models::StatementsCreatedWebhookEvent, Lithic::Models::ThreeDSAuthenticationCreatedWebhookEvent, Lithic::Models::ThreeDSAuthenticationUpdatedWebhookEvent, Lithic::Models::ThreeDSAuthenticationChallengeWebhookEvent, Lithic::Models::TokenizationApprovalRequestWebhookEvent, Lithic::Models::TokenizationResultWebhookEvent, Lithic::Models::TokenizationTwoFactorAuthenticationCodeWebhookEvent, Lithic::Models::TokenizationTwoFactorAuthenticationCodeSentWebhookEvent, Lithic::Models::TokenizationUpdatedWebhookEvent, Lithic::Models::ThreeDSAuthenticationApprovalRequestWebhookEvent, Lithic::Models::DisputeTransactionCreatedWebhookEvent, Lithic::Models::DisputeTransactionUpdatedWebhookEvent)]
     end
   end
 end

data/lib/lithic/models/payment.rb

@@ -222,6 +222,7 @@ module Lithic
         EXTERNAL_CHECK = :EXTERNAL_CHECK
         EXTERNAL_FEDNOW = :EXTERNAL_FEDNOW
         EXTERNAL_RTP = :EXTERNAL_RTP
+        EXTERNAL_STABLECOIN = :EXTERNAL_STABLECOIN
         EXTERNAL_TRANSFER = :EXTERNAL_TRANSFER
         EXTERNAL_WIRE = :EXTERNAL_WIRE
         MANAGEMENT_ADJUSTMENT = :MANAGEMENT_ADJUSTMENT

data/lib/lithic/models/payment_create_stablecoin_params.rb

@@ -0,0 +1,99 @@
+# frozen_string_literal: true
+
+module Lithic
+  module Models
+    # @see Lithic::Resources::Payments#create_stablecoin
+    class PaymentCreateStablecoinParams < Lithic::Internal::Type::BaseModel
+      extend Lithic::Internal::Type::RequestParameters::Converter
+      include Lithic::Internal::Type::RequestParameters
+
+      # @!attribute amount
+      #   Payout amount in cents
+      #
+      #   @return [Integer]
+      required :amount, Integer
+
+      # @!attribute blockchain_recipient_token
+      #   Token of the blockchain recipient to send the payout to. The recipient must be
+      #   in the `ENABLED` verification state
+      #
+      #   @return [String]
+      required :blockchain_recipient_token, String
+
+      # @!attribute financial_account_token
+      #   Token of the financial account the payout is funded from
+      #
+      #   @return [String]
+      required :financial_account_token, String
+
+      # @!attribute type
+      #   Direction of the payment. Stablecoin supports payouts only
+      #
+      #   @return [Symbol, Lithic::Models::PaymentCreateStablecoinParams::Type]
+      required :type, enum: -> { Lithic::PaymentCreateStablecoinParams::Type }
+
+      # @!attribute token
+      #   Customer-provided token that will serve as an idempotency token. This token will
+      #   become the transaction token
+      #
+      #   @return [String, nil]
+      optional :token, String
+
+      # @!attribute hold
+      #   Optional hold to settle when this payout is initiated
+      #
+      #   @return [Lithic::Models::PaymentCreateStablecoinParams::Hold, nil]
+      optional :hold, -> { Lithic::PaymentCreateStablecoinParams::Hold }
+
+      # @!attribute memo
+      #   Memo recorded on the payout. Defaults to `Stablecoin payout on <chain>` when
+      #   omitted
+      #
+      #   @return [String, nil]
+      optional :memo, String
+
+      # @!method initialize(amount:, blockchain_recipient_token:, financial_account_token:, type:, token: nil, hold: nil, memo: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Lithic::Models::PaymentCreateStablecoinParams} for more details.
+      #
+      #   @param amount [Integer] Payout amount in cents
+      #
+      #   @param blockchain_recipient_token [String] Token of the blockchain recipient to send the payout to. The recipient must be i
+      #
+      #   @param financial_account_token [String] Token of the financial account the payout is funded from
+      #
+      #   @param type [Symbol, Lithic::Models::PaymentCreateStablecoinParams::Type] Direction of the payment. Stablecoin supports payouts only
+      #
+      #   @param token [String] Customer-provided token that will serve as an idempotency token. This token will
+      #
+      #   @param hold [Lithic::Models::PaymentCreateStablecoinParams::Hold] Optional hold to settle when this payout is initiated
+      #
+      #   @param memo [String] Memo recorded on the payout. Defaults to `Stablecoin payout on <chain>` when omi
+      #
+      #   @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}]
+
+      # Direction of the payment. Stablecoin supports payouts only
+      module Type
+        extend Lithic::Internal::Type::Enum
+
+        PAYMENT = :PAYMENT
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      class Hold < Lithic::Internal::Type::BaseModel
+        # @!attribute token
+        #   Token of the hold to settle when this payout is initiated
+        #
+        #   @return [String]
+        required :token, String
+
+        # @!method initialize(token:)
+        #   Optional hold to settle when this payout is initiated
+        #
+        #   @param token [String] Token of the hold to settle when this payout is initiated
+      end
+    end
+  end
+end

data/lib/lithic/models/payment_create_stablecoin_response.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Lithic
+  module Models
+    # @see Lithic::Resources::Payments#create_stablecoin
+    class PaymentCreateStablecoinResponse < Lithic::Models::Payment
+      # @!attribute balance
+      #   Balance
+      #
+      #   @return [Lithic::Models::Balance, nil]
+      optional :balance, -> { Lithic::Balance }
+
+      # @!method initialize(balance: nil)
+      #   Payment transaction
+      #
+      #   @param balance [Lithic::Models::Balance] Balance
+    end
+  end
+end

data/lib/lithic/models/payment_list_params.rb

@@ -103,6 +103,7 @@ module Lithic
         extend Lithic::Internal::Type::Enum
 
         ACH = :ACH
+        STABLECOIN = :STABLECOIN
 
         # @!method self.values
         #   @return [Array<Symbol>]

data/lib/lithic/models/payment_retry_params.rb

@@ -12,9 +12,36 @@ module Lithic
       #   @return [String]
       required :payment_token, String
 
-      # @!method initialize(payment_token:, request_options: {})
+      # @!attribute method_
+      #   Settlement speed to retry the payment at. Defaults to the original payment's
+      #   method. An `ACH_SAME_DAY` retry is rejected if the payment is for $1,000,000.00
+      #   or more, or if it is submitted after the same day ACH cutoff
+      #
+      #   @return [Symbol, Lithic::Models::PaymentRetryParams::Method, nil]
+      optional :method_, enum: -> { Lithic::PaymentRetryParams::Method }, api_name: :method
+
+      # @!method initialize(payment_token:, method_: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Lithic::Models::PaymentRetryParams} for more details.
+      #
       #   @param payment_token [String]
+      #
+      #   @param method_ [Symbol, Lithic::Models::PaymentRetryParams::Method] Settlement speed to retry the payment at. Defaults to the original payment's met
+      #
       #   @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}]
+
+      # Settlement speed to retry the payment at. Defaults to the original payment's
+      # method. An `ACH_SAME_DAY` retry is rejected if the payment is for $1,000,000.00
+      # or more, or if it is submitted after the same day ACH cutoff
+      module Method
+        extend Lithic::Internal::Type::Enum
+
+        ACH_NEXT_DAY = :ACH_NEXT_DAY
+        ACH_SAME_DAY = :ACH_SAME_DAY
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
     end
   end
 end

data/lib/lithic/models/payment_simulate_action_params.rb

@@ -71,6 +71,7 @@ module Lithic
         ACH_RETURN_INITIATED = :ACH_RETURN_INITIATED
         ACH_RETURN_PROCESSED = :ACH_RETURN_PROCESSED
         ACH_RETURN_SETTLED = :ACH_RETURN_SETTLED
+        STABLECOIN_REVIEWED = :STABLECOIN_REVIEWED
 
         # @!method self.values
         #   @return [Array<Symbol>]

data/lib/lithic/models/three_ds_authentication.rb

@@ -145,6 +145,14 @@ module Lithic
       #   @return [Symbol, Lithic::Models::ThreeDSAuthentication::DecisionMadeBy, nil]
       optional :decision_made_by, enum: -> { Lithic::ThreeDSAuthentication::DecisionMadeBy }, nil?: true
 
+      # @!attribute psd2_context
+      #   PSD2/SCA context for EEA and UK transactions. Present when Lithic determines the
+      #   transaction is in scope for PSD2 Strong Customer Authentication. Absent for
+      #   out-of-scope transactions.
+      #
+      #   @return [Lithic::Models::ThreeDSAuthentication::Psd2Context, nil]
+      optional :psd2_context, -> { Lithic::ThreeDSAuthentication::Psd2Context }, nil?: true
+
       # @!attribute three_ri_request_type
       #   Type of 3DS Requestor Initiated (3RI) request — i.e., a 3DS authentication that
       #   takes place at the initiation of the merchant rather than the cardholder. The
@@ -164,7 +172,7 @@ module Lithic
       #   @return [Lithic::Models::ThreeDSAuthentication::Transaction, nil]
       optional :transaction, -> { Lithic::ThreeDSAuthentication::Transaction }, nil?: true
 
-      # @!method initialize(token:, account_type:, authentication_result:, card_expiry_check:, card_token:, cardholder:, channel:, created:, merchant:, message_category:, three_ds_requestor_challenge_indicator:, additional_data: nil, app: nil, authentication_request_type: nil, browser: nil, challenge_metadata: nil, challenge_orchestrated_by: nil, decision_made_by: nil, three_ri_request_type: nil, transaction: nil)
+      # @!method initialize(token:, account_type:, authentication_result:, card_expiry_check:, card_token:, cardholder:, channel:, created:, merchant:, message_category:, three_ds_requestor_challenge_indicator:, additional_data: nil, app: nil, authentication_request_type: nil, browser: nil, challenge_metadata: nil, challenge_orchestrated_by: nil, decision_made_by: nil, psd2_context: nil, three_ri_request_type: nil, transaction: nil)
       #   Some parameter documentations has been truncated, see
       #   {Lithic::Models::ThreeDSAuthentication} for more details.
       #
@@ -206,6 +214,8 @@ module Lithic
       #
       #   @param decision_made_by [Symbol, Lithic::Models::ThreeDSAuthentication::DecisionMadeBy, nil] Entity that made the authentication decision. This won't be set for authenticati
       #
+      #   @param psd2_context [Lithic::Models::ThreeDSAuthentication::Psd2Context, nil] PSD2/SCA context for EEA and UK transactions. Present when Lithic determines the
+      #
       #   @param three_ri_request_type [Symbol, Lithic::Models::ThreeDSAuthentication::ThreeRiRequestType, nil] Type of 3DS Requestor Initiated (3RI) request — i.e., a 3DS authentication that
       #
       #   @param transaction [Lithic::Models::ThreeDSAuthentication::Transaction, nil] Object containing data about the e-commerce transaction for which the merchant i
@@ -1142,6 +1152,121 @@ module Lithic
         #   @return [Array<Symbol>]
       end
 
+      # @see Lithic::Models::ThreeDSAuthentication#psd2_context
+      class Psd2Context < Lithic::Internal::Type::BaseModel
+        # @!attribute acquirer_exemption
+        #   SCA exemption declared by the acquirer in the 3DS authentication request.
+        #
+        #   - `NONE` - No exemption claimed
+        #   - `TRANSACTION_RISK_ANALYSIS` - Transaction Risk Analysis (TRA) exemption;
+        #     acquirer asserts low fraud risk
+        #   - `LOW_VALUE` - Low-value payment exemption; transaction is below the EUR 30
+        #     threshold
+        #   - `RECURRING_PAYMENT` - Recurring payment with a fixed amount to the same payee
+        #   - `MERCHANT_INITIATED_TRANSACTION` - Merchant-initiated transaction (MIT);
+        #     cardholder not present
+        #   - `TRUSTED_BENEFICIARY` - Trusted beneficiary; merchant is on cardholder's
+        #     whitelist
+        #   - `STRONG_CUSTOMER_AUTHENTICATION_DELEGATION` - SCA already performed by a
+        #     delegated third-party authenticator
+        #   - `SECURE_CORPORATE_PAYMENT` - Secure corporate payment using a dedicated
+        #     corporate card or process
+        #   - `AUTHENTICATION_OUTAGE_EXCEPTION` - Authentication outage exception;
+        #     scheme-level fallback during ACS downtime
+        #   - `BUNDLED` - Mastercard only; bundled exemption code where the exact exemption
+        #     type cannot be distinguished
+        #
+        #   @return [Symbol, Lithic::Models::ThreeDSAuthentication::Psd2Context::AcquirerExemption, nil]
+        optional :acquirer_exemption, enum: -> { Lithic::ThreeDSAuthentication::Psd2Context::AcquirerExemption }
+
+        # @!attribute lithic_exemption_validation
+        #   Lithic's validation of the acquirer-declared exemption. Absent when no acquirer
+        #   exemption was declared.
+        #
+        #   - `ACCEPTED` - Lithic signals support the acquirer's claim
+        #   - `REJECTED` - Lithic signals contradict the claim, or a required signal is
+        #     missing
+        #   - `NOT_VALIDATED` - Exemption was declared but Lithic has no basis to evaluate
+        #     it; treated as `REJECTED` for challenge purposes
+        #
+        #   @return [Symbol, Lithic::Models::ThreeDSAuthentication::Psd2Context::LithicExemptionValidation, nil]
+        optional :lithic_exemption_validation,
+                 enum: -> { Lithic::ThreeDSAuthentication::Psd2Context::LithicExemptionValidation }
+
+        # @!method initialize(acquirer_exemption: nil, lithic_exemption_validation: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Lithic::Models::ThreeDSAuthentication::Psd2Context} for more details.
+        #
+        #   PSD2/SCA context for EEA and UK transactions. Present when Lithic determines the
+        #   transaction is in scope for PSD2 Strong Customer Authentication. Absent for
+        #   out-of-scope transactions.
+        #
+        #   @param acquirer_exemption [Symbol, Lithic::Models::ThreeDSAuthentication::Psd2Context::AcquirerExemption] SCA exemption declared by the acquirer in the 3DS authentication request.
+        #
+        #   @param lithic_exemption_validation [Symbol, Lithic::Models::ThreeDSAuthentication::Psd2Context::LithicExemptionValidation] Lithic's validation of the acquirer-declared exemption. Absent when no acquirer
+
+        # SCA exemption declared by the acquirer in the 3DS authentication request.
+        #
+        # - `NONE` - No exemption claimed
+        # - `TRANSACTION_RISK_ANALYSIS` - Transaction Risk Analysis (TRA) exemption;
+        #   acquirer asserts low fraud risk
+        # - `LOW_VALUE` - Low-value payment exemption; transaction is below the EUR 30
+        #   threshold
+        # - `RECURRING_PAYMENT` - Recurring payment with a fixed amount to the same payee
+        # - `MERCHANT_INITIATED_TRANSACTION` - Merchant-initiated transaction (MIT);
+        #   cardholder not present
+        # - `TRUSTED_BENEFICIARY` - Trusted beneficiary; merchant is on cardholder's
+        #   whitelist
+        # - `STRONG_CUSTOMER_AUTHENTICATION_DELEGATION` - SCA already performed by a
+        #   delegated third-party authenticator
+        # - `SECURE_CORPORATE_PAYMENT` - Secure corporate payment using a dedicated
+        #   corporate card or process
+        # - `AUTHENTICATION_OUTAGE_EXCEPTION` - Authentication outage exception;
+        #   scheme-level fallback during ACS downtime
+        # - `BUNDLED` - Mastercard only; bundled exemption code where the exact exemption
+        #   type cannot be distinguished
+        #
+        # @see Lithic::Models::ThreeDSAuthentication::Psd2Context#acquirer_exemption
+        module AcquirerExemption
+          extend Lithic::Internal::Type::Enum
+
+          NONE = :NONE
+          TRANSACTION_RISK_ANALYSIS = :TRANSACTION_RISK_ANALYSIS
+          LOW_VALUE = :LOW_VALUE
+          RECURRING_PAYMENT = :RECURRING_PAYMENT
+          MERCHANT_INITIATED_TRANSACTION = :MERCHANT_INITIATED_TRANSACTION
+          TRUSTED_BENEFICIARY = :TRUSTED_BENEFICIARY
+          STRONG_CUSTOMER_AUTHENTICATION_DELEGATION = :STRONG_CUSTOMER_AUTHENTICATION_DELEGATION
+          SECURE_CORPORATE_PAYMENT = :SECURE_CORPORATE_PAYMENT
+          AUTHENTICATION_OUTAGE_EXCEPTION = :AUTHENTICATION_OUTAGE_EXCEPTION
+          BUNDLED = :BUNDLED
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # Lithic's validation of the acquirer-declared exemption. Absent when no acquirer
+        # exemption was declared.
+        #
+        # - `ACCEPTED` - Lithic signals support the acquirer's claim
+        # - `REJECTED` - Lithic signals contradict the claim, or a required signal is
+        #   missing
+        # - `NOT_VALIDATED` - Exemption was declared but Lithic has no basis to evaluate
+        #   it; treated as `REJECTED` for challenge purposes
+        #
+        # @see Lithic::Models::ThreeDSAuthentication::Psd2Context#lithic_exemption_validation
+        module LithicExemptionValidation
+          extend Lithic::Internal::Type::Enum
+
+          ACCEPTED = :ACCEPTED
+          REJECTED = :REJECTED
+          NOT_VALIDATED = :NOT_VALIDATED
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+
       # Type of 3DS Requestor Initiated (3RI) request — i.e., a 3DS authentication that
       # takes place at the initiation of the merchant rather than the cardholder. The
       # most common example of this is where a merchant is authenticating before billing

data/lib/lithic/models/transaction.rb

@@ -1060,6 +1060,7 @@ module Lithic
           PROGRAM_SUSPENDED = :PROGRAM_SUSPENDED
           PROGRAM_USAGE_RESTRICTION = :PROGRAM_USAGE_RESTRICTION
           REVERSAL_UNMATCHED = :REVERSAL_UNMATCHED
+          SCA_REQUIRED = :SCA_REQUIRED
           SECURITY_VIOLATION = :SECURITY_VIOLATION
           SINGLE_USE_CARD_REATTEMPTED = :SINGLE_USE_CARD_REATTEMPTED
           SUSPECTED_FRAUD = :SUSPECTED_FRAUD
@@ -1390,6 +1391,7 @@ module Lithic
             PROGRAM_SUSPENDED = :PROGRAM_SUSPENDED
             PROGRAM_USAGE_RESTRICTION = :PROGRAM_USAGE_RESTRICTION
             REVERSAL_UNMATCHED = :REVERSAL_UNMATCHED
+            SCA_REQUIRED = :SCA_REQUIRED
             SECURITY_VIOLATION = :SECURITY_VIOLATION
             SINGLE_USE_CARD_REATTEMPTED = :SINGLE_USE_CARD_REATTEMPTED
             SUSPECTED_FRAUD = :SUSPECTED_FRAUD

data/lib/lithic/models.rb

@@ -116,6 +116,8 @@ module Lithic
 
   BlockchainRecipientCreateParams = Lithic::Models::BlockchainRecipientCreateParams
 
+  BlockchainRecipientRetrieveParams = Lithic::Models::BlockchainRecipientRetrieveParams
+
   BookTransferCreateParams = Lithic::Models::BookTransferCreateParams
 
   BookTransferListParams = Lithic::Models::BookTransferListParams
@@ -170,6 +172,8 @@ module Lithic
 
   CardListParams = Lithic::Models::CardListParams
 
+  CardPinUpdatedWebhookEvent = Lithic::Models::CardPinUpdatedWebhookEvent
+
   CardProgram = Lithic::Models::CardProgram
 
   CardProgramListParams = Lithic::Models::CardProgramListParams
@@ -475,6 +479,8 @@ module Lithic
 
   PaymentCreateParams = Lithic::Models::PaymentCreateParams
 
+  PaymentCreateStablecoinParams = Lithic::Models::PaymentCreateStablecoinParams
+
   PaymentListParams = Lithic::Models::PaymentListParams
 
   PaymentRetrieveParams = Lithic::Models::PaymentRetrieveParams

data/lib/lithic/resources/blockchain_recipients.rb

@@ -46,6 +46,29 @@ module Lithic
         )
       end
 
+      # Get a blockchain recipient by token
+      #
+      # Use this to poll the `verification_state` after registering an address: a
+      # recipient cannot receive a payout until screening completes and moves it out of
+      # `PENDING`
+      #
+      # @overload retrieve(blockchain_recipient_token, request_options: {})
+      #
+      # @param blockchain_recipient_token [String]
+      # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Lithic::Models::BlockchainRecipient]
+      #
+      # @see Lithic::Models::BlockchainRecipientRetrieveParams
+      def retrieve(blockchain_recipient_token, params = {})
+        @client.request(
+          method: :get,
+          path: ["v1/blockchain_recipients/%1$s", blockchain_recipient_token],
+          model: Lithic::BlockchainRecipient,
+          options: params[:request_options]
+        )
+      end
+
       # @api private
       #
       # @param client [Lithic::Client]

data/lib/lithic/resources/cards.rb

@@ -361,7 +361,8 @@ module Lithic
       # physically damaged). The PAN, expiry, and CVC2 will remain the same and the
       # original card can continue to be used until the new card is activated. Only
       # applies to cards of type `PHYSICAL`. A card can be reissued or renewed a total
-      # of 8 times.
+      # of 8 times. Returns `409` if the card is still ongoing manufacturing when using
+      # Thales as a manufacturer.
       #
       # @overload reissue(card_token, carrier: nil, product_id: nil, shipping_address: nil, shipping_method: nil, request_options: {})
       #
@@ -402,7 +403,8 @@ module Lithic
       # `PHYSICAL` card can be reissued or renewed a total of 8 times. For `VIRTUAL`,
       # the card will retain the same card token and PAN and receive an updated expiry
       # and CVC2 code. `product_id`, `shipping_method`, `shipping_address`, `carrier`
-      # are only relevant for renewing `PHYSICAL` cards.
+      # are only relevant for renewing `PHYSICAL` cards. Returns `409` if the card is
+      # still ongoing manufacturing when using Thales as a manufacturer.
       #
       # @overload renew(card_token, shipping_address:, carrier: nil, exp_month: nil, exp_year: nil, product_id: nil, shipping_method: nil, request_options: {})
       #

data/lib/lithic/resources/financial_accounts/installment_plans.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+module Lithic
+  module Resources
+    class FinancialAccounts
+      class InstallmentPlans
+        # Get a specific installment plan for a given financial account.
+        #
+        # @overload retrieve(installment_plan_token, financial_account_token:, request_options: {})
+        #
+        # @param installment_plan_token [String] Globally unique identifier for installment plan.
+        #
+        # @param financial_account_token [String] Globally unique identifier for financial account.
+        #
+        # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Lithic::Models::FinancialAccounts::InstallmentPlan]
+        #
+        # @see Lithic::Models::FinancialAccounts::InstallmentPlanRetrieveParams
+        def retrieve(installment_plan_token, params)
+          parsed, options = Lithic::FinancialAccounts::InstallmentPlanRetrieveParams.dump_request(params)
+          financial_account_token =
+            parsed.delete(:financial_account_token) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :get,
+            path: [
+              "v1/financial_accounts/%1$s/installment_plans/%2$s",
+              financial_account_token,
+              installment_plan_token
+            ],
+            model: Lithic::FinancialAccounts::InstallmentPlan,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Lithic::Models::FinancialAccounts::InstallmentPlanListParams} for more details.
+        #
+        # List the installment plans for a given financial account.
+        #
+        # @overload list(financial_account_token, ending_before: nil, page_size: nil, starting_after: nil, state: nil, request_options: {})
+        #
+        # @param financial_account_token [String] Globally unique identifier for financial account.
+        #
+        # @param ending_before [String] A cursor representing an item's token before which a page of results should end.
+        #
+        # @param page_size [Integer] Page size (for pagination).
+        #
+        # @param starting_after [String] A cursor representing an item's token after which a page of results should begin
+        #
+        # @param state [Symbol, Lithic::Models::FinancialAccounts::InstallmentPlanListParams::State, nil] Only installment plans in this state will be included.
+        #
+        # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Lithic::Internal::CursorPage<Lithic::Models::FinancialAccounts::InstallmentPlan>]
+        #
+        # @see Lithic::Models::FinancialAccounts::InstallmentPlanListParams
+        def list(financial_account_token, params = {})
+          parsed, options = Lithic::FinancialAccounts::InstallmentPlanListParams.dump_request(params)
+          query = Lithic::Internal::Util.encode_query_params(parsed)
+          @client.request(
+            method: :get,
+            path: ["v1/financial_accounts/%1$s/installment_plans", financial_account_token],
+            query: query,
+            page: Lithic::Internal::CursorPage,
+            model: Lithic::FinancialAccounts::InstallmentPlan,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Lithic::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/lithic/resources/financial_accounts/open_to_buy.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Lithic
+  module Resources
+    class FinancialAccounts
+      class OpenToBuy
+        # Get the funds available for card spend backed by a given Security Account, along
+        # with the balances that amount is derived from.
+        #
+        # Open to buy is the amount Lithic authorizes card spend against. It is not a
+        # stored balance, so it is recalculated on every request from the Security
+        # Account, the funds held against spend Lithic has already paid out to the
+        # networks on your behalf, and the spend that has not yet been collected. The
+        # accounts that feed the calculation depend on your program setup, so
+        # `summary.settled_funds` is `null` outside Commercial Charge.
+        #
+        # Supported for Commercial Charge, Dynamic Reserve, and Secured Charge programs.
+        # Returns `404` if `financial_account_token` is not a Security Account you own, or
+        # if your program setup does not use an open to buy calculation.
+        #
+        # @overload retrieve(financial_account_token, request_options: {})
+        #
+        # @param financial_account_token [String] Globally unique identifier for the Security Account to price
+        #
+        # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Lithic::Models::FinancialAccounts::FinancialAccountsOpenToBuy]
+        #
+        # @see Lithic::Models::FinancialAccounts::OpenToBuyRetrieveParams
+        def retrieve(financial_account_token, params = {})
+          @client.request(
+            method: :get,
+            path: ["v1/financial_accounts/%1$s/open_to_buy", financial_account_token],
+            model: Lithic::FinancialAccounts::FinancialAccountsOpenToBuy,
+            options: params[:request_options]
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Lithic::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/lithic/resources/financial_accounts.rb

@@ -6,6 +6,9 @@ module Lithic
       # @return [Lithic::Resources::FinancialAccounts::Balances]
       attr_reader :balances
 
+      # @return [Lithic::Resources::FinancialAccounts::OpenToBuy]
+      attr_reader :open_to_buy
+
       # @return [Lithic::Resources::FinancialAccounts::FinancialTransactions]
       attr_reader :financial_transactions
 
@@ -18,6 +21,9 @@ module Lithic
       # @return [Lithic::Resources::FinancialAccounts::LoanTapes]
       attr_reader :loan_tapes
 
+      # @return [Lithic::Resources::FinancialAccounts::InstallmentPlans]
+      attr_reader :installment_plans
+
       # @return [Lithic::Resources::FinancialAccounts::LoanTapeConfiguration]
       attr_reader :loan_tape_configuration
 
@@ -184,10 +190,12 @@ module Lithic
       def initialize(client:)
         @client = client
         @balances = Lithic::Resources::FinancialAccounts::Balances.new(client: client)
+        @open_to_buy = Lithic::Resources::FinancialAccounts::OpenToBuy.new(client: client)
         @financial_transactions = Lithic::Resources::FinancialAccounts::FinancialTransactions.new(client: client)
         @credit_configuration = Lithic::Resources::FinancialAccounts::CreditConfiguration.new(client: client)
         @statements = Lithic::Resources::FinancialAccounts::Statements.new(client: client)
         @loan_tapes = Lithic::Resources::FinancialAccounts::LoanTapes.new(client: client)
+        @installment_plans = Lithic::Resources::FinancialAccounts::InstallmentPlans.new(client: client)
         @loan_tape_configuration =
           Lithic::Resources::FinancialAccounts::LoanTapeConfiguration.new(client: client)
         @interest_tier_schedule = Lithic::Resources::FinancialAccounts::InterestTierSchedule.new(client: client)