chore(api): new PaymentEventType for ACH Returns and small updates to 3DS AuthenticationResult (#690)

- adds `ACH_RETURN_SETTLED` to PaymentEventTypes: https://docs.lithic.com/changelog/january-22-2025
- adds `PENDING_CHALLENGE` and `PENDING_DECISION` to 3DS AuthenticationResult. Updates this field to be required and also adds `challenge_orchestrated_by` property

Author: stainless-app[bot]

src/lithic/resources/payments.py

@@ -267,6 +267,7 @@ def simulate_action(
             "ACH_RECEIPT_SETTLED",
             "ACH_RETURN_INITIATED",
             "ACH_RETURN_PROCESSED",
+            "ACH_RETURN_SETTLED",
         ],
         decline_reason: Literal[
             "PROGRAM_TRANSACTION_LIMIT_EXCEEDED", "PROGRAM_DAILY_LIMIT_EXCEEDED", "PROGRAM_MONTHLY_LIMIT_EXCEEDED"
@@ -680,6 +681,7 @@ async def simulate_action(
             "ACH_RECEIPT_SETTLED",
             "ACH_RETURN_INITIATED",
             "ACH_RETURN_PROCESSED",
+            "ACH_RETURN_SETTLED",
         ],
         decline_reason: Literal[
             "PROGRAM_TRANSACTION_LIMIT_EXCEEDED", "PROGRAM_DAILY_LIMIT_EXCEEDED", "PROGRAM_MONTHLY_LIMIT_EXCEEDED"

src/lithic/types/financial_accounts/statements/statement_line_items.py

@@ -50,6 +50,7 @@ class Data(BaseModel):
         "ACH_RECEIPT_SETTLED",
         "ACH_RETURN_INITIATED",
         "ACH_RETURN_PROCESSED",
+        "ACH_RETURN_SETTLED",
         "AUTHORIZATION",
         "AUTHORIZATION_ADVICE",
         "AUTHORIZATION_EXPIRY",

src/lithic/types/financial_transaction.py

@@ -40,6 +40,7 @@ class Event(BaseModel):
             "ACH_RECEIPT_SETTLED",
             "ACH_RETURN_INITIATED",
             "ACH_RETURN_PROCESSED",
+            "ACH_RETURN_SETTLED",
             "AUTHORIZATION",
             "AUTHORIZATION_ADVICE",
             "AUTHORIZATION_EXPIRY",

src/lithic/types/payment.py

@@ -39,6 +39,7 @@ class Event(BaseModel):
         "ACH_RECEIPT_SETTLED",
         "ACH_RETURN_INITIATED",
         "ACH_RETURN_PROCESSED",
+        "ACH_RETURN_SETTLED",
     ]
     """Event types:
 
@@ -58,6 +59,8 @@ class Event(BaseModel):
     - `ACH_RECEIPT_SETTLED` - ACH receipt funds have settled.
     - `ACH_RECEIPT_RELEASED` - ACH receipt released from pending to available
       balance.
+    - `ACH_RETURN_SETTLED` - ACH receipt return settled by the Receiving Depository
+      Financial Institution.
     """
 
     detailed_results: Optional[

src/lithic/types/payment_simulate_action_params.py

@@ -17,6 +17,7 @@ class PaymentSimulateActionParams(TypedDict, total=False):
             "ACH_RECEIPT_SETTLED",
             "ACH_RETURN_INITIATED",
             "ACH_RETURN_PROCESSED",
+            "ACH_RETURN_SETTLED",
         ]
     ]
     """Event Type"""

src/lithic/types/three_ds/authentication_retrieve_response.py

@@ -323,7 +323,7 @@ class AuthenticationRetrieveResponse(BaseModel):
     Maps to EMV 3DS field `acctType`.
     """
 
-    authentication_result: Optional[Literal["DECLINE", "SUCCESS"]] = None
+    authentication_result: Literal["DECLINE", "SUCCESS", "PENDING_CHALLENGE", "PENDING_DECISION"]
     """Indicates the outcome of the 3DS authentication process."""
 
     card_expiry_check: Literal["MATCH", "MISMATCH", "NOT_PRESENT"]
@@ -428,6 +428,9 @@ class AuthenticationRetrieveResponse(BaseModel):
     Present if the channel is 'BROWSER'.
     """
 
+    challenge_orchestrated_by: Optional[Literal["LITHIC", "CUSTOMER", "NO_CHALLENGE"]] = None
+    """Entity that orchestrates the challenge."""
+
     three_ri_request_type: Optional[
         Literal[
             "ACCOUNT_VERIFICATION",

src/lithic/types/transaction.py

@@ -389,16 +389,14 @@ class EventNetworkInfoAcquirer(BaseModel):
 
 class EventNetworkInfoMastercard(BaseModel):
     banknet_reference_number: Optional[str] = None
-    """Identifier assigned by Mastercard."""
+    """Identifier assigned by Mastercard.
 
-    switch_serial_number: Optional[str] = None
-    """
-    Identifier assigned by Mastercard, applicable to single-message transactions
-    only.
+    Guaranteed by Mastercard to be unique for any transaction within a specific
+    financial network on any processing day.
     """
 
     original_banknet_reference_number: Optional[str] = None
-    """[Available on January 28th] Identifier assigned by Mastercard.
+    """Identifier assigned by Mastercard.
 
     Matches the `banknet_reference_number` of a prior related event. May be
     populated in authorization reversals, incremental authorizations (authorization
@@ -413,26 +411,36 @@ class EventNetworkInfoMastercard(BaseModel):
     """
 
     original_switch_serial_number: Optional[str] = None
-    """[Available on January 28th] Identifier assigned by Mastercard.
+    """Identifier assigned by Mastercard.
 
     Matches the `switch_serial_number` of a prior related event. May be populated in
     returns and return reversals. Applicable to single-message transactions only.
     """
 
+    switch_serial_number: Optional[str] = None
+    """
+    Identifier assigned by Mastercard, applicable to single-message transactions
+    only.
+    """
+
 
 class EventNetworkInfoVisa(BaseModel):
-    transaction_id: Optional[str] = None
-    """Identifier assigned by Visa."""
-
     original_transaction_id: Optional[str] = None
-    """[Available on January 28th] Identifier assigned by Visa.
+    """Identifier assigned by Visa.
 
     Matches the `transaction_id` of a prior related event. May be populated in
     incremental authorizations (authorization requests that augment a previously
     authorized amount), authorization advices, financial authorizations, and
     clearings.
     """
 
+    transaction_id: Optional[str] = None
+    """Identifier assigned by Visa to link original messages to subsequent messages.
+
+    Guaranteed by Visa to be unique for each original authorization and financial
+    authorization.
+    """
+
 
 class EventNetworkInfo(BaseModel):
     acquirer: Optional[EventNetworkInfoAcquirer] = None