lithic 0.20.0 → 0.22.0

data/rbi/lithic/models/payment_retry_params.rbi

@@ -14,22 +14,67 @@ module Lithic
       sig { returns(String) }
       attr_accessor :payment_token
 
+      # 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
+      sig { returns(T.nilable(Lithic::PaymentRetryParams::Method::OrSymbol)) }
+      attr_reader :method_
+
+      sig { params(method_: Lithic::PaymentRetryParams::Method::OrSymbol).void }
+      attr_writer :method_
+
       sig do
         params(
           payment_token: String,
+          method_: Lithic::PaymentRetryParams::Method::OrSymbol,
           request_options: Lithic::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
-      def self.new(payment_token:, request_options: {})
+      def self.new(
+        payment_token:,
+        # 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
+        method_: nil,
+        request_options: {}
+      )
       end
 
       sig do
         override.returns(
-          { payment_token: String, request_options: Lithic::RequestOptions }
+          {
+            payment_token: String,
+            method_: Lithic::PaymentRetryParams::Method::OrSymbol,
+            request_options: Lithic::RequestOptions
+          }
         )
       end
       def to_hash
       end
+
+      # 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
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, Lithic::PaymentRetryParams::Method) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        ACH_NEXT_DAY =
+          T.let(:ACH_NEXT_DAY, Lithic::PaymentRetryParams::Method::TaggedSymbol)
+        ACH_SAME_DAY =
+          T.let(:ACH_SAME_DAY, Lithic::PaymentRetryParams::Method::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[Lithic::PaymentRetryParams::Method::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
     end
   end
 end

data/rbi/lithic/models/payment_simulate_action_params.rbi

@@ -163,6 +163,11 @@ module Lithic
             :ACH_RETURN_SETTLED,
             Lithic::PaymentSimulateActionParams::EventType::TaggedSymbol
           )
+        STABLECOIN_REVIEWED =
+          T.let(
+            :STABLECOIN_REVIEWED,
+            Lithic::PaymentSimulateActionParams::EventType::TaggedSymbol
+          )
 
         sig do
           override.returns(

data/rbi/lithic/models/three_ds_authentication.rbi

@@ -183,6 +183,20 @@ module Lithic
       end
       attr_accessor :decision_made_by
 
+      # 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.
+      sig { returns(T.nilable(Lithic::ThreeDSAuthentication::Psd2Context)) }
+      attr_reader :psd2_context
+
+      sig do
+        params(
+          psd2_context:
+            T.nilable(Lithic::ThreeDSAuthentication::Psd2Context::OrHash)
+        ).void
+      end
+      attr_writer :psd2_context
+
       # 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
@@ -245,6 +259,8 @@ module Lithic
             ),
           decision_made_by:
             T.nilable(Lithic::ThreeDSAuthentication::DecisionMadeBy::OrSymbol),
+          psd2_context:
+            T.nilable(Lithic::ThreeDSAuthentication::Psd2Context::OrHash),
           three_ri_request_type:
             T.nilable(
               Lithic::ThreeDSAuthentication::ThreeRiRequestType::OrSymbol
@@ -319,6 +335,10 @@ module Lithic
         # authentications for which a decision has not yet been made (e.g. in-flight
         # customer decisioning request).
         decision_made_by: nil,
+        # 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.
+        psd2_context: nil,
         # 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
@@ -370,6 +390,7 @@ module Lithic
               T.nilable(
                 Lithic::ThreeDSAuthentication::DecisionMadeBy::TaggedSymbol
               ),
+            psd2_context: T.nilable(Lithic::ThreeDSAuthentication::Psd2Context),
             three_ri_request_type:
               T.nilable(
                 Lithic::ThreeDSAuthentication::ThreeRiRequestType::TaggedSymbol
@@ -2171,6 +2192,277 @@ module Lithic
         end
       end
 
+      class Psd2Context < Lithic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Lithic::ThreeDSAuthentication::Psd2Context,
+              Lithic::Internal::AnyHash
+            )
+          end
+
+        # 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
+        sig do
+          returns(
+            T.nilable(
+              Lithic::ThreeDSAuthentication::Psd2Context::AcquirerExemption::TaggedSymbol
+            )
+          )
+        end
+        attr_reader :acquirer_exemption
+
+        sig do
+          params(
+            acquirer_exemption:
+              Lithic::ThreeDSAuthentication::Psd2Context::AcquirerExemption::OrSymbol
+          ).void
+        end
+        attr_writer :acquirer_exemption
+
+        # 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
+        sig do
+          returns(
+            T.nilable(
+              Lithic::ThreeDSAuthentication::Psd2Context::LithicExemptionValidation::TaggedSymbol
+            )
+          )
+        end
+        attr_reader :lithic_exemption_validation
+
+        sig do
+          params(
+            lithic_exemption_validation:
+              Lithic::ThreeDSAuthentication::Psd2Context::LithicExemptionValidation::OrSymbol
+          ).void
+        end
+        attr_writer :lithic_exemption_validation
+
+        # 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.
+        sig do
+          params(
+            acquirer_exemption:
+              Lithic::ThreeDSAuthentication::Psd2Context::AcquirerExemption::OrSymbol,
+            lithic_exemption_validation:
+              Lithic::ThreeDSAuthentication::Psd2Context::LithicExemptionValidation::OrSymbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # 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
+          acquirer_exemption: nil,
+          # 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
+          lithic_exemption_validation: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              acquirer_exemption:
+                Lithic::ThreeDSAuthentication::Psd2Context::AcquirerExemption::TaggedSymbol,
+              lithic_exemption_validation:
+                Lithic::ThreeDSAuthentication::Psd2Context::LithicExemptionValidation::TaggedSymbol
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # 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
+        module AcquirerExemption
+          extend Lithic::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                Lithic::ThreeDSAuthentication::Psd2Context::AcquirerExemption
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          NONE =
+            T.let(
+              :NONE,
+              Lithic::ThreeDSAuthentication::Psd2Context::AcquirerExemption::TaggedSymbol
+            )
+          TRANSACTION_RISK_ANALYSIS =
+            T.let(
+              :TRANSACTION_RISK_ANALYSIS,
+              Lithic::ThreeDSAuthentication::Psd2Context::AcquirerExemption::TaggedSymbol
+            )
+          LOW_VALUE =
+            T.let(
+              :LOW_VALUE,
+              Lithic::ThreeDSAuthentication::Psd2Context::AcquirerExemption::TaggedSymbol
+            )
+          RECURRING_PAYMENT =
+            T.let(
+              :RECURRING_PAYMENT,
+              Lithic::ThreeDSAuthentication::Psd2Context::AcquirerExemption::TaggedSymbol
+            )
+          MERCHANT_INITIATED_TRANSACTION =
+            T.let(
+              :MERCHANT_INITIATED_TRANSACTION,
+              Lithic::ThreeDSAuthentication::Psd2Context::AcquirerExemption::TaggedSymbol
+            )
+          TRUSTED_BENEFICIARY =
+            T.let(
+              :TRUSTED_BENEFICIARY,
+              Lithic::ThreeDSAuthentication::Psd2Context::AcquirerExemption::TaggedSymbol
+            )
+          STRONG_CUSTOMER_AUTHENTICATION_DELEGATION =
+            T.let(
+              :STRONG_CUSTOMER_AUTHENTICATION_DELEGATION,
+              Lithic::ThreeDSAuthentication::Psd2Context::AcquirerExemption::TaggedSymbol
+            )
+          SECURE_CORPORATE_PAYMENT =
+            T.let(
+              :SECURE_CORPORATE_PAYMENT,
+              Lithic::ThreeDSAuthentication::Psd2Context::AcquirerExemption::TaggedSymbol
+            )
+          AUTHENTICATION_OUTAGE_EXCEPTION =
+            T.let(
+              :AUTHENTICATION_OUTAGE_EXCEPTION,
+              Lithic::ThreeDSAuthentication::Psd2Context::AcquirerExemption::TaggedSymbol
+            )
+          BUNDLED =
+            T.let(
+              :BUNDLED,
+              Lithic::ThreeDSAuthentication::Psd2Context::AcquirerExemption::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                Lithic::ThreeDSAuthentication::Psd2Context::AcquirerExemption::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        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
+        module LithicExemptionValidation
+          extend Lithic::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                Lithic::ThreeDSAuthentication::Psd2Context::LithicExemptionValidation
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          ACCEPTED =
+            T.let(
+              :ACCEPTED,
+              Lithic::ThreeDSAuthentication::Psd2Context::LithicExemptionValidation::TaggedSymbol
+            )
+          REJECTED =
+            T.let(
+              :REJECTED,
+              Lithic::ThreeDSAuthentication::Psd2Context::LithicExemptionValidation::TaggedSymbol
+            )
+          NOT_VALIDATED =
+            T.let(
+              :NOT_VALIDATED,
+              Lithic::ThreeDSAuthentication::Psd2Context::LithicExemptionValidation::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                Lithic::ThreeDSAuthentication::Psd2Context::LithicExemptionValidation::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        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/rbi/lithic/models/transaction.rbi

@@ -140,7 +140,8 @@ module Lithic
       attr_accessor :status
 
       # Key-value pairs for tagging resources. Tags allow you to associate arbitrary
-      # metadata with a resource for your own purposes.
+      # metadata with a resource for your own purposes. A resource can have at most 50
+      # tags, with keys up to 40 characters and values up to 500 characters
       sig { returns(T::Hash[Symbol, String]) }
       attr_accessor :tags
 
@@ -253,7 +254,8 @@ module Lithic
         # Status of the transaction.
         status:,
         # Key-value pairs for tagging resources. Tags allow you to associate arbitrary
-        # metadata with a resource for your own purposes.
+        # metadata with a resource for your own purposes. A resource can have at most 50
+        # tags, with keys up to 40 characters and values up to 500 characters
         tags:,
         token_info:,
         # Date and time when the transaction last updated. UTC time zone.
@@ -2079,6 +2081,11 @@ module Lithic
               :REVERSAL_UNMATCHED,
               Lithic::Transaction::Event::DetailedResult::TaggedSymbol
             )
+          SCA_REQUIRED =
+            T.let(
+              :SCA_REQUIRED,
+              Lithic::Transaction::Event::DetailedResult::TaggedSymbol
+            )
           SECURITY_VIOLATION =
             T.let(
               :SECURITY_VIOLATION,
@@ -2982,6 +2989,11 @@ module Lithic
                 :REVERSAL_UNMATCHED,
                 Lithic::Transaction::Event::RuleResult::Result::TaggedSymbol
               )
+            SCA_REQUIRED =
+              T.let(
+                :SCA_REQUIRED,
+                Lithic::Transaction::Event::RuleResult::Result::TaggedSymbol
+              )
             SECURITY_VIOLATION =
               T.let(
                 :SECURITY_VIOLATION,

data/rbi/lithic/models/transaction_simulate_authorization_params.rbi

@@ -30,6 +30,15 @@ module Lithic
       sig { returns(String) }
       attr_accessor :pan
 
+      # 3-character alphabetic ISO 4217 currency code for the cardholder billing amount.
+      # Permitted values are USD, GBP, EUR and CAD, and any other ISO 4217 code returns
+      # a 422. Defaults to USD
+      sig { returns(T.nilable(String)) }
+      attr_reader :billing_currency
+
+      sig { params(billing_currency: String).void }
+      attr_writer :billing_currency
+
       # Merchant category code for the transaction to be simulated. A four-digit number
       # listed in ISO 18245. Supported merchant category codes can be found
       # [here](https://docs.lithic.com/docs/transactions#merchant-category-codes-mccs).
@@ -75,8 +84,10 @@ module Lithic
       sig { params(merchant_amount: Integer).void }
       attr_writer :merchant_amount
 
-      # 3-character alphabetic ISO 4217 currency code. Note: Simulator only accepts USD,
-      # GBP, EUR and defaults to GBP if another ISO 4217 code is provided
+      # 3-character alphabetic ISO 4217 currency code for the merchant amount. Only used
+      # when merchant_amount is set, and defaults to GBP in that case. Without
+      # merchant_amount, the merchant amount uses the billing currency. Permitted values
+      # are USD, GBP, EUR and CAD, and any other ISO 4217 code returns a 422
       sig { returns(T.nilable(String)) }
       attr_reader :merchant_currency
 
@@ -99,6 +110,17 @@ module Lithic
       sig { params(pin: String).void }
       attr_writer :pin
 
+      # 3-character alphabetic ISO 4217 currency code for the settlement amount.
+      # Permitted values are USD, GBP, EUR and CAD, and any other ISO 4217 code returns
+      # a 422. Defaults to the value of billing_currency. Only single message
+      # (financial) authorizations carry a settlement amount, and the value is ignored
+      # for dual message authorizations
+      sig { returns(T.nilable(String)) }
+      attr_reader :settlement_currency
+
+      sig { params(settlement_currency: String).void }
+      attr_writer :settlement_currency
+
       # Type of event to simulate.
       #
       # - `AUTHORIZATION` is a dual message purchase authorization, meaning a subsequent
@@ -137,6 +159,7 @@ module Lithic
           amount: Integer,
           descriptor: String,
           pan: String,
+          billing_currency: String,
           mcc: String,
           merchant_acceptor_city: String,
           merchant_acceptor_country: String,
@@ -146,6 +169,7 @@ module Lithic
           merchant_currency: String,
           partial_approval_capable: T::Boolean,
           pin: String,
+          settlement_currency: String,
           status:
             Lithic::TransactionSimulateAuthorizationParams::Status::OrSymbol,
           request_options: Lithic::RequestOptions::OrHash
@@ -162,6 +186,10 @@ module Lithic
         descriptor:,
         # Sixteen digit card number.
         pan:,
+        # 3-character alphabetic ISO 4217 currency code for the cardholder billing amount.
+        # Permitted values are USD, GBP, EUR and CAD, and any other ISO 4217 code returns
+        # a 422. Defaults to USD
+        billing_currency: nil,
         # Merchant category code for the transaction to be simulated. A four-digit number
         # listed in ISO 18245. Supported merchant category codes can be found
         # [here](https://docs.lithic.com/docs/transactions#merchant-category-codes-mccs).
@@ -177,8 +205,10 @@ module Lithic
         # Amount of the transaction to be simulated in currency specified in
         # merchant_currency, including any acquirer fees.
         merchant_amount: nil,
-        # 3-character alphabetic ISO 4217 currency code. Note: Simulator only accepts USD,
-        # GBP, EUR and defaults to GBP if another ISO 4217 code is provided
+        # 3-character alphabetic ISO 4217 currency code for the merchant amount. Only used
+        # when merchant_amount is set, and defaults to GBP in that case. Without
+        # merchant_amount, the merchant amount uses the billing currency. Permitted values
+        # are USD, GBP, EUR and CAD, and any other ISO 4217 code returns a 422
         merchant_currency: nil,
         # Set to true if the terminal is capable of partial approval otherwise false.
         # Partial approval is when part of a transaction is approved and another payment
@@ -186,6 +216,12 @@ module Lithic
         partial_approval_capable: nil,
         # Simulate entering a PIN. If omitted, PIN check will not be performed.
         pin: nil,
+        # 3-character alphabetic ISO 4217 currency code for the settlement amount.
+        # Permitted values are USD, GBP, EUR and CAD, and any other ISO 4217 code returns
+        # a 422. Defaults to the value of billing_currency. Only single message
+        # (financial) authorizations carry a settlement amount, and the value is ignored
+        # for dual message authorizations
+        settlement_currency: nil,
         # Type of event to simulate.
         #
         # - `AUTHORIZATION` is a dual message purchase authorization, meaning a subsequent
@@ -213,6 +249,7 @@ module Lithic
             amount: Integer,
             descriptor: String,
             pan: String,
+            billing_currency: String,
             mcc: String,
             merchant_acceptor_city: String,
             merchant_acceptor_country: String,
@@ -222,6 +259,7 @@ module Lithic
             merchant_currency: String,
             partial_approval_capable: T::Boolean,
             pin: String,
+            settlement_currency: String,
             status:
               Lithic::TransactionSimulateAuthorizationParams::Status::OrSymbol,
             request_options: Lithic::RequestOptions

data/rbi/lithic/models/transaction_simulate_credit_authorization_advice_params.rbi

@@ -28,6 +28,15 @@ module Lithic
       sig { returns(String) }
       attr_accessor :pan
 
+      # 3-character alphabetic ISO 4217 currency code for the cardholder billing amount.
+      # Permitted values are USD, GBP, EUR and CAD, and any other ISO 4217 code returns
+      # a 422. Defaults to USD
+      sig { returns(T.nilable(String)) }
+      attr_reader :billing_currency
+
+      sig { params(billing_currency: String).void }
+      attr_writer :billing_currency
+
       # Merchant category code for the transaction to be simulated. A four-digit number
       # listed in ISO 18245. Supported merchant category codes can be found
       # [here](https://docs.lithic.com/docs/transactions#merchant-category-codes-mccs).
@@ -70,6 +79,7 @@ module Lithic
           amount: Integer,
           descriptor: String,
           pan: String,
+          billing_currency: String,
           mcc: String,
           merchant_acceptor_city: String,
           merchant_acceptor_country: String,
@@ -87,6 +97,10 @@ module Lithic
         descriptor:,
         # Sixteen digit card number.
         pan:,
+        # 3-character alphabetic ISO 4217 currency code for the cardholder billing amount.
+        # Permitted values are USD, GBP, EUR and CAD, and any other ISO 4217 code returns
+        # a 422. Defaults to USD
+        billing_currency: nil,
         # Merchant category code for the transaction to be simulated. A four-digit number
         # listed in ISO 18245. Supported merchant category codes can be found
         # [here](https://docs.lithic.com/docs/transactions#merchant-category-codes-mccs).
@@ -109,6 +123,7 @@ module Lithic
             amount: Integer,
             descriptor: String,
             pan: String,
+            billing_currency: String,
             mcc: String,
             merchant_acceptor_city: String,
             merchant_acceptor_country: String,

data/rbi/lithic/models/transaction_simulate_return_params.rbi

@@ -26,11 +26,31 @@ module Lithic
       sig { returns(String) }
       attr_accessor :pan
 
+      # 3-character alphabetic ISO 4217 currency code for the cardholder billing amount.
+      # Permitted values are USD, GBP, EUR and CAD, and any other ISO 4217 code returns
+      # a 422. Defaults to USD
+      sig { returns(T.nilable(String)) }
+      attr_reader :billing_currency
+
+      sig { params(billing_currency: String).void }
+      attr_writer :billing_currency
+
+      # 3-character alphabetic ISO 4217 currency code for the settlement amount.
+      # Permitted values are USD, GBP, EUR and CAD, and any other ISO 4217 code returns
+      # a 422. Defaults to the value of billing_currency
+      sig { returns(T.nilable(String)) }
+      attr_reader :settlement_currency
+
+      sig { params(settlement_currency: String).void }
+      attr_writer :settlement_currency
+
       sig do
         params(
           amount: Integer,
           descriptor: String,
           pan: String,
+          billing_currency: String,
+          settlement_currency: String,
           request_options: Lithic::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
@@ -41,6 +61,14 @@ module Lithic
         descriptor:,
         # Sixteen digit card number.
         pan:,
+        # 3-character alphabetic ISO 4217 currency code for the cardholder billing amount.
+        # Permitted values are USD, GBP, EUR and CAD, and any other ISO 4217 code returns
+        # a 422. Defaults to USD
+        billing_currency: nil,
+        # 3-character alphabetic ISO 4217 currency code for the settlement amount.
+        # Permitted values are USD, GBP, EUR and CAD, and any other ISO 4217 code returns
+        # a 422. Defaults to the value of billing_currency
+        settlement_currency: nil,
         request_options: {}
       )
       end
@@ -51,6 +79,8 @@ module Lithic
             amount: Integer,
             descriptor: String,
             pan: String,
+            billing_currency: String,
+            settlement_currency: String,
             request_options: Lithic::RequestOptions
           }
         )

data/rbi/lithic/models.rbi

@@ -92,6 +92,9 @@ module Lithic
   BlockchainRecipientCreateParams =
     Lithic::Models::BlockchainRecipientCreateParams
 
+  BlockchainRecipientRetrieveParams =
+    Lithic::Models::BlockchainRecipientRetrieveParams
+
   BookTransferCreateParams = Lithic::Models::BookTransferCreateParams
 
   BookTransferListParams = Lithic::Models::BookTransferListParams
@@ -150,6 +153,8 @@ module Lithic
 
   CardListParams = Lithic::Models::CardListParams
 
+  CardPinUpdatedWebhookEvent = Lithic::Models::CardPinUpdatedWebhookEvent
+
   CardProgram = Lithic::Models::CardProgram
 
   CardProgramListParams = Lithic::Models::CardProgramListParams
@@ -493,6 +498,8 @@ module Lithic
 
   PaymentCreateParams = Lithic::Models::PaymentCreateParams
 
+  PaymentCreateStablecoinParams = Lithic::Models::PaymentCreateStablecoinParams
+
   PaymentListParams = Lithic::Models::PaymentListParams
 
   PaymentRetrieveParams = Lithic::Models::PaymentRetrieveParams