# Disputes list

Display a list of disputes and allow your connected accounts to manage the disputes.

The Disputes list component displays the disputes associated with a connected account. Each row in the list represents a dispute. Connected accounts can click a row to show detailed information about the dispute and its associated charge. When you enable the `dispute_management` feature, connected accounts can take actions to manage disputes, such as submit evidence or accept disputes. The component also includes functionality to filter disputes based on specific criteria, and export the disputes list for further analysis or record-keeping.

Note: The following is a preview/demo component that behaves differently than live mode usage with real connected accounts. The actual component has more functionality than what might appear in this demo component. For example, for connected accounts without Stripe dashboard access (custom accounts), no user authentication is required in production.

When [creating an Account Session](https://docs.stripe.com/api/account_sessions/create.md), enable this component by specifying `disputes_list` in the `components` parameter. You can turn an individual feature of the payment details component on or off by specifying the `features` parameter under `disputes_list`:

```curl
curl https://api.stripe.com/v1/account_sessions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "account={{CONNECTEDACCOUNT_ID}}" \
  -d "components[disputes_list][enabled]=true" \
  -d "components[disputes_list][features][refund_management]=true" \
  -d "components[disputes_list][features][dispute_management]=true" \
  -d "components[disputes_list][features][capture_payments]=true" \
  -d "components[disputes_list][features][destination_on_behalf_of_charge_management]=false"
```

After creating the Account Session and [initializing ConnectJS](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#account-sessions), you can render the Disputes list component in the front end:

#### JavaScript

```js
// Include this element in your HTML
const disputesList = stripeConnectInstance.create('disputes-list');
container.appendChild(disputesList);
```

## Dispute management for destination charges

By default, embedded components are most compatible with Connect integrations that accept direct charges. You can allow users to see disputes associated with destination charges with the [on_behalf_of](https://docs.stripe.com/api/payment_intents/object.md#payment_intent_object-on_behalf_of) attribute by enabling the `destination_on_behalf_of_charge_management` feature. Otherwise, this component doesn’t include disputes for these types of charges.

When you enable both `dispute_management` and `destination_on_behalf_of_charge_management`, your connected accounts can update and modify dispute evidence, counter disputes, and accept disputes for destination charges with the `on_behalf_of` attribute set to the connected account.

For [destination charges](https://docs.stripe.com/connect/destination-charges.md), with or without `on_behalf_of`, Stripe debits dispute amounts and fees from your platform account.

We recommend setting up [a webhook](https://docs.stripe.com/webhooks.md) to listen to [dispute created events](https://docs.stripe.com/api/events/types.md#event_types-charge.dispute.created). When that happens, you can attempt to recover funds from the connected account by reversing the transfer through the [Dashboard](https://dashboard.stripe.com/test/transfers) or by [creating a transfer reversal](https://docs.stripe.com/api/transfer_reversals/create.md).

If the connected account has a negative balance, Stripe attempts to [debit its external account](https://docs.stripe.com/connect/account-balances.md#automatically-debit-connected-accounts) if `debit_negative_balances` is set to `true`.

If you challenge the dispute and win, you can transfer the funds that you previously reversed back to the connected account. If your platform has an insufficient balance, the transfer fails. Prevent insufficient balance errors by [adding funds to your Stripe balance](https://docs.stripe.com/get-started/account/add-funds.md).

> Retransferring a previous reversal is subject to [cross-border transfer restrictions](https://docs.stripe.com/connect/account-capabilities.md#transfers-cross-border), meaning you might have no means to repay your connected account. Instead, wait to recover disputed cross-border payment transfers for destination charges with `on_behalf_of` until after a dispute is lost.