feat(api): add route method to transactions

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 213
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic/lithic-6200f208b7ffdb9b4c7dd8468dbfe69f0078f8b8b0fd171ba2edc1c2a641f185.yml
-openapi_spec_hash: 2c396033aca49407378b3982e46d19e6
-config_hash: 126e04f676f61e5871a82889336dbf9d
+configured_endpoints: 214
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic/lithic-a4afc884f86f30a87445552888031ac1ca18aed0476d7120da555bf457627e65.yml
+openapi_spec_hash: ce8d0830986c702f0c7a693b1c3cc5a2
+config_hash: 4b618a1df59e555cebe6aa13e8c0218f

api.md

@@ -537,6 +537,7 @@ Methods:
 - <code title="get /v1/transactions/{transaction_token}">client.transactions.<a href="./src/resources/transactions/transactions.ts">retrieve</a>(transactionToken) -> Transaction</code>
 - <code title="get /v1/transactions">client.transactions.<a href="./src/resources/transactions/transactions.ts">list</a>({ ...params }) -> TransactionsCursorPage</code>
 - <code title="post /v1/transactions/{transaction_token}/expire_authorization">client.transactions.<a href="./src/resources/transactions/transactions.ts">expireAuthorization</a>(transactionToken) -> void</code>
+- <code title="post /v1/transactions/{transaction_token}/route">client.transactions.<a href="./src/resources/transactions/transactions.ts">route</a>(transactionToken, { ...params }) -> void</code>
 - <code title="post /v1/simulate/authorize">client.transactions.<a href="./src/resources/transactions/transactions.ts">simulateAuthorization</a>({ ...params }) -> TransactionSimulateAuthorizationResponse</code>
 - <code title="post /v1/simulate/authorization_advice">client.transactions.<a href="./src/resources/transactions/transactions.ts">simulateAuthorizationAdvice</a>({ ...params }) -> TransactionSimulateAuthorizationAdviceResponse</code>
 - <code title="post /v1/simulate/clearing">client.transactions.<a href="./src/resources/transactions/transactions.ts">simulateClearing</a>({ ...params }) -> TransactionSimulateClearingResponse</code>

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

@@ -243,6 +243,7 @@ const fuse = new Fuse(
     'client.transactions.expireAuthorization',
     'client.transactions.list',
     'client.transactions.retrieve',
+    'client.transactions.route',
     'client.transactions.simulateAuthorization',
     'client.transactions.simulateAuthorizationAdvice',
     'client.transactions.simulateClearing',

packages/mcp-server/src/local-docs-search.ts

@@ -7593,6 +7593,55 @@ const EMBEDDED_METHODS: MethodEntry[] = [
       },
     },
   },
