fundingDisputeEvents

An itemized list of financially impacting dispute events occuring on the pertinent funds release dates. Use this report to track dispute-related money-movements.

Operation

query FundingDisputeEvents($input: FundingDisputeEventInput!) {
  fundingDisputeEvents(input: $input) {
    items {
      acceptor {
        businessName
        fundingDisputeEvents
        id
        name
        reference
      }
      acquirerReferenceNumber
      caseNumber
      dateOfEvent
      disputeId
      fundingAmount
      fundingCurrency
      fundsReleaseDate
      fundsTransferDescriptor
      fundsTransferId
      id
      lifeCycle
      organization {
        businessName
        capabilities
        fundingDisputeEvents
        id
        legalName
        name
        phoneNumber
      }
      paymentBrand
      paymentId
      perspective
      processingNetwork
      transactionId
      transactionReference
    }
    pageInfo {
      hasNextPage
      hasPreviousPage
    }
  }
}

Response

{
  "data": {
    "fundingDisputeEvents": {
      "items": [
        {
          "acceptor": {
            "allocations": "example",
            "authorizationSummaries": "example",
            "billingDescriptor": "CLACKSWORTH KEYBOARDS",
            "businessName": "Clacksworth Keyboards",
            "fees": "example",
            "feeSummaries": "example",
            "fundingAchReturns": "example",
            "fundingDisputeEvents": "example",
            "fundingSummaries": "example",
            "fundingTransactions": "example",
            "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "name": "Ben Torres",
            "paymentTransactions": "example",
            "paymentTransactionSummaries": "example",
            "reference": "example"
          },
          "acquirerReferenceNumber": "example",
          "caseNumber": "example",
          "dateOfEvent": "2026-01-15",
          "disputeId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
          "fundingAmount": 0,
          "fundingCurrency": "example",
          "fundsReleaseDate": "2026-01-15",
          "fundsTransferDescriptor": "example",
          "fundsTransferId": "c9a1e2d3-4b5f-6789-0abc-def123456789",
          "id": "d8b2f3e4-5c6a-7890-1bcd-ef2345678901",
          "lifeCycle": "ARBITRATION",
          "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",
          "perspective": "PARTNER",
          "processingNetwork": "example",
          "transactionId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
          "transactionReference": "example"
        }
      ],
      "pageInfo": {
        "hasNextPage": true,
        "hasPreviousPage": true
      }
    }
  }
}

Query

Arguments

input · FundingDisputeEventInput! · required

Show child attributes

paging · PagingInput! · required

See PagingInput

where · FundingDisputeEventsFilterInput! · required

Show child attributes

acceptorId · GuidFilterInput

See GuidFilterInput

dateOfEvent · DateRangeFilterInput

See DateRangeFilterInput

fundsReleaseDate · DateRangeFilterInput

See DateRangeFilterInput

fundsTransferId · GuidFilterInput

See GuidFilterInput

paymentBrand · EnumFilterInputOfPaymentBrandInput

See EnumFilterInputOfPaymentBrandInput

perspective · EnumFilterInputOfPerspectiveInput

See EnumFilterInputOfPerspectiveInput

Return type

FundingDisputeEventOutputCollection

items · [FundingDisputeEventOutput!]! · required

Show child attributes

acceptor · Acceptor

See Acceptor

acquirerReferenceNumber · String! · required

The Acquirer Reference Number (ARN) is a unique 23 digit number created by Tesouro, that was assigned to the original transaction and provided to the acquiring and issuing banks for their purpose of tracing the transaction through the full process until it is funded to the bank.

caseNumber · String

The case number assigned to the dispute.

dateOfEvent · Date

The date the dispute lifecycle was received.

disputeId · UUID! · required

A unique identifier created and used internally by Tesouro, and assigned to the dispute.

fundingAmount · Decimal

The funded amount of the dispute, which may be different from the “dispute amount” if the original transaction’s amount was presented in a different currency than its funding currency.

