paymentTransaction

query PaymentTransaction($id: UUID!) {
  paymentTransaction(id: $id) {
    acceptor {
      allocations {

      }
      authorizationSummaries {

      }
      billingDescriptor {
        city
        name
        serviceFeeName
        state
      }
      businessName
      fees {

      }
      feeSummaries {

      }
      fundingAchReturns {

      }
      fundingDisputeEvents {

      }
      fundingSummaries {

      }
      fundingTransactions {

      }
      id
      name
      paymentTransactions {
        items
      }
      paymentTransactionSummaries {

      }
      reference
    }
    activityDate
    amountDetails {
      cashBack
      convenienceFee
      discount
      duty
      gratuity
      serviceFee
      shipping
      subTotal
      surcharge
    }
    billingDescriptor
    businessApplicationId
    fees {
      items {
        billableEventAmount
        calculatedAmount
        currency
        name
        rateMultiplier
        rateUnitAmount
        type
      }
      summary {
        interchangeAmount
        networkAmount
        partnerAmount
        processorAmount
        totalAmount
      }
    }
    id
    lineItems {
      commodityCode
      description
      discountAmount
      lineItemAmount
      productCode
      productSku
      taxDetails {
        localAmount
        nationalAmount
        totalAmount
      }
      unitOfMeasure
      unitPrice
      unitQuantity
    }
    location {
      id
      outlet {
        id
      }
    }
    merchantCategory
    organization {
      acceptorApplicationCounts {
        acceptorApplicationStatus
        total
      }
      acceptors {

      }
      achNotificationsOfChange {

      }
      achReturns {

      }
      allocations {

      }
      allowedMerchantCategories {
        code
      }
      authorizationSummaries {

      }
      businessAddress {
        address1
        address2
        address3
        city
        countryCode
        postalCode
        state
      }
      businessName
      capabilities
      fees {

      }
      feeSummaries {

      }
      fundingAchReturns {

      }
      fundingDisbursementReturns {

      }
      fundingDisputeEvents {

      }
      fundingSummaries {

      }
      fundingTransactions {

      }
      id
      legalName
      name
      paymentTransactions {
        items
      }
      paymentTransactionSummaries {

      }
      phoneNumber
      reportAvailability {
        availabilityEndDate
        availabilityStartDate
        dateType
      }
      settings {

      }
    }
    paymentId
    paymentMethod {
      acquirerToken
      brand
      type
    }
    processingNetwork
    processorResponseCode
    processorResponseMessage
    reference
    responseType
    resultLabel
    taxes {
      localAmount
      nationalAmount
      totalAmount
    }
    taxIdentificationNumber
    transactionDateTime
    transactionType

}
}

