feat(api): add route method to transactions

Author: stainless-app[bot]

.stats.yml

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

api.md

@@ -588,6 +588,7 @@ Methods:
 - <code title="get /v1/transactions/{transaction_token}">client.transactions.<a href="./src/lithic/resources/transactions/transactions.py">retrieve</a>(transaction_token) -> <a href="./src/lithic/types/transaction.py">Transaction</a></code>
 - <code title="get /v1/transactions">client.transactions.<a href="./src/lithic/resources/transactions/transactions.py">list</a>(\*\*<a href="src/lithic/types/transaction_list_params.py">params</a>) -> <a href="./src/lithic/types/transaction.py">SyncCursorPage[Transaction]</a></code>
 - <code title="post /v1/transactions/{transaction_token}/expire_authorization">client.transactions.<a href="./src/lithic/resources/transactions/transactions.py">expire_authorization</a>(transaction_token) -> None</code>
+- <code title="post /v1/transactions/{transaction_token}/route">client.transactions.<a href="./src/lithic/resources/transactions/transactions.py">route</a>(transaction_token, \*\*<a href="src/lithic/types/transaction_route_params.py">params</a>) -> None</code>
 - <code title="post /v1/simulate/authorize">client.transactions.<a href="./src/lithic/resources/transactions/transactions.py">simulate_authorization</a>(\*\*<a href="src/lithic/types/transaction_simulate_authorization_params.py">params</a>) -> <a href="./src/lithic/types/transaction_simulate_authorization_response.py">TransactionSimulateAuthorizationResponse</a></code>
 - <code title="post /v1/simulate/authorization_advice">client.transactions.<a href="./src/lithic/resources/transactions/transactions.py">simulate_authorization_advice</a>(\*\*<a href="src/lithic/types/transaction_simulate_authorization_advice_params.py">params</a>) -> <a href="./src/lithic/types/transaction_simulate_authorization_advice_response.py">TransactionSimulateAuthorizationAdviceResponse</a></code>
 - <code title="post /v1/simulate/clearing">client.transactions.<a href="./src/lithic/resources/transactions/transactions.py">simulate_clearing</a>(\*\*<a href="src/lithic/types/transaction_simulate_clearing_params.py">params</a>) -> <a href="./src/lithic/types/transaction_simulate_clearing_response.py">TransactionSimulateClearingResponse</a></code>

src/lithic/resources/transactions/transactions.py

