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

# Disputes

> Find a dispute in the Fintoc Dashboard, check its documentation deadline, and submit evidence for review.

A dispute (chargeback) happens when your customer contests a card payment with their issuer. Each dispute has an ID prefixed with `cb_`. While a dispute is open, the payment amount stays on hold until the issuer resolves the dispute. You can answer a dispute from the Dashboard by uploading evidence and submitting it for review before the deadline.

To answer disputes through the API instead, see the [Disputes API reference](/api/payments-api/disputes).

## Before you begin

* Your organization must have card payments enabled. The **Disputes** tab appears only for organizations with card payments.
* To view disputes, your user needs **Read** access to **Payments**.
* To upload evidence and submit it for review, your user needs **Manage** access to **Disputes**. If your user doesn't have this access, ask an administrator of your organization to grant access or to upload the evidence for you. To learn more, see [Permission roles](/guides/home/dashboard/permission-roles).

## Find a dispute

1. In the Dashboard, go to **Payment history**.
2. Open the **Disputes** tab. The badge next to the tab shows how many disputes are waiting for documentation.
3. To find a specific dispute, filter by **Dispute ID** with the exact `cb_` ID or by **Status**.
4. Click the dispute to open its detail page.

The detail page shows the payment details, the **Activity** timeline with the documentation deadline, and the **Supporting documents** section.

## Dispute statuses

The Dashboard shows each dispute status with its matching API value:

| Dashboard status | API status | Description |
| :- | :- | :- |
| Documentation required | `waiting_documentation` | Your customer opened the dispute. Upload evidence and submit it before the deadline. |
| In review | `in_review` | You submitted your evidence and the dispute is under review. You can't add or remove documents. |
| Dispute won | `won` | The issuer resolved the dispute in your favor. You receive the funds back. |
| Dispute lost | `lost` | The issuer resolved the dispute in your customer's favor. You don't receive the funds back. |
| Expired | `expired` | The deadline passed without submitted evidence. You lose the dispute and don't receive the funds. |

## Documentation deadline

Each dispute has a documentation deadline, shown next to **Deadline:** in the dispute detail page. The API returns the deadline as `documentation_upload_deadline`. You can upload and submit documents only while the dispute is in **Documentation required** and before the deadline. If the deadline passes without submitted evidence, the dispute moves to **Expired**.

## Upload evidence and submit for review

Attach evidence related to the sale or service you provided, such as receipts, communications with your customer, or proof of delivery.

1. Open the dispute detail page.
2. In **Supporting documents**, upload one or more files. Each file must be a PDF, JPEG, or PNG and smaller than 10 MB.
3. Click **Submit documentation**.
4. In the confirmation dialog, click **Submit documentation** again.

After you submit the evidence, the dispute moves to **In review**. You can no longer add or remove documents for that dispute.

## Get notified about disputes

To track disputes from your systems, subscribe to the `dispute.*` webhook events. To learn more, see [Types of events](/api/main-resources/events-reference/types-of-events).