Skip to main content
mutation RespondToDispute($input: RespondToDisputeInput!) {
  respondToDispute(input: $input) {
    dispute {
      acceptor {
        businessName
        id
        name
        reference
      }
      acquirer {
        businessName
        id
      }
      acquirerReferenceNumber
      amountContext
      assignment
      caseNumber
      createdDateTime
      disputeAmount
      disputeAttachments {
        createdDateTime
        description
        dispute
        fileName
        fileType
        fileUrl
        id
      }
      disputeCurrencyCode
      disputeDate
      disputeEvents {

      }
      disputeFundingAmount
      disputeFundingCurrency
      id
      lastUpdatedUserId
      lifeCycle
      networkReason
      networkReasonCode
      networkReasonLabel
      organization {
        businessName
        capabilities
        id
        legalName
        name
        phoneNumber
      }
      paymentBrand
      paymentId
      processingNetwork
      processorExpirationDate
      respondByDate
      status
      transactionId
      updatedDateTime
      workflowAssignment
    }
    errors {
      ... on AttachmentsRequiredError {
        advice
        message
      }
      ... on ExpirationDateExceededError {
        expirationDate
        message
      }
      ... on ForbiddenError {
        advice
        code
        message
      }
      ... on InvalidAssignmentError {
        currentAssignment
        message
        validAssignments
      }
      ... on NotFoundError {
        advice
        code
        message
        resourceId
        resourceName
      }
    }

}
}

{
  "data": {
    "respondToDispute": {
      "dispute": {
        "acceptor": {
          "allocations": "example",
          "authorizationSummaries": "example",
          "billingDescriptor": "CLACKSWORTH KEYBOARDS",
          "businessName": "Clacksworth Keyboards",
          "fees": "example",
          "feeSummaries": "example",
          "fundingAchReturns": "example",
          "fundingDisputeEvents": "example",
          "fundingSummaries": "example",
          "fundingTransactions": "example",
          "id": "b6d4e5f6-7a8b-9012-3def-456789012345",
          "name": "Ben Torres",
          "paymentTransactions": "example",
          "paymentTransactionSummaries": "example",
          "reference": "example"
        },
        "acquirer": {
          "acquirerBin": [
            "example"
          ],
          "businessName": "Clacksworth Keyboards",
          "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
        },
        "acquirerReferenceNumber": "example",
        "amountContext": "FULL_AMOUNT",
        "assignment": "CARD_NETWORK",
        "caseNumber": "example",
        "createdDateTime": "2026-01-15T14:30:00Z",
        "disputeAmount": 0,
        "disputeAttachments": [
          {
            "acceptor": "example",
            "acquirer": "example",
            "createdDateTime": "2026-01-15T14:30:00Z",
            "description": "example",
            "dispute": "example",
            "fileName": "business-license.pdf",
            "fileType": "BMP",
            "fileUrl": "example",
            "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
            "organization": "example"
          }
        ],
        "disputeCurrencyCode": "USD",
        "disputeDate": "2026-01-15",
        "disputeEvents": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "disputeFundingAmount": 0,
        "disputeFundingCurrency": "USD",
        "id": "c9a1e2d3-4b5f-6789-0abc-def123456789",
        "lastUpdatedUserId": "d8b2f3e4-5c6a-7890-1bcd-ef2345678901",
        "lifeCycle": "ARBITRATION",
        "networkReason": "NONE",
        "networkReasonCode": "example",
        "networkReasonLabel": "example",
        "organization": {
          "acceptorApplicationCounts": [
            "example"
          ],
          "acceptors": "example",
          "achNotificationsOfChange": "example",
          "achReturns": "example",
          "allocations": "example",
          "allowedMerchantCategories": [
            "example"
          ],
          "authorizationSummaries": "example",
          "businessAddress": "example",
          "businessName": "Clacksworth Keyboards",
          "capabilities": [
            "ACQUIRING"
          ],
          "fees": "example",
          "feeSummaries": "example",
          "fundingAchReturns": "example",
          "fundingDisbursementReturns": "example",
          "fundingDisputeEvents": "example",
          "fundingSummaries": "example",
          "fundingTransactions": "example",
          "id": "e7c3a4b5-6d7e-8901-2cde-f34567890123",
          "legalName": "example",
          "name": "Ben Torres",
          "paymentTransactions": "example",
          "paymentTransactionSummaries": "example",
          "phoneNumber": "example",
          "reportAvailability": [
            "example"
          ],
          "settings": "example"
        },
        "paymentBrand": "VISA",
        "paymentId": "b6d4e5f6-7a8b-9012-3def-456789012345",
        "processingNetwork": "VISA",
        "processorExpirationDate": "2026-01-15",
        "respondByDate": "2026-01-15",
        "status": "OPEN",
        "transactionId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "updatedDateTime": "2026-01-15T14:30:00Z",
        "workflowAssignment": "CARD_NETWORK"
      },
      "errors": [
        {
          "__typename": "AttachmentsRequiredError",
          "advice": "example",
          "message": "example"
        }
      ]
    }
  }
}
Mutation

Arguments

input
RespondToDisputeInput!
required

Return type

