release: 0.147.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.146.0"
+  ".": "0.147.0"
 }

.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

CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## 0.147.0 (2026-09-18)
+
+Full Changelog: [v0.146.0...v0.147.0](https://github.com/lithic-com/lithic-node/compare/v0.146.0...v0.147.0)
+
+### Features
+
+* [CARDS-5174] Add reiusse/renew 409 error ([fa0ae4c](https://github.com/lithic-com/lithic-node/commit/fa0ae4c9d0d466dc66ee5fe7bc5bc3174db1d4e0))
+* [TRE-14464] Update /retry payments endpoint to accept method ([ad8c6d4](https://github.com/lithic-com/lithic-node/commit/ad8c6d429b3868c9202c2ff7a0d00ae21376487b))
+* [TRE-14524] Add Open to buy API spec ([e0bc361](https://github.com/lithic-com/lithic-node/commit/e0bc36190aaac85568d469b9dc0daa4f0b4cb8ee))
+* Add missing blockchain/stablecoin endpoints to the spec ([6011012](https://github.com/lithic-com/lithic-node/commit/60110124c2d5033eef60f80a8a90b6f5fccae5fb))
+* **api:** add card.pin_updated webhook event ([e174e1b](https://github.com/lithic-com/lithic-node/commit/e174e1b4fa580e4b93f4a91384a3a771a474506b))
+* **api:** add EXTERNAL_STABLECOIN category and events to payments/account-activity/statements ([d89001c](https://github.com/lithic-com/lithic-node/commit/d89001c431cbfcb4a0be1e61a79299d8d6096794))
+* **api:** add FEE/FEE_REVERSAL to line-items/management-operations/financial events ([c2550c8](https://github.com/lithic-com/lithic-node/commit/c2550c85089ea32157af9de5f31e3935db7c5681))
+* **api:** add installmentPlans resource to financialAccounts ([778acc4](https://github.com/lithic-com/lithic-node/commit/778acc4e58811d933d45866ab9066004e85f65f9))
+* **api:** add OTHER enum value to type field in auth_rules.v2 ([022c00b](https://github.com/lithic-com/lithic-node/commit/022c00bec0a58609473ce0a843f526f01382c064))
+* **api:** add psd2_context field to threeDS.authentication response ([9872235](https://github.com/lithic-com/lithic-node/commit/9872235a163047bd300ed1222ec79e2fcc9a1fc1))
+* **api:** add STABLECOIN_REVIEWED event type to payment simulate action ([d40e9cd](https://github.com/lithic-com/lithic-node/commit/d40e9cd20eb0a8d1547648cb3fdec27976d6c604))
+* AUTH-3759: Add DECLINE_SCA_REQUIRED and SCA_REQUIRED enum entries ([bb3cc93](https://github.com/lithic-com/lithic-node/commit/bb3cc935769cfe3c0b69728d6d83ef7e802baa97))
+* TRE-14349: add installment plan management operation event types ([67bb3d0](https://github.com/lithic-com/lithic-node/commit/67bb3d0ae9522b3f4b76df53fbf43961f5bb874e))
+* TRE-14429: Document the stablecoin payments endpoint ([1f241df](https://github.com/lithic-com/lithic-node/commit/1f241df9bbd3b4c5c31521f07f3ccb52f06b8640))
+
+
+### Documentation
+
+* **mcp:** document code execution modes and the local code runner ([7623f85](https://github.com/lithic-com/lithic-node/commit/7623f85c394e10f26f44b377a730d33edb9ea4c8))
+
 ## 0.146.0 (2026-08-31)
 
 Full Changelog: [v0.145.0...v0.146.0](https://github.com/lithic-com/lithic-node/compare/v0.145.0...v0.146.0)

MIGRATION.md

@@ -69,6 +69,7 @@ This affects the following methods:
 - `client.financialAccounts.statements.retrieve()`
 - `client.financialAccounts.statements.lineItems.list()`
 - `client.financialAccounts.loanTapes.retrieve()`
+- `client.financialAccounts.installmentPlans.retrieve()`
 - `client.financialAccounts.interestTierSchedule.retrieve()`
 - `client.financialAccounts.interestTierSchedule.update()`
 - `client.financialAccounts.interestTierSchedule.delete()`
@@ -140,12 +141,14 @@ client.example.list(undefined, { headers: { ... } });
 - `client.financialAccounts.creditConfiguration.update()`
 - `client.financialAccounts.statements.list()`
 - `client.financialAccounts.loanTapes.list()`
+- `client.financialAccounts.installmentPlans.list()`
 - `client.financialAccounts.interestTierSchedule.list()`
 - `client.transactions.list()`
 - `client.externalBankAccounts.list()`
 - `client.externalBankAccounts.retryMicroDeposits()`
 - `client.externalBankAccounts.retryPrenote()`
 - `client.payments.list()`
+- `client.payments.retry()`
 - `client.reports.settlement.listDetails()`
 - `client.reports.settlement.networkTotals.list()`
 - `client.cardPrograms.list()`

api.md

@@ -440,6 +440,17 @@ Methods:
 
 - <code title="get /v1/financial_accounts/{financial_account_token}/balances">client.financialAccounts.balances.<a href="./src/resources/financial-accounts/balances.ts">list</a>(financialAccountToken, { ...params }) -> FinancialAccountBalancesSinglePage</code>
 
+## OpenToBuy
+
+Types:
+
+- <code><a href="./src/resources/financial-accounts/open-to-buy.ts">OpenToBuy</a></code>
+- <code><a href="./src/resources/financial-accounts/open-to-buy.ts">OpenToBuySummary</a></code>
+
+Methods:
+
+- <code title="get /v1/financial_accounts/{financial_account_token}/open_to_buy">client.financialAccounts.openToBuy.<a href="./src/resources/financial-accounts/open-to-buy.ts">retrieve</a>(financialAccountToken) -> OpenToBuy</code>
+
 ## FinancialTransactions
 
 Methods:
@@ -492,6 +503,18 @@ Methods:
 - <code title="get /v1/financial_accounts/{financial_account_token}/loan_tapes/{loan_tape_token}">client.financialAccounts.loanTapes.<a href="./src/resources/financial-accounts/loan-tapes.ts">retrieve</a>(loanTapeToken, { ...params }) -> LoanTape</code>
 - <code title="get /v1/financial_accounts/{financial_account_token}/loan_tapes">client.financialAccounts.loanTapes.<a href="./src/resources/financial-accounts/loan-tapes.ts">list</a>(financialAccountToken, { ...params }) -> LoanTapesCursorPage</code>
 
+## InstallmentPlans
+
+Types:
+
+- <code><a href="./src/resources/financial-accounts/installment-plans.ts">InstallmentPlan</a></code>
+- <code><a href="./src/resources/financial-accounts/installment-plans.ts">TransactionCategoryBalances</a></code>
+
+Methods:
+
+- <code title="get /v1/financial_accounts/{financial_account_token}/installment_plans/{installment_plan_token}">client.financialAccounts.installmentPlans.<a href="./src/resources/financial-accounts/installment-plans.ts">retrieve</a>(installmentPlanToken, { ...params }) -> InstallmentPlan</code>
+- <code title="get /v1/financial_accounts/{financial_account_token}/installment_plans">client.financialAccounts.installmentPlans.<a href="./src/resources/financial-accounts/installment-plans.ts">list</a>(financialAccountToken, { ...params }) -> InstallmentPlansCursorPage</code>
+
 ## LoanTapeConfiguration
 
 Types:
@@ -638,13 +661,15 @@ Types:
 Methods:
 
 - <code title="post /v1/blockchain_recipients">client.blockchainRecipients.<a href="./src/resources/blockchain-recipients.ts">create</a>({ ...params }) -> BlockchainRecipient</code>
+- <code title="get /v1/blockchain_recipients/{blockchain_recipient_token}">client.blockchainRecipients.<a href="./src/resources/blockchain-recipients.ts">retrieve</a>(blockchainRecipientToken) -> BlockchainRecipient</code>
 
 # Payments
 
 Types:
 
 - <code><a href="./src/resources/payments.ts">Payment</a></code>
 - <code><a href="./src/resources/payments.ts">PaymentCreateResponse</a></code>
+- <code><a href="./src/resources/payments.ts">PaymentCreateStablecoinResponse</a></code>
 - <code><a href="./src/resources/payments.ts">PaymentRetryResponse</a></code>
 - <code><a href="./src/resources/payments.ts">PaymentSimulateActionResponse</a></code>
 - <code><a href="./src/resources/payments.ts">PaymentSimulateReceiptResponse</a></code>
@@ -656,7 +681,8 @@ Methods:
 - <code title="post /v1/payments">client.payments.<a href="./src/resources/payments.ts">create</a>({ ...params }) -> PaymentCreateResponse</code>
 - <code title="get /v1/payments/{payment_token}">client.payments.<a href="./src/resources/payments.ts">retrieve</a>(paymentToken) -> Payment</code>
 - <code title="get /v1/payments">client.payments.<a href="./src/resources/payments.ts">list</a>({ ...params }) -> PaymentsCursorPage</code>
-- <code title="post /v1/payments/{payment_token}/retry">client.payments.<a href="./src/resources/payments.ts">retry</a>(paymentToken) -> PaymentRetryResponse</code>
+- <code title="post /v1/payments/stablecoin">client.payments.<a href="./src/resources/payments.ts">createStablecoin</a>({ ...params }) -> PaymentCreateStablecoinResponse</code>
+- <code title="post /v1/payments/{payment_token}/retry">client.payments.<a href="./src/resources/payments.ts">retry</a>(paymentToken, { ...params }) -> PaymentRetryResponse</code>
 - <code title="post /v1/payments/{payment_token}/return">client.payments.<a href="./src/resources/payments.ts">return</a>(paymentToken, { ...params }) -> Payment</code>
 - <code title="post /v1/simulate/payments/{payment_token}/action">client.payments.<a href="./src/resources/payments.ts">simulateAction</a>(paymentToken, { ...params }) -> PaymentSimulateActionResponse</code>
 - <code title="post /v1/simulate/payments/receipt">client.payments.<a href="./src/resources/payments.ts">simulateReceipt</a>({ ...params }) -> PaymentSimulateReceiptResponse</code>
@@ -906,6 +932,7 @@ Types:
 - <code><a href="./src/resources/webhooks.ts">BookTransferTransactionUpdatedWebhookEvent</a></code>
 - <code><a href="./src/resources/webhooks.ts">CardCreatedWebhookEvent</a></code>
 - <code><a href="./src/resources/webhooks.ts">CardConvertedWebhookEvent</a></code>
+- <code><a href="./src/resources/webhooks.ts">CardPinUpdatedWebhookEvent</a></code>
 - <code><a href="./src/resources/webhooks.ts">CardRenewedWebhookEvent</a></code>
 - <code><a href="./src/resources/webhooks.ts">CardReissuedWebhookEvent</a></code>
 - <code><a href="./src/resources/webhooks.ts">CardShippedWebhookEvent</a></code>

bin/migration-config.json

@@ -506,6 +506,39 @@
         }
       ]
     },
+    {
+      "base": "financialAccounts.installmentPlans",
+      "name": "retrieve",
+      "params": [
+        {
+          "type": "param",
+          "key": "installment_plan_token",
+          "location": "path"
+        },
+        {
+          "type": "params",
+          "maybeOverload": false
+        },
+        {
+          "type": "options"
+        }
+      ],
+      "oldParams": [
+        {
+          "type": "param",
+          "key": "financial_account_token",
+          "location": "path"
+        },
+        {
+          "type": "param",
+          "key": "installment_plan_token",
+          "location": "path"
+        },
+        {
+          "type": "options"
+        }
+      ]
+    },
     {
       "base": "financialAccounts.interestTierSchedule",
       "name": "retrieve",

package.json

@@ -1,6 +1,6 @@
 {
   "name": "lithic",
-  "version": "0.146.0",
+  "version": "0.147.0",
   "description": "The official TypeScript library for the Lithic API",
   "author": "Lithic <sdk-feedback@lithic.com>",
   "types": "dist/index.d.ts",

packages/mcp-server/README.md

@@ -62,20 +62,33 @@ claude mcp add lithic_mcp_api --header "x-lithic-api-key: My Lithic API Key" --t
 ## Code Mode
 
 This MCP server is built on the "Code Mode" tool scheme. In this MCP Server,
-your agent will write code against the TypeScript SDK, which will then be executed in an
-isolated sandbox. To accomplish this, the server will expose two tools to your agent:
+your agent will write code against the TypeScript SDK, which will then be executed in a
+sandbox. To accomplish this, the server will expose two tools to your agent:
 
 - The first tool is a docs search tool, which can be used to generically query for
   documentation about your API/SDK.
 
 - The second tool is a code tool, where the agent can write code against the TypeScript SDK.
-  The code will be executed in a sandbox environment without web or filesystem access. Then,
-  anything the code returns or prints will be returned to the agent as the result of the
-  tool call.
+  The code is executed in a sandbox whose filesystem and network access are restricted to
+  what the SDK needs — see "Where code runs" below. Then, anything the code returns or
+  prints will be returned to the agent as the result of the tool call.
 
 Using this scheme, agents are capable of performing very complex tasks deterministically
 and repeatably.
 
+### Where code runs
+
+The `--code-execution-mode` flag controls where the code tool runs your agent's code:
+
+- `--code-execution-mode=local` runs each code tool call in a Deno subprocess on the same
+  machine as the MCP server, restricted to reading the server's own files and to making network
+  requests to your API host. Nothing is sent to Stainless. Deno must be installed for this mode
+  to work: install it from https://deno.land, or add it to the MCP server's dependencies with
+  `npm install deno`.
+
+- `--code-execution-mode=stainless-sandbox` sends the code to a Stainless-hosted sandbox to be
+  executed there. This mode is deprecated and is being turned off, so use `local` instead.
+
 ## Running remotely
 
 Launching the client with `--transport=http` launches the server as a remote server using Streamable HTTP transport. The `--port` setting can choose the port it will run on, and the `--socket` setting allows it to run on a Unix socket.

packages/mcp-server/manifest.json

@@ -1,7 +1,7 @@
 {
   "dxt_version": "0.2",
   "name": "lithic-mcp",
-  "version": "0.146.0",
+  "version": "0.147.0",
   "description": "The official MCP Server for the Lithic API",
   "author": {
     "name": "Lithic",

packages/mcp-server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lithic-mcp",
-  "version": "0.146.0",
+  "version": "0.147.0",
   "description": "The official MCP Server for the Lithic API",
   "author": "Lithic <sdk-feedback@lithic.com>",
   "types": "dist/index.d.ts",

packages/mcp-server/src/code-tool-worker.ts

@@ -226,6 +226,7 @@ const fuse = new Fuse(
     'client.financialAccounts.update',
     'client.financialAccounts.updateStatus',
     'client.financialAccounts.balances.list',
+    'client.financialAccounts.openToBuy.retrieve',
     'client.financialAccounts.financialTransactions.list',
     'client.financialAccounts.financialTransactions.retrieve',
     'client.financialAccounts.creditConfiguration.retrieve',
@@ -235,6 +236,8 @@ const fuse = new Fuse(
     'client.financialAccounts.statements.lineItems.list',
     'client.financialAccounts.loanTapes.list',
     'client.financialAccounts.loanTapes.retrieve',
+    'client.financialAccounts.installmentPlans.list',
+    'client.financialAccounts.installmentPlans.retrieve',
     'client.financialAccounts.loanTapeConfiguration.retrieve',
     'client.financialAccounts.interestTierSchedule.create',
     'client.financialAccounts.interestTierSchedule.delete',
@@ -269,7 +272,9 @@ const fuse = new Fuse(
     'client.externalBankAccounts.update',
     'client.externalBankAccounts.microDeposits.create',
     'client.blockchainRecipients.create',
+    'client.blockchainRecipients.retrieve',
     'client.payments.create',
+    'client.payments.createStablecoin',
     'client.payments.list',
     'client.payments.retrieve',
     'client.payments.retry',