{
  "data": {
    "paymentTransaction": {
      "acceptor": {
        "allocations": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "authorizationSummaries": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "billingDescriptor": {
          "city": "example",
          "name": "Ben Torres",
          "serviceFeeName": "example",
          "state": "example"
        },
        "businessName": "Clacksworth Keyboards",
        "fees": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "feeSummaries": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "fundingAchReturns": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "fundingDisputeEvents": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "fundingSummaries": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "fundingTransactions": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "name": "Ben Torres",
        "paymentTransactions": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "paymentTransactionSummaries": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "reference": "example"
      },
      "activityDate": "2026-01-15",
      "amountDetails": {
        "cashBack": 0,
        "convenienceFee": 0,
        "discount": 0,
        "duty": 0,
        "gratuity": 0,
        "serviceFee": 0,
        "shipping": 0,
        "subTotal": 0,
        "surcharge": 0
      },
      "billingDescriptor": "CLACKSWORTH KEYBOARDS",
      "businessApplicationId": "CB",
      "fees": {
        "items": [
          {
            "billableEventAmount": 0,
            "calculatedAmount": 0,
            "currency": "example",
            "name": "Ben Torres",
            "rateMultiplier": 0,
            "rateUnitAmount": 0,
            "type": "SETTLEMENT"
          }
        ],
        "summary": {
          "interchangeAmount": 0,
          "networkAmount": 0,
          "partnerAmount": 0,
          "processorAmount": 0,
          "totalAmount": 0
        }
      },
      "id": "c9a1e2d3-4b5f-6789-0abc-def123456789",
      "lineItems": [
        {
          "commodityCode": "example",
          "description": "example",
          "discountAmount": 0,
          "lineItemAmount": 0,
          "productCode": "example",
          "productSku": "example",
          "taxDetails": {
            "localAmount": 0,
            "nationalAmount": 0,
            "totalAmount": 0
          },
          "unitOfMeasure": "example",
          "unitPrice": 0,
          "unitQuantity": 0
        }
      ],
      "location": {
        "id": "d8b2f3e4-5c6a-7890-1bcd-ef2345678901",
        "outlet": {
          "id": "e7c3a4b5-6d7e-8901-2cde-f34567890123",
          "pointOfInteraction": "example"
        }
      },
      "merchantCategory": "example",
      "organization": {
        "acceptorApplicationCounts": [
          {
            "acceptorApplicationStatus": "APPROVED",
            "total": 0
          }
        ],
        "acceptors": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "achNotificationsOfChange": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "achReturns": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "allocations": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "allowedMerchantCategories": [
          {
            "code": "example"
          }
        ],
        "authorizationSummaries": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "businessAddress": {
          "address1": "example",
          "address2": "example",
          "address3": "example",
          "city": "example",
          "countryCode": "AFG",
          "postalCode": "example",
          "state": "example"
        },
        "businessName": "Clacksworth Keyboards",
        "capabilities": [
          "ACQUIRING"
        ],
        "fees": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "feeSummaries": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "fundingAchReturns": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "fundingDisbursementReturns": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "fundingDisputeEvents": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "fundingSummaries": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "fundingTransactions": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "id": "b6d4e5f6-7a8b-9012-3def-456789012345",
        "legalName": "example",
        "name": "Ben Torres",
        "paymentTransactions": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "paymentTransactionSummaries": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "phoneNumber": "example",
        "reportAvailability": [
          {
            "availabilityEndDate": "2026-01-15",
            "availabilityStartDate": "2026-01-15",
            "dateType": "ACTIVITY_DATE"
          }
        ],
        "settings": {
          "access": "example"
        }
      },
      "paymentId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "paymentMethod": {
        "acquirerToken": "example",
        "brand": "VISA",
        "type": "CARD"
      },
      "processingNetwork": "VISA",
      "processorResponseCode": "A0000",
      "processorResponseMessage": "example",
      "reference": "example",
      "responseType": "APPROVAL",
      "resultLabel": "example",
      "taxes": {
        "localAmount": 0,
        "nationalAmount": 0,
        "totalAmount": 0
      },
      "taxIdentificationNumber": "example",
      "transactionDateTime": "2026-01-15T14:30:00Z",
      "transactionType": "AUTHORIZATION"
    }
  }
}

query PaymentTransaction($id: UUID!) {
  paymentTransaction(id: $id) {
    acceptor {
      allocations {

      }
      authorizationSummaries {

      }
      billingDescriptor {
        city
        name
        serviceFeeName
        state
      }
      businessName
      fees {

      }
      feeSummaries {

      }
      fundingAchReturns {

      }
      fundingDisputeEvents {

      }
      fundingSummaries {

      }
      fundingTransactions {

      }
      id
      name
      paymentTransactions {
        items
      }
      paymentTransactionSummaries {

      }
      reference
    }
    activityDate
    amountDetails {
      cashBack
      convenienceFee
      discount
      duty
      gratuity
      serviceFee
      shipping
      subTotal
      surcharge
    }
    billingDescriptor
    businessApplicationId
    fees {
      items {
        billableEventAmount
        calculatedAmount
        currency
        name
        rateMultiplier
        rateUnitAmount
        type
      }
      summary {
        interchangeAmount
        networkAmount
        partnerAmount
        processorAmount
        totalAmount
      }
    }
    id
    lineItems {
      commodityCode
      description
      discountAmount
      lineItemAmount
      productCode
      productSku
      taxDetails {
        localAmount
        nationalAmount
        totalAmount
      }
      unitOfMeasure
      unitPrice
      unitQuantity
    }
    location {
      id
      outlet {
        id
      }
    }
    merchantCategory
    organization {
      acceptorApplicationCounts {
        acceptorApplicationStatus
        total
      }
      acceptors {

      }
      achNotificationsOfChange {

      }
      achReturns {

      }
      allocations {

      }
      allowedMerchantCategories {
        code
      }
      authorizationSummaries {

      }
      businessAddress {
        address1
        address2
        address3
        city
        countryCode
        postalCode
        state
      }
      businessName
      capabilities
      fees {

      }
      feeSummaries {

      }
      fundingAchReturns {

      }
      fundingDisbursementReturns {

      }
      fundingDisputeEvents {

      }
      fundingSummaries {

      }
      fundingTransactions {

      }
      id
      legalName
      name
      paymentTransactions {
        items
      }
      paymentTransactionSummaries {

      }
      phoneNumber
      reportAvailability {
        availabilityEndDate
        availabilityStartDate
        dateType
      }
      settings {

      }
    }
    paymentId
    paymentMethod {
      acquirerToken
      brand
      type
    }
    processingNetwork
    processorResponseCode
    processorResponseMessage
    reference
    responseType
    resultLabel
    taxes {
      localAmount
      nationalAmount
      totalAmount
    }
    taxIdentificationNumber
    transactionDateTime
    transactionType

}
}

