feat(api): add WIRE category, wire events, remove remittance_information from payment

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 188
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic%2Flithic-b0ae5fc46338788b5191870fa233397a5624402f6f30177574fc824c2d6d235f.yml
-openapi_spec_hash: 13b104665e60f7d755b0483eb2e8a344
-config_hash: 7daa8d0d03697920c0c1ca18ce6d4594
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic%2Flithic-716063c7d5d29dd3904168352017d0a065e50eec066f78ed8a3f7c796a48a78b.yml
+openapi_spec_hash: 3d930f469199651974e9bfbee65486ef
+config_hash: 8799cfd589579f105ef8696a6d664c71

src/lithic/resources/account_activity.py

@@ -51,6 +51,7 @@ def list(
         business_account_token: str | Omit = omit,
         category: Literal[
             "ACH",
+            "WIRE",
             "BALANCE_OR_FUNDING",
             "FEE",
             "REWARD",
@@ -222,6 +223,7 @@ def list(
         business_account_token: str | Omit = omit,
         category: Literal[
             "ACH",
+            "WIRE",
             "BALANCE_OR_FUNDING",
             "FEE",
             "REWARD",

src/lithic/types/account_activity_list_params.py

@@ -26,6 +26,7 @@ class AccountActivityListParams(TypedDict, total=False):
 
     category: Literal[
         "ACH",
+        "WIRE",
         "BALANCE_OR_FUNDING",
         "FEE",
         "REWARD",

src/lithic/types/account_activity_list_response.py

@@ -25,6 +25,7 @@ class FinancialTransaction(BaseModel):
 
     category: Literal[
         "ACH",
+        "WIRE",
         "BALANCE_OR_FUNDING",
         "FEE",
         "REWARD",

src/lithic/types/account_activity_retrieve_transaction_response.py

@@ -25,6 +25,7 @@ class FinancialTransaction(BaseModel):
 
     category: Literal[
         "ACH",
+        "WIRE",
         "BALANCE_OR_FUNDING",
         "FEE",
         "REWARD",

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

@@ -18,6 +18,7 @@ class Data(BaseModel):
 
     category: Literal[
         "ACH",
+        "WIRE",
         "BALANCE_OR_FUNDING",
         "FEE",
         "REWARD",
@@ -39,6 +40,11 @@ class Data(BaseModel):
         "HOLD",
         "PROGRAM_FUNDING",
     ]
+    """
+    Note: Inbound wire transfers are coming soon (availability varies by partner
+    bank). The WIRE category is a preview. To learn more, contact your customer
+    success manager.
+    """
 
     created: datetime
     """Timestamp of when the line item was generated"""

src/lithic/types/payment.py

@@ -18,7 +18,11 @@
 
 
 class Event(BaseModel):
-    """Payment Event"""
+    """
+    Note: Inbound wire transfers are coming soon (availability varies by partner bank). Wire-related fields below are a preview. To learn more, contact your customer success manager.
+
+    Payment Event
+    """
 
     token: str
     """Globally unique identifier."""
@@ -54,8 +58,22 @@ class Event(BaseModel):
         "ACH_RETURN_PROCESSED",
         "ACH_RETURN_REJECTED",
         "ACH_RETURN_SETTLED",
+        "WIRE_TRANSFER_INBOUND_RECEIVED",
+        "WIRE_TRANSFER_INBOUND_SETTLED",
+        "WIRE_TRANSFER_INBOUND_BLOCKED",
+        "WIRE_RETURN_OUTBOUND_INITIATED",
+        "WIRE_RETURN_OUTBOUND_SENT",
+        "WIRE_RETURN_OUTBOUND_SETTLED",
+        "WIRE_RETURN_OUTBOUND_REJECTED",
     ]
-    """Event types:
+    """
+    Note: Inbound wire transfers are coming soon (availability varies by partner
+    bank). Wire-related event types below are a preview. To learn more, contact your
+    customer success manager.
+
+    Event types:
+
+    ACH events:
 
     - `ACH_ORIGINATION_INITIATED` - ACH origination received and pending
       approval/release from an ACH hold.
@@ -81,6 +99,26 @@ class Event(BaseModel):
       Financial Institution.
     - `ACH_RETURN_REJECTED` - ACH return was rejected by the Receiving Depository
       Financial Institution.
+
+    Wire transfer events:
+
+    - `WIRE_TRANSFER_INBOUND_RECEIVED` - Inbound wire transfer received from the
+      Federal Reserve and pending release to available balance.
+    - `WIRE_TRANSFER_INBOUND_SETTLED` - Inbound wire transfer funds released from
+      pending to available balance.
+    - `WIRE_TRANSFER_INBOUND_BLOCKED` - Inbound wire transfer blocked and funds
+      frozen for regulatory review.
+
+    Wire return events:
+
+    - `WIRE_RETURN_OUTBOUND_INITIATED` - Outbound wire return initiated to return
+      funds from an inbound wire transfer.
+    - `WIRE_RETURN_OUTBOUND_SENT` - Outbound wire return sent to the Federal Reserve
+      and pending acceptance.
+    - `WIRE_RETURN_OUTBOUND_SETTLED` - Outbound wire return accepted by the Federal
+      Reserve and funds returned to sender.
+    - `WIRE_RETURN_OUTBOUND_REJECTED` - Outbound wire return rejected by the Federal
+      Reserve.
     """
 
     detailed_results: Optional[
@@ -99,7 +137,11 @@ class Event(BaseModel):
     """More detailed reasons for the event"""
 
     external_id: Optional[str] = None
-    """Payment event external ID, for example, ACH trace number."""
+    """Payment event external ID.
+
+    For ACH transactions, this is the ACH trace number. For inbound wire transfers,
+    this is the IMAD (Input Message Accountability Data).
+    """
 
 
 class MethodAttributesACHMethodAttributes(BaseModel):
@@ -145,9 +187,6 @@ class MethodAttributesWireMethodAttributes(BaseModel):
     for tracking the message through the Fedwire system
     """
 
-    remittance_information: Optional[str] = None
-    """Payment details or invoice reference"""
-
 
 MethodAttributes: TypeAlias = Union[MethodAttributesACHMethodAttributes, MethodAttributesWireMethodAttributes]
 
@@ -170,6 +209,7 @@ class Payment(BaseModel):
 
     category: Literal[
         "ACH",
+        "WIRE",
         "BALANCE_OR_FUNDING",
         "FEE",
         "REWARD",