lithic-com · stainless-app · Sep 18, 2026 · Sep 1, 2026 · Sep 3, 2026 · Sep 10, 2026
diff --git a/.release-please-manifest.json b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.20.0"
+  ".": "0.21.0"
 }
diff --git a/.stats.yml b/.stats.yml
@@ -1,4 +1,4 @@
-configured_endpoints: 216
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic/lithic-38a020a15ab14f79c7fea3290822406cf80a9d43d46ab3295632a9723f5e42cd.yml
-openapi_spec_hash: 5a7357a17c5119bc91d8f5e42297fac3
-config_hash: 27fa50e251754c8982e3dc615ef6da41
+configured_endpoints: 221
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic/lithic-61a059277e4c1eb58cc145be1639732d3d0d79d969742baff98690faf96dc164.yml
+openapi_spec_hash: cc69f6bb4c6d98be95100774de6aff3e
+config_hash: f21cef3cf163623883f344efe9032e4f
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,30 @@
 # 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)

diff --git a/Gemfile.lock b/Gemfile.lock
@@ -11,7 +11,7 @@ GIT
 PATH
   remote: .
   specs:
-    lithic (0.20.0)
+    lithic (0.21.0)
       cgi
       connection_pool
 

diff --git a/README.md b/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.20.0"
+gem "lithic", "~> 0.21.0"
 ```
 
 <!-- x-release-please-end -->

diff --git a/lib/lithic.rb b/lib/lithic.rb
@@ -169,6 +169,7 @@
 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/blockchain_recipient_retrieve_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"
@@ -194,6 +195,7 @@
 require_relative "lithic/models/card_embed_response"
 require_relative "lithic/models/cardholder_authentication"
 require_relative "lithic/models/card_list_params"
+require_relative "lithic/models/card_pin_updated_webhook_event"
 require_relative "lithic/models/card_program"
 require_relative "lithic/models/card_program_list_params"
 require_relative "lithic/models/card_program_retrieve_params"
@@ -322,9 +324,13 @@
 require_relative "lithic/models/financial_accounts/credit_configuration_update_params"
 require_relative "lithic/models/financial_accounts/financial_account_credit_config"
 require_relative "lithic/models/financial_accounts/loan_tape_configuration"
+require_relative "lithic/models/financial_accounts/open_to_buy"
 require_relative "lithic/models/financial_accounts/statements"
 require_relative "lithic/models/financial_accounts/financial_transaction_list_params"
 require_relative "lithic/models/financial_accounts/financial_transaction_retrieve_params"
+require_relative "lithic/models/financial_accounts/installment_plan"
+require_relative "lithic/models/financial_accounts/installment_plan_list_params"
+require_relative "lithic/models/financial_accounts/installment_plan_retrieve_params"
 require_relative "lithic/models/financial_accounts/interest_tier_schedule_create_params"
 require_relative "lithic/models/financial_accounts/interest_tier_schedule_delete_params"
 require_relative "lithic/models/financial_accounts/interest_tier_schedule_list_params"
@@ -334,10 +340,13 @@
 require_relative "lithic/models/financial_accounts/loan_tape_list_params"
 require_relative "lithic/models/financial_accounts/loan_tape_rebuild_configuration"
 require_relative "lithic/models/financial_accounts/loan_tape_retrieve_params"
+require_relative "lithic/models/financial_accounts/open_to_buy_retrieve_params"
+require_relative "lithic/models/financial_accounts/open_to_buy_summary"
 require_relative "lithic/models/financial_accounts/statement_list_params"
 require_relative "lithic/models/financial_accounts/statement_retrieve_params"
 require_relative "lithic/models/financial_accounts/statements/line_item_list_params"
 require_relative "lithic/models/financial_accounts/statements/statement_line_items"
+require_relative "lithic/models/financial_accounts/transaction_category_balances"
 require_relative "lithic/models/financial_account_updated_webhook_event"
 require_relative "lithic/models/financial_account_update_params"
 require_relative "lithic/models/financial_account_update_status_params"
@@ -383,6 +392,8 @@
 require_relative "lithic/models/parsed_webhook_event"
 require_relative "lithic/models/payment_create_params"
 require_relative "lithic/models/payment_create_response"
+require_relative "lithic/models/payment_create_stablecoin_params"
+require_relative "lithic/models/payment_create_stablecoin_response"
 require_relative "lithic/models/payment_list_params"
 require_relative "lithic/models/payment_retrieve_params"
 require_relative "lithic/models/payment_retry_params"
@@ -550,9 +561,11 @@
 require_relative "lithic/resources/financial_accounts/balances"
 require_relative "lithic/resources/financial_accounts/credit_configuration"
 require_relative "lithic/resources/financial_accounts/financial_transactions"
+require_relative "lithic/resources/financial_accounts/installment_plans"
 require_relative "lithic/resources/financial_accounts/interest_tier_schedule"
 require_relative "lithic/resources/financial_accounts/loan_tape_configuration"
 require_relative "lithic/resources/financial_accounts/loan_tapes"
+require_relative "lithic/resources/financial_accounts/open_to_buy"
 require_relative "lithic/resources/financial_accounts/statements"
 require_relative "lithic/resources/financial_accounts/statements/line_items"
 require_relative "lithic/resources/fraud"

diff --git a/lib/lithic/models.rb b/lib/lithic/models.rb
@@ -116,6 +116,8 @@ module Lithic
 
   BlockchainRecipientCreateParams = Lithic::Models::BlockchainRecipientCreateParams
 
+  BlockchainRecipientRetrieveParams = Lithic::Models::BlockchainRecipientRetrieveParams
+
   BookTransferCreateParams = Lithic::Models::BookTransferCreateParams
 
   BookTransferListParams = Lithic::Models::BookTransferListParams
@@ -170,6 +172,8 @@ module Lithic
 
   CardListParams = Lithic::Models::CardListParams
 
+  CardPinUpdatedWebhookEvent = Lithic::Models::CardPinUpdatedWebhookEvent
+
   CardProgram = Lithic::Models::CardProgram
 
   CardProgramListParams = Lithic::Models::CardProgramListParams
@@ -475,6 +479,8 @@ module Lithic
 
   PaymentCreateParams = Lithic::Models::PaymentCreateParams
 
+  PaymentCreateStablecoinParams = Lithic::Models::PaymentCreateStablecoinParams
+
   PaymentListParams = Lithic::Models::PaymentListParams
 
   PaymentRetrieveParams = Lithic::Models::PaymentRetrieveParams

diff --git a/lib/lithic/models/account_activity_list_params.rb b/lib/lithic/models/account_activity_list_params.rb
@@ -123,6 +123,7 @@ module Category
         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

diff --git a/lib/lithic/models/account_activity_list_response.rb b/lib/lithic/models/account_activity_list_response.rb
@@ -162,6 +162,7 @@ module Category
           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

diff --git a/lib/lithic/models/account_activity_retrieve_transaction_response.rb b/lib/lithic/models/account_activity_retrieve_transaction_response.rb
@@ -165,6 +165,7 @@ module Category
           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

diff --git a/lib/lithic/models/auth_rules/auth_rule.rb b/lib/lithic/models/auth_rules/auth_rule.rb
@@ -86,6 +86,8 @@ class AuthRule < Lithic::Internal::Type::BaseModel
         #   - `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 State
         # - `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 Type
           MERCHANT_LOCK = :MERCHANT_LOCK
           CONDITIONAL_ACTION = :CONDITIONAL_ACTION
           TYPESCRIPT_CODE = :TYPESCRIPT_CODE
