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

# Creating a Dispute

> Create a single dispute case in the Disputes portal.

This tutorial walks you through how to locate a transaction and create a dispute case in the Disputes portal.
The Disputes portal is the Marqeta dispute management platform for handling dispute cases from initial filing through final resolution.

By the end of this tutorial, you will have an active case ready to manage in the dispute lifecycle.

<h2 id="_prerequisites">
  Prerequisites
</h2>

To create a dispute in the Disputes portal, you must have the following:

* Access to the Disputes portal and an active sign-in.
* The transaction token, name of the user, or number of the card associated with the transaction you want to dispute.

<Note>
  Creating disputes might require specific roles or permissions in the Disputes portal.
  Confirm your access level with your administrator if you don't see the options described below.
</Note>

<h2 id="_finding_the_transaction_you_want_to_dispute">
  Finding the transaction you want to dispute
</h2>

You can find the transaction want to dispute using one of the following ways:

* Searching the transaction directly using the transaction token.
* Looking up all transactions for a specified user.
* Looking up all transactions for a specified card.

<h3 id="_looking_up_the_transaction">
  Looking up the transaction using a transaction token
</h3>

From the left navigation menu, click **Single Dispute** under the **Create Case** section.
The **Create a single dispute** screen appears.

<Frame>
  <img src="https://mintcdn.com/marqeta-b295cded/6HTPvxtY28nz8-YB/images/docs/developer-guides/disputes-portal/disputes-portal-create-single-dispute-ui.png?fit=max&auto=format&n=6HTPvxtY28nz8-YB&q=85&s=76df138b1b11199324d1c57ce9e1a0f5" alt="Create a single dispute screen" width="1954" height="710" data-path="images/docs/developer-guides/disputes-portal/disputes-portal-create-single-dispute-ui.png" />
</Frame>

In the **Transaction token** field, enter or paste the token for the disputed transaction, then click **Search**.

The Disputes portal retrieves the transaction details and displays them in the side panel on the right.
This transaction panel shows key details, including the token, type, amount, currency, and created time.
Use it to confirm that you've selected the correct transaction before continuing.

<h3 id="_looking_up_a_user">
  Looking up transactions for a user
</h3>

You can create a dispute by finding the cardholder first and selecting from their transactions.

<Frame>
  <img src="https://mintcdn.com/marqeta-b295cded/6HTPvxtY28nz8-YB/images/docs/developer-guides/disputes-portal/disputes-portal-create-from-user.png?fit=max&auto=format&n=6HTPvxtY28nz8-YB&q=85&s=82eae43c9dfa287044c1c2c093c4a30b" alt="Look up disputes cases from a specific user screen" width="2896" height="840" data-path="images/docs/developer-guides/disputes-portal/disputes-portal-create-from-user.png" />
</Frame>

<Steps>
  <Step>From the left navigation menu, click **User Details** under **Cardholder Search**.</Step>
  <Step>Enter the search parameters you have for the user.</Step>
  <Step>Click **Search**. The Disputes portal returns a list of matching users.</Step>
  <Step>Click the user of interest. The next screen loads a list of all disputable transactions for that user. </Step>
  <Step>Click **Dispute Transaction** on the transaction you want to dispute.</Step>
</Steps>

<h3 id="_looking_up_a_card">
  Looking up transactions for a card
</h3>

You can also create a dispute by searching for a card and selecting from its transactions.

<Frame>
  <img src="https://mintcdn.com/marqeta-b295cded/6HTPvxtY28nz8-YB/images/docs/developer-guides/disputes-portal/disputes-portal-create-from-card.png?fit=max&auto=format&n=6HTPvxtY28nz8-YB&q=85&s=1711015858691e77b674f195091e549f" alt="Look up disputes cases from a specific card screen" width="2886" height="484" data-path="images/docs/developer-guides/disputes-portal/disputes-portal-create-from-card.png" />
</Frame>

<Steps>
  <Step>From the left navigation menu, click **Card Details** under **Cardholder Search**.</Step>
  <Step>Enter the card's last four digits or full PAN.</Step>
  <Step>Click **Search**. The Disputes portal returns a list of matching cards.</Step>
  <Step>Click the card of interest. The next screen loads a list of all disputable transactions made with that card.</Step>
  <Step>Click **Dispute Transaction** on the transaction you want to dispute.</Step>
</Steps>

<h2 id="_choosing_your_dispute_creation_method">
  Choosing your dispute creation method
</h2>

After the transaction loads, the dispute creation form appears.
Select the method that best fits your situation:

* **Questionnaire** — Creates the dispute through a step-by-step questionnaire.
  The guided questions determine the card network reason code automatically.
  This method is best for guided dispute creation when you need detailed prompts.
* **Fraud only** — Reports fraud without initiating a chargeback.
  This method is best for fraud reporting that doesn't require immediate chargeback action.

<h2 id="_creating_the_dispute">
  Creating the dispute case
</h2>

Work through the selected method, answering each prompt with the details of the dispute.
When you're finished, submit your answers to the Disputes portal.

The Disputes portal then:

* Creates a new dispute case.
* Directs you to the **Dispute Lifecycle** tab so you can continue managing the case.
* Adds the case to your case views for tracking and follow-up.

<h2 id="_next_steps">
  Next steps
</h2>

Your dispute case is now active. From here, you can:

* Review case details and monitor provisional credit deadlines in the **Dispute Lifecycle** tab.
* Upload supporting files in the **Documents** tab.
* Track every action on the case in the **Activity** tab.

<h2 id="_bulk_disputes">
  Bulk disputes
</h2>

Administrators can also create disputes in bulk for specific scenarios. Contact your administrator if you need to create multiple disputes at once.


## Related topics

- [Creating a Dispute](/docs/developer-guides/disputes-create.md)
- [Disputes in the Marqeta Dashboard](/docs/developer-guides/disputes-dashboard.md)
- [Create, Submit, and Manage a Dispute](/docs/developer-guides/disputes-sandbox/disputes-sandbox-submit-manage.md)
- [Disputes Sandbox Overview](/docs/developer-guides/disputes-sandbox/disputes-sandbox-overview.md)
- [Disputes (PULSE)](/docs/core-api/disputes-pulse.md)