+  {
+    name: 'route',
+    endpoint: '/v1/transactions/{transaction_token}/route',
+    httpMethod: 'post',
+    summary: 'Route a transaction',
+    description:
+      'Route a card transaction to a financial account. Only available for select use cases and programs.',
+    stainlessPath: '(resource) transactions > (method) route',
+    qualified: 'client.transactions.route',
+    params: ['transaction_token: string;', 'financial_account_token: string;'],
+    markdown:
+      "## route\n\n`client.transactions.route(transaction_token: string, financial_account_token: string): void`\n\n**post** `/v1/transactions/{transaction_token}/route`\n\nRoute a card transaction to a financial account. Only available for select use cases and programs.\n\n### Parameters\n\n- `transaction_token: string`\n\n- `financial_account_token: string`\n  The token of the financial account to route the transaction to.\n\n### Example\n\n```typescript\nimport Lithic from 'lithic';\n\nconst client = new Lithic();\n\nawait client.transactions.route('00000000-0000-0000-0000-000000000000', { financial_account_token: '00000000-0000-0000-0000-000000000000' })\n```",
+    perLanguage: {
+      typescript: {
+        method: 'client.transactions.route',
+        example:
+          "import Lithic from 'lithic';\n\nconst client = new Lithic({\n  apiKey: process.env['LITHIC_API_KEY'], // This is the default and can be omitted\n});\n\nawait client.transactions.route('00000000-0000-0000-0000-000000000000', {\n  financial_account_token: '00000000-0000-0000-0000-000000000000',\n});",
+      },
+      python: {
+        method: 'transactions.route',
+        example:
+          'import os\nfrom lithic import Lithic\n\nclient = Lithic(\n    api_key=os.environ.get("LITHIC_API_KEY"),  # This is the default and can be omitted\n)\nclient.transactions.route(\n    transaction_token="00000000-0000-0000-0000-000000000000",\n    financial_account_token="00000000-0000-0000-0000-000000000000",\n)',
+      },
+      java: {
+        method: 'transactions().route',
+        example:
+          'package com.lithic.api.example;\n\nimport com.lithic.api.client.LithicClient;\nimport com.lithic.api.client.okhttp.LithicOkHttpClient;\nimport com.lithic.api.models.TransactionRouteParams;\n\npublic final class Main {\n    private Main() {}\n\n    public static void main(String[] args) {\n        LithicClient client = LithicOkHttpClient.fromEnv();\n\n        TransactionRouteParams params = TransactionRouteParams.builder()\n            .transactionToken("00000000-0000-0000-0000-000000000000")\n            .financialAccountToken("00000000-0000-0000-0000-000000000000")\n            .build();\n        client.transactions().route(params);\n    }\n}',
+      },
+      kotlin: {
+        method: 'transactions().route',
+        example:
+          'package com.lithic.api.example\n\nimport com.lithic.api.client.LithicClient\nimport com.lithic.api.client.okhttp.LithicOkHttpClient\nimport com.lithic.api.models.TransactionRouteParams\n\nfun main() {\n    val client: LithicClient = LithicOkHttpClient.fromEnv()\n\n    val params: TransactionRouteParams = TransactionRouteParams.builder()\n        .transactionToken("00000000-0000-0000-0000-000000000000")\n        .financialAccountToken("00000000-0000-0000-0000-000000000000")\n        .build()\n    client.transactions().route(params)\n}',
+      },
+      go: {
+        method: 'client.Transactions.Route',
+        example:
+          'package main\n\nimport (\n\t"context"\n\n\t"github.com/lithic-com/lithic-go"\n\t"github.com/lithic-com/lithic-go/option"\n)\n\nfunc main() {\n\tclient := lithic.NewClient(\n\t\toption.WithAPIKey("My Lithic API Key"),\n\t)\n\terr := client.Transactions.Route(\n\t\tcontext.TODO(),\n\t\t"00000000-0000-0000-0000-000000000000",\n\t\tlithic.TransactionRouteParams{\n\t\t\tFinancialAccountToken: lithic.F("00000000-0000-0000-0000-000000000000"),\n\t\t},\n\t)\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n}\n',
+      },
+      ruby: {
+        method: 'transactions.route',
+        example:
+          'require "lithic"\n\nlithic = Lithic::Client.new(\n  api_key: "My Lithic API Key",\n  environment: "sandbox" # defaults to "production"\n)\n\nresult = lithic.transactions.route(\n  "00000000-0000-0000-0000-000000000000",\n  financial_account_token: "00000000-0000-0000-0000-000000000000"\n)\n\nputs(result)',
+      },
+      http: {
+        example:
+          'curl https://api.lithic.com/v1/transactions/$TRANSACTION_TOKEN/route \\\n    -H \'Content-Type: application/json\' \\\n    -H "Authorization: $LITHIC_API_KEY" \\\n    -d \'{\n          "financial_account_token": "00000000-0000-0000-0000-000000000000"\n        }\'',
+      },
+    },
+  },
   {
     name: 'retrieve',
     endpoint: '/v1/transactions/{transaction_token}/enhanced_commercial_data',

packages/mcp-server/src/methods.ts

@@ -821,6 +821,12 @@ export const sdkMethods: SdkMethod[] = [
     httpMethod: 'post',
     httpPath: '/v1/transactions/{transaction_token}/expire_authorization',
   },
+  {
+    clientCallName: 'client.transactions.route',
+    fullyQualifiedName: 'transactions.route',
+    httpMethod: 'post',
+    httpPath: '/v1/transactions/{transaction_token}/route',
+  },
   {
     clientCallName: 'client.transactions.simulateAuthorization',
     fullyQualifiedName: 'transactions.simulateAuthorization',

src/client.ts

@@ -355,6 +355,7 @@ import {
   TokenInfo,
   Transaction,
   TransactionListParams,
+  TransactionRouteParams,
   TransactionSimulateAuthorizationAdviceParams,
   TransactionSimulateAuthorizationAdviceResponse,
   TransactionSimulateAuthorizationParams,
@@ -1409,6 +1410,7 @@ export declare namespace Lithic {
     type TransactionSimulateVoidResponse as TransactionSimulateVoidResponse,
     type TransactionsCursorPage as TransactionsCursorPage,
     type TransactionListParams as TransactionListParams,
+    type TransactionRouteParams as TransactionRouteParams,
     type TransactionSimulateAuthorizationParams as TransactionSimulateAuthorizationParams,
     type TransactionSimulateAuthorizationAdviceParams as TransactionSimulateAuthorizationAdviceParams,
     type TransactionSimulateClearingParams as TransactionSimulateClearingParams,

src/resources/index.ts

@@ -281,6 +281,7 @@ export {
   type TransactionSimulateReturnReversalResponse,
   type TransactionSimulateVoidResponse,
   type TransactionListParams,
+  type TransactionRouteParams,
   type TransactionSimulateAuthorizationParams,
   type TransactionSimulateAuthorizationAdviceParams,
   type TransactionSimulateClearingParams,

src/resources/transactions/index.ts

@@ -19,6 +19,7 @@ export {
   type TransactionSimulateReturnReversalResponse,
   type TransactionSimulateVoidResponse,
   type TransactionListParams,
+  type TransactionRouteParams,
   type TransactionSimulateAuthorizationParams,
   type TransactionSimulateAuthorizationAdviceParams,
   type TransactionSimulateClearingParams,

src/resources/transactions/transactions.ts

@@ -64,6 +64,25 @@ export class Transactions extends APIResource {
     return this._client.post(path`/v1/transactions/${transactionToken}/expire_authorization`, options);
   }
 
+  /**
+   * Route a card transaction to a financial account. Only available for select use
+   * cases and programs.
+   *
+   * @example
+   * ```ts
+   * await client.transactions.route(
+   *   '00000000-0000-0000-0000-000000000000',
+   *   {
+   *     financial_account_token:
+   *       '00000000-0000-0000-0000-000000000000',
+   *   },
+   * );
+   * ```
+   */
+  route(transactionToken: string, body: TransactionRouteParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.post(path`/v1/transactions/${transactionToken}/route`, { body, ...options });
+  }
+
   /**
    * Simulates an authorization request from the card network as if it came from a
    * merchant acquirer. If you are configured for ASA, simulating authorizations
@@ -1291,6 +1310,13 @@ export interface TransactionListParams extends CursorPageParams {
   status?: 'PENDING' | 'VOIDED' | 'SETTLED' | 'DECLINED' | 'EXPIRED';
 }
 
+export interface TransactionRouteParams {
+  /**
+   * The token of the financial account to route the transaction to.
+   */
+  financial_account_token: string;
+}
+
 export interface TransactionSimulateAuthorizationParams {
   /**
    * Amount (in cents) to authorize. For credit authorizations and financial credit
@@ -1578,6 +1604,7 @@ export declare namespace Transactions {
     type TransactionSimulateVoidResponse as TransactionSimulateVoidResponse,
     type TransactionsCursorPage as TransactionsCursorPage,
     type TransactionListParams as TransactionListParams,
+    type TransactionRouteParams as TransactionRouteParams,
     type TransactionSimulateAuthorizationParams as TransactionSimulateAuthorizationParams,
     type TransactionSimulateAuthorizationAdviceParams as TransactionSimulateAuthorizationAdviceParams,
     type TransactionSimulateClearingParams as TransactionSimulateClearingParams,

tests/api-resources/transactions/transactions.test.ts

@@ -61,6 +61,25 @@ describe('resource transactions', () => {
     expect(dataAndResponse.response).toBe(rawResponse);
   });
 
+  test('route: only required params', async () => {
+    const responsePromise = client.transactions.route('00000000-0000-0000-0000-000000000000', {
+      financial_account_token: '00000000-0000-0000-0000-000000000000',
+    });
+    const rawResponse = await responsePromise.asResponse();
+    expect(rawResponse).toBeInstanceOf(Response);
+    const response = await responsePromise;
+    expect(response).not.toBeInstanceOf(Response);
+    const dataAndResponse = await responsePromise.withResponse();
+    expect(dataAndResponse.data).toBe(response);
+    expect(dataAndResponse.response).toBe(rawResponse);
+  });
+
+  test('route: required and optional params', async () => {
+    const response = await client.transactions.route('00000000-0000-0000-0000-000000000000', {
+      financial_account_token: '00000000-0000-0000-0000-000000000000',
+    });
+  });
+
   test('simulateAuthorization: only required params', async () => {
     const responsePromise = client.transactions.simulateAuthorization({
       amount: 3831,