respondToDispute

Respond to a dispute.

Operation

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
      }
    }

}
}

Response

{
  "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

Show child attributes

accept · AcceptDisputeInput

Show child attributes

disputeId · UUID! · required

A unique ID assigned to a dispute.

arbitration · ArbitrationInput

Show child attributes

attachmentIds · [UUID!]! · required

A list of dispute attachment IDs to submit as evidence for arbitration.

disputeId · UUID! · required

The ID of the dispute to submit to arbitration.

represent · RepresentFirstChargebackInput

Show child attributes

attachmentIds · [UUID!]! · required

A list of dispute attachment IDs to submit as evidence for the challenge.

disputeId · UUID! · required

The ID of the dispute to challenge.

Return type

RespondToDisputePayload!

dispute · Dispute

Show child attributes

acceptor · Acceptor

See Acceptor

acquirer · Acquirer

Show child attributes

acquirerBin · [AcquirerBin!]! · required

Show child attributes

bin · String

paymentNetwork · Network

See Network

businessName · String! · required

The descriptive name for the acquirer that is different from its legal entity name. Also known as “Doing Business As” (DBA), “trade name”, “assumed name”, or “fictitious name”.

id · UUID! · required

The id of the acquirer as defined in their profile.

acquirerReferenceNumber · String

amountContext · DisputeAmountContext

Show Possible enum values

FULL_AMOUNT · enum

The full amount of the original transaction is being disputed.

PARTIAL_AMOUNT · enum

Only a part of the original transaction amount is being disputed.

assignment · DisputeWorkflowAssignment · deprecated

Deprecated: Use workflowAssignment instead.

Show Possible enum values

CARD_NETWORK · enum

The dispute is assigned to the pertinent card network (Visa, Mastercard, American Express, or Discover) for next steps.

PARTNER · enum

The dispute is assigned to the partner entity that created the transaction now being disputed.

PROCESSOR · enum

The dispute is assigned to the payment processor, i.e., Tesouro, for next steps.

caseNumber · String

createdDateTime · DateTime

disputeAmount · Decimal

disputeAttachments · [DisputeAttachment!]

Show child attributes

acceptor · Acceptor

See Acceptor

acquirer · Acquirer

Show child attributes

acquirerBin · [AcquirerBin!]! · required

businessName · String! · required

The descriptive name for the acquirer that is different from its legal entity name. Also known as “Doing Business As” (DBA), “trade name”, “assumed name”, or “fictitious name”.

id · UUID! · required

The id of the acquirer as defined in their profile.

createdDateTime · DateTime

description · String

dispute · Dispute

fileName · String

fileType · FileType

Show Possible enum values

BMP · enum

GIF · enum

JPEG · enum

JPG · enum

PDF · enum

PNG · enum

TIF · enum

TIFF · enum

UNKNOWN · enum

fileUrl · String

id · UUID

organization · Organization

See Organization

disputeCurrencyCode · CurrencyCodeAlpha

disputeDate · Date

disputeEvents · DisputeEventCollection

Show child attributes

items · [DisputeEvent!]! · required

Show child attributes

acceptor · Acceptor

acquirer · Acquirer

attachment · DisputeAttachment

createdDateTime · DateTime

cycle · DisputeLifeCycle · deprecated

Deprecated: Use lifeCycle instead.

See DisputeLifeCycle

dateOfEvent · Date

dispute · Dispute

eventType · DisputeEventType

Show Possible enum values

ARBITRATION_APPEALED · enum

ARBITRATION_RAISED · enum

CASE_CLOSED · enum

DECISION_RULED_IN_FAVOR_OF_ACCEPTOR · enum

DECISION_RULED_IN_FAVOR_OF_ISSUER · enum

…and 13 more values. See DisputeEventType for the full list.

fromQueue · DisputeWorkflowAssignment

Show Possible enum values

CARD_NETWORK · enum

The dispute is assigned to the pertinent card network (Visa, Mastercard, American Express, or Discover) for next steps.

PARTNER · enum

The dispute is assigned to the partner entity that created the transaction now being disputed.

PROCESSOR · enum

The dispute is assigned to the payment processor, i.e., Tesouro, for next steps.

id · UUID

lifeCycle · DisputeLifeCycle

See DisputeLifeCycle

organization · Organization

source · DisputeEventSource

Show Possible enum values

API · enum

NETWORK · enum

SYSTEM · enum

USER · enum

status · DisputeStatus

Show Possible enum values

OPEN · enum

The dispute case is pending a response or final decision, and the deadline for challenging the decision has not passed.

CLOSED · enum

The dispute case has been accepted by the organization, or the network has made a final decision, or the deadline for the participants to take action has passed.

toQueue · DisputeWorkflowAssignment

Show Possible enum values

CARD_NETWORK · enum

The dispute is assigned to the pertinent card network (Visa, Mastercard, American Express, or Discover) for next steps.

PARTNER · enum

The dispute is assigned to the partner entity that created the transaction now being disputed.

PROCESSOR · enum

The dispute is assigned to the payment processor, i.e., Tesouro, for next steps.

userId · UUID

pageInfo · PageInfo! · required

See PageInfo

disputeFundingAmount · Decimal

disputeFundingCurrency · CurrencyCodeAlpha

id · UUID

lastUpdatedUserId · UUID

lifeCycle · DisputeLifeCycle

See DisputeLifeCycle

networkReason · NetworkReason

Show Possible enum values

NONE · enum

VISA_EMV_LIABILITY_SHIFT_COUNTERFEIT_FRAUD · enum

VISA_EMV_LIABILITY_SHIFT_NON_COUNTERFEIT_FRAUD · enum

VISA_OTHER_FRAUD_CARD_PRESENT_ENVIRONMENT · enum

VISA_OTHER_FRAUD_CARD_ABSENT_ENVIRONMENT · enum

…and 113 more values. See NetworkReason for the full list.

networkReasonCode · String

networkReasonLabel · String

organization · Organization

See Organization

paymentBrand · PaymentBrand

See PaymentBrand

paymentId · UUID

A unique 36 character identifier created by Tesouro and assigned to a group of transactions in the same payment request cohort. e.g., An authorization request, incremental authorization request, and the final capture would have the same paymentID.

processingNetwork · Network

See Network

processorExpirationDate · Date

respondByDate · Date

status · DisputeStatus

Show Possible enum values

OPEN · enum

The dispute case is pending a response or final decision, and the deadline for challenging the decision has not passed.

CLOSED · enum

The dispute case has been accepted by the organization, or the network has made a final decision, or the deadline for the participants to take action has passed.

transactionId · UUID · deprecated

Deprecated: Will be removed in a future release.

updatedDateTime · DateTime

workflowAssignment · DisputeWorkflowAssignment

Show Possible enum values

CARD_NETWORK · enum

The dispute is assigned to the pertinent card network (Visa, Mastercard, American Express, or Discover) for next steps.

PARTNER · enum

The dispute is assigned to the partner entity that created the transaction now being disputed.

PROCESSOR · enum

The dispute is assigned to the payment processor, i.e., Tesouro, for next steps.

errors · [RespondToDisputeError!]

Show Possible types

Show AttachmentsRequiredError

advice · String! · required

message · String! · required

Show ExpirationDateExceededError

expirationDate · Date

message · String! · required

Show ForbiddenError

advice · String! · required

code · CommonErrorCode! · required

See CommonErrorCode

message · String! · required

Show InvalidAssignmentError

currentAssignment · DisputeWorkflowAssignment

Show Possible enum values

CARD_NETWORK · enum

The dispute is assigned to the pertinent card network (Visa, Mastercard, American Express, or Discover) for next steps.

PARTNER · enum

The dispute is assigned to the partner entity that created the transaction now being disputed.

PROCESSOR · enum

The dispute is assigned to the payment processor, i.e., Tesouro, for next steps.

message · String! · required

validAssignments · [DisputeWorkflowAssignment!]

Show Possible enum values

CARD_NETWORK · enum

The dispute is assigned to the pertinent card network (Visa, Mastercard, American Express, or Discover) for next steps.

PARTNER · enum

The dispute is assigned to the partner entity that created the transaction now being disputed.

PROCESSOR · enum

The dispute is assigned to the payment processor, i.e., Tesouro, for next steps.

Show NotFoundError

advice · String! · required

code · CommonErrorCode! · required

See CommonErrorCode

message · String! · required

resourceId · String

resourceName · String

Operation

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
      }
    }

}
}

Response

{
  "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"
        }
      ]
    }
  }
}