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

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

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. For more information, see Challenge a Dispute.

Required permissions: PAYMENTS_WRITE

Path Parameters

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
curl https://connect.squareup.com/v2/disputes/EAZoK70gX3fyvibecLwIGB/submit-evidence \
  -X POST \
  -H 'Square-Version: 2020-06-25' \
  -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?