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

You are viewing an old version of the API
Accept dispute BETA

POST /v2/disputes/{dispute_id}/accept

Accepts 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 balance does not have sufficient funds, Square debits the associated bank account.


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

Required

ID of the dispute you want to accept.

Response Fields

Name Description
errors
Error [ ]

Information on errors encountered during the request.

dispute
Dispute

Details about the accepted dispute.

Examples

You are viewing an old version of the API
POST /v2/disputes/{dispute_id}/accept
cURL
  • cURL
  • Ruby
  • Python
  • C#
  • Java
  • PHP
  • Node.js
curl https://connect.squareup.com/v2/disputes/XDgyFu7yo1E2S5lQGGpYn/accept \
  -X POST \
  -H 'Square-Version: 2020-11-18' \
  -H 'Authorization: Bearer ACCESS_TOKEN' \
  -H 'Content-Type: application/json'
Response JSON
{
  "dispute": {
    "dispute_id": "XDgyFu7yo1E2S5lQGGpYn",
    "amount_money": {
      "amount": 2000,
      "currency": "USD"
    },
    "reason": "NO_KNOWLEDGE",
    "state": "LOST",
    "due_at": "2018-11-01T00:00:00.000Z",
    "disputed_payments": [
      {
        "payment_id": "6Ee10wvqhfipStz297mtUhBXvaB"
      }
    ],
    "card_brand": "visa",
    "created_at": "2018-10-18T15:59:13.613Z",
    "updated_at": "2018-10-18T15:59:13.613Z",
    "brand_dispute_id": "100000282394"
  }
}

Share Feedback

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