feat(api): add set_verification_method to external_bank_accounts

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 189
+configured_endpoints: 190
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic%2Flithic-28c9b43d3182bf0e1c9635f6100e4995a744724db1edd635cfd3fc7702ced68c.yml
 openapi_spec_hash: aba00a65f877c5095499d9d1a66b5e5f
-config_hash: 5eca052bb23d273fa970eac3127dd919
+config_hash: ac8326134e692f3f3bdec82396bbec80

api.md

@@ -577,6 +577,7 @@ Methods:
 - <code title="get /v1/external_bank_accounts">client.external_bank_accounts.<a href="./src/lithic/resources/external_bank_accounts/external_bank_accounts.py">list</a>(\*\*<a href="src/lithic/types/external_bank_account_list_params.py">params</a>) -> <a href="./src/lithic/types/external_bank_account_list_response.py">SyncCursorPage[ExternalBankAccountListResponse]</a></code>
 - <code title="post /v1/external_bank_accounts/{external_bank_account_token}/retry_micro_deposits">client.external_bank_accounts.<a href="./src/lithic/resources/external_bank_accounts/external_bank_accounts.py">retry_micro_deposits</a>(external_bank_account_token, \*\*<a href="src/lithic/types/external_bank_account_retry_micro_deposits_params.py">params</a>) -> <a href="./src/lithic/types/external_bank_account_retry_micro_deposits_response.py">ExternalBankAccountRetryMicroDepositsResponse</a></code>
 - <code title="post /v1/external_bank_accounts/{external_bank_account_token}/retry_prenote">client.external_bank_accounts.<a href="./src/lithic/resources/external_bank_accounts/external_bank_accounts.py">retry_prenote</a>(external_bank_account_token, \*\*<a href="src/lithic/types/external_bank_account_retry_prenote_params.py">params</a>) -> <a href="./src/lithic/types/external_bank_account.py">ExternalBankAccount</a></code>
+- <code title="post /v1/external_bank_accounts/{external_bank_account_token}/set_verification_method">client.external_bank_accounts.<a href="./src/lithic/resources/external_bank_accounts/external_bank_accounts.py">set_verification_method</a>(external_bank_account_token, \*\*<a href="src/lithic/types/external_bank_account_set_verification_method_params.py">params</a>) -> <a href="./src/lithic/types/external_bank_account.py">ExternalBankAccount</a></code>
 - <code title="post /v1/external_bank_accounts/{external_bank_account_token}/unpause">client.external_bank_accounts.<a href="./src/lithic/resources/external_bank_accounts/external_bank_accounts.py">unpause</a>(external_bank_account_token) -> <a href="./src/lithic/types/external_bank_account.py">ExternalBankAccount</a></code>
 
 ## MicroDeposits

src/lithic/resources/external_bank_accounts/external_bank_accounts.py

@@ -17,6 +17,7 @@
     external_bank_account_update_params,
     external_bank_account_retry_prenote_params,
     external_bank_account_retry_micro_deposits_params,
+    external_bank_account_set_verification_method_params,
 )
 from ..._types import Body, Omit, Query, Headers, NotGiven, SequenceNotStr, omit, not_given
 from ..._utils import path_template, required_args, maybe_transform, async_maybe_transform
@@ -644,6 +645,60 @@ def retry_prenote(
             cast_to=ExternalBankAccount,
         )
 
