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

# Disputes Notifications

When your customer files a dispute against a payment, the issuing bank informs us of the dispute and we notify you through Email Notifications or [Webhooks](/api-reference/payments/latest/disputes/dispute-webhooks).

## Email notifications

Email notifications can be configured from the [Merchant Dashboard](https://merchant.cashfree.com/merchants). Emails on which the merchant wants to receive these notifications can be configured from the [Merchant Dashboard](https://merchant.cashfree.com/merchants) by following the below steps:

Go to **Payment Gateway Dashboard** > **Settings** > **Email Notifications** > **Dispute Emails**.

<Frame caption="">
  <img src="https://mintcdn.com/cashfreepayments-d00050e9/JZc-JzI9LQpTeTyY/static/payments/disputes/dispute-notify-1.png?fit=max&auto=format&n=JZc-JzI9LQpTeTyY&q=85&s=b66607fbeded73e06d9e4ed8d16224d6" width="1809" height="1024" data-path="static/payments/disputes/dispute-notify-1.png" />
</Frame>

We notify you through email in the following scenarios:

| Scenarios                 | Description                                                                                                     |
| :------------------------ | :-------------------------------------------------------------------------------------------------------------- |
| Dispute created           | You will be notified when there is a new dispute that your customer raises.                                     |
| Dispute phase/type change | You will be notified when there is a change in the dispute phase (Pre-arbitration, Arbitration).                |
| States change             | You will be notified when there is a change in the dispute state, for example, Action Required -> Under Review. |
| Comment updated           | You will be notified when there is a comment updated.                                                           |
| Reminder email            | You will be notified when the dispute has reached the deadline day.                                             |

***

## Webhooks

Dispute webhooks can be configured to receive automated notifications when disputes are created, updated and closed.

To add a new webhook,

1. Go to **Payment Gateway Dashboard** > **Developers** or click the **Developers** option from the homepage.
2. The following events apply to dispute webhooks:
   * dispute created
   * dispute closed
   * dispute updated
3. Click **Add Webhook Endpoint** to create a new webhook. Enter the **endpoint URL** and select the **webhook version** using the drop-down menu. The available API versions are 2021-09-21, 2022-09-01. Click on **Test** to verify if the webhook endpoint returns a response. Once done, click **Next**.
4. Select the respective event and click **Add Webhook**.

<Frame caption="">
  <img src="https://mintcdn.com/cashfreepayments-d00050e9/JZc-JzI9LQpTeTyY/static/payments/disputes/dispute-notify-2.png?fit=max&auto=format&n=JZc-JzI9LQpTeTyY&q=85&s=0c25f2d82d16ecacdfc286f664d15111" width="3456" height="1920" data-path="static/payments/disputes/dispute-notify-2.png" />
</Frame>

6. The webhook is added successfully. You can test the webhook and edit it from the webhook homepage.

### Test webhook endpoint

You can test the URL at any time using the Test option. Click the **Test** option in the Test Webhook Endpoint pop-up. Click **Done** once you get a successful response.

<Frame caption="">
  <img src="https://mintcdn.com/cashfreepayments-d00050e9/JZc-JzI9LQpTeTyY/static/payments/disputes/dispute-notify-3.png?fit=max&auto=format&n=JZc-JzI9LQpTeTyY&q=85&s=846dcc2b438e4921c8aa7f3b2912ab21" width="3456" height="1920" data-path="static/payments/disputes/dispute-notify-3.png" />
</Frame>

### Edit webhook endpoint

You also have the option of editing a webhook. Click the **Edit** option on the webhook that is to be edited and select the events you want to add/remove to the webhook. Once done click **Save**.

<Frame caption="">
  <img src="https://mintcdn.com/cashfreepayments-d00050e9/JZc-JzI9LQpTeTyY/static/payments/disputes/dispute-notify-4.png?fit=max&auto=format&n=JZc-JzI9LQpTeTyY&q=85&s=8de46d1ce256c1ff708209ce37f20990" width="3456" height="1920" data-path="static/payments/disputes/dispute-notify-4.png" />
</Frame>

Read more about the [different types of dispute webhooks](/api-reference/payments/latest/disputes/dispute-webhooks), along with their sample payloads.
