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

# Disputes Sandbox Overview

> Simulate the full disputes lifecycle in a private sandbox environment.

This guide describes the sequence of API requests used in a typical dispute case and how to simulate the full disputes lifecycle within a private sandbox environment..

By the end of this guide, you will understand:

* The complete disputes lifecycle using the Marqeta Disputes API, from creating and submitting a dispute, to monitoring dispute state changes via webhook events.
* The sequence of API requests that comprise the disputes lifecycle, including basic payloads and response examples.
* The different dispute states used by Marqeta and the card networks (Visa, Mastercard, and Pulse), and how these relate to each other.

## Prerequisites

Before using this guide, ensure that you have performed the following actions:

* Set up a private sandbox environment with Marqeta.
* Enabled the disputes API functionality within your private sandbox.
* Confirmed that you can simulate and clear a transaction within your private sandbox.

The Disputes Sandbox guide contains the following topics:

* [**Set up a webhook handler**](/developer-guides/disputes-sandbox/webhook) – This topic explains how to create, host, and submit a webhook handler API in the sandbox environment.

<Warning>
  The Marqeta platform sends all dispute-related notifications via webhook events.
  You must setup the webhook handler before attempting to simulate a dispute.
</Warning>

* [**Creating, Submitting, and Managing a Dispute**](/developer-guides/disputes-sandbox-submit-manage): This topic describes the sequence of API requests used in a dispute case and explains their role in the disputes lifecycle.


## Related topics

- [Disputes Overview](/docs/developer-guides/disputes-landing-page.md)
- [Platform Overview](/docs/developer-guides/platform-overview.md)
- [Credit Overview](/docs/developer-guides/credit-landing-page.md)
- [Dashboard Overview and Quick Start](/docs/developer-guides/dashboard-overview-and-quick-start.md)
- [Transactions Overview](/docs/developer-guides/transactions-landing-page.md)