> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tabby.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Disputes

> Handle customer disputes programmatically with the Disputes API.

The Disputes API simplifies handling disputes and helps you resolve issues with customers' orders more efficiently. Use it to:

* retrieve a list of disputes;
* view details about a specific dispute;
* approve or challenge disputes (one challenge per dispute);
* upload attachments (up to 5 per dispute).

The API mirrors the functionality available on Tabby Merchant Dashboard. It operates exclusively with **live payments** and live credentials — including testing.

<Warning>
  A secret key is required for using the Disputes API.
</Warning>

<Note>
  Want to react to disputes in real time instead of polling? Tabby can push <a href="/pay-in-4-custom-integration/dispute-webhooks">dispute webhooks</a> to your endpoint when a dispute is opened, challenged, or resolved — ask the Integrations Team to enable them.
</Note>

API documentation:

* <a href="/api-reference/disputes">Disputes API</a>
* <a href="https://storage.googleapis.com/tabby-assets/Disputes_ch.html">Disputes API in Chinese</a>