{
  "data": {
    "paymentTransaction": {
      "acceptor": {
        "allocations": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "authorizationSummaries": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "billingDescriptor": {
          "city": "example",
          "name": "Ben Torres",
          "serviceFeeName": "example",
          "state": "example"
        },
        "businessName": "Clacksworth Keyboards",
        "fees": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "feeSummaries": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "fundingAchReturns": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "fundingDisputeEvents": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "fundingSummaries": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "fundingTransactions": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "name": "Ben Torres",
        "paymentTransactions": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "paymentTransactionSummaries": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "reference": "example"
      },
      "activityDate": "2026-01-15",
      "amountDetails": {
        "cashBack": 0,
        "convenienceFee": 0,
        "discount": 0,
        "duty": 0,
        "gratuity": 0,
        "serviceFee": 0,
        "shipping": 0,
        "subTotal": 0,
        "surcharge": 0
      },
      "billingDescriptor": "CLACKSWORTH KEYBOARDS",
      "businessApplicationId": "CB",
      "fees": {
        "items": [
          {
            "billableEventAmount": 0,
            "calculatedAmount": 0,
            "currency": "example",
            "name": "Ben Torres",
            "rateMultiplier": 0,
            "rateUnitAmount": 0,
            "type": "SETTLEMENT"
          }
        ],
        "summary": {
          "interchangeAmount": 0,
          "networkAmount": 0,
          "partnerAmount": 0,
          "processorAmount": 0,
          "totalAmount": 0
        }
      },
      "id": "c9a1e2d3-4b5f-6789-0abc-def123456789",
      "lineItems": [
        {
          "commodityCode": "example",
          "description": "example",
          "discountAmount": 0,
          "lineItemAmount": 0,
          "productCode": "example",
          "productSku": "example",
          "taxDetails": {
            "localAmount": 0,
            "nationalAmount": 0,
            "totalAmount": 0
          },
          "unitOfMeasure": "example",
          "unitPrice": 0,
          "unitQuantity": 0
        }
      ],
      "location": {
        "id": "d8b2f3e4-5c6a-7890-1bcd-ef2345678901",
        "outlet": {
          "id": "e7c3a4b5-6d7e-8901-2cde-f34567890123",
          "pointOfInteraction": "example"
        }
      },
      "merchantCategory": "example",
      "organization": {
        "acceptorApplicationCounts": [
          {
            "acceptorApplicationStatus": "APPROVED",
            "total": 0
          }
        ],
        "acceptors": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "achNotificationsOfChange": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "achReturns": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "allocations": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "allowedMerchantCategories": [
          {
            "code": "example"
          }
        ],
        "authorizationSummaries": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "businessAddress": {
          "address1": "example",
          "address2": "example",
          "address3": "example",
          "city": "example",
          "countryCode": "AFG",
          "postalCode": "example",
          "state": "example"
        },
        "businessName": "Clacksworth Keyboards",
        "capabilities": [
          "ACQUIRING"
        ],
        "fees": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "feeSummaries": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "fundingAchReturns": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "fundingDisbursementReturns": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "fundingDisputeEvents": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "fundingSummaries": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "fundingTransactions": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "id": "b6d4e5f6-7a8b-9012-3def-456789012345",
        "legalName": "example",
        "name": "Ben Torres",
        "paymentTransactions": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "paymentTransactionSummaries": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "phoneNumber": "example",
        "reportAvailability": [
          {
            "availabilityEndDate": "2026-01-15",
            "availabilityStartDate": "2026-01-15",
            "dateType": "ACTIVITY_DATE"
          }
        ],
        "settings": {
          "access": "example"
        }
      },
      "paymentId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "paymentMethod": {
        "acquirerToken": "example",
        "brand": "VISA",
        "type": "CARD"
      },
      "processingNetwork": "VISA",
      "processorResponseCode": "A0000",
      "processorResponseMessage": "example",
      "reference": "example",
      "responseType": "APPROVAL",
      "resultLabel": "example",
      "taxes": {
        "localAmount": 0,
        "nationalAmount": 0,
        "totalAmount": 0
      },
      "taxIdentificationNumber": "example",
      "transactionDateTime": "2026-01-15T14:30:00Z",
      "transactionType": "AUTHORIZATION"
    }
  }
}

