o tBhP@sPddlmZddlmZddlmZddlmZddlm Z GdddeZ dS) ) APIHelper) ApiResponse) FileWrapper)BaseApi)OAuth2cs|eZdZdZdfdd Z   dddZddZd d Z dd d Z  dd dZ ddZ ddZ ddZ ddZ ZS) DisputesApiz3A Controller to access Endpoints in the square API.Ncstt|||dSN)superr__init__)selfconfig call_back __class__n/var/www/html/riverr-enterprise-integrations-main/venv/lib/python3.10/site-packages/square/api/disputes_api.pyr szDisputesApi.__init__cCsd}|j}||7}|||d}t||}t|}ddi}|jjj||d} t|j| | | } t | j } t | t urG| d} nd} t| | | d} | S) aDoes a GET request to /v2/disputes. Returns a list of disputes associated with a particular account. Args: cursor (string, optional): A pagination cursor returned by a previous call to this endpoint. Provide this cursor to retrieve the next set of results for the original query. For more information, see [Pagination](https://developer.squareup.com/docs/basics/api101/ pagination). states (DisputeState, optional): The dispute states to filter the result. If not specified, the endpoint returns all open disputes (the dispute status is not `INQUIRY_CLOSED`, `WON`, or `LOST`). location_id (string, optional): The ID of the location for which to return a list of disputes. If not specified, the endpoint returns all open disputes (the dispute status is not `INQUIRY_CLOSED`, `WON`, or `LOST`) associated with all locations. Returns: ApiResponse: An object with the response value as well as other useful information such as status codes and headers. Success Raises: APIException: When an error occurs while fetching the data from the remote API. This exception includes the HTTP Response code, an error message, and the HTTP body that was received in the request. z /v2/disputes)cursorstates location_idacceptapplication/jsonheaderserrorsNbodyr)r get_base_urir append_url_with_query_parameters clean_url http_clientgetrapplyexecute_requestjson_deserializetexttypedictr)r rrr _url_path_query_builder_query_parameters _query_url_headers_request _responsedecoded_errors_resultrrr list_disputess.&      zDisputesApi.list_disputesc Csd}t|d|ddi}|j}||7}t|}ddi}|jjj||d}t|j|| |}t |j }t |t urF|d} nd } t||| d } | S) aDoes a GET request to /v2/disputes/{dispute_id}. Returns details about a specific dispute. Args: dispute_id (string): The ID of the dispute you want more details about. Returns: ApiResponse: An object with the response value as well as other useful information such as status codes and headers. Success Raises: APIException: When an error occurs while fetching the data from the remote API. This exception includes the HTTP Response code, an error message, and the HTTP body that was received in the request. z/v2/disputes/{dispute_id} dispute_idTvalueencoderrrrNrr#append_url_with_template_parametersr rrrr rr!r"r#r$r%r&r r r2r'r(r*r+r,r-r.r/r0rrrretrieve_disputeWs$       zDisputesApi.retrieve_disputec Cd}t|d|ddi}|j}||7}t|}ddi}|jjj||d}t|j|| |}t |j }t |t urF|d} nd } t||| d } | S) uDoes a POST request to /v2/disputes/{dispute_id}/accept. Accepts the loss on a dispute. Square returns the disputed amount to the cardholder and updates the dispute state to ACCEPTED. Square debits the disputed amount from the seller’s Square account. If the Square account does not have sufficient funds, Square debits the associated bank account. Args: dispute_id (string): The ID of the dispute you want to accept. Returns: ApiResponse: An object with the response value as well as other useful information such as status codes and headers. Success Raises: APIException: When an error occurs while fetching the data from the remote API. This exception includes the HTTP Response code, an error message, and the HTTP body that was received in the request. z /v2/disputes/{dispute_id}/acceptr2Tr3rrrrNrrr7r rrrpostrr!r"r#r$r%r&r rr8rrraccept_disputes$       zDisputesApi.accept_disputec Csd}t|d|ddi}|j}||7}d|i}t||}t|}ddi}|jjj||d}t |j|| |} t | j } t | turP| d } nd } t| | | d } | S) aDoes a GET request to /v2/disputes/{dispute_id}/evidence. Returns a list of evidence associated with a dispute. Args: dispute_id (string): The ID of the dispute. cursor (string, optional): A pagination cursor returned by a previous call to this endpoint. Provide this cursor to retrieve the next set of results for the original query. For more information, see [Pagination](https://developer.squareup.com/docs/basics/api101/ pagination). Returns: ApiResponse: An object with the response value as well as other useful information such as status codes and headers. Success Raises: APIException: When an error occurs while fetching the data from the remote API. This exception includes the HTTP Response code, an error message, and the HTTP body that was received in the request. z"/v2/disputes/{dispute_id}/evidencer2Tr3rrrrrNr)rr7r rrrrr rr!r"r#r$r%r&r) r r2rr'r(r)r*r+r,r-r.r/r0rrrlist_dispute_evidences0       z!DisputesApi.list_dispute_evidencecCsd}t|d|ddi}|j}||7}t|}t|tr'|j}|j}n|}d}dt |df|j ||fd} d d i} |jj j || | d } t |j| || } t| j} t| turf| d }nd}t| | |d }|S)a;Does a POST request to /v2/disputes/{dispute_id}/evidence-files. Uploads a file to use as evidence in a dispute challenge. The endpoint accepts HTTP multipart/form-data file uploads in HEIC, HEIF, JPEG, PDF, PNG, and TIFF formats. Args: dispute_id (string): The ID of the dispute you want to upload evidence for. request (CreateDisputeEvidenceFileRequest, optional): Defines the parameters for a `CreateDisputeEvidenceFile` request. image_file (typing.BinaryIO, optional): TODO: type description here. Returns: ApiResponse: An object with the response value as well as other useful information such as status codes and headers. Success Raises: APIException: When an error occurs while fetching the data from the remote API. This exception includes the HTTP Response code, an error message, and the HTTP body that was received in the request. z(/v2/disputes/{dispute_id}/evidence-filesr2Tr3z image/jpegNzapplication/json; charset=utf-8)request image_filerr)rfilesrr)rr7r rr isinstancer file_stream content_typejson_serializenamerr<rr!r"r#r$r%r&r r)r r2r?r@r'r(r*image_file_wrapperimage_file_content_type_filesr+r,r-r.r/r0rrrcreate_dispute_evidence_files4          z(DisputesApi.create_dispute_evidence_filec Csd}t|d|ddi}|j}||7}t|}ddd}|jjj||t|d}t |j|| |}t |j } t | turK| d} nd } t|| | d } | S) aDoes a POST request to /v2/disputes/{dispute_id}/evidence-text. Uploads text to use as evidence for a dispute challenge. Args: dispute_id (string): The ID of the dispute you want to upload evidence for. body (CreateDisputeEvidenceTextRequest): An object containing the fields to POST for the request. See the corresponding object definition for field details. Returns: ApiResponse: An object with the response value as well as other useful information such as status codes and headers. Success Raises: APIException: When an error occurs while fetching the data from the remote API. This exception includes the HTTP Response code, an error message, and the HTTP body that was received in the request. z'/v2/disputes/{dispute_id}/evidence-textr2Tr3r)rz Content-Type)r parametersrNr)rr7r rrrr<rErr!r"r#r$r%r&r r) r r2rr'r(r*r+r,r-r.r/r0rrrcreate_dispute_evidence_textCs&       z(DisputesApi.create_dispute_evidence_textc Csd}t||dd|ddd}|j}||7}t|}ddi}|jjj||d}t|j|| |}t |j } t | t urJ| d} nd } t|| | d } | S) aDoes a DELETE request to /v2/disputes/{dispute_id}/evidence/{evidence_id}. Removes specified evidence from a dispute. Square does not send the bank any evidence that is removed. Also, you cannot remove evidence after submitting it to the bank using [SubmitEvidence]($e/Disputes/SubmitEvidence). Args: dispute_id (string): The ID of the dispute you want to remove evidence from. evidence_id (string): The ID of the evidence you want to remove. Returns: ApiResponse: An object with the response value as well as other useful information such as status codes and headers. Success Raises: APIException: When an error occurs while fetching the data from the remote API. This exception includes the HTTP Response code, an error message, and the HTTP body that was received in the request. 0/v2/disputes/{dispute_id}/evidence/{evidence_id}Tr3r2 evidence_idrrrrNr)rr7r rrrdeleterr!r"r#r$r%r&r r r r2rOr'r(r*r+r,r-r.r/r0rrrdelete_dispute_evidencey&      z#DisputesApi.delete_dispute_evidencec Csd}t||dd|ddd}|j}||7}t|}ddi}|jjj||d}t|j|| |}t |j } t | t urJ| d} nd } t|| | d } | S) aDoes a GET request to /v2/disputes/{dispute_id}/evidence/{evidence_id}. Returns the evidence metadata specified by the evidence ID in the request URL path You must maintain a copy of the evidence you upload if you want to reference it later. You cannot download the evidence after you upload it. Args: dispute_id (string): The ID of the dispute that you want to retrieve evidence from. evidence_id (string): The ID of the evidence to retrieve. Returns: ApiResponse: An object with the response value as well as other useful information such as status codes and headers. Success Raises: APIException: When an error occurs while fetching the data from the remote API. This exception includes the HTTP Response code, an error message, and the HTTP body that was received in the request. rMTr3rNrrrrNrr6rQrrrretrieve_dispute_evidencerSz%DisputesApi.retrieve_dispute_evidencec Cr:) a:Does a POST request to /v2/disputes/{dispute_id}/submit-evidence. Submits evidence to the cardholder's bank. Before submitting evidence, Square compiles all available evidence. This includes evidence uploaded using the [CreateDisputeEvidenceFile]($e/Disputes/CreateDisputeEvidenceFile) and [CreateDisputeEvidenceText]($e/Disputes/CreateDisputeEvidenceText) endpoints and evidence automatically provided by Square, when available. Args: dispute_id (string): The ID of the dispute that you want to submit evidence for. Returns: ApiResponse: An object with the response value as well as other useful information such as status codes and headers. Success Raises: APIException: When an error occurs while fetching the data from the remote API. This exception includes the HTTP Response code, an error message, and the HTTP body that was received in the request. z)/v2/disputes/{dispute_id}/submit-evidencer2Tr3rrrrNrr;r8rrrsubmit_evidences$       zDisputesApi.submit_evidencer)NNN)NN)__name__ __module__ __qualname____doc__r r1r9r=r>rJrLrRrTrU __classcell__rrrrr s$ F18 @ G688rN) square.api_helperrsquare.http.api_responsersquare.utilities.file_wrapperrsquare.api.base_apirsquare.http.auth.o_auth_2rrrrrrs