> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tesouro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PaymentTransactionCollection

`OBJECT`

## Fields

<ResponseField name="items" type="[PaymentTransaction!]!" required>
  <Expandable title="child attributes">
    <ResponseField name="acceptor" type="Acceptor!" required>
      <Expandable title="child attributes">
        <ResponseField name="allocations" type="AllocationDetailCollection">
          An itemized list of applied allocations for a given transaction activity date or funds release date.

          See [AllocationDetailCollection](/underwriting/reference/graphql/types/allocation-detail-collection)
        </ResponseField>

        <ResponseField name="authorizationSummaries" type="AuthorizationSummaryCollection">
          A summary of authorizations (counts, amounts) for the given transaction date, grouped by acceptor, transaction currency, response code, and payment brand.

          See [AuthorizationSummaryCollection](/underwriting/reference/graphql/types/authorization-summary-collection)
        </ResponseField>

        <ResponseField name="billingDescriptor" type="BillingDescriptor!" required>
          Billing descriptor information for the acceptor.

          <Expandable title="child attributes">
            <ResponseField name="city" type="String!" required>
              The acceptor's city that will appear on a credit card statement.  Maximum 13 characters.
            </ResponseField>

            <ResponseField name="name" type="String!" required>
              The descriptive name for the acceptor that will appear on a credit card statement.  Maximum 22 characters.
            </ResponseField>

            <ResponseField name="serviceFeeName" type="String!" required>
              The descriptive name for the acceptor's service fee that may appear on a credit card statement.  Maximum 22 characters.
            </ResponseField>

            <ResponseField name="state" type="String!" required>
              The 2-letter abbreviation of the acceptor's state that will appear on a credit card statement.
            </ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="businessName" type="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".
        </ResponseField>

        <ResponseField name="fees" type="FeeCollection">
          An itemized list of applied fees for a given transaction activity date or funds release date.

          See [FeeCollection](/underwriting/reference/graphql/types/fee-collection)
        </ResponseField>

        <ResponseField name="feeSummaries" type="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](/underwriting/reference/graphql/types/fee-summary-collection)
        </ResponseField>

        <ResponseField name="fundingAchReturns" type="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](/underwriting/reference/graphql/types/funding-ach-return-output-collection)
        </ResponseField>

        <ResponseField name="fundingDisputeEvents" type="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](/underwriting/reference/graphql/types/funding-dispute-event-output-collection)
        </ResponseField>

        <ResponseField name="fundingSummaries" type="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](/underwriting/reference/graphql/types/funding-summary-collection)
        </ResponseField>

        <ResponseField name="fundingTransactions" type="FundingTransactionCollection">
          An itemized list of funded transactions (captures, sales, and refunds) for the selected transaction activity date or funds release date.

          See [FundingTransactionCollection](/underwriting/reference/graphql/types/funding-transaction-collection)
        </ResponseField>

        <ResponseField name="id" type="UUID!" required>
          The id of the acceptor as defined in their profile.
        </ResponseField>

        <ResponseField name="name" type="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.
        </ResponseField>

        <ResponseField name="paymentTransactions" type="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.
        </ResponseField>

        <ResponseField name="paymentTransactionSummaries" type="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](/underwriting/reference/graphql/types/payment-transaction-summary-collection)
        </ResponseField>

        <ResponseField name="reference" type="String!" required>
          The acceptor provided reference as defined in their profile.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="activityDate" type="Date">
      The date Tesouro recognized the payment request based upon the acceptor cutoff.
    </ResponseField>

    <ResponseField name="amountDetails" type="AmountDetails">
      Components of the requested amount that may or may not have been provided by the presenter on the payment transaction request.

      <Expandable title="child attributes">
        <ResponseField name="cashBack" type="Decimal">
          The amount of cashback requested by the presenter.
        </ResponseField>

        <ResponseField name="convenienceFee" type="Decimal">
          The total amount of convenience fees collected.
        </ResponseField>

        <ResponseField name="discount" type="Decimal">
          Total discount amount applied to the order.
        </ResponseField>

        <ResponseField name="duty" type="Decimal">
          Total charges for any import or export duties included in the order.
        </ResponseField>

        <ResponseField name="gratuity" type="Decimal">
          The amount of gratuity requested by the presenter.
        </ResponseField>

        <ResponseField name="serviceFee" type="Decimal">
          The total amount of service fees collected.
        </ResponseField>

        <ResponseField name="shipping" type="Decimal">
          Total shipping charges for the transaction.
        </ResponseField>

        <ResponseField name="subTotal" type="Decimal">
          The sum of all item costs in the transaction before applying any additional charges such as taxes, or fees.
        </ResponseField>

        <ResponseField name="surcharge" type="Decimal">
          The total amount of surcharge collected.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="billingDescriptor" type="String">
      The billing descriptor name that appears on the customer's statement.
    </ResponseField>

    <ResponseField name="businessApplicationId" type="BusinessApplicationId">
      The business application identifier (BAI) is a value provided by Visa to identify the type of transfer that is being performed.

      <Expandable title="Possible enum values">
        <ResponseField name="CB" type="enum">
          Consumer Bill Pay
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="fees" type="FeeDetails">
      Aggregate information for assessed fees

      <Expandable title="child attributes">
        <ResponseField name="items" type="[ItemizedFee!]!" required>
          An itemized collection of each fee applicable to the transaction entity.

          <Expandable title="child attributes">
            <ResponseField name="billableEventAmount" type="Decimal">
              The amount tied to the billable event on which the fee is applied.
            </ResponseField>

            <ResponseField name="calculatedAmount" type="Decimal!" required>
              The total amount of the fee, calculated as \[(billableEventAmount \* rateMultiplier) + rateUnitAmount]. e.g., $100.00 * 0.035 + $0.10 = \$3.60
            </ResponseField>

            <ResponseField name="currency" type="String!" required>
              The currency of the fee amount.
            </ResponseField>

            <ResponseField name="name" type="String!" required>
              The name of the itemized fee or allocation.
            </ResponseField>

            <ResponseField name="rateMultiplier" type="Decimal!" required>
              The variable rate, expressed as a decimal, used to calculate the total fee amount. e.g., 3.50% would be expressed as 0.035
            </ResponseField>

            <ResponseField name="rateUnitAmount" type="Decimal!" required>
              The fixed amount per transaction used in the rate to calculate the total fee amount. e.g., \$0.10 per transaction.
            </ResponseField>

            <ResponseField name="type" type="AllocationType!" required>
              The type of fee or allocation, e.g.. Interchange, Network fee, Processor fee, or Partner fee

              <Expandable title="Possible enum values">
                <ResponseField name="SETTLEMENT" type="enum" />

                <ResponseField name="INTERCHANGE_FEE" type="enum" />

                <ResponseField name="ASSESSMENT_FEE" type="enum" />

                <ResponseField name="PROCESSOR_FEE" type="enum" />

                <ResponseField name="PRESENTER_FEE" type="enum" />

                ...and 16 more values. See [AllocationType](/underwriting/reference/graphql/types/allocation-type) for the full list.
              </Expandable>
            </ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="summary" type="FeeSummaryTotals!" required>
          Total amount of various fee types.

          <Expandable title="child attributes">
            <ResponseField name="interchangeAmount" type="Decimal!" required>
              The total amount of interchange fees collected.
            </ResponseField>

            <ResponseField name="networkAmount" type="Decimal!" required>
              The total amount of network fees collected.
            </ResponseField>

            <ResponseField name="partnerAmount" type="Decimal!" required>
              The total amount of partner fees collected.
            </ResponseField>

            <ResponseField name="processorAmount" type="Decimal!" required>
              The total amount of processor fees collected.
            </ResponseField>

            <ResponseField name="totalAmount" type="Decimal!" required>
              The total amount of fees collected.
            </ResponseField>
          </Expandable>
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="id" type="UUID!" required>
      A unique identifier assigned by Tesouro for every transaction request received.
    </ResponseField>

    <ResponseField name="lineItems" type="[LineItem!]">
      Line items associated with the payment transaction.

      <Expandable title="child attributes">
        <ResponseField name="commodityCode" type="String">
          A specific code used to classify and categorize the type of goods and services being purchased.
        </ResponseField>

        <ResponseField name="description" type="String">
          Description of the goods or services.
        </ResponseField>

        <ResponseField name="discountAmount" type="Decimal">
          Details regarding any discounts applied to the line item.
        </ResponseField>

        <ResponseField name="lineItemAmount" type="Decimal">
          The total amount of the item. Calculated as \[Unit price \* Unit quantity]
        </ResponseField>

        <ResponseField name="productCode" type="String">
          The supplier's unique product identifier, inventory number, or UPC code used to identity a specific product.
        </ResponseField>

        <ResponseField name="productSku" type="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.
        </ResponseField>

        <ResponseField name="taxDetails" type="LineItemTaxes">
          Tax details applicable to the individual line item. If the item is not taxable, these fields should be set to null.

          <Expandable title="child attributes">
            <ResponseField name="localAmount" type="Decimal">
              The total amount of local taxes collected.
            </ResponseField>

            <ResponseField name="nationalAmount" type="Decimal">
              The total amount of national taxes collected.
            </ResponseField>

            <ResponseField name="totalAmount" type="Decimal">
              The total amount of taxes collected.
            </ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="unitOfMeasure" type="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.
        </ResponseField>

        <ResponseField name="unitPrice" type="Decimal">
          The "per unit" price of the line item.
        </ResponseField>

        <ResponseField name="unitQuantity" type="Decimal">
          The number of units included in the line item.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="location" type="Location">
      The location where this transaction took place.

      <Expandable title="child attributes">
        <ResponseField name="id" type="UUID!" required>
          The unique identifier assigned by Tesouro for this location.
        </ResponseField>

        <ResponseField name="outlet" type="Outlet">
          The outlet associated with this transaction.

          <Expandable title="child attributes">
            <ResponseField name="id" type="UUID!" required>
              The unique identifier assigned by Tesouro for this outlet.
            </ResponseField>

            <ResponseField name="pointOfInteraction" type="PointOfInteraction">
              The point of interaction device used for this transaction.
            </ResponseField>
          </Expandable>
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="merchantCategory" type="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.
    </ResponseField>

    <ResponseField name="organization" type="Organization!" required>
      See [Organization](/underwriting/reference/graphql/types/organization)
    </ResponseField>

    <ResponseField name="paymentId" type="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.
    </ResponseField>

    <ResponseField name="paymentMethod" type="PaymentMethod!" required>
      Refers to the various options available for customers to make payments when purchasing a product or service.

      <Expandable title="child attributes">
        <ResponseField name="acquirerToken" type="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.
        </ResponseField>

        <ResponseField name="brand" type="PaymentBrand">
          The brand of payment method used.

          <Expandable title="Possible enum values">
            <ResponseField name="VISA" type="enum">
              Visa
            </ResponseField>

            <ResponseField name="MASTERCARD" type="enum">
              Mastercard
            </ResponseField>

            <ResponseField name="DISCOVER" type="enum">
              Discover
            </ResponseField>

            <ResponseField name="AMERICAN_EXPRESS" type="enum">
              American Express
            </ResponseField>

            <ResponseField name="DINERS_CLUB_INTERNATIONAL" type="enum">
              Diners Club International
            </ResponseField>

            <ResponseField name="JCB" type="enum">
              JCB
            </ResponseField>

            <ResponseField name="UNION_PAY" type="enum">
              UnionPay
            </ResponseField>

            <ResponseField name="PAYPAL" type="enum">
              PayPal
            </ResponseField>

            <ResponseField name="MAESTRO" type="enum">
              Maestro
            </ResponseField>

            <ResponseField name="PRIVATE_LABEL" type="enum">
              Private Label
            </ResponseField>

            <ResponseField name="ATM" type="enum">
              ATM
            </ResponseField>

            <ResponseField name="ELECTRON" type="enum">
              Electron
            </ResponseField>

            <ResponseField name="V_PAY" type="enum">
              V Pay
            </ResponseField>

            <ResponseField name="ACH" type="enum">
              Automated Clearing House
            </ResponseField>

            <ResponseField name="NOT_APPLICABLE" type="enum">
              Does not apply
            </ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="type" type="PaymentMethodType">
          The type of payment method used by the customer to submit the transaction, e.g., Card, Bank transfer, etc.

          <Expandable title="Possible enum values">
            <ResponseField name="CARD" type="enum" />

            <ResponseField name="NETWORK_TOKEN" type="enum" />

            <ResponseField name="BANK_ACCOUNT" type="enum" />
          </Expandable>
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="processingNetwork" type="Network!" required>
      The payment network that the transaction was sent across, which may be unaffiliated with the card brand.

      <Expandable title="Possible enum values">
        <ResponseField name="VISA" type="enum">
          Visa
        </ResponseField>

        <ResponseField name="MASTERCARD" type="enum">
          Mastercard
        </ResponseField>

        <ResponseField name="DISCOVER" type="enum">
          Discover
        </ResponseField>

        <ResponseField name="AMERICAN_EXPRESS" type="enum">
          American Express
        </ResponseField>

        <ResponseField name="ACH" type="enum">
          Automated Clearing House
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="processorResponseCode" type="ProcessorResponseCode!" required>
      A response code provided by Tesouro identifying the specific approval or decline reason.

      <Expandable title="Possible enum values">
        <ResponseField name="A0000" type="enum">
          Full amount approved.
        </ResponseField>

        <ResponseField name="A0001" type="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.
        </ResponseField>

        <ResponseField name="A0002" type="enum">
          Purchase amount approved, not cash.
        </ResponseField>

        <ResponseField name="A0003" type="enum">
          Point-to-Point Encryption (P2PE) success.
        </ResponseField>

        <ResponseField name="A0004" type="enum">
          Account Validated.
        </ResponseField>

        ...and 90 more values. See [ProcessorResponseCode](/underwriting/reference/graphql/types/processor-response-code) for the full list.
      </Expandable>
    </ResponseField>

    <ResponseField name="processorResponseMessage" type="String!" required>
      A human readable description of the authorization response code. e.g., Insufficient funds.
    </ResponseField>

    <ResponseField name="reference" type="String">
      A unique transaction identifier created by the entity holding the direct relationship with the Acceptor. Tesouro uses this identifier to manage idempotency.
    </ResponseField>

    <ResponseField name="responseType" type="ResponseType">
      The result of the authorization request, e.g., Approved or Declined.

      <Expandable title="Possible enum values">
        <ResponseField name="APPROVAL" type="enum" />

        <ResponseField name="SOFT_DECLINE" type="enum" />

        <ResponseField name="HARD_DECLINE" type="enum" />

        <ResponseField name="REJECT" type="enum" />
      </Expandable>
    </ResponseField>

    <ResponseField name="resultLabel" type="String!" required>
      Short description of the payment transaction result. Examples include Approved, Insufficient funds. Intended for display purposes only.
    </ResponseField>

    <ResponseField name="taxes" type="Taxes">
      The various tax amounts collected on the payment transaction.

      <Expandable title="child attributes">
        <ResponseField name="localAmount" type="Decimal">
          The total amount of local taxes collected.
        </ResponseField>

        <ResponseField name="nationalAmount" type="Decimal">
          The total amount of national taxes collected.
        </ResponseField>

        <ResponseField name="totalAmount" type="Decimal!" required>
          The total amount of taxes collected.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="taxIdentificationNumber" type="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.
    </ResponseField>

    <ResponseField name="transactionDateTime" type="DateTime!" required>
      The date and time that Tesouro received the transaction, in UTC. Formatted as 2024-03-27T02:40:00Z
    </ResponseField>

    <ResponseField name="transactionType" type="PaymentTransactionType!" required>
      The type of payment transaction, e.g., Authorization, Capture, Sale, Refund, Reversal, etc.

      <Expandable title="Possible enum values">
        <ResponseField name="AUTHORIZATION" type="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.
        </ResponseField>

        <ResponseField name="INCREMENTAL_AUTHORIZATION" type="enum">
          A request to adjust the amount of a previously approved authorization before it is captured.
        </ResponseField>

        <ResponseField name="CAPTURE" type="enum">
          A request to initiate the flow of funds from the cardholder's issuing bank account to your merchant account. Follows an approved authorization.
        </ResponseField>

        <ResponseField name="SALE" type="enum">
          A request to initiate the flow of funds from the customer's bank account to your merchant account.
        </ResponseField>

        <ResponseField name="REFUND" type="enum">
          A request to send money back to the cardholder's account who has returned a purchase or no longer wants to receive services.
        </ResponseField>

        <ResponseField name="REVERSAL" type="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.
        </ResponseField>

        <ResponseField name="CARD_VERIFICATION" type="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.
        </ResponseField>

        <ResponseField name="REFUND_AUTHORIZATION" type="enum">
          A request to the cardholder's issuing bank to confirm that the account is active and capable of completing the refund transaction.
        </ResponseField>

        <ResponseField name="BANK_ACCOUNT_VALIDATION" type="enum">
          Validates a bank account to ensure that the account belongs to the person or entity that claims to own it.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="pageInfo" type="PageInfo!" required>
  <Expandable title="child attributes">
    <ResponseField name="hasNextPage" type="Boolean!" required />

    <ResponseField name="hasPreviousPage" type="Boolean!" required />
  </Expandable>
</ResponseField>
