feat(api): add disputes V2 endpoints

feat(api): add unpause external_bank_accounts API method
feat(api): add return payment method
feat(api): extract some common schemas into models
feat(api): add Tokenization and ACH Rules
fix(api): mark certain optional fields as nullable
fix(api): change allowed phone number length from 18 to 16

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 167
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic%2Flithic-c3f6c23018d70fd1b259b21cfd377b5d905872f0d3c5ce2cdb8013f4b6daa338.yml
-openapi_spec_hash: b551344da9d29eb4c5374874ed84a9b0
-config_hash: 012f050e575d1bbfe8db56a9eeaa5fcd
+configured_endpoints: 171
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic%2Flithic-e1901db484e520cc1f6aa88c8b00d0fcda30c8f9e5ea562a12b9edfc3fb3b6d6.yml
+openapi_spec_hash: 59c317749628f3ed4cc7911b68f6351f
+config_hash: aab05d0cf41f1f6b9f4d5677273c1600

api.md

@@ -7,7 +7,9 @@ from lithic.types import (
     Carrier,
     Currency,
     Document,
+    FinancialEvent,
     InstanceFinancialAccountType,
+    Merchant,
     ShippingAddress,
 )
 ```
@@ -82,9 +84,13 @@ from lithic.types.auth_rules import (
     AuthRule,
     AuthRuleCondition,
     Conditional3DSActionParameters,
+    ConditionalACHActionParameters,
     ConditionalAttribute,
     ConditionalAuthorizationActionParameters,
     ConditionalBlockParameters,
+    ConditionalOperation,
+    ConditionalTokenizationActionParameters,
+    ConditionalValue,
     MerchantLockParameters,
     RuleStats,
     VelocityLimitParams,
@@ -269,30 +275,35 @@ Methods:
 Types:
 
 ```python
