lithic 0.19.0 → 0.21.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 106bded7bf43dfa21ef3e2508bf03ef3342f794cabd4633237802f10825127cb
-  data.tar.gz: c3a1a41578d0042e4dd4ec936ffb1b74ee90fb62514056f5d58842b59009aea3
+  metadata.gz: 9e9f6ed3184bfb671fac6deab7e1e5a01108b92a3f4adc97e15bd4539c5d69d1
+  data.tar.gz: d9f0cd5fa590316ed27b0de33185eff8342f2fa4e885720f6648d4f871d8ef5b
 SHA512:
-  metadata.gz: 6dedf816499b354a2f0673e059ef289773366a0fe1309c828be58580345adbc42afd336d71084979387c6a8f86194fba773d385c5734eb85db4ee0d075b783da
-  data.tar.gz: 32f2ce22c41fe321a7b1ea99b7f2956ad07547c1e4c0dd806c31d833cea507e2cc2db1493b106e7576ec85e7b01ac33dc18d1adbb4b45003936ecdf8101d809f
+  metadata.gz: 9958c2f72d732e9b67960ffc80a089edf988feaaed6347d6946c4efa56aae6898d549507dfa3921b5399d2d099a0fa3bc204b8c4967a4ebf11b4e6494cdb56b1
+  data.tar.gz: ea002ba56ac10e779df7971feea5b3b6b752b3172feaf69e22abf4248df595b4574e17af419b6f690156b1c0f3663cf81b4a3f43da79eb24b3ef2de02eac4fc1

data/CHANGELOG.md

@@ -1,5 +1,66 @@
 # Changelog
 