@@ -12,6 +12,7 @@
 from ... import _legacy_response
 from ...types import (
     transaction_list_params,
+    transaction_route_params,
     transaction_simulate_void_params,
     transaction_simulate_return_params,
     transaction_simulate_clearing_params,
@@ -239,6 +240,47 @@ def expire_authorization(
             cast_to=NoneType,
         )
 
+    def route(
+        self,
+        transaction_token: str,
+        *,
+        financial_account_token: str,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> None:
+        """Route a card transaction to a financial account.
+
+        Only available for select use
+        cases and programs.
+
+        Args:
+          financial_account_token: The token of the financial account to route the transaction to.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not transaction_token:
+            raise ValueError(f"Expected a non-empty value for `transaction_token` but received {transaction_token!r}")
+        return self._post(
+            path_template("/v1/transactions/{transaction_token}/route", transaction_token=transaction_token),
+            body=maybe_transform(
+                {"financial_account_token": financial_account_token}, transaction_route_params.TransactionRouteParams
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=NoneType,
+        )
+
     def simulate_authorization(
         self,
         *,
@@ -942,6 +984,47 @@ async def expire_authorization(
             cast_to=NoneType,
         )
 
+    async def route(
+        self,
+        transaction_token: str,
+        *,
+        financial_account_token: str,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> None:
+        """Route a card transaction to a financial account.
+
+        Only available for select use
+        cases and programs.
+
+        Args:
+          financial_account_token: The token of the financial account to route the transaction to.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not transaction_token:
+            raise ValueError(f"Expected a non-empty value for `transaction_token` but received {transaction_token!r}")
+        return await self._post(
+            path_template("/v1/transactions/{transaction_token}/route", transaction_token=transaction_token),
+            body=await async_maybe_transform(
+                {"financial_account_token": financial_account_token}, transaction_route_params.TransactionRouteParams
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=NoneType,
+        )
+
     async def simulate_authorization(
         self,
         *,
@@ -1478,6 +1561,9 @@ def __init__(self, transactions: Transactions) -> None:
         self.expire_authorization = _legacy_response.to_raw_response_wrapper(
             transactions.expire_authorization,
         )
+        self.route = _legacy_response.to_raw_response_wrapper(
+            transactions.route,
+        )
         self.simulate_authorization = _legacy_response.to_raw_response_wrapper(
             transactions.simulate_authorization,
         )
@@ -1527,6 +1613,9 @@ def __init__(self, transactions: AsyncTransactions) -> None:
         self.expire_authorization = _legacy_response.async_to_raw_response_wrapper(
             transactions.expire_authorization,
         )
+        self.route = _legacy_response.async_to_raw_response_wrapper(
+            transactions.route,
+        )
         self.simulate_authorization = _legacy_response.async_to_raw_response_wrapper(
             transactions.simulate_authorization,
         )
@@ -1576,6 +1665,9 @@ def __init__(self, transactions: Transactions) -> None:
         self.expire_authorization = to_streamed_response_wrapper(
             transactions.expire_authorization,
         )
+        self.route = to_streamed_response_wrapper(
+            transactions.route,
+        )
         self.simulate_authorization = to_streamed_response_wrapper(
             transactions.simulate_authorization,
         )
@@ -1625,6 +1717,9 @@ def __init__(self, transactions: AsyncTransactions) -> None:
         self.expire_authorization = async_to_streamed_response_wrapper(
             transactions.expire_authorization,
         )
+        self.route = async_to_streamed_response_wrapper(
+            transactions.route,
+        )
         self.simulate_authorization = async_to_streamed_response_wrapper(
             transactions.simulate_authorization,
         )

src/lithic/types/__init__.py

@@ -102,6 +102,7 @@
 from .card_program_list_params import CardProgramListParams as CardProgramListParams
 from .tokenization_list_params import TokenizationListParams as TokenizationListParams
 from .tokenization_rule_result import TokenizationRuleResult as TokenizationRuleResult
+from .transaction_route_params import TransactionRouteParams as TransactionRouteParams
 from .transfer_limits_response import TransferLimitsResponse as TransferLimitsResponse
 from .book_transfer_list_params import BookTransferListParams as BookTransferListParams
 from .card_get_embed_url_params import CardGetEmbedURLParams as CardGetEmbedURLParams

src/lithic/types/transaction_route_params.py

@@ -0,0 +1,12 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Required, TypedDict
+
+__all__ = ["TransactionRouteParams"]
+
+
+class TransactionRouteParams(TypedDict, total=False):
+    financial_account_token: Required[str]
+    """The token of the financial account to route the transaction to."""

tests/api_resources/test_transactions.py

@@ -147,6 +147,48 @@ def test_path_params_expire_authorization(self, client: Lithic) -> None:
                 "",
             )
 
+    @parametrize
+    def test_method_route(self, client: Lithic) -> None:
+        transaction = client.transactions.route(
+            transaction_token="00000000-0000-0000-0000-000000000000",
+            financial_account_token="00000000-0000-0000-0000-000000000000",
+        )
+        assert transaction is None
+
+    @parametrize
+    def test_raw_response_route(self, client: Lithic) -> None:
+        response = client.transactions.with_raw_response.route(
+            transaction_token="00000000-0000-0000-0000-000000000000",
+            financial_account_token="00000000-0000-0000-0000-000000000000",
+        )
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        transaction = response.parse()
+        assert transaction is None
+
+    @parametrize
+    def test_streaming_response_route(self, client: Lithic) -> None:
+        with client.transactions.with_streaming_response.route(
+            transaction_token="00000000-0000-0000-0000-000000000000",
+            financial_account_token="00000000-0000-0000-0000-000000000000",
+        ) as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            transaction = response.parse()
+            assert transaction is None
+
+        assert cast(Any, response.is_closed) is True
+
+    @parametrize
+    def test_path_params_route(self, client: Lithic) -> None:
+        with pytest.raises(ValueError, match=r"Expected a non-empty value for `transaction_token` but received ''"):
+            client.transactions.with_raw_response.route(
+                transaction_token="",
+                financial_account_token="00000000-0000-0000-0000-000000000000",
+            )
+
     @parametrize
     def test_method_simulate_authorization(self, client: Lithic) -> None:
         transaction = client.transactions.simulate_authorization(
@@ -614,6 +656,48 @@ async def test_path_params_expire_authorization(self, async_client: AsyncLithic)
                 "",
             )
 
+    @parametrize
+    async def test_method_route(self, async_client: AsyncLithic) -> None:
+        transaction = await async_client.transactions.route(
+            transaction_token="00000000-0000-0000-0000-000000000000",
+            financial_account_token="00000000-0000-0000-0000-000000000000",
+        )
+        assert transaction is None
+
+    @parametrize
+    async def test_raw_response_route(self, async_client: AsyncLithic) -> None:
+        response = await async_client.transactions.with_raw_response.route(
+            transaction_token="00000000-0000-0000-0000-000000000000",
+            financial_account_token="00000000-0000-0000-0000-000000000000",
+        )
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        transaction = response.parse()
+        assert transaction is None
+
+    @parametrize
+    async def test_streaming_response_route(self, async_client: AsyncLithic) -> None:
+        async with async_client.transactions.with_streaming_response.route(
+            transaction_token="00000000-0000-0000-0000-000000000000",
+            financial_account_token="00000000-0000-0000-0000-000000000000",
+        ) as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            transaction = await response.parse()
+            assert transaction is None
+
+        assert cast(Any, response.is_closed) is True
+
+    @parametrize
+    async def test_path_params_route(self, async_client: AsyncLithic) -> None:
+        with pytest.raises(ValueError, match=r"Expected a non-empty value for `transaction_token` but received ''"):
+            await async_client.transactions.with_raw_response.route(
+                transaction_token="",
+                financial_account_token="00000000-0000-0000-0000-000000000000",
+            )
+
     @parametrize
     async def test_method_simulate_authorization(self, async_client: AsyncLithic) -> None:
         transaction = await async_client.transactions.simulate_authorization(