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 ->

dispute.created

Published when a Dispute is created.

dispute.evidence.created

Published when evidence is added to a Dispute from the Disputes Dashboard in the Seller Dashboard, the Square Point of Sale app, or by calling either CreateDisputeEvidenceFile or CreateDisputeEvidenceText.

dispute.evidence.deleted

Published when evidence is removed from a Dispute from the Disputes Dashboard in the Seller Dashboard, the Square Point of Sale app, or by calling DeleteDisputeEvidence.

dispute.state.updated

Published when the state of a Dispute changes. This includes the dispute resolution (WON, LOST) reported by the bank