fundingCurrency · String

The currency associated with the dispute funding amount

fundsReleaseDate · Date

The date the debited or credited funds for the dispute lifecycle were released.

fundsTransferDescriptor · String

A value created by Tesouro and sent with the funds transfer to the recipient’s bank for display on the bank statement. It includes information on who sent the money and the purpose of the payment. The recipient can use this value to help with bank and transaction reconciliation.

fundsTransferId · UUID

A unique identifier created by Tesouro and assigned to the transfer of money to a bank account for this dispute, that identifies a cohort of funded transactions making up the transfer.

id · UUID! · required

A unique identifier created by Tesouro and assigned to the dispute event resulting in the credit or debit.

lifeCycle · DisputeLifeCycle! · required

Specifies where in the life cycle the dispute is at, e.g., Retrieval request, Chargeback, Representment, Pre-arbitration, etc.

See DisputeLifeCycle

organization · Organization! · required

See Organization

paymentBrand · PaymentBrand

The brand of payment method used.

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.

perspective · Perspective

The perspective of the dispute, which can be either ‘Acceptor’ or ‘Partner’. This field is used to determine the perspective from which the dispute is reported.

See Perspective

processingNetwork · String

The processing network that the transaction was sent across, which may be unaffiliated with the card brand.

transactionId · UUID! · required

A unique identifier assigned by Tesouro for the transaction associated with this dispute event.

transactionReference · String

A unique transaction identifier created by the entity holding the direct relationship with the Acceptor. Tesouro uses this identifier to manage idempotency.

pageInfo · PageInfo! · required

Show child attributes

hasNextPage · Boolean! · required

hasPreviousPage · Boolean! · required

Operation

query FundingDisputeEvents($input: FundingDisputeEventInput!) {
  fundingDisputeEvents(input: $input) {
    items {
      acceptor {
        businessName
        fundingDisputeEvents
        id
        name
        reference
      }
      acquirerReferenceNumber
      caseNumber
      dateOfEvent
      disputeId
      fundingAmount
      fundingCurrency
      fundsReleaseDate
      fundsTransferDescriptor
      fundsTransferId
      id
      lifeCycle
      organization {
        businessName
        capabilities
        fundingDisputeEvents
        id
        legalName
        name
        phoneNumber
      }
      paymentBrand
      paymentId
      perspective
      processingNetwork
      transactionId
      transactionReference
    }
    pageInfo {
      hasNextPage
      hasPreviousPage
    }
  }
}

Response

{
  "data": {
    "fundingDisputeEvents": {
      "items": [
        {
          "acceptor": {
            "allocations": "example",
            "authorizationSummaries": "example",
            "billingDescriptor": "CLACKSWORTH KEYBOARDS",
            "businessName": "Clacksworth Keyboards",
            "fees": "example",
            "feeSummaries": "example",
            "fundingAchReturns": "example",
            "fundingDisputeEvents": "example",
            "fundingSummaries": "example",
            "fundingTransactions": "example",
            "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "name": "Ben Torres",
            "paymentTransactions": "example",
            "paymentTransactionSummaries": "example",
            "reference": "example"
          },
          "acquirerReferenceNumber": "example",
          "caseNumber": "example",
          "dateOfEvent": "2026-01-15",
          "disputeId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
          "fundingAmount": 0,
          "fundingCurrency": "example",
          "fundsReleaseDate": "2026-01-15",
          "fundsTransferDescriptor": "example",
          "fundsTransferId": "c9a1e2d3-4b5f-6789-0abc-def123456789",
          "id": "d8b2f3e4-5c6a-7890-1bcd-ef2345678901",
          "lifeCycle": "ARBITRATION",
          "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",
          "perspective": "PARTNER",
          "processingNetwork": "example",
          "transactionId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
          "transactionReference": "example"
        }
      ],
      "pageInfo": {
        "hasNextPage": true,
        "hasPreviousPage": true
      }
    }
  }
}