lithic 0.19.0 → 0.20.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 106bded7bf43dfa21ef3e2508bf03ef3342f794cabd4633237802f10825127cb
-  data.tar.gz: c3a1a41578d0042e4dd4ec936ffb1b74ee90fb62514056f5d58842b59009aea3
+  metadata.gz: 9a1dad385b89d74fc7b9228fc05beafec83f75a70f844981c069f5363224516c
+  data.tar.gz: ebf7bf2cb414e22297cec903a453e582a65ae88bcc9452a7151905d261504332
 SHA512:
-  metadata.gz: 6dedf816499b354a2f0673e059ef289773366a0fe1309c828be58580345adbc42afd336d71084979387c6a8f86194fba773d385c5734eb85db4ee0d075b783da
-  data.tar.gz: 32f2ce22c41fe321a7b1ea99b7f2956ad07547c1e4c0dd806c31d833cea507e2cc2db1493b106e7576ec85e7b01ac33dc18d1adbb4b45003936ecdf8101d809f
+  metadata.gz: e8c7901fb8cfcddae62cf0652149ce81862fb297ac35ee9e4494bdfee61a455feaa15821eeceaa13e41effba6ebfc3f87a6a10a9713d8110de617c5eff7252fe
+  data.tar.gz: 9e5d08fa9e5d110aab84ffe6e9afac0e093db30b2cdf41a582995669c342c94dffe7134d8cac89b96a975fa1ebe6f14d8e303e7f6a0bae8b6a393cb5ca5a3777

data/CHANGELOG.md

@@ -1,5 +1,41 @@
 # Changelog
 
