Skip to main content
What is it? The respondToDispute mutation allows partners to accept or challenge a dispute that has been assigned to them. This mutation provides two options:
  1. Accept the dispute - Acknowledge the dispute’s validity and accept the chargeback
  2. Challenge the dispute - Contest the dispute by providing supporting evidence
When to Use
  • A customer has disputed a transaction with their card issuer.
  • You need to accept liability or challenge a dispute with evidence.
  • You want to respond to a chargeback within the required timeframe.
ScenarioWhen Ben disputes a transaction for a keyboard he purchased from CoolTechGear.com, the dispute is assigned to the partner. The partner then decides whether to accept liability for the dispute, or challenge Ben’s dispute by providing evidence that the transaction was valid.

​
Implementation rules

  1. The dispute must be assigned to the partner to respond to it
  2. When accepting a dispute, only the disputeId is required
  3. When challenging a dispute, both the disputeId and at least one attachmentId are required
  4. Attachment IDs are obtained by first uploading evidence files
  5. Responses must be submitted before the dispute’s expiration date
The same mutation is used for both accepting and challenging a dispute, with different input parameters: 
mutation RespondToDispute($input: RespondToDisputeInput!) {
  respondToDispute(input: $input) {
    dispute {
      id
    }
    errors {
      ... on AttachmentsRequiredError {
        message
      }
      ... on ExpirationDateExceededError {
        expirationDate
        message
      }
      ... on InvalidAssignmentError {
        currentAssignment
        message
        validAssignments
      }
    }
  }
}

​
Accept a dispute

Use the accept input parameter with the dispute ID when you don’t want to challenge the dispute and are willing to accept the chargeback.
Accept a Dispute
Variables
{
  "input": {
    "accept": {
      "disputeId": "d8f8a027-04ce-437c-ad4e-7d41f667c23c"
    }
  }
}
Response
{
  "data": {
    "respondToDispute": {
      "dispute": {
        "id": "d8f8a027-04ce-437c-ad4e-7d41f667c23c"
      },
      "errors": null
    }
  }
}

​
Challenge a dispute

Use the represent input parameter with the dispute ID and at least one attachment ID when you want to contest the dispute by providing evidence.
Challenge a dispute
Variables
{
  "input": {
    "represent": {
      "disputeId": "daf59e49-5646-4fc2-ab71-fb32cb134c54",
      "attachmentIds": ["981e535f-8a77-4854-9e2e-4c7d136ef17c"]
    }
  }
}
Response
{
  "data": {
    "respondToDispute": {
      "dispute": {
        "id": "daf59e49-5646-4fc2-ab71-fb32cb134c54"
      },
      "errors": null
    }
  }
}