+## 0.21.0 (2026-09-18)
+
+Full Changelog: [v0.20.0...v0.21.0](https://github.com/lithic-com/lithic-ruby/compare/v0.20.0...v0.21.0)
+
+### Features
+
+* [CARDS-5174] Add reiusse/renew 409 error ([2fc8f3b](https://github.com/lithic-com/lithic-ruby/commit/2fc8f3b93ff2e392d8eda8e343d21e423c214191))
+* [TRE-14464] Update /retry payments endpoint to accept method ([6031d67](https://github.com/lithic-com/lithic-ruby/commit/6031d6794afd8c3a4b121cf2f7368e0ac40867c0))
+* [TRE-14524] Add Open to buy API spec ([bdf043e](https://github.com/lithic-com/lithic-ruby/commit/bdf043e53ac45964c091134b25fb7a3023948397))
+* Add missing blockchain/stablecoin endpoints to the spec ([3e8c0dc](https://github.com/lithic-com/lithic-ruby/commit/3e8c0dcdaa7169ba0a47bea4493e71d778af8853))
+* **api:** add EXTERNAL_STABLECOIN category and events to payment resources ([518aebb](https://github.com/lithic-com/lithic-ruby/commit/518aebb0cf94cbc0b1ca1ef85a94a71c5bf1983e))
+* **api:** add FEE/FEE_REVERSAL to financial_event, statement_line_items, management_operation ([04690f1](https://github.com/lithic-com/lithic-ruby/commit/04690f1542cb3f213da8695507a371c4f0a5aed4))
+* **api:** add OTHER enum value to auth_rules type field ([1bb4cc8](https://github.com/lithic-com/lithic-ruby/commit/1bb4cc80ab6e025ebf0d6fcdd88c5b62cbb602a0))
+* **api:** add psd2_context field to three_ds_authentication ([19e526e](https://github.com/lithic-com/lithic-ruby/commit/19e526e916227881e91ac1dac42e75d86132451e))
+* **api:** add retrieve/list methods to financial_accounts installment_plans ([13b25f3](https://github.com/lithic-com/lithic-ruby/commit/13b25f3cef123eedc918ab5730aacb64114175fe))
+* **api:** add STABLECOIN_REVIEWED event type to payment simulate action ([766c658](https://github.com/lithic-com/lithic-ruby/commit/766c658645a79accfca85707ce6d5c087d93959e))
+* AUTH-3759: Add DECLINE_SCA_REQUIRED and SCA_REQUIRED enum entries ([e784b27](https://github.com/lithic-com/lithic-ruby/commit/e784b275c2690eb0d2ab4a36a3ee9f5af2f79b0b))
+* TRE-14349: add installment plan management operation event types ([bd71bde](https://github.com/lithic-com/lithic-ruby/commit/bd71bde5d20641e236b5b2e95908293bf0ef48e9))
+* TRE-14429: Document the stablecoin payments endpoint ([050c7bd](https://github.com/lithic-com/lithic-ruby/commit/050c7bdd679e3c090c6e1819c0aa3405e3cbfc0c))
+
+
+### Documentation
+
+* Document the card.pin_updated webhook ([b96e92e](https://github.com/lithic-com/lithic-ruby/commit/b96e92e36fa4ae4dab543d1cc639d807f810b967))
+
+## 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.21.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/account_activity_list_params.rb

@@ -123,6 +123,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/account_activity_list_response.rb

@@ -162,6 +162,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/account_activity_retrieve_transaction_response.rb

@@ -165,6 +165,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/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/auth_rule.rb

@@ -86,6 +86,8 @@ module Lithic
         #   - `TYPESCRIPT_CODE`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
         #     ACH_CREDIT_RECEIPT, ACH_DEBIT_RECEIPT, CARD_TRANSACTION_UPDATE, or
         #     ACH_PAYMENT_UPDATE event stream.
+        #   - `OTHER`: A rule whose type is not exposed through this API. Rules of this type
+        #     are read-only; `OTHER` cannot be used when creating a rule.
         #
         #   @return [Symbol, Lithic::Models::AuthRules::AuthRule::Type]
         required :type, enum: -> { Lithic::AuthRules::AuthRule::Type }
@@ -339,6 +341,8 @@ module Lithic
         # - `TYPESCRIPT_CODE`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
         #   ACH_CREDIT_RECEIPT, ACH_DEBIT_RECEIPT, CARD_TRANSACTION_UPDATE, or
         #   ACH_PAYMENT_UPDATE event stream.
+        # - `OTHER`: A rule whose type is not exposed through this API. Rules of this type
+        #   are read-only; `OTHER` cannot be used when creating a rule.
         #
         # @see Lithic::Models::AuthRules::AuthRule#type
         module Type
@@ -349,6 +353,7 @@ module Lithic
           MERCHANT_LOCK = :MERCHANT_LOCK
           CONDITIONAL_ACTION = :CONDITIONAL_ACTION
           TYPESCRIPT_CODE = :TYPESCRIPT_CODE
+          OTHER = :OTHER
 
           # @!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/report_stats.rb

@@ -166,6 +166,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/auth_rules/v2_create_params.rb

@@ -49,6 +49,8 @@ module Lithic
             #   - `TYPESCRIPT_CODE`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
             #     ACH_CREDIT_RECEIPT, ACH_DEBIT_RECEIPT, CARD_TRANSACTION_UPDATE, or
             #     ACH_PAYMENT_UPDATE event stream.
+            #   - `OTHER`: A rule whose type is not exposed through this API. Rules of this type
+            #     are read-only; `OTHER` cannot be used when creating a rule.
             #
             #   @return [Symbol, Lithic::Models::AuthRules::V2CreateParams::Body::AccountLevelRule::Type]
             required :type, enum: -> { Lithic::AuthRules::V2CreateParams::Body::AccountLevelRule::Type }
@@ -143,6 +145,8 @@ module Lithic
             # - `TYPESCRIPT_CODE`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
             #   ACH_CREDIT_RECEIPT, ACH_DEBIT_RECEIPT, CARD_TRANSACTION_UPDATE, or
             #   ACH_PAYMENT_UPDATE event stream.
+            # - `OTHER`: A rule whose type is not exposed through this API. Rules of this type
+            #   are read-only; `OTHER` cannot be used when creating a rule.
             #
             # @see Lithic::Models::AuthRules::V2CreateParams::Body::AccountLevelRule#type
             module Type
@@ -153,6 +157,7 @@ module Lithic
               MERCHANT_LOCK = :MERCHANT_LOCK
               CONDITIONAL_ACTION = :CONDITIONAL_ACTION
               TYPESCRIPT_CODE = :TYPESCRIPT_CODE
+              OTHER = :OTHER
 
               # @!method self.values
               #   @return [Array<Symbol>]
@@ -188,6 +193,8 @@ module Lithic
             #   - `TYPESCRIPT_CODE`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
             #     ACH_CREDIT_RECEIPT, ACH_DEBIT_RECEIPT, CARD_TRANSACTION_UPDATE, or
             #     ACH_PAYMENT_UPDATE event stream.
+            #   - `OTHER`: A rule whose type is not exposed through this API. Rules of this type
+            #     are read-only; `OTHER` cannot be used when creating a rule.
             #
             #   @return [Symbol, Lithic::Models::AuthRules::V2CreateParams::Body::CardLevelRule::Type]
             required :type, enum: -> { Lithic::AuthRules::V2CreateParams::Body::CardLevelRule::Type }
@@ -268,6 +275,8 @@ module Lithic
             # - `TYPESCRIPT_CODE`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
             #   ACH_CREDIT_RECEIPT, ACH_DEBIT_RECEIPT, CARD_TRANSACTION_UPDATE, or
             #   ACH_PAYMENT_UPDATE event stream.
+            # - `OTHER`: A rule whose type is not exposed through this API. Rules of this type
+            #   are read-only; `OTHER` cannot be used when creating a rule.
             #
             # @see Lithic::Models::AuthRules::V2CreateParams::Body::CardLevelRule#type
             module Type
@@ -278,6 +287,7 @@ module Lithic
               MERCHANT_LOCK = :MERCHANT_LOCK
               CONDITIONAL_ACTION = :CONDITIONAL_ACTION
               TYPESCRIPT_CODE = :TYPESCRIPT_CODE
+              OTHER = :OTHER
 
               # @!method self.values
               #   @return [Array<Symbol>]
@@ -313,6 +323,8 @@ module Lithic
             #   - `TYPESCRIPT_CODE`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
             #     ACH_CREDIT_RECEIPT, ACH_DEBIT_RECEIPT, CARD_TRANSACTION_UPDATE, or
             #     ACH_PAYMENT_UPDATE event stream.
+            #   - `OTHER`: A rule whose type is not exposed through this API. Rules of this type
+            #     are read-only; `OTHER` cannot be used when creating a rule.
             #
             #   @return [Symbol, Lithic::Models::AuthRules::V2CreateParams::Body::ProgramLevelRule::Type]
             required :type, enum: -> { Lithic::AuthRules::V2CreateParams::Body::ProgramLevelRule::Type }
@@ -417,6 +429,8 @@ module Lithic
             # - `TYPESCRIPT_CODE`: AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION,
             #   ACH_CREDIT_RECEIPT, ACH_DEBIT_RECEIPT, CARD_TRANSACTION_UPDATE, or
             #   ACH_PAYMENT_UPDATE event stream.
+            # - `OTHER`: A rule whose type is not exposed through this API. Rules of this type
+            #   are read-only; `OTHER` cannot be used when creating a rule.
             #
             # @see Lithic::Models::AuthRules::V2CreateParams::Body::ProgramLevelRule#type
             module Type
@@ -427,6 +441,7 @@ module Lithic
               MERCHANT_LOCK = :MERCHANT_LOCK
               CONDITIONAL_ACTION = :CONDITIONAL_ACTION
               TYPESCRIPT_CODE = :TYPESCRIPT_CODE
+              OTHER = :OTHER
 
               # @!method self.values
               #   @return [Array<Symbol>]

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

@@ -182,6 +182,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
@@ -1059,6 +1060,7 @@ module Lithic
 
                 CARD = :CARD
                 ACCOUNT = :ACCOUNT
+                PROGRAM = :PROGRAM
 
                 # @!method self.values
                 #   @return [Array<Symbol>]
@@ -1269,6 +1271,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/blockchain_recipient_retrieve_params.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Lithic
+  module Models
+    # @see Lithic::Resources::BlockchainRecipients#retrieve
+    class BlockchainRecipientRetrieveParams < Lithic::Internal::Type::BaseModel
+      extend Lithic::Internal::Type::RequestParameters::Converter
+      include Lithic::Internal::Type::RequestParameters
+
+      # @!attribute blockchain_recipient_token
+      #
+      #   @return [String]
+      required :blockchain_recipient_token, String
+
+      # @!method initialize(blockchain_recipient_token:, request_options: {})
+      #   @param blockchain_recipient_token [String]
+      #   @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