A case raised by a customer to either request information about or to challenge a charge. These are initiated via a customer's payment provider, such as their bank, and require a merchant to provide evidence or further information.
amountMonetaryThe amount of money from the original charge that the customer is disputing. Can be 0. This amount is debited from a merchant's account and held in a third-party account until the dispute is resolved, at which time it is sent to either the merchant or customer.
amountMonetaryIf an amount was disputed, the amount of money awarded back to the merchant if the dispute was reversed.
createdTimestampDate and time at which the dispute was created.
evidence[DisputeEvidence records submitted by the merchant for the dispute.
idID!Non-nullUnique identifier.
legacyID!Non-nullLegacy unique identifier.
originalDisputeRecursive referenceIf this dispute is a follow-up to a previous chargeback or retrieval, the original dispute.
prePreThe pre-dispute program of the dispute.
processorDisputeAdditional information from the payment processor.
protectionDisputeThe protection level of the dispute.
receivedDateDate the dispute was received by the merchant.
replyDateThe reply by date for the merchant to submit a response to the dispute.
responseTimestampThe deadline for the merchant to submit a response to the dispute.
statusDisputeThe status of the dispute.
status[DisputeA log of history events containing status changes by date for this dispute.
transactionTransactionThe disputed transaction which the customer is either requesting further information on or challenging.
typeDisputeThe type of dispute.
chargebackChargebackUse protectionLevel instead.
The chargeback protection status of the dispute.
This field is redundant to OPEN status which represents disputes with allowed evidence submission. For all other statuses it is not possible to submit evidence.
Indicates whether or not the merchant can upload evidence for this dispute based on its current status.
type Dispute implements Node {
id: ID!
legacyId: ID!
amountDisputed: MonetaryAmount
amountWon: MonetaryAmount
caseNumber: String
createdAt: Timestamp
receivedDate: Date
referenceNumber: String
responseDeadline: Timestamp
replyByDate: Date
type: DisputeType
evidence: [DisputeEvidence!]
originalDispute: Dispute
processorResponse: DisputeProcessorResponse
status: DisputeStatus
statusHistory: [DisputeStatusEvent!]
transaction: Transaction
chargebackProtectionLevel: ChargebackProtectionLevel @deprecated(reason: "Use `protectionLevel` instead.")
protectionLevel: DisputeProtectionLevel
evidenceSubmittable: Boolean @deprecated(reason: "This field is redundant to `OPEN` status which represents disputes with allowed evidence submission. For all other statuses it is not possible to submit evidence.")
preDisputeProgram: PreDisputeProgram
remainingFileEvidenceStorage: Int
}