Development
  • Guides
  • API Reference
  • API Explorer
  • SDKs
  • Sample apps
  • System status
Support
  • Developer forums
  • Developer blog
  • YouTube
  • X
More
  • Square Home
  • Square Developer
  • App Marketplace
  • Partner with Square
  • Solutions Partner Program
  • Pricing
  • Sales

© 2026 Square, Inc.

  • Developer terms of service
  • Developer Integration and Marketing Agreement
  • Privacy policy
  • Partnerships
  • Sign In
  • Sign In
  • Home

  • Dev Essentials

  • Payments

    • Payments

    • Refunds

    • Checkout

    • Terminal

    • Disputes

    • Invoices

    • Cards

    • Subscriptions

    • Bank Accounts

    • Payouts

    • Devices

    • Apple Pay

  • Commerce

  • Customers

  • Staff

  • Merchants

  • Objects & Enums

  • Webhook Events

  • Deprecated

  • SDKs

<- Square API

Square API

All versions ->

Disputes

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.

For more information, see the following guides:

  • Disputes
  • Square Webhooks Overview
  • Endpoints

  • Webhooks

All versions ->

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.