Query

Arguments

UUID!

required

Return type

PaymentTransaction

acceptor

Acceptor!

required

Show child attributes

allocations

AllocationDetailCollection

An itemized list of applied allocations for a given transaction activity date or funds release date.See AllocationDetailCollection

authorizationSummaries

AuthorizationSummaryCollection

A summary of authorizations (counts, amounts) for the given transaction date, grouped by acceptor, transaction currency, response code, and payment brand.See AuthorizationSummaryCollection

billingDescriptor

BillingDescriptor!

required

Billing descriptor information for the acceptor.See BillingDescriptor

businessName

String!

required

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

fees

FeeCollection

An itemized list of applied fees for a given transaction activity date or funds release date.See FeeCollection

feeSummaries

FeeSummaryCollection

A summary of aggregated fees by acceptor and fee name/program for a specified activity date or funds release date, grouped by fee type, and where applicable, payment brand, product, and funding source.See FeeSummaryCollection

fundingAchReturns

FundingAchReturnOutputCollection

An itemized list of financially impacting ach returns occuring on the pertinent funds release dates. Use this report to track ach return-related money-movements.See FundingAchReturnOutputCollection

fundingDisputeEvents

FundingDisputeEventOutputCollection

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

fundingSummaries

FundingSummaryCollection

A summary of financial activity for a given funds release date or transaction activity date. Use this report to understand financial impact of daily sales, reconcile sales activity to your bank deposits, or drill deeper into the composition of your funding.See FundingSummaryCollection

fundingTransactions

FundingTransactionCollection

An itemized list of funded transactions (captures, sales, and refunds) for the selected transaction activity date or funds release date.See FundingTransactionCollection

UUID!

required

The id of the acceptor as defined in their profile.

name

String!

required

deprecated

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

paymentTransactions

PaymentTransactionCollection

A list of transaction requests (including conveyed) submitted on the pertinent transaction activity dates. Use this report as an operational tool to reconcile against your internal record of submitted transactions.See PaymentTransactionCollection

paymentTransactionSummaries

PaymentTransactionSummaryCollection

A summary of transaction aggregates (counts and amounts, including conveyed transactions) by pertinent transaction type, currency, card brand, and transaction activity date.See PaymentTransactionSummaryCollection

reference

String!

required

The acceptor provided reference as defined in their profile.

activityDate

Date

The date Tesouro recognized the payment request based upon the acceptor cutoff.

amountDetails

AmountDetails

Components of the requested amount that may or may not have been provided by the presenter on the payment transaction request.

Show child attributes

cashBack

Decimal

The amount of cashback requested by the presenter.

convenienceFee

Decimal

The total amount of convenience fees collected.

discount

