Skip to main content

Dispute

A claim about an order, a fee or a payment, and how it was settled. A buyer's claim goes to the seller first; a seller's claim and a chargeback go to the operator.

type Dispute implements Node {
  id: ID!
  description: String!
  sellerResponseDueAt: DateTime
  resolutionDueAt: DateTime!
  externalId: String
  resolvedAt: DateTime
  createdAt: DateTime!
  updatedAt: DateTime!
  kind: DisputeKind!
  status: DisputeStatus!
  reason: DisputeReason!
  requestedResolution: DisputeRequestedResolution!
  outcome: DisputeOutcome
  seller: Seller
  order: Order
  nauticalOrder: NauticalOrder
  chargedTo: RefundChargeToEnum
  refund: Refund
  events(
    before: String
    after: String
    first: Int
    last: Int
  ): DisputeEventCountableConnection!
}
Show more ↓

Fields​

Dispute.id ● ID! non-null scalar​

The Globally Unique ID of this object

Dispute.description ● String! non-null scalar​

The claimant's account of it.

Dispute.sellerResponseDueAt ● DateTime scalar​

When the seller must answer a buyer's claim. Null for any other kind.

Dispute.resolutionDueAt ● DateTime! non-null scalar​

When the dispute should be settled. For a chargeback a processor reported, when the processor needs the evidence by.

Dispute.externalId ● String scalar​

A chargeback's id at its payment processor, as the processor's dashboard shows it. Null for any other kind.

Dispute.resolvedAt ● DateTime scalar​

When it was settled or withdrawn. Null while it is open.

Dispute.createdAt ● DateTime! non-null scalar​

When it was opened.

Dispute.updatedAt ● DateTime! non-null scalar​

When it last changed.

Dispute.kind ● DisputeKind! non-null enum​

Who is claiming against whom.

Dispute.status ● DisputeStatus! non-null enum​

Where the dispute is.

Dispute.reason ● DisputeReason! non-null enum​

Why it was opened.

Dispute.requestedResolution ● DisputeRequestedResolution! non-null enum​

What the claimant asks for.

Dispute.outcome ● DisputeOutcome enum​

How it ended. Null while it is open.

Dispute.seller ● Seller object​

The seller the dispute concerns. Null for a chargeback, which disputes a whole payment.

Dispute.order ● Order object​

The seller's own order the claim is about, if any.

Dispute.nauticalOrder ● NauticalOrder object​

The whole marketplace order, every seller's part of it. Only the operator and the dispute's buyer read it; for anyone else it is null. A seller reads order.

Dispute.chargedTo ● RefundChargeToEnum enum​

Who bears the refund of a claim settled as REFUNDED: the marketplace or the seller. Every line of its refund is charged to them. Null when it was not said.

Dispute.refund ● Refund object​

The refund that carries out a claim settled as REFUNDED, once linked. The dispute closes when it is paid, and goes back to the operator if it fails. Null without MANAGE_REFUNDS, which reading a refund requires.

Dispute.events ● DisputeEventCountableConnection! non-null object​

The dispute's record, oldest first. Operator-only entries are left out for anyone but the operator, and are not counted in totalCount.

Dispute.events.before ● String scalar​

Returns the items in the list that come before the specified cursor.

Dispute.events.after ● String scalar​

Returns the items in the list that come after the specified cursor.

Dispute.events.first ● Int scalar​

Returns the first n items from the list.

Dispute.events.last ● Int scalar​

Returns the items in the list that come after the specified cursor.

Interfaces​

Node interface​

An object with a Globally Unique ID

Returned By​

dispute query

Member Of​

DisputeAddEvidence object ● DisputeAddMessage object ● DisputeClose object ● DisputeCountableEdge object ● DisputeEscalate object ● DisputeLinkRefund object ● DisputeOpen object ● DisputeResolve object ● DisputeRespond object ● DisputeWithdraw object

Was this page helpful?