-from lithic.types import (
-    Dispute,
-    DisputeEvidence,
-    DisputeCreateResponse,
-    DisputeRetrieveResponse,
-    DisputeUpdateResponse,
-    DisputeListResponse,
-    DisputeDeleteResponse,
-)
+from lithic.types import Dispute, DisputeEvidence
 ```
 
 Methods:
 
-- <code title="post /v1/disputes">client.disputes.<a href="./src/lithic/resources/disputes.py">create</a>(\*\*<a href="src/lithic/types/dispute_create_params.py">params</a>) -> <a href="./src/lithic/types/dispute_create_response.py">DisputeCreateResponse</a></code>
-- <code title="get /v1/disputes/{dispute_token}">client.disputes.<a href="./src/lithic/resources/disputes.py">retrieve</a>(dispute_token) -> <a href="./src/lithic/types/dispute_retrieve_response.py">DisputeRetrieveResponse</a></code>
-- <code title="patch /v1/disputes/{dispute_token}">client.disputes.<a href="./src/lithic/resources/disputes.py">update</a>(dispute_token, \*\*<a href="src/lithic/types/dispute_update_params.py">params</a>) -> <a href="./src/lithic/types/dispute_update_response.py">DisputeUpdateResponse</a></code>
-- <code title="get /v1/disputes">client.disputes.<a href="./src/lithic/resources/disputes.py">list</a>(\*\*<a href="src/lithic/types/dispute_list_params.py">params</a>) -> <a href="./src/lithic/types/dispute_list_response.py">SyncCursorPage[DisputeListResponse]</a></code>
-- <code title="delete /v1/disputes/{dispute_token}">client.disputes.<a href="./src/lithic/resources/disputes.py">delete</a>(dispute_token) -> <a href="./src/lithic/types/dispute_delete_response.py">DisputeDeleteResponse</a></code>
+- <code title="post /v1/disputes">client.disputes.<a href="./src/lithic/resources/disputes.py">create</a>(\*\*<a href="src/lithic/types/dispute_create_params.py">params</a>) -> <a href="./src/lithic/types/dispute.py">Dispute</a></code>
+- <code title="get /v1/disputes/{dispute_token}">client.disputes.<a href="./src/lithic/resources/disputes.py">retrieve</a>(dispute_token) -> <a href="./src/lithic/types/dispute.py">Dispute</a></code>
+- <code title="patch /v1/disputes/{dispute_token}">client.disputes.<a href="./src/lithic/resources/disputes.py">update</a>(dispute_token, \*\*<a href="src/lithic/types/dispute_update_params.py">params</a>) -> <a href="./src/lithic/types/dispute.py">Dispute</a></code>
+- <code title="get /v1/disputes">client.disputes.<a href="./src/lithic/resources/disputes.py">list</a>(\*\*<a href="src/lithic/types/dispute_list_params.py">params</a>) -> <a href="./src/lithic/types/dispute.py">SyncCursorPage[Dispute]</a></code>
+- <code title="delete /v1/disputes/{dispute_token}">client.disputes.<a href="./src/lithic/resources/disputes.py">delete</a>(dispute_token) -> <a href="./src/lithic/types/dispute.py">Dispute</a></code>
 - <code title="delete /v1/disputes/{dispute_token}/evidences/{evidence_token}">client.disputes.<a href="./src/lithic/resources/disputes.py">delete_evidence</a>(evidence_token, \*, dispute_token) -> <a href="./src/lithic/types/dispute_evidence.py">DisputeEvidence</a></code>
 - <code title="post /v1/disputes/{dispute_token}/evidences">client.disputes.<a href="./src/lithic/resources/disputes.py">initiate_evidence_upload</a>(dispute_token, \*\*<a href="src/lithic/types/dispute_initiate_evidence_upload_params.py">params</a>) -> <a href="./src/lithic/types/dispute_evidence.py">DisputeEvidence</a></code>
 - <code title="get /v1/disputes/{dispute_token}/evidences">client.disputes.<a href="./src/lithic/resources/disputes.py">list_evidences</a>(dispute_token, \*\*<a href="src/lithic/types/dispute_list_evidences_params.py">params</a>) -> <a href="./src/lithic/types/dispute_evidence.py">SyncCursorPage[DisputeEvidence]</a></code>
 - <code title="get /v1/disputes/{dispute_token}/evidences/{evidence_token}">client.disputes.<a href="./src/lithic/resources/disputes.py">retrieve_evidence</a>(evidence_token, \*, dispute_token) -> <a href="./src/lithic/types/dispute_evidence.py">DisputeEvidence</a></code>
 - <code>client.disputes.<a href="./src/lithic/resources/disputes.py">upload_evidence</a>(\*args) -> None</code>
 
+# DisputesV2
+
+Types:
+
+```python
+from lithic.types import DisputeV2
+```
+
+Methods:
+
+- <code title="get /v2/disputes/{dispute_token}">client.disputes_v2.<a href="./src/lithic/resources/disputes_v2.py">retrieve</a>(dispute_token) -> <a href="./src/lithic/types/dispute_v2.py">DisputeV2</a></code>
+- <code title="get /v2/disputes">client.disputes_v2.<a href="./src/lithic/resources/disputes_v2.py">list</a>(\*\*<a href="src/lithic/types/disputes_v2_list_params.py">params</a>) -> <a href="./src/lithic/types/dispute_v2.py">SyncCursorPage[DisputeV2]</a></code>
+
 # Events
 
 Types:
@@ -341,7 +352,7 @@ Methods:
 Types:
 
 ```python
-from lithic.types import FinancialAccount, FinancialTransaction
+from lithic.types import CategoryDetails, FinancialAccount, FinancialTransaction, StatementTotals
 ```
 
 Methods:
@@ -415,7 +426,7 @@ Methods:
 Types:
 
 ```python
-from lithic.types.financial_accounts import LoanTape
+from lithic.types.financial_accounts import CategoryBalances, LoanTape
 ```
 
 Methods:
@@ -517,6 +528,7 @@ from lithic.types import (
     ExternalBankAccountListResponse,
     ExternalBankAccountRetryMicroDepositsResponse,
     ExternalBankAccountRetryPrenoteResponse,
+    ExternalBankAccountUnpauseResponse,
 )
 ```
 
@@ -528,6 +540,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_retry_prenote_response.py">ExternalBankAccountRetryPrenoteResponse</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_unpause_response.py">ExternalBankAccountUnpauseResponse</a></code>
 
 ## MicroDeposits
 
