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

# Disputes

> Track card disputes and chargebacks raised against payments, with the customer, invoices, reason and the date a response is due

A dispute is a challenge a cardholder raises with their bank against a payment, also called a chargeback. Alguna records the disputes your payment provider reports and links each one to the payment it was raised on, the customer, and the invoices that payment settled. All of them appear in one list. Use it to see which payments are contested, how much is at stake, and when each response is due, without searching your provider's dashboard customer by customer. See [How Alguna Works](https://alguna.com/docs/concepts/how-alguna-works.md) for how payments, invoices and corrections relate, and [Payments](https://alguna.com/docs/invoices/payments.md) for the payment record itself.

Disputes are dashboard-only. The public API has no dispute endpoints.

***

## Where disputes come from

Disputes are recorded for payments collected through [Stripe](https://alguna.com/docs/integrations/payments/stripe.md). When Stripe opens a dispute on a payment Alguna collected, or updates it, Alguna updates its record of that dispute. Each dispute keeps the provider's dispute ID, which links to the dispute in the provider's dashboard.

You respond to a dispute in the payment provider, for example by submitting evidence. Alguna shows the dispute and its current status.

***

## Statuses

| Status | Meaning |
| - | - |
| **Open** | The dispute needs a response |
| **Challenged** | A response was submitted and the provider is reviewing it |
| **Won** | The dispute was decided in your favor |
| **Lost** | The dispute was decided against you |

The status filter also lists **Accepted**, **Expired** and **Cancelled**, which are closed statuses. **Open** and **Challenged** count as active disputes. The dashboard flags those on the payment and on the invoice.

***

## The Disputes list

Open **Payments → Disputes** to see every dispute. Filter the list by status. Each status filter shows how many disputes it holds.

| Column | Shows |
| - | - |
| **Status** | The dispute's current status |
| **Response Due** | The date the provider needs a response by, if it set one |
| **Customer** | The customer who made the payment |
| **Payment** | The disputed payment |
| **Invoice** | The invoices that payment settled |
| **Amount** | The disputed amount and its currency |
| **Reason** | The reason the provider reported |
| **Provider ID** | The provider's dispute ID, linked to the dispute in the provider's dashboard |
| **Disputed** | The date the dispute was raised |

You can sort the list by **Response Due** or **Amount**.

Select a dispute to open its details:

* **Summary**: reason, the date it was raised, response due date, resolved date once it closes, customer, payment and invoices.
* **Provider**: the provider and its dispute ID, with a link to the dispute in the provider's dashboard.
* **Provider Events**: each update received from the provider, with when it was received.

Users who can view payments can see disputes.

***

## Disputes on payments and invoices

* **Payments**: a payment with an active dispute shows an alert icon. Its details have a **Disputes** section that lists each dispute raised on it, with its status, amount, reason, disputed date and response due date.
* **Invoices**: a paid invoice whose payment has an active dispute shows an alert icon in the invoice list and on the invoice. The invoice's activity timeline records each dispute event, such as a dispute opening or being won or lost.

***

## What a dispute changes

A dispute is a record. It does not change the payment's status, the invoice's status or balance, allocations, credits, refunds or revenue. If you decide to return money or correct the invoice, issue a [credit note](https://alguna.com/docs/invoices/credit-notes.md) or a [refund](https://alguna.com/docs/invoices/refunds.md).

***

## FAQ

**Where do I respond to a dispute?**
In your payment provider. Use **Provider ID** to open the dispute there. Alguna shows the updated status once the provider reports it.

**Does a lost dispute reopen the invoice?**
No. The invoice keeps its status. Make any correction with a credit note or a refund.

**Which providers report disputes?**
Stripe. Disputes are recorded for payments collected through a connected Stripe account.

**Are disputes in the public API or webhooks?**
No. Disputes are visible in the dashboard.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.