• Example searches: “transaction”, “CreateOrder”, “/v2/locations”, “inventory”, “delete customer”

You are viewing an old version of the API
Submit evidence

POST /v2/disputes/{dispute_id}/submit-evidence

Submits evidence to the cardholder's bank.

The evidence submitted by this endpoint includes evidence uploaded using the CreateDisputeEvidenceFile and CreateDisputeEvidenceText endpoints and evidence automatically provided by Square, when available. Evidence cannot be removed from a dispute after submission.


Permissions
DISPUTES_WRITE
Guide
Challenge a dispute
Try in API Explorer
Name Description
dispute_id
string

Required

The ID of the dispute for which you want to submit evidence.

Response Fields

Name Description
errors
Error [ ]

Information about errors encountered during the request.

dispute
Dispute

The Dispute for which evidence was submitted.

Examples

You are viewing an old version of the API
POST /v2/disputes/{dispute_id}/submit-evidence
cURL
  • cURL
  • Ruby
  • Python
  • C#
  • Java
  • PHP
  • Node.js
curl https://connect.squareup.com/v2/disputes/EAZoK70gX3fyvibecLwIGB/submit-evidence \
  -X POST \
  -H 'Square-Version: 2022-11-16' \
  -H 'Authorization: Bearer ACCESS_TOKEN' \
  -H 'Content-Type: application/json'
Response JSON
{
  "dispute": {
    "amount_money": {
      "amount": 4350,
      "currency": "USD"
    },
    "reason": "CUSTOMER_REQUESTS_CREDIT",
    "state": "PROCESSING",
    "due_at": "2022-06-01T00:00:00.000Z",
    "disputed_payment": {
      "payment_id": "2yeBUWJzllJTpmnSqtMRAL19taB"
    },
    "card_brand": "VISA",
    "created_at": "2022-05-18T16:02:15.313Z",
    "updated_at": "2022-05-18T16:02:15.313Z",
    "brand_dispute_id": "100000399240",
    "version": 4,
    "location_id": "LSY8XKGSMMX94",
    "id": "EAZoK70gX3fyvibecLwIGB",
    "reported_at": "2022-05-18T00:00:00.000Z"
  }
}