Decimal

Total discount amount applied to the order.

duty

Decimal

Total charges for any import or export duties included in the order.

gratuity

Decimal

The amount of gratuity requested by the presenter.

serviceFee

Decimal

The total amount of service fees collected.

shipping

Decimal

Total shipping charges for the transaction.

subTotal

Decimal

The sum of all item costs in the transaction before applying any additional charges such as taxes, or fees.

surcharge

Decimal

The total amount of surcharge collected.

billingDescriptor

String

The billing descriptor name that appears on the customer’s statement.

businessApplicationId

BusinessApplicationId

The business application identifier (BAI) is a value provided by Visa to identify the type of transfer that is being performed.

Show Possible enum values

enum

Consumer Bill Pay

fees

FeeDetails

Aggregate information for assessed fees

Show child attributes

items

[ItemizedFee!]!

required

An itemized collection of each fee applicable to the transaction entity.See ItemizedFee

summary

FeeSummaryTotals!

required

Total amount of various fee types.See FeeSummaryTotals

UUID!

required

A unique identifier assigned by Tesouro for every transaction request received.

lineItems

[LineItem!]

Line items associated with the payment transaction.

Show child attributes

commodityCode

String

A specific code used to classify and categorize the type of goods and services being purchased.

description

String

Description of the goods or services.

discountAmount

Decimal

Details regarding any discounts applied to the line item.

lineItemAmount

Decimal

The total amount of the item. Calculated as [Unit price * Unit quantity]

productCode

String

The supplier’s unique product identifier, inventory number, or UPC code used to identity a specific product.

productSku

String

A SKU, or Stock Keeping Unit, is a unique alphanumeric code assigned by a retailer to identify and track each distinct product or product variation within their inventory.

taxDetails

LineItemTaxes

Tax details applicable to the individual line item. If the item is not taxable, these fields should be set to null.See LineItemTaxes

unitOfMeasure

String

The metric used for understanding the quantity of a given line item. e.g., for quantities, use “each” or “piece” for length, use “meter” or “inch” for volume, use “liter” or “gallon” and for weight, use “gram” or “pound”, etc.

unitPrice

Decimal

The “per unit” price of the line item.

unitQuantity

Decimal

The number of units included in the line item.

location

Location

The location where this transaction took place.

Show child attributes

UUID!

required

The unique identifier assigned by Tesouro for this location.

outlet

Outlet

The outlet associated with this transaction.See Outlet

merchantCategory

String

Unique ISO four digit values used to classify merchants and their transactions into specific categories based on the type of business, trade or services supplied.

organization

Organization!

required

Show child attributes

acceptorApplicationCounts

[AcceptorApplicationCounts!]!

required

See AcceptorApplicationCounts

acceptors

AcceptorCollection

See AcceptorCollection

achNotificationsOfChange

AchNotificationOfChangeCollection

A Notification of Change (NOC), notifies the sender of an ACH payment that information related to the customer’s bank account was inaccurate or outdated, and provides the updated information that needs to be corrected before another payment can be sent from (or to) the account.See AchNotificationOfChangeCollection

achReturns

AchReturnCollection

An itemized list of ach returns for a given transaction activity date or acticity date.See AchReturnCollection

allocations

AllocationDetailCollection

An itemized list of applied allocations for a given transaction activity date or funds release date.See AllocationDetailCollection

allowedMerchantCategories

[MerchantCategory!]!

required

The allowed Merchant Category Codes for acceptors within this organization.See MerchantCategory

authorizationSummaries

AuthorizationSummaryCollection

A summary of authorizations (counts, amounts) for the given transaction date, grouped by acceptor, transaction currency, response code, and payment brand.See AuthorizationSummaryCollection

businessAddress

AddressOutput

The business address of the organization.See AddressOutput

businessName

String!

required

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

capabilities

[OrganizationCapability!]!

required

The product capabilities enabled for this organization.See OrganizationCapability

fees

FeeCollection

An itemized list of applied fees for a given transaction activity date or funds release date.See FeeCollection

feeSummaries

FeeSummaryCollection

fundingAchReturns

FundingAchReturnOutputCollection

