feat(api): Add Hold API for financial account fund reservations

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 184
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic%2Flithic-df289940d26615072a7c5c9dd4d32b9bc7a86d977642b377c58abbe7a4cb93d0.yml
-openapi_spec_hash: 836bb078df7ac5f8d2dd5081c2e833be
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic%2Flithic-45bd51c1d7885bde620179da56671e3378571e301528c60975604c4fbaa2c800.yml
+openapi_spec_hash: e1355583b829f269875b6f800078a9e0
 config_hash: fb5070d41fcabdedbc084b83964b592a

src/lithic/resources/payments.py

@@ -66,6 +66,7 @@ def create(
         method_attributes: payment_create_params.MethodAttributes,
         type: Literal["COLLECTION", "PAYMENT"],
         token: str | Omit = omit,
+        hold: payment_create_params.Hold | Omit = omit,
         memo: str | Omit = omit,
         user_defined_id: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -82,6 +83,8 @@ def create(
           token: Customer-provided token that will serve as an idempotency token. This token will
               become the transaction token.
 
+          hold: Optional hold to settle when this payment is initiated.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -101,6 +104,7 @@ def create(
                     "method_attributes": method_attributes,
                     "type": type,
                     "token": token,
+                    "hold": hold,
                     "memo": memo,
                     "user_defined_id": user_defined_id,
                 },
@@ -566,6 +570,7 @@ async def create(
         method_attributes: payment_create_params.MethodAttributes,
         type: Literal["COLLECTION", "PAYMENT"],
         token: str | Omit = omit,
+        hold: payment_create_params.Hold | Omit = omit,
         memo: str | Omit = omit,
         user_defined_id: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -582,6 +587,8 @@ async def create(
           token: Customer-provided token that will serve as an idempotency token. This token will
               become the transaction token.
 
+          hold: Optional hold to settle when this payment is initiated.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -601,6 +608,7 @@ async def create(
                     "method_attributes": method_attributes,
                     "type": type,
                     "token": token,
+                    "hold": hold,
                     "memo": memo,
                     "user_defined_id": user_defined_id,
                 },

src/lithic/types/payment_create_params.py

@@ -5,7 +5,7 @@
 from typing import Optional
 from typing_extensions import Literal, Required, TypedDict
 
-__all__ = ["PaymentCreateParams", "MethodAttributes"]
+__all__ = ["PaymentCreateParams", "MethodAttributes", "Hold"]
 
 
 class PaymentCreateParams(TypedDict, total=False):
@@ -27,6 +27,9 @@ class PaymentCreateParams(TypedDict, total=False):
     This token will become the transaction token.
     """
 
+    hold: Hold
+    """Optional hold to settle when this payment is initiated."""
+
     memo: str
 
     user_defined_id: str
@@ -39,3 +42,10 @@ class MethodAttributes(TypedDict, total=False):
     """Number of days to hold the ACH payment"""
 
     addenda: Optional[str]
+
+
+class Hold(TypedDict, total=False):
+    """Optional hold to settle when this payment is initiated."""
+
+    token: Required[str]
+    """Token of the hold to settle when this payment is initiated."""

tests/api_resources/test_payments.py

@@ -53,6 +53,7 @@ def test_method_create_with_all_params(self, client: Lithic) -> None:
             },
             type="COLLECTION",
             token="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+            hold={"token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"},
             memo="memo",
             user_defined_id="user_defined_id",
         )
@@ -475,6 +476,7 @@ async def test_method_create_with_all_params(self, async_client: AsyncLithic) ->
             },
             type="COLLECTION",
             token="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+            hold={"token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"},
             memo="memo",
             user_defined_id="user_defined_id",
         )