RespondToDisputePayload!
dispute
Dispute
errors
[RespondToDisputeError!]
mutation RespondToDispute($input: RespondToDisputeInput!) {
  respondToDispute(input: $input) {
    dispute {
      acceptor {
        businessName
        id
        name
        reference
      }
      acquirer {
        businessName
        id
      }
      acquirerReferenceNumber
      amountContext
      assignment
      caseNumber
      createdDateTime
      disputeAmount
      disputeAttachments {
        createdDateTime
        description
        dispute
        fileName
        fileType
        fileUrl
        id
      }
      disputeCurrencyCode
      disputeDate
      disputeEvents {

      }
      disputeFundingAmount
      disputeFundingCurrency
      id
      lastUpdatedUserId
      lifeCycle
      networkReason
      networkReasonCode
      networkReasonLabel
      organization {
        businessName
        capabilities
        id
        legalName
        name
        phoneNumber
      }
      paymentBrand
      paymentId
      processingNetwork
      processorExpirationDate
      respondByDate
      status
      transactionId
      updatedDateTime
      workflowAssignment
    }
    errors {
      ... on AttachmentsRequiredError {
        advice
        message
      }
      ... on ExpirationDateExceededError {
        expirationDate
        message
      }
      ... on ForbiddenError {
        advice
        code
        message
      }
      ... on InvalidAssignmentError {
        currentAssignment
        message
        validAssignments
      }
      ... on NotFoundError {
        advice
        code
        message
        resourceId
        resourceName
      }
    }

}
}

{
  "data": {
    "respondToDispute": {
      "dispute": {
        "acceptor": {
          "allocations": "example",
          "authorizationSummaries": "example",
          "billingDescriptor": "CLACKSWORTH KEYBOARDS",
          "businessName": "Clacksworth Keyboards",
          "fees": "example",
          "feeSummaries": "example",
          "fundingAchReturns": "example",
          "fundingDisputeEvents": "example",
          "fundingSummaries": "example",
          "fundingTransactions": "example",
          "id": "b6d4e5f6-7a8b-9012-3def-456789012345",
          "name": "Ben Torres",
          "paymentTransactions": "example",
          "paymentTransactionSummaries": "example",
          "reference": "example"
        },
        "acquirer": {
          "acquirerBin": [
            "example"
          ],
          "businessName": "Clacksworth Keyboards",
          "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
        },
        "acquirerReferenceNumber": "example",
        "amountContext": "FULL_AMOUNT",
        "assignment": "CARD_NETWORK",
        "caseNumber": "example",
        "createdDateTime": "2026-01-15T14:30:00Z",
        "disputeAmount": 0,
        "disputeAttachments": [
          {
            "acceptor": "example",
            "acquirer": "example",
            "createdDateTime": "2026-01-15T14:30:00Z",
            "description": "example",
            "dispute": "example",
            "fileName": "business-license.pdf",
            "fileType": "BMP",
            "fileUrl": "example",
            "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
            "organization": "example"
          }
        ],
        "disputeCurrencyCode": "USD",
        "disputeDate": "2026-01-15",
        "disputeEvents": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "disputeFundingAmount": 0,
        "disputeFundingCurrency": "USD",
        "id": "c9a1e2d3-4b5f-6789-0abc-def123456789",
        "lastUpdatedUserId": "d8b2f3e4-5c6a-7890-1bcd-ef2345678901",
        "lifeCycle": "ARBITRATION",
        "networkReason": "NONE",
        "networkReasonCode": "example",
        "networkReasonLabel": "example",
        "organization": {
          "acceptorApplicationCounts": [
            "example"
          ],
          "acceptors": "example",
          "achNotificationsOfChange": "example",
          "achReturns": "example",
          "allocations": "example",
          "allowedMerchantCategories": [
            "example"
          ],
          "authorizationSummaries": "example",
          "businessAddress": "example",
          "businessName": "Clacksworth Keyboards",
          "capabilities": [
            "ACQUIRING"
          ],
          "fees": "example",
          "feeSummaries": "example",
          "fundingAchReturns": "example",
          "fundingDisbursementReturns": "example",
          "fundingDisputeEvents": "example",
          "fundingSummaries": "example",
          "fundingTransactions": "example",
          "id": "e7c3a4b5-6d7e-8901-2cde-f34567890123",
          "legalName": "example",
          "name": "Ben Torres",
          "paymentTransactions": "example",
          "paymentTransactionSummaries": "example",
          "phoneNumber": "example",
          "reportAvailability": [
            "example"
          ],
          "settings": "example"
        },
        "paymentBrand": "VISA",
        "paymentId": "b6d4e5f6-7a8b-9012-3def-456789012345",
        "processingNetwork": "VISA",
        "processorExpirationDate": "2026-01-15",
        "respondByDate": "2026-01-15",
        "status": "OPEN",
        "transactionId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "updatedDateTime": "2026-01-15T14:30:00Z",
        "workflowAssignment": "CARD_NETWORK"
      },
      "errors": [
        {
          "__typename": "AttachmentsRequiredError",
          "advice": "example",
          "message": "example"
        }
      ]
    }
  }
}