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

# Overview

> Manage Cashfree disputes and chargebacks end-to-end from the Merchant Dashboard, with notifications, evidence uploads, APIs, and reporting for each case.

A dispute arises when a customer disagrees with a transaction and raises it with either their bank or Cashfree Payments. Customers may also report fraudulent transactions to cybercells, and banks often initiate disputes over suspicious transactions directly. We will notify you over email whenever a new dispute is created, changes state or there is a new update from Cashfree.

To get real-time notifications for a dispute raised by a customer, configure your email on the dashboard:

1. Log in to the [Merchant Dashboard](https://merchant.cashfree.com/auth/login).
2. Go to **Payment Gateway Dashboard > Settings > Notifications > Merchant Notifications > Dispute Emails** and click the **Add Recipient** button to add the email addresses that should receive dispute notifications then select the **Disputes** email category and click **Submit**.

<Tip>Install [Cashfree Agent Skills](/tools-ai/cashfree-agent-skills) to bring Cashfree product knowledge into your AI coding assistant (Claude Code, Cursor, VS Code Copilot, Gemini CLI, and more) to answer integration questions and generate accurate code without leaving your editor.</Tip>

## Chargeback types

| State           | Description                                                              | Response time                  | Resolution time                                                                                                       |
| --------------- | ------------------------------------------------------------------------ | ------------------------------ | --------------------------------------------------------------------------------------------------------------------- |
| Dispute         | Initial complaints from customers or fraud alerts from banks/authorities | 3 days (1 day for fraud cases) | • Customer complaints: 5-7 business days<br />• Fraud cases: Up to several months<br />• Wallet/Netbanking: \~30 days |
| Retrieval       | Preliminary query raised by customer with their bank                     | 3 days                         | • If contested: 30-45 days waiting period<br />• If accepted: \~10 days                                               |
| Chargeback      | Customer formally disputes transaction after retrieval                   | 3 days                         | • Cards: 30-45 days<br />• UPI: 15-20 days                                                                            |
| Pre-arbitration | Second level dispute if customer disagrees with evidence                 | 2 days                         | • Cards: 30-45 days<br />• UPI: 15-20 days                                                                            |
| Arbitration     | Final stage where card networks/NPCI makes decision                      | 1 day                          | \~15 days for final verdict                                                                                           |

<Warning>
  * Your customer can raise a pre-arbitration or an arbitration even for a dispute that is Closed (Merchant Won).
  * Response Time: Maximum days allowed to respond to the dispute
  * Resolution Time: Typical time taken to reach a final decision
  * Arbitration involves additional fees for the losing party
  * Timelines may vary based on payment method and case complexity
</Warning>

## Chargeback process states

<Frame>
  <img height="200" src="https://mintcdn.com/cashfreepayments-d00050e9/3p7irhmTjRVwqRH8/static/payments/pg/manage/disputes-lifecycle.jpg?fit=max&auto=format&n=3p7irhmTjRVwqRH8&q=85&s=1809ad8d57bf171de75bd24c7f5c0da6" data-path="static/payments/pg/manage/disputes-lifecycle.jpg" />

  <img height="200" src="https://mintcdn.com/cashfreepayments-d00050e9/3p7irhmTjRVwqRH8/static/payments/pg/manage/dispute-process-flow.jpg?fit=max&auto=format&n=3p7irhmTjRVwqRH8&q=85&s=236ad328491ab4b6f146c36225b9a543" data-path="static/payments/pg/manage/dispute-process-flow.jpg" />
</Frame>

## Manage chargebacks

Learn in detail about the various scenarios involved in disputes.

<AccordionGroup>
  <Accordion title="Scenario 1: You accept the dispute">
    If you accept a dispute and agree that the customer raised a valid dispute, Cashfree Payments refunds the amount to the customer's account. This is sometimes the most appropriate option.
  </Accordion>

  <Accordion title="Scenario 2: You contest the dispute">
    Keep the following points in mind before you decide to contest the dispute:

    Have the complete set of documents available before you upload them. Learn more about the [documents required during the upload process](/payments/manage/disputes/disputes-process-flow).
    The issuing bank reviews all documents, so ensure you upload valid documents.
    It is not necessary to contest every dispute. In some cases like pre-arbitration and arbitration, there is a high penalty involved.
    The entire dispute may take around 3 months to conclude.
    If you do not respond, you lose the dispute and Cashfree Payments refunds the customer.
  </Accordion>
</AccordionGroup>

## Webhooks

You can subscribe to the following asynchronous webhook events for disputes. Read more about [dispute webhooks](/api-reference/payments/latest/disputes/dispute-webhooks).

* `DISPUTE_CREATED`
* `DISPUTE_UPDATED`
* `DISPUTE_CLOSED`

<div class="hidden" data-table-of-contents="bottom">
  <p class="mt-4 font-medium flex items-center gap-2 related-docs-heading">
    <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" class="w-4 h-4">
      <path d="M3 4h7a2 2 0 0 1 2 2v13a2 2 0 0 0-2-2H3z" />

      <path d="M21 4h-7a2 2 0 0 0-2 2v13a2 2 0 0 1 2-2h7z" />
    </svg>

    <span>Related topics</span>
  </p>

  <ul>
    <li><a href="/docs/api-reference/payments/latest/disputes/get-disputes-by-order-id">Get Disputes by Order ID API</a></li>
    <li><a href="/docs/payments/manage/disputes/disputes-faqs">FAQs</a></li>
  </ul>
</div>