An itemized list of financially impacting ACH returns occurring on the pertinent funds release dates. Use this report to track ACH return-related money-movements.See FundingAchReturnOutputCollection

fundingDisbursementReturns

FundingDisbursementReturnCollection

An itemized list of funding disbursement returns for a given activity date.See FundingDisbursementReturnCollection

fundingDisputeEvents

FundingDisputeEventOutputCollection

fundingSummaries

FundingSummaryCollection

fundingTransactions

FundingTransactionCollection

An itemized list of funded transactions (captures, sales, and refunds) for the selected transaction activity date or funds release date.See FundingTransactionCollection

UUID!

required

The id of the organization as defined in their profile.

legalName

String!

required

The legal entity name for the organization.

name

String!

required

deprecated

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

paymentTransactions

PaymentTransactionCollection

A list of payment transaction requests (including conveyed) submitted on the pertinent transaction activity dates. Use this report as an operational tool to reconcile against your internal record of submitted transactions.See PaymentTransactionCollection

paymentTransactionSummaries

PaymentTransactionSummaryCollection

phoneNumber

String

The phone number of the organization.

reportAvailability

[ReportAvailability!]

See ReportAvailability

settings

OrganizationSettingsOutput!

required

Organization settings.See OrganizationSettingsOutput

paymentId

UUID!

required

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.

paymentMethod

PaymentMethod!

required

Refers to the various options available for customers to make payments when purchasing a product or service.

Show child attributes

acquirerToken

String

The acquirer token on file for this payment card, if the card has been used before and the transactor is subscribed to Tesouro’s tokenization services. Otherwise, this field’s value will be null.

brand

PaymentBrand

The brand of payment method used.See PaymentBrand

type

PaymentMethodType

The type of payment method used by the customer to submit the transaction, e.g., Card, Bank transfer, etc.See PaymentMethodType

processingNetwork

Network!

required

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

Show Possible enum values

VISA

enum

Visa

MASTERCARD

enum

Mastercard

DISCOVER

enum

Discover

AMERICAN_EXPRESS

enum

American Express

ACH

enum

Automated Clearing House

processorResponseCode

ProcessorResponseCode!

required

A response code provided by Tesouro identifying the specific approval or decline reason.

Show Possible enum values

A0000

enum

Full amount approved.

A0001

enum

Partially approved. The transaction was approved for an amount less than the original request because the cardholder’s account balance was insufficient to cover the full amount.

A0002

enum

Purchase amount approved, not cash.

A0003

enum

Point-to-Point Encryption (P2PE) success.

A0004

enum

Account Validated.

…and 90 more values. See ProcessorResponseCode for the full list.

processorResponseMessage

String!

required

A human readable description of the authorization response code. e.g., Insufficient funds.

reference

String

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

responseType

ResponseType

The result of the authorization request, e.g., Approved or Declined.

Show Possible enum values

APPROVAL

enum

SOFT_DECLINE

enum

HARD_DECLINE

enum

REJECT

enum

resultLabel

String!

required

Short description of the payment transaction result. Examples include Approved, Insufficient funds. Intended for display purposes only.

taxes

Taxes

The various tax amounts collected on the payment transaction.

Show child attributes

localAmount

Decimal

The total amount of local taxes collected.

nationalAmount

Decimal

The total amount of national taxes collected.

totalAmount

Decimal!

required

The total amount of taxes collected.

taxIdentificationNumber

String

The last 4 digits of the tax identification number (TIN), which is a unique identifier created by the national government and associated with the acceptor at the time the transaction was submitted.

transactionDateTime

DateTime!

required

The date and time that Tesouro received the transaction, in UTC. Formatted as 2024-03-27T02:40:00Z

transactionType

PaymentTransactionType!

required

The type of payment transaction, e.g., Authorization, Capture, Sale, Refund, Reversal, etc.

Show Possible enum values

AUTHORIZATION

enum

A request to the cardholder’s issuing bank to confirm that the account is active and has enough credit or funds to make the transaction. If approved, the requested amount is put on hold in the cardholder’s account.

INCREMENTAL_AUTHORIZATION

enum

A request to adjust the amount of a previously approved authorization before it is captured.

