release: 0.19.0

.github/workflows/ci.yml

@@ -21,7 +21,7 @@ jobs:
     permissions:
       contents: read
       id-token: write
-    runs-on: ${{ github.repository == 'stainless-sdks/lithic-ruby' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
+    runs-on: ${{ startsWith(github.repository, 'stainless-sdks/') && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     if: |-
       github.repository == 'stainless-sdks/lithic-ruby' &&
       (github.event_name == 'push' || github.event.pull_request.head.repo.fork) && (github.event_name != 'push' || github.event.head_commit.message != 'codegen metadata')
@@ -56,7 +56,7 @@ jobs:
   lint:
     timeout-minutes: 10
     name: lint
-    runs-on: ${{ github.repository == 'stainless-sdks/lithic-ruby' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
+    runs-on: ${{ startsWith(github.repository, 'stainless-sdks/') && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
 
     steps:
@@ -73,7 +73,7 @@ jobs:
   test:
     timeout-minutes: 10
     name: test
-    runs-on: ${{ github.repository == 'stainless-sdks/lithic-ruby' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
+    runs-on: ${{ startsWith(github.repository, 'stainless-sdks/') && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2

.release-please-manifest.json

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

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 214
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic/lithic-9e397c65ffb81e2928b8ecf979769a79131ae6058b6fb373a5e930dc8a168732.yml
-openapi_spec_hash: 93aea3855d2d1c390107d223762aa818
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic/lithic-09b6d1b85c657173562e9a372adc74551f07d476122003078e9168467329f792.yml
+openapi_spec_hash: a2b3a526310ceccd4ccb59ec428d246f
 config_hash: 5bb913c05ebeb301ec925b16e75bb251

CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.19.0 (2026-07-17)
+
+Full Changelog: [v0.18.1...v0.19.0](https://github.com/lithic-com/lithic-ruby/compare/v0.18.1...v0.19.0)
+
+### Features
+
+* **api:** add PAYMENT type to book transfers ([979bd5d](https://github.com/lithic-com/lithic-ruby/commit/979bd5d73e39028767418a470e10fc39cfb9686f))
+* **stlc:** configurable CI runner and private-production-repo support in workflow templates ([69b6ead](https://github.com/lithic-com/lithic-ruby/commit/69b6ead528e48ca397c5b14bcfd5868d6819aaca))
+
+
+### Documentation
+
+* **api:** clarify simulate_clearing supports multiple calls in transactions ([7a7e783](https://github.com/lithic-com/lithic-ruby/commit/7a7e78338a405f4edb463df0de5f64cf157c0334))
+* **api:** expand dispute event descriptions across Event and subscription models ([4db3479](https://github.com/lithic-com/lithic-ruby/commit/4db3479aaf148f8f3ea7e16ea89eb3c275fe963e))
+* **api:** update category parameter description in external_payments ([db7d72a](https://github.com/lithic-com/lithic-ruby/commit/db7d72a41aaee552817197d85b7989d85f6399c3))
+
 ## 0.18.1 (2026-06-29)
 
 Full Changelog: [v0.18.0...v0.18.1](https://github.com/lithic-com/lithic-ruby/compare/v0.18.0...v0.18.1)

Gemfile.lock

@@ -11,7 +11,7 @@ GIT
 PATH
   remote: .
   specs:
-    lithic (0.18.1)
+    lithic (0.19.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.18.1"
+gem "lithic", "~> 0.19.0"
 ```
 
 <!-- x-release-please-end -->

lib/lithic/models/book_transfer_create_params.rb

@@ -145,6 +145,7 @@ module Type
         INTEREST = :INTEREST
         LATE_PAYMENT = :LATE_PAYMENT
         BILL_PAYMENT = :BILL_PAYMENT
+        PAYMENT_FEE = :PAYMENT_FEE
         CASH_BACK = :CASH_BACK
         ACCOUNT_TO_ACCOUNT = :ACCOUNT_TO_ACCOUNT
         CARD_TO_CARD = :CARD_TO_CARD

lib/lithic/models/book_transfer_response.rb

@@ -285,6 +285,7 @@ module Type
           INTEREST = :INTEREST
           LATE_PAYMENT = :LATE_PAYMENT
           BILL_PAYMENT = :BILL_PAYMENT
+          PAYMENT_FEE = :PAYMENT_FEE
           CASH_BACK = :CASH_BACK
           ACCOUNT_TO_ACCOUNT = :ACCOUNT_TO_ACCOUNT
           CARD_TO_CARD = :CARD_TO_CARD

lib/lithic/models/event.rb

@@ -22,7 +22,7 @@ class Event < Lithic::Internal::Type::BaseModel
       #   The type of event that occurred. Possible values:
       #
       #   - account_holder_document.updated: Occurs when an account holder's document
-      #     upload status has been updated
+      #     upload status has been updated.
       #   - account_holder.created: Occurs when a new account_holder is created.
       #   - account_holder.updated: Occurs when an account_holder is updated.
       #   - account_holder.verification: Occurs when an asynchronous account_holder's
@@ -86,10 +86,21 @@ class Event < Lithic::Internal::Type::BaseModel
       #   This event will be deprecated in the future. We recommend using
       #   `tokenization.updated` instead.
       #
-      #   - dispute_evidence.upload_failed: Occurs when a dispute evidence upload fails.
+      #   - dispute_evidence.upload_failed: Occurs when an evidence upload fails for a
+      #     dispute filed through the Chargebacks API (`/v1/disputes`).
+      #
+      #   This event is not emitted for Managed Disputes.
+      #
       #   - dispute_transaction.created: Occurs when a new dispute transaction is created
-      #   - dispute_transaction.updated: Occurs when a dispute transaction is updated
-      #   - dispute.updated: Occurs when a dispute is updated.
+      #     for a Managed Disputes case.
+      #   - dispute_transaction.updated: Occurs when a dispute transaction for a Managed
+      #     Disputes case is updated.
+      #   - dispute.updated: Occurs when a dispute filed through the Chargebacks API
+      #     (`/v1/disputes`) is created or updated.
+      #
+      #   This event is not emitted for Managed Disputes. Use
+      #   `dispute_transaction.created` and `dispute_transaction.updated` instead.
+      #
       #   - external_bank_account.created: Occurs when an external bank account is
       #     created.
       #   - external_bank_account.updated: Occurs when an external bank account is
@@ -111,7 +122,7 @@ class Event < Lithic::Internal::Type::BaseModel
       #   - payment_transaction.updated: Occurs when a payment transaction is updated.
       #   - settlement_report.updated: Occurs when a settlement report is created or
       #     updated.
-      #   - statements.created: Occurs when a statement has been created
+      #   - statements.created: Occurs when a statement has been created.
       #   - three_ds_authentication.challenge: The `three_ds_authentication.challenge`
       #     event. Upon receiving this request, the Card Program should issue its own
       #     challenge to the cardholder. After a cardholder challenge is successfully
@@ -158,7 +169,7 @@ class Event < Lithic::Internal::Type::BaseModel
       # The type of event that occurred. Possible values:
       #
       # - account_holder_document.updated: Occurs when an account holder's document
-      #   upload status has been updated
+      #   upload status has been updated.
       # - account_holder.created: Occurs when a new account_holder is created.
       # - account_holder.updated: Occurs when an account_holder is updated.
       # - account_holder.verification: Occurs when an asynchronous account_holder's
@@ -222,10 +233,21 @@ class Event < Lithic::Internal::Type::BaseModel
       # This event will be deprecated in the future. We recommend using
       # `tokenization.updated` instead.
       #
-      # - dispute_evidence.upload_failed: Occurs when a dispute evidence upload fails.
+      # - dispute_evidence.upload_failed: Occurs when an evidence upload fails for a
+      #   dispute filed through the Chargebacks API (`/v1/disputes`).
+      #
+      # This event is not emitted for Managed Disputes.
+      #
       # - dispute_transaction.created: Occurs when a new dispute transaction is created
-      # - dispute_transaction.updated: Occurs when a dispute transaction is updated
-      # - dispute.updated: Occurs when a dispute is updated.
+      #   for a Managed Disputes case.
+      # - dispute_transaction.updated: Occurs when a dispute transaction for a Managed
+      #   Disputes case is updated.
+      # - dispute.updated: Occurs when a dispute filed through the Chargebacks API
+      #   (`/v1/disputes`) is created or updated.
+      #
+      # This event is not emitted for Managed Disputes. Use
+      # `dispute_transaction.created` and `dispute_transaction.updated` instead.
+      #
       # - external_bank_account.created: Occurs when an external bank account is
       #   created.
       # - external_bank_account.updated: Occurs when an external bank account is
@@ -247,7 +269,7 @@ class Event < Lithic::Internal::Type::BaseModel
       # - payment_transaction.updated: Occurs when a payment transaction is updated.
       # - settlement_report.updated: Occurs when a settlement report is created or
       #   updated.
-      # - statements.created: Occurs when a statement has been created
+      # - statements.created: Occurs when a statement has been created.
       # - three_ds_authentication.challenge: The `three_ds_authentication.challenge`
       #   event. Upon receiving this request, the Card Program should issue its own
       #   challenge to the cardholder. After a cardholder challenge is successfully

lib/lithic/models/event_list_params.rb

@@ -76,7 +76,7 @@ class EventListParams < Lithic::Internal::Type::BaseModel
       # The type of event that occurred. Possible values:
       #
       # - account_holder_document.updated: Occurs when an account holder's document
-      #   upload status has been updated
+      #   upload status has been updated.
       # - account_holder.created: Occurs when a new account_holder is created.
       # - account_holder.updated: Occurs when an account_holder is updated.
       # - account_holder.verification: Occurs when an asynchronous account_holder's
@@ -140,10 +140,21 @@ class EventListParams < Lithic::Internal::Type::BaseModel
       # This event will be deprecated in the future. We recommend using
       # `tokenization.updated` instead.
       #
-      # - dispute_evidence.upload_failed: Occurs when a dispute evidence upload fails.
+      # - dispute_evidence.upload_failed: Occurs when an evidence upload fails for a
+      #   dispute filed through the Chargebacks API (`/v1/disputes`).
+      #
+      # This event is not emitted for Managed Disputes.
+      #
       # - dispute_transaction.created: Occurs when a new dispute transaction is created
-      # - dispute_transaction.updated: Occurs when a dispute transaction is updated
-      # - dispute.updated: Occurs when a dispute is updated.
+      #   for a Managed Disputes case.
+      # - dispute_transaction.updated: Occurs when a dispute transaction for a Managed
+      #   Disputes case is updated.
+      # - dispute.updated: Occurs when a dispute filed through the Chargebacks API
+      #   (`/v1/disputes`) is created or updated.
+      #
+      # This event is not emitted for Managed Disputes. Use
+      # `dispute_transaction.created` and `dispute_transaction.updated` instead.
+      #
       # - external_bank_account.created: Occurs when an external bank account is
       #   created.
       # - external_bank_account.updated: Occurs when an external bank account is
@@ -165,7 +176,7 @@ class EventListParams < Lithic::Internal::Type::BaseModel
       # - payment_transaction.updated: Occurs when a payment transaction is updated.
       # - settlement_report.updated: Occurs when a settlement report is created or
       #   updated.
-      # - statements.created: Occurs when a statement has been created
+      # - statements.created: Occurs when a statement has been created.
       # - three_ds_authentication.challenge: The `three_ds_authentication.challenge`
       #   event. Upon receiving this request, the Card Program should issue its own
       #   challenge to the cardholder. After a cardholder challenge is successfully

lib/lithic/models/event_subscription.rb

@@ -49,7 +49,7 @@ class EventSubscription < Lithic::Internal::Type::BaseModel
       # The type of event that occurred. Possible values:
       #
       # - account_holder_document.updated: Occurs when an account holder's document
-      #   upload status has been updated
+      #   upload status has been updated.
       # - account_holder.created: Occurs when a new account_holder is created.
       # - account_holder.updated: Occurs when an account_holder is updated.
       # - account_holder.verification: Occurs when an asynchronous account_holder's
@@ -113,10 +113,21 @@ class EventSubscription < Lithic::Internal::Type::BaseModel
       # This event will be deprecated in the future. We recommend using
       # `tokenization.updated` instead.
       #
-      # - dispute_evidence.upload_failed: Occurs when a dispute evidence upload fails.
+      # - dispute_evidence.upload_failed: Occurs when an evidence upload fails for a
+      #   dispute filed through the Chargebacks API (`/v1/disputes`).
+      #
+      # This event is not emitted for Managed Disputes.
+      #
       # - dispute_transaction.created: Occurs when a new dispute transaction is created
-      # - dispute_transaction.updated: Occurs when a dispute transaction is updated
-      # - dispute.updated: Occurs when a dispute is updated.
+      #   for a Managed Disputes case.
+      # - dispute_transaction.updated: Occurs when a dispute transaction for a Managed
+      #   Disputes case is updated.
+      # - dispute.updated: Occurs when a dispute filed through the Chargebacks API
+      #   (`/v1/disputes`) is created or updated.
+      #
+      # This event is not emitted for Managed Disputes. Use
+      # `dispute_transaction.created` and `dispute_transaction.updated` instead.
+      #
       # - external_bank_account.created: Occurs when an external bank account is
       #   created.
       # - external_bank_account.updated: Occurs when an external bank account is
@@ -138,7 +149,7 @@ class EventSubscription < Lithic::Internal::Type::BaseModel
       # - payment_transaction.updated: Occurs when a payment transaction is updated.
       # - settlement_report.updated: Occurs when a settlement report is created or
       #   updated.
-      # - statements.created: Occurs when a statement has been created
+      # - statements.created: Occurs when a statement has been created.
       # - three_ds_authentication.challenge: The `three_ds_authentication.challenge`
       #   event. Upon receiving this request, the Card Program should issue its own
       #   challenge to the cardholder. After a cardholder challenge is successfully

lib/lithic/models/events/subscription_create_params.rb

@@ -51,7 +51,7 @@ class SubscriptionCreateParams < Lithic::Internal::Type::BaseModel
         # The type of event that occurred. Possible values:
         #
         # - account_holder_document.updated: Occurs when an account holder's document
-        #   upload status has been updated
+        #   upload status has been updated.
         # - account_holder.created: Occurs when a new account_holder is created.
         # - account_holder.updated: Occurs when an account_holder is updated.
         # - account_holder.verification: Occurs when an asynchronous account_holder's
@@ -115,10 +115,21 @@ class SubscriptionCreateParams < Lithic::Internal::Type::BaseModel
         # This event will be deprecated in the future. We recommend using
         # `tokenization.updated` instead.
         #
-        # - dispute_evidence.upload_failed: Occurs when a dispute evidence upload fails.
+        # - dispute_evidence.upload_failed: Occurs when an evidence upload fails for a
+        #   dispute filed through the Chargebacks API (`/v1/disputes`).
+        #
+        # This event is not emitted for Managed Disputes.
+        #
         # - dispute_transaction.created: Occurs when a new dispute transaction is created
-        # - dispute_transaction.updated: Occurs when a dispute transaction is updated
-        # - dispute.updated: Occurs when a dispute is updated.
+        #   for a Managed Disputes case.
+        # - dispute_transaction.updated: Occurs when a dispute transaction for a Managed
+        #   Disputes case is updated.
+        # - dispute.updated: Occurs when a dispute filed through the Chargebacks API
+        #   (`/v1/disputes`) is created or updated.
+        #
+        # This event is not emitted for Managed Disputes. Use
+        # `dispute_transaction.created` and `dispute_transaction.updated` instead.
+        #
         # - external_bank_account.created: Occurs when an external bank account is
         #   created.
         # - external_bank_account.updated: Occurs when an external bank account is
@@ -140,7 +151,7 @@ class SubscriptionCreateParams < Lithic::Internal::Type::BaseModel
         # - payment_transaction.updated: Occurs when a payment transaction is updated.
         # - settlement_report.updated: Occurs when a settlement report is created or
         #   updated.
-        # - statements.created: Occurs when a statement has been created
+        # - statements.created: Occurs when a statement has been created.
         # - three_ds_authentication.challenge: The `three_ds_authentication.challenge`
         #   event. Upon receiving this request, the Card Program should issue its own
         #   challenge to the cardholder. After a cardholder challenge is successfully

lib/lithic/models/events/subscription_update_params.rb

@@ -58,7 +58,7 @@ class SubscriptionUpdateParams < Lithic::Internal::Type::BaseModel
         # The type of event that occurred. Possible values:
         #
         # - account_holder_document.updated: Occurs when an account holder's document
-        #   upload status has been updated
+        #   upload status has been updated.
         # - account_holder.created: Occurs when a new account_holder is created.
         # - account_holder.updated: Occurs when an account_holder is updated.
         # - account_holder.verification: Occurs when an asynchronous account_holder's
@@ -122,10 +122,21 @@ class SubscriptionUpdateParams < Lithic::Internal::Type::BaseModel
         # This event will be deprecated in the future. We recommend using
         # `tokenization.updated` instead.
         #
-        # - dispute_evidence.upload_failed: Occurs when a dispute evidence upload fails.
+        # - dispute_evidence.upload_failed: Occurs when an evidence upload fails for a
+        #   dispute filed through the Chargebacks API (`/v1/disputes`).
+        #
+        # This event is not emitted for Managed Disputes.
+        #
         # - dispute_transaction.created: Occurs when a new dispute transaction is created
-        # - dispute_transaction.updated: Occurs when a dispute transaction is updated
-        # - dispute.updated: Occurs when a dispute is updated.
+        #   for a Managed Disputes case.
+        # - dispute_transaction.updated: Occurs when a dispute transaction for a Managed
+        #   Disputes case is updated.
+        # - dispute.updated: Occurs when a dispute filed through the Chargebacks API
+        #   (`/v1/disputes`) is created or updated.
+        #
+        # This event is not emitted for Managed Disputes. Use
+        # `dispute_transaction.created` and `dispute_transaction.updated` instead.
+        #
         # - external_bank_account.created: Occurs when an external bank account is
         #   created.
         # - external_bank_account.updated: Occurs when an external bank account is
@@ -147,7 +158,7 @@ class SubscriptionUpdateParams < Lithic::Internal::Type::BaseModel
         # - payment_transaction.updated: Occurs when a payment transaction is updated.
         # - settlement_report.updated: Occurs when a settlement report is created or
         #   updated.
-        # - statements.created: Occurs when a statement has been created
+        # - statements.created: Occurs when a statement has been created.
         # - three_ds_authentication.challenge: The `three_ds_authentication.challenge`
         #   event. Upon receiving this request, the Card Program should issue its own
         #   challenge to the cardholder. After a cardholder challenge is successfully