chore(api): new 3DS Event and new challenge_metadata property on Authentications (#695)

stainless-app[bot] · stainless-app[bot] · commit 276e85f3693f · 2025-02-14T05:11:10.000Z
- adds `three_ds_authentication.updated` Event
- adds `challenge_metadata` to Authentications
diff --git a/src/lithic/resources/events/events.py b/src/lithic/resources/events/events.py
@@ -130,6 +130,7 @@ def list(
                 "settlement_report.updated",
                 "statements.created",
                 "three_ds_authentication.created",
+                "three_ds_authentication.updated",
                 "tokenization.approval_request",
                 "tokenization.result",
                 "tokenization.two_factor_authentication_code",
@@ -387,6 +388,7 @@ def list(
                 "settlement_report.updated",
                 "statements.created",
                 "three_ds_authentication.created",
+                "three_ds_authentication.updated",
                 "tokenization.approval_request",
                 "tokenization.result",
                 "tokenization.two_factor_authentication_code",
diff --git a/src/lithic/resources/events/subscriptions.py b/src/lithic/resources/events/subscriptions.py
@@ -97,6 +97,7 @@ def create(
                 "settlement_report.updated",
                 "statements.created",
                 "three_ds_authentication.created",
+                "three_ds_authentication.updated",
                 "tokenization.approval_request",
                 "tokenization.result",
                 "tokenization.two_factor_authentication_code",
@@ -228,6 +229,7 @@ def update(
                 "settlement_report.updated",
                 "statements.created",
                 "three_ds_authentication.created",
+                "three_ds_authentication.updated",
                 "tokenization.approval_request",
                 "tokenization.result",
                 "tokenization.two_factor_authentication_code",
@@ -665,6 +667,7 @@ def send_simulated_example(
             "settlement_report.updated",
             "statements.created",
             "three_ds_authentication.created",
+            "three_ds_authentication.updated",
             "tokenization.approval_request",
             "tokenization.result",
             "tokenization.two_factor_authentication_code",
@@ -772,6 +775,7 @@ async def create(
                 "settlement_report.updated",
                 "statements.created",
                 "three_ds_authentication.created",
+                "three_ds_authentication.updated",
                 "tokenization.approval_request",
                 "tokenization.result",
                 "tokenization.two_factor_authentication_code",
@@ -903,6 +907,7 @@ async def update(
                 "settlement_report.updated",
                 "statements.created",
                 "three_ds_authentication.created",
+                "three_ds_authentication.updated",
                 "tokenization.approval_request",
                 "tokenization.result",
                 "tokenization.two_factor_authentication_code",
@@ -1340,6 +1345,7 @@ async def send_simulated_example(
             "settlement_report.updated",
             "statements.created",
             "three_ds_authentication.created",
+            "three_ds_authentication.updated",
             "tokenization.approval_request",
             "tokenization.result",
             "tokenization.two_factor_authentication_code",
diff --git a/src/lithic/resources/external_bank_accounts/external_bank_accounts.py b/src/lithic/resources/external_bank_accounts/external_bank_accounts.py
@@ -408,6 +408,7 @@ def update(
         name: str | NotGiven = NOT_GIVEN,
         owner: str | NotGiven = NOT_GIVEN,
         owner_type: OwnerType | NotGiven = NOT_GIVEN,
+        type: Literal["CHECKING", "SAVINGS"] | NotGiven = NOT_GIVEN,
         user_defined_id: str | NotGiven = NOT_GIVEN,
         # 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.
@@ -460,6 +461,7 @@ def update(
                     "name": name,
                     "owner": owner,
                     "owner_type": owner_type,
+                    "type": type,
                     "user_defined_id": user_defined_id,
                 },
                 external_bank_account_update_params.ExternalBankAccountUpdateParams,
@@ -975,6 +977,7 @@ async def update(
         name: str | NotGiven = NOT_GIVEN,
         owner: str | NotGiven = NOT_GIVEN,
         owner_type: OwnerType | NotGiven = NOT_GIVEN,
+        type: Literal["CHECKING", "SAVINGS"] | NotGiven = NOT_GIVEN,
         user_defined_id: str | NotGiven = NOT_GIVEN,
         # 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.
@@ -1027,6 +1030,7 @@ async def update(
                     "name": name,
                     "owner": owner,
                     "owner_type": owner_type,
+                    "type": type,
                     "user_defined_id": user_defined_id,
                 },
                 external_bank_account_update_params.ExternalBankAccountUpdateParams,
diff --git a/src/lithic/types/event.py b/src/lithic/types/event.py
@@ -54,6 +54,7 @@ class Event(BaseModel):
         "settlement_report.updated",
         "statements.created",
         "three_ds_authentication.created",
+        "three_ds_authentication.updated",
         "tokenization.approval_request",
         "tokenization.result",
         "tokenization.two_factor_authentication_code",
diff --git a/src/lithic/types/event_list_params.py b/src/lithic/types/event_list_params.py
@@ -66,6 +66,7 @@ class EventListParams(TypedDict, total=False):
             "settlement_report.updated",
             "statements.created",
             "three_ds_authentication.created",
+            "three_ds_authentication.updated",
             "tokenization.approval_request",
             "tokenization.result",
             "tokenization.two_factor_authentication_code",
diff --git a/src/lithic/types/event_subscription.py b/src/lithic/types/event_subscription.py
@@ -57,6 +57,7 @@ class EventSubscription(BaseModel):
                 "settlement_report.updated",
                 "statements.created",
                 "three_ds_authentication.created",
+                "three_ds_authentication.updated",
                 "tokenization.approval_request",
                 "tokenization.result",
                 "tokenization.two_factor_authentication_code",
diff --git a/src/lithic/types/events/subscription_create_params.py b/src/lithic/types/events/subscription_create_params.py
@@ -54,6 +54,7 @@ class SubscriptionCreateParams(TypedDict, total=False):
             "settlement_report.updated",
             "statements.created",
             "three_ds_authentication.created",
+            "three_ds_authentication.updated",
             "tokenization.approval_request",
             "tokenization.result",
             "tokenization.two_factor_authentication_code",
diff --git a/src/lithic/types/events/subscription_send_simulated_example_params.py b/src/lithic/types/events/subscription_send_simulated_example_params.py
@@ -43,6 +43,7 @@ class SubscriptionSendSimulatedExampleParams(TypedDict, total=False):
         "settlement_report.updated",
         "statements.created",
         "three_ds_authentication.created",
+        "three_ds_authentication.updated",
         "tokenization.approval_request",
         "tokenization.result",
         "tokenization.two_factor_authentication_code",
diff --git a/src/lithic/types/events/subscription_update_params.py b/src/lithic/types/events/subscription_update_params.py
@@ -54,6 +54,7 @@ class SubscriptionUpdateParams(TypedDict, total=False):
             "settlement_report.updated",
             "statements.created",
             "three_ds_authentication.created",
+            "three_ds_authentication.updated",
             "tokenization.approval_request",
             "tokenization.result",
             "tokenization.two_factor_authentication_code",
diff --git a/src/lithic/types/external_bank_account_update_params.py b/src/lithic/types/external_bank_account_update_params.py
@@ -4,7 +4,7 @@
 
 from typing import Union
 from datetime import date
-from typing_extensions import Annotated, TypedDict
+from typing_extensions import Literal, Annotated, TypedDict
 
 from .._utils import PropertyInfo
 from .owner_type import OwnerType
@@ -38,6 +38,8 @@ class ExternalBankAccountUpdateParams(TypedDict, total=False):
     owner_type: OwnerType
     """Owner Type"""
 
+    type: Literal["CHECKING", "SAVINGS"]
+
     user_defined_id: str
     """User Defined ID"""
 
diff --git a/src/lithic/types/three_ds/authentication_retrieve_response.py b/src/lithic/types/three_ds/authentication_retrieve_response.py
@@ -16,6 +16,7 @@
     "AdditionalData",
     "App",
     "Browser",
+    "ChallengeMetadata",
     "Transaction",
 ]
 
@@ -276,6 +277,14 @@ class Browser(BaseModel):
     """Content of the HTTP user-agent header. Maps to EMV 3DS field browserUserAgent."""
 
 
+class ChallengeMetadata(BaseModel):
+    method_type: Literal["SMS_OTP", "OUT_OF_BAND"]
+    """The type of challenge method used for authentication."""
+
+    phone_number: Optional[str] = None
+    """The phone number used for delivering the OTP. Relevant only for SMS_OTP method."""
+
+
 class Transaction(BaseModel):
     amount: float
     """Amount of the purchase in minor units of currency with all punctuation removed.
@@ -350,11 +359,6 @@ class AuthenticationRetrieveResponse(BaseModel):
     created: datetime
     """Date and time when the authentication was created in Lithic's system."""
 
-    decision_made_by: Optional[Literal["CUSTOMER_ENDPOINT", "LITHIC_DEFAULT", "LITHIC_RULES", "NETWORK", "UNKNOWN"]] = (
-        None
-    )
-    """Entity that made the authentication decision."""
-
     merchant: Merchant
     """
     Object containing data about the merchant involved in the e-commerce
@@ -428,9 +432,17 @@ class AuthenticationRetrieveResponse(BaseModel):
     Present if the channel is 'BROWSER'.
     """
 
+    challenge_metadata: Optional[ChallengeMetadata] = None
+    """Metadata about the challenge method and delivery."""
+
     challenge_orchestrated_by: Optional[Literal["LITHIC", "CUSTOMER", "NO_CHALLENGE"]] = None
     """Entity that orchestrates the challenge."""
 
+    decision_made_by: Optional[Literal["CUSTOMER_ENDPOINT", "LITHIC_DEFAULT", "LITHIC_RULES", "NETWORK", "UNKNOWN"]] = (
+        None
+    )
+    """Entity that made the authentication decision."""
+
     three_ri_request_type: Optional[
         Literal[
             "ACCOUNT_VERIFICATION",
diff --git a/tests/api_resources/test_external_bank_accounts.py b/tests/api_resources/test_external_bank_accounts.py
@@ -311,6 +311,7 @@ def test_method_update_with_all_params(self, client: Lithic) -> None:
             name="name",
             owner="owner",
             owner_type="INDIVIDUAL",
+            type="CHECKING",
             user_defined_id="x",
         )
         assert_matches_type(ExternalBankAccountUpdateResponse, external_bank_account, path=["response"])
@@ -775,6 +776,7 @@ async def test_method_update_with_all_params(self, async_client: AsyncLithic) ->
             name="name",
             owner="owner",
             owner_type="INDIVIDUAL",
+            type="CHECKING",
             user_defined_id="x",
         )
         assert_matches_type(ExternalBankAccountUpdateResponse, external_bank_account, path=["response"])