@@ -550,6 +563,7 @@ from lithic.types import (
     Payment,
     PaymentCreateResponse,
     PaymentRetryResponse,
+    PaymentReturnResponse,
     PaymentSimulateActionResponse,
     PaymentSimulateReceiptResponse,
     PaymentSimulateReleaseResponse,
@@ -563,6 +577,7 @@ Methods:
 - <code title="get /v1/payments/{payment_token}">client.payments.<a href="./src/lithic/resources/payments.py">retrieve</a>(payment_token) -> <a href="./src/lithic/types/payment.py">Payment</a></code>
 - <code title="get /v1/payments">client.payments.<a href="./src/lithic/resources/payments.py">list</a>(\*\*<a href="src/lithic/types/payment_list_params.py">params</a>) -> <a href="./src/lithic/types/payment.py">SyncCursorPage[Payment]</a></code>
 - <code title="post /v1/payments/{payment_token}/retry">client.payments.<a href="./src/lithic/resources/payments.py">retry</a>(payment_token) -> <a href="./src/lithic/types/payment_retry_response.py">PaymentRetryResponse</a></code>
+- <code title="post /v1/payments/{payment_token}/return">client.payments.<a href="./src/lithic/resources/payments.py">return\_</a>(payment_token, \*\*<a href="src/lithic/types/payment_return_params.py">params</a>) -> <a href="./src/lithic/types/payment_return_response.py">PaymentReturnResponse</a></code>
 - <code title="post /v1/simulate/payments/{payment_token}/action">client.payments.<a href="./src/lithic/resources/payments.py">simulate_action</a>(payment_token, \*\*<a href="src/lithic/types/payment_simulate_action_params.py">params</a>) -> <a href="./src/lithic/types/payment_simulate_action_response.py">PaymentSimulateActionResponse</a></code>
 - <code title="post /v1/simulate/payments/receipt">client.payments.<a href="./src/lithic/resources/payments.py">simulate_receipt</a>(\*\*<a href="src/lithic/types/payment_simulate_receipt_params.py">params</a>) -> <a href="./src/lithic/types/payment_simulate_receipt_response.py">PaymentSimulateReceiptResponse</a></code>
 - <code title="post /v1/simulate/payments/release">client.payments.<a href="./src/lithic/resources/payments.py">simulate_release</a>(\*\*<a href="src/lithic/types/payment_simulate_release_params.py">params</a>) -> <a href="./src/lithic/types/payment_simulate_release_response.py">PaymentSimulateReleaseResponse</a></code>

examples/upload_evidence.py

@@ -6,7 +6,7 @@
 #   1. Install Rye and setup a Python virtual environment: ./scripts/bootstrap
 #   2. Run the example: LITHIC_API_KEY=<your_api_key> rye run python examples/upload_evidence.py
 from lithic import Lithic, file_from_path
-from lithic.types import DisputeListResponse, DisputeCreateResponse
+from lithic.types import Dispute
 
 client = Lithic(environment="sandbox")
 
@@ -17,7 +17,7 @@
 assert transaction.token, "Transaction must have a token"
 
 disputes_page = client.disputes.list()
-dispute: DisputeCreateResponse | DisputeListResponse | None = disputes_page.data[0] if disputes_page.data else None
+dispute: Dispute | None = disputes_page.data[0] if disputes_page.data else None
 if not dispute:
     dispute = client.disputes.create(
         amount=42,

src/lithic/_client.py

@@ -49,6 +49,7 @@
         three_ds,
         webhooks,
         auth_rules,
+        disputes_v2,
         transactions,
         card_programs,
         tokenizations,
@@ -73,6 +74,7 @@
     from .resources.disputes import Disputes, AsyncDisputes
     from .resources.payments import Payments, AsyncPayments
     from .resources.cards.cards import Cards, AsyncCards
+    from .resources.disputes_v2 import DisputesV2, AsyncDisputesV2
     from .resources.fraud.fraud import Fraud, AsyncFraud
     from .resources.card_programs import CardPrograms, AsyncCardPrograms
     from .resources.events.events import Events, AsyncEvents
@@ -262,6 +264,12 @@ def disputes(self) -> Disputes:
 
         return Disputes(self)
 
+    @cached_property
+    def disputes_v2(self) -> DisputesV2:
+        from .resources.disputes_v2 import DisputesV2
+
+        return DisputesV2(self)
+
     @cached_property
     def events(self) -> Events:
         from .resources.events import Events
@@ -660,6 +668,12 @@ def disputes(self) -> AsyncDisputes:
 
         return AsyncDisputes(self)
 
+    @cached_property
+    def disputes_v2(self) -> AsyncDisputesV2:
+        from .resources.disputes_v2 import AsyncDisputesV2
+
+        return AsyncDisputesV2(self)
+
     @cached_property
     def events(self) -> AsyncEvents:
         from .resources.events import AsyncEvents
@@ -981,6 +995,12 @@ def disputes(self) -> disputes.DisputesWithRawResponse:
 
         return DisputesWithRawResponse(self._client.disputes)
 
+    @cached_property
+    def disputes_v2(self) -> disputes_v2.DisputesV2WithRawResponse:
+        from .resources.disputes_v2 import DisputesV2WithRawResponse
+
+        return DisputesV2WithRawResponse(self._client.disputes_v2)
+
     @cached_property
     def events(self) -> events.EventsWithRawResponse:
         from .resources.events import EventsWithRawResponse
@@ -1160,6 +1180,12 @@ def disputes(self) -> disputes.AsyncDisputesWithRawResponse:
 
         return AsyncDisputesWithRawResponse(self._client.disputes)
 
+    @cached_property
+    def disputes_v2(self) -> disputes_v2.AsyncDisputesV2WithRawResponse:
+        from .resources.disputes_v2 import AsyncDisputesV2WithRawResponse
+
+        return AsyncDisputesV2WithRawResponse(self._client.disputes_v2)
+
     @cached_property
     def events(self) -> events.AsyncEventsWithRawResponse:
         from .resources.events import AsyncEventsWithRawResponse
@@ -1339,6 +1365,12 @@ def disputes(self) -> disputes.DisputesWithStreamingResponse:
 
         return DisputesWithStreamingResponse(self._client.disputes)
 
+    @cached_property
+    def disputes_v2(self) -> disputes_v2.DisputesV2WithStreamingResponse:
+        from .resources.disputes_v2 import DisputesV2WithStreamingResponse
+
+        return DisputesV2WithStreamingResponse(self._client.disputes_v2)
+
     @cached_property
     def events(self) -> events.EventsWithStreamingResponse:
         from .resources.events import EventsWithStreamingResponse
@@ -1518,6 +1550,12 @@ def disputes(self) -> disputes.AsyncDisputesWithStreamingResponse:
 
         return AsyncDisputesWithStreamingResponse(self._client.disputes)
 
+    @cached_property
+    def disputes_v2(self) -> disputes_v2.AsyncDisputesV2WithStreamingResponse:
+        from .resources.disputes_v2 import AsyncDisputesV2WithStreamingResponse
+
+        return AsyncDisputesV2WithStreamingResponse(self._client.disputes_v2)
+
     @cached_property
     def events(self) -> events.AsyncEventsWithStreamingResponse:
         from .resources.events import AsyncEventsWithStreamingResponse

src/lithic/resources/__init__.py

@@ -81,6 +81,14 @@
     AuthRulesWithStreamingResponse,
     AsyncAuthRulesWithStreamingResponse,
 )
+from .disputes_v2 import (
+    DisputesV2,
+    AsyncDisputesV2,
+    DisputesV2WithRawResponse,
+    AsyncDisputesV2WithRawResponse,
+    DisputesV2WithStreamingResponse,
+    AsyncDisputesV2WithStreamingResponse,
+)
 from .transactions import (
     Transactions,
     AsyncTransactions,
@@ -287,6 +295,12 @@
     "AsyncDisputesWithRawResponse",
     "DisputesWithStreamingResponse",
     "AsyncDisputesWithStreamingResponse",
+    "DisputesV2",
+    "AsyncDisputesV2",
+    "DisputesV2WithRawResponse",
+    "AsyncDisputesV2WithRawResponse",
+    "DisputesV2WithStreamingResponse",
+    "AsyncDisputesV2WithStreamingResponse",
     "Events",
     "AsyncEvents",
     "EventsWithRawResponse",