Square API
You are viewing an old version of the API
Disputes
Square API
Use the Disputes API to manage disputes (chargebacks).
A seller has the following options to process a dispute:
- Accept the dispute using the AcceptDispute endpoint. Square returns the disputed amount from the account balance of the Square account.
- Challenge the dispute using the SubmitEvidence endpoint. If the payment was valid, you can contest the disputed payment. You submit supporting evidence you have about the transaction, such as receipts, invoices, email correspondence, proof of delivery, or photos. You upload evidence using the CreateDisputeEvidenceFile endpoint.
The Disputes API also supports other endpoints useful in dispute management.
-
List disputes
GET /v2/disputes - Returns a list of disputes associated with a particular account.
-
Retrieve dispute
GET /v2/disputes/{dispute_id} - Returns details about a specific dispute.
-
Accept dispute
POST /v2/disputes/{dispute_id}/accept - Accepts the loss on a dispute.
-
List dispute evidence
GET /v2/disputes/{dispute_id}/evidence - Returns a list of evidence associated with a dispute.
-
Create dispute evidence file
POST /v2/disputes/{dispute_id}/evidence-files - Uploads a file to use as evidence in a dispute challenge.
-
Create dispute evidence text
POST /v2/disputes/{dispute_id}/evidence-text - Uploads text to use as evidence for a dispute challenge.
-
Delete dispute evidence
DELETE /v2/disputes/{dispute_id}/evidence/{evidence_id} - Removes specified evidence from a dispute.
-
Retrieve dispute evidence
GET /v2/disputes/{dispute_id}/evidence/{evidence_id} - Returns the metadata for the evidence specified in the request URL path.
-
Submit evidence
POST /v2/disputes/{dispute_id}/submit-evidence - Submits evidence to the cardholder's bank.