feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 227
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/increase%2Fincrease-63db8a5872b6a112abfc879f75a53bc6975994025752e86b27ab327884d94655.yml
-openapi_spec_hash: b7ffb71e0102fcd040a575bf917656e3
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/increase%2Fincrease-4e978c9426fb846c81f3169f5c1bc7aad137577c13e52ac48fcc756e613a1557.yml
+openapi_spec_hash: b44f228e3feac325305cd744c072ebc9
 config_hash: ca52ca9a2968f330339fd50c1a386e05

src/increase/resources/card_disputes.py

@@ -52,6 +52,7 @@ def create(
         network: Literal["visa"],
         amount: int | Omit = omit,
         attachment_files: Iterable[card_dispute_create_params.AttachmentFile] | Omit = omit,
+        explanation: str | Omit = omit,
         visa: card_dispute_create_params.Visa | Omit = omit,
         # 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.
@@ -80,6 +81,9 @@ def create(
 
           attachment_files: The files to be attached to the initial dispute submission.
 
+          explanation: The free-form explanation provided to Increase to provide more context for the
+              user submission. This field is not sent directly to the card networks.
+
           visa: The Visa-specific parameters for the dispute. Required if and only if `network`
               is `visa`.
 
@@ -101,6 +105,7 @@ def create(
                     "network": network,
                     "amount": amount,
                     "attachment_files": attachment_files,
+                    "explanation": explanation,
                     "visa": visa,
                 },
                 card_dispute_create_params.CardDisputeCreateParams,
@@ -216,6 +221,7 @@ def submit_user_submission(
         network: Literal["visa"],
         amount: int | Omit = omit,
         attachment_files: Iterable[card_dispute_submit_user_submission_params.AttachmentFile] | Omit = omit,
+        explanation: str | Omit = omit,
         visa: card_dispute_submit_user_submission_params.Visa | Omit = omit,
         # 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.
@@ -243,6 +249,9 @@ def submit_user_submission(
 
           attachment_files: The files to be attached to the user submission.
 
+          explanation: The free-form explanation provided to Increase to provide more context for the
+              user submission. This field is not sent directly to the card networks.
+
           visa: The Visa-specific parameters for the dispute. Required if and only if `network`
               is `visa`.
 
@@ -265,6 +274,7 @@ def submit_user_submission(
                     "network": network,
                     "amount": amount,
                     "attachment_files": attachment_files,
+                    "explanation": explanation,
                     "visa": visa,
                 },
                 card_dispute_submit_user_submission_params.CardDisputeSubmitUserSubmissionParams,
@@ -349,6 +359,7 @@ async def create(
         network: Literal["visa"],
         amount: int | Omit = omit,
         attachment_files: Iterable[card_dispute_create_params.AttachmentFile] | Omit = omit,
+        explanation: str | Omit = omit,
         visa: card_dispute_create_params.Visa | Omit = omit,
         # 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.
@@ -377,6 +388,9 @@ async def create(
 
           attachment_files: The files to be attached to the initial dispute submission.
 
+          explanation: The free-form explanation provided to Increase to provide more context for the
+              user submission. This field is not sent directly to the card networks.
+
           visa: The Visa-specific parameters for the dispute. Required if and only if `network`
               is `visa`.
 
@@ -398,6 +412,7 @@ async def create(
                     "network": network,
                     "amount": amount,
                     "attachment_files": attachment_files,
+                    "explanation": explanation,
                     "visa": visa,
                 },
                 card_dispute_create_params.CardDisputeCreateParams,
@@ -513,6 +528,7 @@ async def submit_user_submission(
         network: Literal["visa"],
         amount: int | Omit = omit,
         attachment_files: Iterable[card_dispute_submit_user_submission_params.AttachmentFile] | Omit = omit,
+        explanation: str | Omit = omit,
         visa: card_dispute_submit_user_submission_params.Visa | Omit = omit,
         # 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.
@@ -540,6 +556,9 @@ async def submit_user_submission(
 
           attachment_files: The files to be attached to the user submission.
 
+          explanation: The free-form explanation provided to Increase to provide more context for the
+              user submission. This field is not sent directly to the card networks.
+
           visa: The Visa-specific parameters for the dispute. Required if and only if `network`
               is `visa`.
 
@@ -562,6 +581,7 @@ async def submit_user_submission(
                     "network": network,
                     "amount": amount,
                     "attachment_files": attachment_files,
+                    "explanation": explanation,
                     "visa": visa,
                 },
                 card_dispute_submit_user_submission_params.CardDisputeSubmitUserSubmissionParams,

src/increase/types/card_dispute.py

@@ -2533,6 +2533,12 @@ class VisaUserSubmission(BaseModel):
     the Visa Card Dispute User Submission was created.
     """
 
+    explanation: Optional[str] = None
+    """
+    The free-form explanation provided to Increase to provide more context for the
+    user submission. This field is not sent directly to the card networks.
+    """
+
     further_information_requested_at: Optional[datetime] = None
     """
     The date and time at which Increase requested further information from the user

src/increase/types/card_dispute_create_params.py

@@ -100,6 +100,12 @@ class CardDisputeCreateParams(TypedDict, total=False):
     attachment_files: Iterable[AttachmentFile]
     """The files to be attached to the initial dispute submission."""
 
+    explanation: str
+    """
+    The free-form explanation provided to Increase to provide more context for the
+    user submission. This field is not sent directly to the card networks.
+    """
+
     visa: Visa
     """The Visa-specific parameters for the dispute.
 

src/increase/types/card_dispute_submit_user_submission_params.py

@@ -98,6 +98,12 @@ class CardDisputeSubmitUserSubmissionParams(TypedDict, total=False):
     attachment_files: Iterable[AttachmentFile]
     """The files to be attached to the user submission."""
 
+    explanation: str
+    """
+    The free-form explanation provided to Increase to provide more context for the
+    user submission. This field is not sent directly to the card networks.
+    """
+
     visa: Visa
     """The Visa-specific parameters for the dispute.
 

tests/api_resources/test_card_disputes.py

@@ -36,6 +36,7 @@ def test_method_create_with_all_params(self, client: Increase) -> None:
             network="visa",
             amount=100,
             attachment_files=[{"file_id": "file_id"}],
+            explanation="x",
             visa={
                 "category": "fraud",
                 "authorization": {"account_status": "account_closed"},
@@ -400,6 +401,7 @@ def test_method_submit_user_submission_with_all_params(self, client: Increase) -
             network="visa",
             amount=1,
             attachment_files=[{"file_id": "file_id"}],
+            explanation="x",
             visa={
                 "category": "merchant_prearbitration_decline",
                 "chargeback": {
@@ -750,6 +752,7 @@ async def test_method_create_with_all_params(self, async_client: AsyncIncrease)
             network="visa",
             amount=100,
             attachment_files=[{"file_id": "file_id"}],
+            explanation="x",
             visa={
                 "category": "fraud",
                 "authorization": {"account_status": "account_closed"},
@@ -1114,6 +1117,7 @@ async def test_method_submit_user_submission_with_all_params(self, async_client:
             network="visa",
             amount=1,
             attachment_files=[{"file_id": "file_id"}],
+            explanation="x",
             visa={
                 "category": "merchant_prearbitration_decline",
                 "chargeback": {