release: 0.20.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.19.0"
+  ".": "0.20.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 214
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic/lithic-59c09c7355b21b663e001d2ee1086ebd0a70d9b5433823282bca296eedff9eb0.yml
-openapi_spec_hash: d9c3b932c810809abc6e973d662ad376
-config_hash: 337a99d8cc30006358b7bc2531401669
+configured_endpoints: 215
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic/lithic-113e179e6007c80abd835ff26bfdce4dd24beee5174678687431cb672ce06be8.yml
+openapi_spec_hash: 0f42308e15d062d48e3d4857c39ac749
+config_hash: f6d04d790aaddf639fc04b7f0092e7ec

CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 0.20.0 (2026-08-14)
+
+Full Changelog: [v0.19.0...v0.20.0](https://github.com/lithic-com/lithic-ruby/compare/v0.19.0...v0.20.0)
+
+### Features
+
+* **api:** add blockchain_addresses field to FinancialAccount model ([c46e82c](https://github.com/lithic-com/lithic-ruby/commit/c46e82cc5bf4560c31adc1ebd6e991b55a1c3f2d))
+* **api:** add blockchain_recipients resource ([437d522](https://github.com/lithic-com/lithic-ruby/commit/437d5226c1c6b1dfd8faaa70787e8b2ea533f14a))
+* **api:** add claim_token field/param and WRITE_OFF_REVERSED to disputes v2 ([d32fe12](https://github.com/lithic-com/lithic-ruby/commit/d32fe12d9edaa339a12b61333e542f24c67f3c2e))
+* **api:** add limit_cash_amount and limit_cash_count to velocity limit params ([4e4dfb7](https://github.com/lithic-com/lithic-ruby/commit/4e4dfb78069500939027ed67d445d63160cd9e1c))
+* **api:** add PROGRAM scope to auth rules, FINANCIAL_ACCOUNT/PROGRAM to case_entity ([1520693](https://github.com/lithic-com/lithic-ruby/commit/15206930f871b13afd3852083c6bf778a83e6eb9))
+* **api:** add STABLECOIN enum value to payment type ([5151e5d](https://github.com/lithic-com/lithic-ruby/commit/5151e5d6276054b59f41d32af07efae6badabcbb))
+* **api:** add stablecoin event types to payment/financial_event/statement_line_items ([2f1fbca](https://github.com/lithic-com/lithic-ruby/commit/2f1fbca332e111e3624d834a774db3f7d979f4a4))
+* **api:** add STABLECOIN method, make method_attributes nullable in Payment ([6ecbe70](https://github.com/lithic-com/lithic-ruby/commit/6ecbe702c2e3d1cd3e5623cecf46e4bc02fb3b41))
+* **api:** add stablecoin payment method type to payments ([80e026a](https://github.com/lithic-com/lithic-ruby/commit/80e026ae4b67579db63140dcaa70c44409b47b83))
+
+
+### Documentation
+
+* **api:** update cvv field documentation in Card and tokenization ([b520213](https://github.com/lithic-com/lithic-ruby/commit/b520213ceec3af853f96b5ca9e8ef32a34169a0a))
+
 ## 0.19.0 (2026-07-30)
 
 Full Changelog: [v0.18.1...v0.19.0](https://github.com/lithic-com/lithic-ruby/compare/v0.18.1...v0.19.0)

Gemfile.lock

@@ -11,7 +11,7 @@ GIT
 PATH
   remote: .
   specs:
-    lithic (0.19.0)
+    lithic (0.20.0)
       cgi
       connection_pool
 

README.md

@@ -24,7 +24,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "lithic", "~> 0.19.0"
+gem "lithic", "~> 0.20.0"
 ```
 
 <!-- x-release-please-end -->

lib/lithic.rb

@@ -167,6 +167,8 @@
 require_relative "lithic/models/balance"
 require_relative "lithic/models/balance_list_params"
 require_relative "lithic/models/balance_updated_webhook_event"
+require_relative "lithic/models/blockchain_recipient"
+require_relative "lithic/models/blockchain_recipient_create_params"
 require_relative "lithic/models/book_transfer_create_params"
 require_relative "lithic/models/book_transfer_list_params"
 require_relative "lithic/models/book_transfer_retrieve_params"
@@ -523,6 +525,7 @@
 require_relative "lithic/resources/auth_rules/v2/backtests"
 require_relative "lithic/resources/auth_stream_enrollment"
 require_relative "lithic/resources/balances"
+require_relative "lithic/resources/blockchain_recipients"
 require_relative "lithic/resources/book_transfers"
 require_relative "lithic/resources/card_authorizations"
 require_relative "lithic/resources/card_bulk_orders"

lib/lithic/client.rb

@@ -83,6 +83,9 @@ class Client < Lithic::Internal::Transport::BaseClient
     # @return [Lithic::Resources::ExternalBankAccounts]
     attr_reader :external_bank_accounts
 
+    # @return [Lithic::Resources::BlockchainRecipients]
+    attr_reader :blockchain_recipients
+
     # @return [Lithic::Resources::Payments]
     attr_reader :payments
 
@@ -240,6 +243,7 @@ def initialize(
       @transactions = Lithic::Resources::Transactions.new(client: self)
       @responder_endpoints = Lithic::Resources::ResponderEndpoints.new(client: self)
       @external_bank_accounts = Lithic::Resources::ExternalBankAccounts.new(client: self)
+      @blockchain_recipients = Lithic::Resources::BlockchainRecipients.new(client: self)
       @payments = Lithic::Resources::Payments.new(client: self)
       @three_ds = Lithic::Resources::ThreeDS.new(client: self)
       @reports = Lithic::Resources::Reports.new(client: self)

lib/lithic/models.rb

@@ -112,6 +112,10 @@ module Lithic
 
   BalanceUpdatedWebhookEvent = Lithic::Models::BalanceUpdatedWebhookEvent
 
+  BlockchainRecipient = Lithic::Models::BlockchainRecipient
+
+  BlockchainRecipientCreateParams = Lithic::Models::BlockchainRecipientCreateParams
+
   BookTransferCreateParams = Lithic::Models::BookTransferCreateParams
 
   BookTransferListParams = Lithic::Models::BookTransferListParams

lib/lithic/models/auth_rules/ach_payment_update_action.rb

@@ -82,6 +82,7 @@ module Scope
             extend Lithic::Internal::Type::Enum
 
             FINANCIAL_ACCOUNT = :FINANCIAL_ACCOUNT
+            PROGRAM = :PROGRAM
 
             # @!method self.values
             #   @return [Array<Symbol>]

lib/lithic/models/auth_rules/card_transaction_update_action.rb

@@ -83,6 +83,7 @@ module Scope
 
             CARD = :CARD
             ACCOUNT = :ACCOUNT
+            PROGRAM = :PROGRAM
 
             # @!method self.values
             #   @return [Array<Symbol>]

lib/lithic/models/auth_rules/v2_list_results_response.rb

@@ -1059,6 +1059,7 @@ module Scope
 
                 CARD = :CARD
                 ACCOUNT = :ACCOUNT
+                PROGRAM = :PROGRAM
 
                 # @!method self.values
                 #   @return [Array<Symbol>]
@@ -1269,6 +1270,7 @@ module Scope
                 extend Lithic::Internal::Type::Enum
 
                 FINANCIAL_ACCOUNT = :FINANCIAL_ACCOUNT
+                PROGRAM = :PROGRAM
 
                 # @!method self.values
                 #   @return [Array<Symbol>]

lib/lithic/models/auth_rules/velocity_limit_params.rb

@@ -29,6 +29,25 @@ class VelocityLimitParams < Lithic::Internal::Type::BaseModel
         #   @return [Integer, nil]
         optional :limit_amount, Integer, nil?: true
 
+        # @!attribute limit_cash_amount
+        #   The maximum amount of cash spend velocity allowed in the period in minor units
+        #   (the smallest unit of a currency, e.g. cents for USD). Cash spend covers ATM
+        #   withdrawals, cash disbursements, and purchases with cashback. Transactions
+        #   exceeding this limit will be declined.
+        #
+        #   @return [Integer, nil]
+        optional :limit_cash_amount, Integer, nil?: true
+
+        # @!attribute limit_cash_count
+        #   The number of cash spend velocity impacting transactions may not exceed this
+        #   limit in the period. Transactions exceeding this limit will be declined. A cash
+        #   velocity impacting transaction is an ATM withdrawal, cash disbursement, or
+        #   purchase with cashback that has been authorized, and optionally settled, or a
+        #   force post (a transaction that settled without prior authorization).
+        #
+        #   @return [Integer, nil]
+        optional :limit_cash_count, Integer, nil?: true
+
         # @!attribute limit_count
         #   The number of spend velocity impacting transactions may not exceed this limit in
         #   the period. Transactions exceeding this limit will be declined. A spend velocity
@@ -39,7 +58,7 @@ class VelocityLimitParams < Lithic::Internal::Type::BaseModel
         #   @return [Integer, nil]
         optional :limit_count, Integer, nil?: true
 
-        # @!method initialize(period:, scope:, filters: nil, limit_amount: nil, limit_count: nil)
+        # @!method initialize(period:, scope:, filters: nil, limit_amount: nil, limit_cash_amount: nil, limit_cash_count: nil, limit_count: nil)
         #   Some parameter documentations has been truncated, see
         #   {Lithic::Models::AuthRules::VelocityLimitParams} for more details.
         #
@@ -51,6 +70,10 @@ class VelocityLimitParams < Lithic::Internal::Type::BaseModel
         #
         #   @param limit_amount [Integer, nil] The maximum amount of spend velocity allowed in the period in minor units (the s
         #
+        #   @param limit_cash_amount [Integer, nil] The maximum amount of cash spend velocity allowed in the period in minor units (
+        #
+        #   @param limit_cash_count [Integer, nil] The number of cash spend velocity impacting transactions may not exceed this lim
+        #
         #   @param limit_count [Integer, nil] The number of spend velocity impacting transactions may not exceed this limit in
 
         # The scope the velocity is calculated for

lib/lithic/models/blockchain_recipient.rb

@@ -0,0 +1,147 @@
+# frozen_string_literal: true
+
+module Lithic
+  module Models
+    # @see Lithic::Resources::BlockchainRecipients#create
+    class BlockchainRecipient < Lithic::Internal::Type::BaseModel
+      # @!attribute token
+      #   A globally unique identifier for this blockchain recipient
+      #
+      #   @return [String]
+      required :token, String
+
+      # @!attribute account_token
+      #   The financial account the blockchain recipient belongs to
+      #
+      #   @return [String]
+      required :account_token, String
+
+      # @!attribute address_tag
+      #   An optional tag or memo used by some chains to identify the destination of a
+      #   transfer within a shared address
+      #
+      #   @return [String, nil]
+      required :address_tag, String, nil?: true
+
+      # @!attribute chain
+      #   The blockchain network that the address belongs to
+      #
+      #   @return [String]
+      required :chain, String
+
+      # @!attribute created
+      #   An ISO 8601 string representing when this blockchain recipient was created
+      #
+      #   @return [Time]
+      required :created, Time
+
+      # @!attribute external_id
+      #   The identifier the recipient is registered under with the payment provider
+      #
+      #   @return [String, nil]
+      required :external_id, String, nil?: true
+
+      # @!attribute name
+      #   The nickname for this blockchain recipient
+      #
+      #   @return [String, nil]
+      required :name, String, nil?: true
+
+      # @!attribute owner
+      #   Legal name of the business or individual who owns the blockchain address
+      #
+      #   @return [String]
+      required :owner, String
+
+      # @!attribute owner_type
+      #   Owner Type
+      #
+      #   @return [Symbol, Lithic::Models::OwnerType]
+      required :owner_type, enum: -> { Lithic::OwnerType }
+
+      # @!attribute program_id
+      #   Globally unique identifier for the program the blockchain recipient is
+      #   associated with
+      #
+      #   @return [String]
+      required :program_id, String
+
+      # @!attribute state
+      #   Account State
+      #
+      #   @return [Symbol, Lithic::Models::BlockchainRecipient::State]
+      required :state, enum: -> { Lithic::BlockchainRecipient::State }
+
+      # @!attribute updated
+      #   An ISO 8601 string representing when this blockchain recipient was last updated
+      #
+      #   @return [Time]
+      required :updated, Time
+
+      # @!attribute verification_state
+      #   Verification State
+      #
+      #   @return [Symbol, Lithic::Models::BlockchainRecipient::VerificationState]
+      required :verification_state, enum: -> { Lithic::BlockchainRecipient::VerificationState }
+
+      # @!method initialize(token:, account_token:, address_tag:, chain:, created:, external_id:, name:, owner:, owner_type:, program_id:, state:, updated:, verification_state:)
+      #   Some parameter documentations has been truncated, see
+      #   {Lithic::Models::BlockchainRecipient} for more details.
+      #
+      #   @param token [String] A globally unique identifier for this blockchain recipient
+      #
+      #   @param account_token [String] The financial account the blockchain recipient belongs to
+      #
+      #   @param address_tag [String, nil] An optional tag or memo used by some chains to identify the destination of a tra
+      #
+      #   @param chain [String] The blockchain network that the address belongs to
+      #
+      #   @param created [Time] An ISO 8601 string representing when this blockchain recipient was created
+      #
+      #   @param external_id [String, nil] The identifier the recipient is registered under with the payment provider
+      #
+      #   @param name [String, nil] The nickname for this blockchain recipient
+      #
+      #   @param owner [String] Legal name of the business or individual who owns the blockchain address
+      #
+      #   @param owner_type [Symbol, Lithic::Models::OwnerType] Owner Type
+      #
+      #   @param program_id [String] Globally unique identifier for the program the blockchain recipient is associate
+      #
+      #   @param state [Symbol, Lithic::Models::BlockchainRecipient::State] Account State
+      #
+      #   @param updated [Time] An ISO 8601 string representing when this blockchain recipient was last updated
+      #
+      #   @param verification_state [Symbol, Lithic::Models::BlockchainRecipient::VerificationState] Verification State
+
+      # Account State
+      #
+      # @see Lithic::Models::BlockchainRecipient#state
+      module State
+        extend Lithic::Internal::Type::Enum
+
+        ENABLED = :ENABLED
+        CLOSED = :CLOSED
+        PAUSED = :PAUSED
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # Verification State
+      #
+      # @see Lithic::Models::BlockchainRecipient#verification_state
+      module VerificationState
+        extend Lithic::Internal::Type::Enum
+
+        PENDING = :PENDING
+        ENABLED = :ENABLED
+        FAILED_VERIFICATION = :FAILED_VERIFICATION
+        INSUFFICIENT_FUNDS = :INSUFFICIENT_FUNDS
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end