+## 0.20.0 (2026-08-31)
+
+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 reassign_account method to cards ([2f6bdfa](https://github.com/lithic-com/lithic-ruby/commit/2f6bdfaf9f1c6c9128e765e10b495252ca9711ce))
+* **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))
+* **api:** add stablecoin_inbound/stablecoin_outbound to payment type enum ([087861b](https://github.com/lithic-com/lithic-ruby/commit/087861b820756e52b92ff69b5d7929109e27ba59))
+* Make blockchain recipient account_token nullable ([ce96330](https://github.com/lithic-com/lithic-ruby/commit/ce96330d08b6f3b9bbc4ee1011dcc7080f839a38))
+* Remove stablecoin transfer type ([41e80f8](https://github.com/lithic-com/lithic-ruby/commit/41e80f87c3b3a3167f97c4657acd71cf28bc3074))
+
+
+### Bug Fixes
+
+* **types:** rename event data variants, remove type discriminator in dispute_v2 ([aeedd0a](https://github.com/lithic-com/lithic-ruby/commit/aeedd0ab75d527323dc8a748af1ea86a95f52ac5))
+
+
+### Chores
+
+* **internal:** allow the mock server port to be set with STAINLESS_MOCK_PORT ([0fbeb86](https://github.com/lithic-com/lithic-ruby/commit/0fbeb86633809668c1bd304a40b2f23860b232be))
+
+
+### Documentation
+
+* **api:** update client_device_id and client_wallet_account_id descriptions in card provision ([e5cd94f](https://github.com/lithic-com/lithic-ruby/commit/e5cd94f58dbafc40ab1f2e25182b4b559d2ed258))
+* **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)

data/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 -->

data/lib/lithic/client.rb

@@ -83,6 +83,9 @@ module Lithic
     # @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 @@ module Lithic
       @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)

data/lib/lithic/models/auth_rules/ach_payment_update_action.rb

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

data/lib/lithic/models/auth_rules/card_transaction_update_action.rb

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

data/lib/lithic/models/auth_rules/v2_list_results_response.rb

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

data/lib/lithic/models/auth_rules/velocity_limit_params.rb

@@ -29,6 +29,25 @@ module Lithic
         #   @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 @@ module Lithic
         #   @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 @@ module Lithic
         #
         #   @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

data/lib/lithic/models/blockchain_recipient.rb

@@ -0,0 +1,148 @@
+# 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, or null when the
+      #   recipient is registered against the program rather than a financial account
+      #
+      #   @return [String, nil]
+      required :account_token, String, nil?: true
+
+      # @!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, nil] The financial account the blockchain recipient belongs to, or null when the reci
+      #
+      #   @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

data/lib/lithic/models/blockchain_recipient_create_params.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+module Lithic
+  module Models
+    # @see Lithic::Resources::BlockchainRecipients#create
+    class BlockchainRecipientCreateParams < Lithic::Internal::Type::BaseModel
+      extend Lithic::Internal::Type::RequestParameters::Converter
+      include Lithic::Internal::Type::RequestParameters
+
+      # @!attribute account_token
+      #   The financial account the blockchain recipient belongs to
+      #
+      #   @return [String]
+      required :account_token, String
+
+      # @!attribute address
+      #   The blockchain address funds will be withdrawn to
+      #
+      #   @return [String]
+      required :address, String
+
+      # @!attribute chain
+      #   The blockchain network that the address belongs to
+      #
+      #   @return [String]
+      required :chain, String
+
+      # @!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 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]
+      optional :address_tag, String
+
+      # @!attribute name
+      #   The nickname for this blockchain recipient
+      #
+      #   @return [String, nil]
+      optional :name, String
+
+      # @!method initialize(account_token:, address:, chain:, owner:, owner_type:, address_tag: nil, name: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Lithic::Models::BlockchainRecipientCreateParams} for more details.
+      #
+      #   @param account_token [String] The financial account the blockchain recipient belongs to
+      #
+      #   @param address [String] The blockchain address funds will be withdrawn to
+      #
+      #   @param chain [String] The blockchain network that the address belongs to
+      #
+      #   @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 address_tag [String] An optional tag or memo used by some chains to identify the destination of a tra
+      #
+      #   @param name [String] The nickname for this blockchain recipient
+      #
+      #   @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/lithic/models/card.rb

@@ -5,7 +5,7 @@ module Lithic
     # @see Lithic::Resources::Cards#create
     class Card < Lithic::Models::NonPCICard
       # @!attribute cvv
-      #   Three digit cvv printed on the back of the card.
+      #   Three or four digit CVV printed on the card. Amex cards use four digit CVVs
       #
       #   @return [String, nil]
       optional :cvv, String
@@ -24,7 +24,7 @@ module Lithic
       #
       #   Card details with potentially PCI sensitive information for Enterprise customers
       #
-      #   @param cvv [String] Three digit cvv printed on the back of the card.
+      #   @param cvv [String] Three or four digit CVV printed on the card. Amex cards use four digit CVVs
       #
       #   @param pan [String] Primary Account Number (PAN) (i.e. the card number). Customers must be PCI compl
     end

data/lib/lithic/models/card_provision_params.rb

@@ -22,17 +22,19 @@ module Lithic
       optional :certificate, String
 
       # @!attribute client_device_id
-      #   Only applicable if `digital_wallet` is `GOOGLE_PAY` or `SAMSUNG_PAY` and the
-      #   card is on the Visa network. Stable device identification set by the wallet
-      #   provider.
+      #   Only applicable if `digital_wallet` is `GOOGLE_PAY` or `SAMSUNG_PAY`. Stable
+      #   device identification set by the wallet provider. Required for both wallets
+      #   regardless of network, though the value is only used for cards on the Visa
+      #   network and is ignored on Amex and Mastercard.
       #
       #   @return [String, nil]
       optional :client_device_id, String
 
       # @!attribute client_wallet_account_id
-      #   Only applicable if `digital_wallet` is `GOOGLE_PAY` or `SAMSUNG_PAY` and the
-      #   card is on the Visa network. Consumer ID that identifies the wallet account
-      #   holder entity.
+      #   Only applicable if `digital_wallet` is `GOOGLE_PAY` or `SAMSUNG_PAY`. Consumer
+      #   ID that identifies the wallet account holder entity. Required for both wallets
+      #   regardless of network, though the value is only used for cards on the Visa
+      #   network and is ignored on Amex and Mastercard.
       #
       #   @return [String, nil]
       optional :client_wallet_account_id, String
@@ -67,9 +69,9 @@ module Lithic
       #
       #   @param certificate [String] Only applicable if `digital_wallet` is `APPLE_PAY`. Omit to receive only `activa
       #
-      #   @param client_device_id [String] Only applicable if `digital_wallet` is `GOOGLE_PAY` or `SAMSUNG_PAY` and the car
+      #   @param client_device_id [String] Only applicable if `digital_wallet` is `GOOGLE_PAY` or `SAMSUNG_PAY`. Stable dev
       #
-      #   @param client_wallet_account_id [String] Only applicable if `digital_wallet` is `GOOGLE_PAY` or `SAMSUNG_PAY` and the car
+      #   @param client_wallet_account_id [String] Only applicable if `digital_wallet` is `GOOGLE_PAY` or `SAMSUNG_PAY`. Consumer I
       #
       #   @param digital_wallet [Symbol, Lithic::Models::CardProvisionParams::DigitalWallet] Name of digital wallet provider.
       #

data/lib/lithic/models/card_reassign_account_params.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Lithic
+  module Models
+    # @see Lithic::Resources::Cards#reassign_account
+    class CardReassignAccountParams < Lithic::Internal::Type::BaseModel
+      extend Lithic::Internal::Type::RequestParameters::Converter
+      include Lithic::Internal::Type::RequestParameters
+
+      # @!attribute card_token
+      #
+      #   @return [String]
+      required :card_token, String
+
+      # @!attribute new_account_token
+      #   Globally unique identifier for the account to associate with the card
+      #
+      #   @return [String]
+      required :new_account_token, String
+
+      # @!method initialize(card_token:, new_account_token:, request_options: {})
+      #   @param card_token [String]
+      #
+      #   @param new_account_token [String] Globally unique identifier for the account to associate with the card
+      #
+      #   @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end