CAPTURE

enum

A request to initiate the flow of funds from the cardholder’s issuing bank account to your merchant account. Follows an approved authorization.

SALE

enum

A request to initiate the flow of funds from the customer’s bank account to your merchant account.

REFUND

enum

A request to send money back to the cardholder’s account who has returned a purchase or no longer wants to receive services.

REVERSAL

enum

A request to cancel a previous transaction request. Authorization reversals notify the cardholder’s issuer that all or part of a transaction has been canceled and that the authorization hold should be released.

CARD_VERIFICATION

enum

Performs address and card security code checks on a cardholder’s account to ensure it is in good standing, without actually charging an amount to the card.

REFUND_AUTHORIZATION

enum

A request to the cardholder’s issuing bank to confirm that the account is active and capable of completing the refund transaction.

BANK_ACCOUNT_VALIDATION

enum

Validates a bank account to ensure that the account belongs to the person or entity that claims to own it.

query PaymentTransaction($id: UUID!) {
  paymentTransaction(id: $id) {
    acceptor {
      allocations {

      }
      authorizationSummaries {

      }
      billingDescriptor {
        city
        name
        serviceFeeName
        state
      }
      businessName
      fees {

      }
      feeSummaries {

      }
      fundingAchReturns {

      }
      fundingDisputeEvents {

      }
      fundingSummaries {

      }
      fundingTransactions {

      }
      id
      name
      paymentTransactions {
        items
      }
      paymentTransactionSummaries {

      }
      reference
    }
    activityDate
    amountDetails {
      cashBack
      convenienceFee
      discount
      duty
      gratuity
      serviceFee
      shipping
      subTotal
      surcharge
    }
    billingDescriptor
    businessApplicationId
    fees {
      items {
        billableEventAmount
        calculatedAmount
        currency
        name
        rateMultiplier
        rateUnitAmount
        type
      }
      summary {
        interchangeAmount
        networkAmount
        partnerAmount
        processorAmount
        totalAmount
      }
    }
    id
    lineItems {
      commodityCode
      description
      discountAmount
      lineItemAmount
      productCode
      productSku
      taxDetails {
        localAmount
        nationalAmount
        totalAmount
      }
      unitOfMeasure
      unitPrice
      unitQuantity
    }
    location {
      id
      outlet {
        id
      }
    }
    merchantCategory
    organization {
      acceptorApplicationCounts {
        acceptorApplicationStatus
        total
      }
      acceptors {

      }
      achNotificationsOfChange {

      }
      achReturns {

      }
      allocations {

      }
      allowedMerchantCategories {
        code
      }
      authorizationSummaries {

      }
      businessAddress {
        address1
        address2
        address3
        city
        countryCode
        postalCode
        state
      }
      businessName
      capabilities
      fees {

      }
      feeSummaries {

      }
      fundingAchReturns {

      }
      fundingDisbursementReturns {

      }
      fundingDisputeEvents {

      }
      fundingSummaries {

      }
      fundingTransactions {

      }
      id
      legalName
      name
      paymentTransactions {
        items
      }
      paymentTransactionSummaries {

      }
      phoneNumber
      reportAvailability {
        availabilityEndDate
        availabilityStartDate
        dateType
      }
      settings {

      }
    }
    paymentId
    paymentMethod {
      acquirerToken
      brand
      type
    }
    processingNetwork
    processorResponseCode
    processorResponseMessage
    reference
    responseType
    resultLabel
    taxes {
      localAmount
      nationalAmount
      totalAmount
    }
    taxIdentificationNumber
    transactionDateTime
    transactionType

}
}

