> This page is for Cash App Pay Partner API.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.cash.app/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.cash.app/_mcp/server.

# Event: dispute.status.updated

POST 

**When is this event triggered?**

This event is created whenever a dispute's state is updated. This can be caused by a variety of things:
  - An API client-driven change where the dispute is accepted or challenged
  - Cash App Pay making a final decision on a dispute

Reference: https://developers.cash.app/cash-app-pay-partner-api/api-reference/network-api/dispute-status-updated

## Request

### Payload

- `type` (string, required) — The type of event that occurred. `dispute.status.updated` for this event.
- `event_id` (string, required) — A unique identifier provided by Cash App for the event.
- `created_at` (datetime, required) — When this event occured in [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339) format (UTC). The time that the event is delivered may be significantly later than this timestamp due to webhooks being retried for up to 72 hours.
- `data` (DisputeStatusUpdatedPayloadData, required) — Data about the dispute that was updated.

## Types

### DisputeStatusUpdatedPayloadData

Data about the dispute that was updated.

- `id` (string, required) — A unique identifier provided by Cash App for the dispute.
- `object` (DisputeStatusUpdatedPayloadDataObject, required) — A snapshot of the dispute immediately after the dispute's status was updated.
- `type` (string, required) — The resource type contained in the `object` field. For this event, it is `dispute`.

### DisputeStatusUpdatedPayloadDataObject

A snapshot of the dispute immediately after the dispute's status was updated.

- `dispute` (Dispute, required) — Represents a dispute initiated by a customer within Cash App or the customer's linked bank

### Dispute

Represents a dispute initiated by a customer within Cash App or the customer's linked bank

- `id` (string, required) — A unique identifier for the dispute issued by Cash App. Min length: `1` Max length: `128`
- `payment_id` (string, required) — ID of the disputed payment. Min length: `1` Max length: `128`
- `amount` (integer, required) — Amount of disputed money, in the lowest denomination of currency on the associated payment. Min value: `1`
- `reason` (enum, required) — 4-digit code consisting of 2 letters followed by 2 numbers that indicates why the dispute was created, at a high level. Current values: - `FR10`: Customer has no knowledge of the payment. - `FR11`: Customer has no knowledge of the payment and liability has shifted to the merchant due to collusion, fraud monitoring program thresholds, or any other reason. - `PE10`: Payment was processed twice. - `PE11`: Payment amount differs from agreed amount. - `PE12`: Payment was paid for by another means. - `CD10`: Cancelled services. - `CD11`: Goods or services differ from what was agreed upon for the payment. - `CD12`: The goods or services were not received. - `CD13`: The purchase was cancelled or returned, but the refund has not been processed.
  - Allowed values: `FR10`, `FR11`, `PE10`, `PE11`, `PE12`, `CD10`, `CD11`, `CD13`
- `settlement_withholding` (enum, required) — Indicates if the disputed amount has already been withheld from a settlement or not. Current values: - `NOT_WITHHELD`: The disputed amount has not yet been withheld in a settlement. It may impact future settlements if the dispute is "lost" by the merchant. - `WITHHELD_ALREADY`: The disputed amount was withheld in a prior settlement. This dispute will not impact future settlements.
  - Allowed values: `NOT_WITHHELD`, `WITHHELD_ALREADY`
- `state` (enum, required) — The step in the dispute lifecycle that this dispute is currently at: - `RESPONSE_REQUIRED` - `NO_RESPONSE_REQUIRED` - `PROCESSING` - `ACCEPTED` - `WON` - `PARTIALLY_WON` - `LOST`
  - Allowed values: `RESPONSE_REQUIRED`, `NO_RESPONSE_REQUIRED`, `PROCESSING`, `ACCEPTED`, `WON`, `PARTIALLY_WON`, `LOST`
- `created_at` (datetime, required) — When this dispute was created, in [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339) format (UTC).
- `updated_at` (datetime, required) — When this dispute was last updated, in [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339) format (UTC).
- `merchant_id` (string, required) — ID of the merchant that collected the disputed payment. Min length: `1` Max length: `128`
- `customer_credited_amount` (integer, optional, nullable) — The amount credited to the Customer after resolving the dispute. Note: The amount will be in the lowest denomination of the currency used on the associated payment. Min value: `0`
- `response_due_at` (datetime, optional, nullable) — When the dispute must be challenged by, after which it will be automatically accepted, in [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339) format (UTC).