---
title: ShopifyPaymentsDispute - GraphQL Admin
description: >-
  A dispute occurs when a buyer questions the legitimacy of a charge with their
  financial institution.
api_version: 2026-01
api_name: admin
type: object
api_type: graphql
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsDispute
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsDispute.md
---

# Shopify​Payments​Dispute

object

Requires User must have `read_shopify_payments_disputes` access.

A dispute occurs when a buyer questions the legitimacy of a charge with their financial institution.

## Fields

* amount
* disputeEvidence
* evidenceDueBy
* evidenceSentOn
* finalizedOn
* id
* initiatedAt
* legacyResourceId
* order
* reasonDetails
* status
* type

***

## Map

### Fields and connections with this object

* [ShopifyPaymentsAccount.disputes](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsAccount#field-ShopifyPaymentsAccount.fields.disputes)
* [ShopifyPaymentsDisputeConnection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/ShopifyPaymentsDisputeConnection#returns-nodes)
* [ShopifyPaymentsDisputeEdge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsDisputeEdge#field-ShopifyPaymentsDisputeEdge.fields.node)
* [ShopifyPaymentsDisputeEvidence.dispute](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsDisputeEvidence#field-ShopifyPaymentsDisputeEvidence.fields.dispute)

***

## Queries

* dispute
* disputes

***

## ShopifyPaymentsDispute Queries

### Queried by

* [dispute](https://shopify.dev/docs/api/admin-graphql/latest/queries/dispute)
* [disputes](https://shopify.dev/docs/api/admin-graphql/latest/queries/disputes)

***

## Interfaces

* LegacyInteroperability
* Node

***

## ShopifyPaymentsDispute Implements

### Implements

* [Legacy​Interoperability](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/LegacyInteroperability)
* [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)