{
  "data": {
    "paymentTransaction": {
      "acceptor": {
        "allocations": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "authorizationSummaries": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "billingDescriptor": {
          "city": "example",
          "name": "Ben Torres",
          "serviceFeeName": "example",
          "state": "example"
        },
        "businessName": "Clacksworth Keyboards",
        "fees": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "feeSummaries": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "fundingAchReturns": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "fundingDisputeEvents": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "fundingSummaries": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "fundingTransactions": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "name": "Ben Torres",
        "paymentTransactions": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "paymentTransactionSummaries": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "reference": "example"
      },
      "activityDate": "2026-01-15",
      "amountDetails": {
        "cashBack": 0,
        "convenienceFee": 0,
        "discount": 0,
        "duty": 0,
        "gratuity": 0,
        "serviceFee": 0,
        "shipping": 0,
        "subTotal": 0,
        "surcharge": 0
      },
      "billingDescriptor": "CLACKSWORTH KEYBOARDS",
      "businessApplicationId": "CB",
      "fees": {
        "items": [
          {
            "billableEventAmount": 0,
            "calculatedAmount": 0,
            "currency": "example",
            "name": "Ben Torres",
            "rateMultiplier": 0,
            "rateUnitAmount": 0,
            "type": "SETTLEMENT"
          }
        ],
        "summary": {
          "interchangeAmount": 0,
          "networkAmount": 0,
          "partnerAmount": 0,
          "processorAmount": 0,
          "totalAmount": 0
        }
      },
      "id": "c9a1e2d3-4b5f-6789-0abc-def123456789",
      "lineItems": [
        {
          "commodityCode": "example",
          "description": "example",
          "discountAmount": 0,
          "lineItemAmount": 0,
          "productCode": "example",
          "productSku": "example",
          "taxDetails": {
            "localAmount": 0,
            "nationalAmount": 0,
            "totalAmount": 0
          },
          "unitOfMeasure": "example",
          "unitPrice": 0,
          "unitQuantity": 0
        }
      ],
      "location": {
        "id": "d8b2f3e4-5c6a-7890-1bcd-ef2345678901",
        "outlet": {
          "id": "e7c3a4b5-6d7e-8901-2cde-f34567890123",
          "pointOfInteraction": "example"
        }
      },
      "merchantCategory": "example",
      "organization": {
        "acceptorApplicationCounts": [
          {
            "acceptorApplicationStatus": "APPROVED",
            "total": 0
          }
        ],
        "acceptors": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "achNotificationsOfChange": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "achReturns": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "allocations": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "allowedMerchantCategories": [
          {
            "code": "example"
          }
        ],
        "authorizationSummaries": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "businessAddress": {
          "address1": "example",
          "address2": "example",
          "address3": "example",
          "city": "example",
          "countryCode": "AFG",
          "postalCode": "example",
          "state": "example"
        },
        "businessName": "Clacksworth Keyboards",
        "capabilities": [
          "ACQUIRING"
        ],
        "fees": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "feeSummaries": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "fundingAchReturns": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "fundingDisbursementReturns": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "fundingDisputeEvents": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "fundingSummaries": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "fundingTransactions": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "id": "b6d4e5f6-7a8b-9012-3def-456789012345",
        "legalName": "example",
        "name": "Ben Torres",
        "paymentTransactions": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "paymentTransactionSummaries": {
          "items": [
            "example"
          ],
          "pageInfo": "example"
        },
        "phoneNumber": "example",
        "reportAvailability": [
          {
            "availabilityEndDate": "2026-01-15",
            "availabilityStartDate": "2026-01-15",
            "dateType": "ACTIVITY_DATE"
          }
        ],
        "settings": {
          "access": "example"
        }
      },
      "paymentId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "paymentMethod": {
        "acquirerToken": "example",
        "brand": "VISA",
        "type": "CARD"
      },
      "processingNetwork": "VISA",
      "processorResponseCode": "A0000",
      "processorResponseMessage": "example",
      "reference": "example",
      "responseType": "APPROVAL",
      "resultLabel": "example",
      "taxes": {
        "localAmount": 0,
        "nationalAmount": 0,
        "totalAmount": 0
      },
      "taxIdentificationNumber": "example",
      "transactionDateTime": "2026-01-15T14:30:00Z",
      "transactionType": "AUTHORIZATION"
    }
  }
}

Funding transactions Payment transactions

⌘I

Boarding

Transaction Processing

Risk, Compliance & Dispute Management

Reporting

Types

paymentTransaction

Arguments

Return type

Boarding

Transaction Processing

Risk, Compliance & Dispute Management

Reporting

Types

​Arguments

​Return type

Arguments

Return type