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

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>