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

You are viewing an old version of the API
Submit evidence BETA

POST /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 and CreateDisputeEvidenceText endpoints, and evidence automatically provided by Square, when available.


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

Required

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

Response Fields

Name Description
errors
Error [ ]

Information on 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: 2020-11-18' \
  -H 'Authorization: Bearer ACCESS_TOKEN' \
  -H 'Content-Type: application/json'
Response JSON
{
  "dispute": {
    "dispute_id": "EAZoK70gX3fyvibecLwIGB",
    "amount_money": {
      "amount": 2000,
      "currency": "USD"
    },
    "reason": "NO_KNOWLEDGE",
    "state": "PROCESSING",
    "due_at": "2018-11-01T00:00:00.000Z",
    "disputed_payments": [
      {
        "payment_id": "2yeBUWJzllJTpmnSqtMRAL19taB"
      }
    ],
    "evidence_ids": [
      "CKWRhnZN0eMSUbh38BKmD"
    ],
    "card_brand": "visa",
    "created_at": "2018-10-18T16:02:15.313Z",
    "updated_at": "2018-10-18T16:02:15.313Z",
    "brand_dispute_id": "100000399240"
  }
}

Share Feedback

Thanks for visiting the Square API documentation. What's on your mind?