+    def set_verification_method(
+        self,
+        external_bank_account_token: str,
+        *,
+        verification_method: Literal["MICRO_DEPOSIT", "PRENOTE", "EXTERNALLY_VERIFIED"],
+        financial_account_token: str | Omit = omit,
+        # 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,
+    ) -> ExternalBankAccount:
+        """Update the verification method for an external bank account.
+
+        Verification method
+        can only be updated if the `verification_state` is `PENDING`.
+
+        Args:
+          verification_method: The verification method to set for the external bank account
+
+          financial_account_token: The financial account token of the operating account to fund the micro deposits.
+              Required when verification_method is MICRO_DEPOSIT or PRENOTE.
+
+          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 external_bank_account_token:
+            raise ValueError(
+                f"Expected a non-empty value for `external_bank_account_token` but received {external_bank_account_token!r}"
+            )
+        return self._post(
+            path_template(
+                "/v1/external_bank_accounts/{external_bank_account_token}/set_verification_method",
+                external_bank_account_token=external_bank_account_token,
+            ),
+            body=maybe_transform(
+                {
+                    "verification_method": verification_method,
+                    "financial_account_token": financial_account_token,
+                },
+                external_bank_account_set_verification_method_params.ExternalBankAccountSetVerificationMethodParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=ExternalBankAccount,
+        )
+
     def unpause(
         self,
         external_bank_account_token: str,
@@ -1281,6 +1336,60 @@ async def retry_prenote(
             cast_to=ExternalBankAccount,
         )
 
+    async def set_verification_method(
+        self,
+        external_bank_account_token: str,
+        *,
+        verification_method: Literal["MICRO_DEPOSIT", "PRENOTE", "EXTERNALLY_VERIFIED"],
+        financial_account_token: str | Omit = omit,
+        # 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,
+    ) -> ExternalBankAccount:
+        """Update the verification method for an external bank account.
+
+        Verification method
+        can only be updated if the `verification_state` is `PENDING`.
+
+        Args:
+          verification_method: The verification method to set for the external bank account
+
+          financial_account_token: The financial account token of the operating account to fund the micro deposits.
+              Required when verification_method is MICRO_DEPOSIT or PRENOTE.
+
+          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 external_bank_account_token:
+            raise ValueError(
+                f"Expected a non-empty value for `external_bank_account_token` but received {external_bank_account_token!r}"
+            )
+        return await self._post(
+            path_template(
+                "/v1/external_bank_accounts/{external_bank_account_token}/set_verification_method",
+                external_bank_account_token=external_bank_account_token,
+            ),
+            body=await async_maybe_transform(
+                {
+                    "verification_method": verification_method,
+                    "financial_account_token": financial_account_token,
+                },
+                external_bank_account_set_verification_method_params.ExternalBankAccountSetVerificationMethodParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=ExternalBankAccount,
+        )
+
     async def unpause(
         self,
         external_bank_account_token: str,
@@ -1342,6 +1451,9 @@ def __init__(self, external_bank_accounts: ExternalBankAccounts) -> None:
         self.retry_prenote = _legacy_response.to_raw_response_wrapper(
             external_bank_accounts.retry_prenote,
         )
+        self.set_verification_method = _legacy_response.to_raw_response_wrapper(
+            external_bank_accounts.set_verification_method,
+        )
         self.unpause = _legacy_response.to_raw_response_wrapper(
             external_bank_accounts.unpause,
         )
@@ -1373,6 +1485,9 @@ def __init__(self, external_bank_accounts: AsyncExternalBankAccounts) -> None:
         self.retry_prenote = _legacy_response.async_to_raw_response_wrapper(
             external_bank_accounts.retry_prenote,
         )
+        self.set_verification_method = _legacy_response.async_to_raw_response_wrapper(
+            external_bank_accounts.set_verification_method,
+        )
         self.unpause = _legacy_response.async_to_raw_response_wrapper(
             external_bank_accounts.unpause,
         )
@@ -1404,6 +1519,9 @@ def __init__(self, external_bank_accounts: ExternalBankAccounts) -> None:
         self.retry_prenote = to_streamed_response_wrapper(
             external_bank_accounts.retry_prenote,
         )
+        self.set_verification_method = to_streamed_response_wrapper(
+            external_bank_accounts.set_verification_method,
+        )
         self.unpause = to_streamed_response_wrapper(
             external_bank_accounts.unpause,
         )
@@ -1435,6 +1553,9 @@ def __init__(self, external_bank_accounts: AsyncExternalBankAccounts) -> None:
         self.retry_prenote = async_to_streamed_response_wrapper(
             external_bank_accounts.retry_prenote,
         )
+        self.set_verification_method = async_to_streamed_response_wrapper(
+            external_bank_accounts.set_verification_method,
+        )
         self.unpause = async_to_streamed_response_wrapper(
             external_bank_accounts.unpause,
         )

src/lithic/types/__init__.py

@@ -366,6 +366,9 @@
 from .card_transaction_enhanced_data_updated_webhook_event import (
     CardTransactionEnhancedDataUpdatedWebhookEvent as CardTransactionEnhancedDataUpdatedWebhookEvent,
 )
+from .external_bank_account_set_verification_method_params import (
+    ExternalBankAccountSetVerificationMethodParams as ExternalBankAccountSetVerificationMethodParams,
+)
 from .three_ds_authentication_approval_request_webhook_event import (
     ThreeDSAuthenticationApprovalRequestWebhookEvent as ThreeDSAuthenticationApprovalRequestWebhookEvent,
 )

src/lithic/types/external_bank_account_set_verification_method_params.py

@@ -0,0 +1,18 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Literal, Required, TypedDict
+
+__all__ = ["ExternalBankAccountSetVerificationMethodParams"]
+
+
+class ExternalBankAccountSetVerificationMethodParams(TypedDict, total=False):
+    verification_method: Required[Literal["MICRO_DEPOSIT", "PRENOTE", "EXTERNALLY_VERIFIED"]]
+    """The verification method to set for the external bank account"""
+
+    financial_account_token: str
+    """The financial account token of the operating account to fund the micro deposits.
+
+    Required when verification_method is MICRO_DEPOSIT or PRENOTE.
+    """

tests/api_resources/test_external_bank_accounts.py

@@ -512,6 +512,59 @@ def test_path_params_retry_prenote(self, client: Lithic) -> None:
                 external_bank_account_token="",
             )
 
+    @parametrize
+    def test_method_set_verification_method(self, client: Lithic) -> None:
+        external_bank_account = client.external_bank_accounts.set_verification_method(
+            external_bank_account_token="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+            verification_method="MICRO_DEPOSIT",
+        )
+        assert_matches_type(ExternalBankAccount, external_bank_account, path=["response"])
+
+    @parametrize
+    def test_method_set_verification_method_with_all_params(self, client: Lithic) -> None:
+        external_bank_account = client.external_bank_accounts.set_verification_method(
+            external_bank_account_token="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+            verification_method="MICRO_DEPOSIT",
+            financial_account_token="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+        )
+        assert_matches_type(ExternalBankAccount, external_bank_account, path=["response"])
+
+    @parametrize
+    def test_raw_response_set_verification_method(self, client: Lithic) -> None:
+        response = client.external_bank_accounts.with_raw_response.set_verification_method(
+            external_bank_account_token="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+            verification_method="MICRO_DEPOSIT",
+        )
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        external_bank_account = response.parse()
+        assert_matches_type(ExternalBankAccount, external_bank_account, path=["response"])
+
+    @parametrize
+    def test_streaming_response_set_verification_method(self, client: Lithic) -> None:
+        with client.external_bank_accounts.with_streaming_response.set_verification_method(
+            external_bank_account_token="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+            verification_method="MICRO_DEPOSIT",
+        ) as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            external_bank_account = response.parse()
+            assert_matches_type(ExternalBankAccount, external_bank_account, path=["response"])
+
+        assert cast(Any, response.is_closed) is True
+
+    @parametrize
+    def test_path_params_set_verification_method(self, client: Lithic) -> None:
+        with pytest.raises(
+            ValueError, match=r"Expected a non-empty value for `external_bank_account_token` but received ''"
+        ):
+            client.external_bank_accounts.with_raw_response.set_verification_method(
+                external_bank_account_token="",
+                verification_method="MICRO_DEPOSIT",
+            )
+
     @parametrize
     def test_method_unpause(self, client: Lithic) -> None:
         external_bank_account = client.external_bank_accounts.unpause(
@@ -1044,6 +1097,59 @@ async def test_path_params_retry_prenote(self, async_client: AsyncLithic) -> Non
                 external_bank_account_token="",
             )
 
+    @parametrize
+    async def test_method_set_verification_method(self, async_client: AsyncLithic) -> None:
+        external_bank_account = await async_client.external_bank_accounts.set_verification_method(
+            external_bank_account_token="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+            verification_method="MICRO_DEPOSIT",
+        )
+        assert_matches_type(ExternalBankAccount, external_bank_account, path=["response"])
+
+    @parametrize
+    async def test_method_set_verification_method_with_all_params(self, async_client: AsyncLithic) -> None:
+        external_bank_account = await async_client.external_bank_accounts.set_verification_method(
+            external_bank_account_token="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+            verification_method="MICRO_DEPOSIT",
+            financial_account_token="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+        )
+        assert_matches_type(ExternalBankAccount, external_bank_account, path=["response"])
+
+    @parametrize
+    async def test_raw_response_set_verification_method(self, async_client: AsyncLithic) -> None:
+        response = await async_client.external_bank_accounts.with_raw_response.set_verification_method(
+            external_bank_account_token="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+            verification_method="MICRO_DEPOSIT",
+        )
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        external_bank_account = response.parse()
+        assert_matches_type(ExternalBankAccount, external_bank_account, path=["response"])
+
+    @parametrize
+    async def test_streaming_response_set_verification_method(self, async_client: AsyncLithic) -> None:
+        async with async_client.external_bank_accounts.with_streaming_response.set_verification_method(
+            external_bank_account_token="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+            verification_method="MICRO_DEPOSIT",
+        ) as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            external_bank_account = await response.parse()
+            assert_matches_type(ExternalBankAccount, external_bank_account, path=["response"])
+
+        assert cast(Any, response.is_closed) is True
+
+    @parametrize
+    async def test_path_params_set_verification_method(self, async_client: AsyncLithic) -> None:
+        with pytest.raises(
+            ValueError, match=r"Expected a non-empty value for `external_bank_account_token` but received ''"
+        ):
+            await async_client.external_bank_accounts.with_raw_response.set_verification_method(
+                external_bank_account_token="",
+                verification_method="MICRO_DEPOSIT",
+            )
+
     @parametrize
     async def test_method_unpause(self, async_client: AsyncLithic) -> None:
         external_bank_account = await async_client.external_bank_accounts.unpause(