+          OTHER = :OTHER
 
           # @!method self.values
           #   @return [Array<Symbol>]

diff --git a/lib/lithic/models/auth_rules/report_stats.rb b/lib/lithic/models/auth_rules/report_stats.rb
@@ -166,6 +166,7 @@ module Code
                 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

diff --git a/lib/lithic/models/auth_rules/v2_create_params.rb b/lib/lithic/models/auth_rules/v2_create_params.rb
@@ -49,6 +49,8 @@ class AccountLevelRule < Lithic::Internal::Type::BaseModel
             #   - `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 Parameters
             # - `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 Type
               MERCHANT_LOCK = :MERCHANT_LOCK
               CONDITIONAL_ACTION = :CONDITIONAL_ACTION
               TYPESCRIPT_CODE = :TYPESCRIPT_CODE
+              OTHER = :OTHER
 
               # @!method self.values
               #   @return [Array<Symbol>]
@@ -188,6 +193,8 @@ class CardLevelRule < Lithic::Internal::Type::BaseModel
             #   - `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 Parameters
             # - `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 Type
               MERCHANT_LOCK = :MERCHANT_LOCK
               CONDITIONAL_ACTION = :CONDITIONAL_ACTION
               TYPESCRIPT_CODE = :TYPESCRIPT_CODE
+              OTHER = :OTHER
 
               # @!method self.values
               #   @return [Array<Symbol>]
@@ -313,6 +323,8 @@ class ProgramLevelRule < Lithic::Internal::Type::BaseModel
             #   - `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 Parameters
             # - `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 Type
               MERCHANT_LOCK = :MERCHANT_LOCK
               CONDITIONAL_ACTION = :CONDITIONAL_ACTION
               TYPESCRIPT_CODE = :TYPESCRIPT_CODE
+              OTHER = :OTHER
 
               # @!method self.values
               #   @return [Array<Symbol>]

diff --git a/lib/lithic/models/auth_rules/v2_list_results_response.rb b/lib/lithic/models/auth_rules/v2_list_results_response.rb
@@ -182,6 +182,7 @@ module Code
                 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

diff --git a/lib/lithic/models/blockchain_recipient_retrieve_params.rb b/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