> ## 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.

# FeeSummaryCollection

`OBJECT`

## Fields

<ResponseField name="items" type="[FeeSummary!]!" required>
  <Expandable title="child attributes">
    <ResponseField name="acceptor" type="Acceptor">
      <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.
        </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.

          See [PaymentTransactionCollection](/underwriting/reference/graphql/types/payment-transaction-collection)
        </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="billableEventAmount" type="Decimal">
      The total amount of the billable type and used to calculate the Fee when a fee rate multiplier is part of the fee rate..
    </ResponseField>

    <ResponseField name="billableEventType" type="BillableType">
      Billable type of the fee

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

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

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

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

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

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

    <ResponseField name="feeActivityDate" type="Date!" required>
      The date the fee was applied
    </ResponseField>

    <ResponseField name="feeAmount" type="Decimal">
      The total amount of fees applied.
    </ResponseField>

    <ResponseField name="feeCount" type="Int">
      The number of fees
    </ResponseField>

    <ResponseField name="feeDescription" type="String">
      A detailed description of the fee or program.
    </ResponseField>

    <ResponseField name="feeName" type="String">
      The name of the fee, interchange or wholesale program.
    </ResponseField>

    <ResponseField name="feeProfileId" type="UUID!" required>
      A unique identifier created by Tesouro and assigned to each fee allocation.
    </ResponseField>

    <ResponseField name="feeRateMultiplier" type="Decimal">
      A component of the fee rate; the decimal used to multiply against the transaction amount to determine a 'percent' cost.
    </ResponseField>

    <ResponseField name="feeRateUnitAmount" type="Decimal">
      A component of the fee rate; the unit amount charged per item.
    </ResponseField>

    <ResponseField name="feeType" type="AllocationType">
      The type of fee, e.g., Interchange, Network, Processor, etc.

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

    <ResponseField name="fundingCurrency" type="String">
      The currency of the funded transaction, formatted in ISO 4217 alphabetic code.
    </ResponseField>

    <ResponseField name="fundsReleaseDate" type="Date">
      The date that Tesouro releases the funds from its bank account to the recipient's bank account.
    </ResponseField>

    <ResponseField name="fundsTransferId" type="UUID!" required>
      A unique identifier created by Tesouro and assigned to the transfer of money to a bank account, that identifies a cohort of funded transactions making up the transfer.
    </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. NOTE: This field will present a null, not applicable, or empty value if the fee is not tied to a specific transaction.
    </ResponseField>

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

    <ResponseField name="paymentBrand" type="PaymentBrand">
      Specifies which payment brand was used, e.g., Visa, Mastercard, Discover, American Express, etc. NOTE: This field will present a null, not applicable, or empty value if the fee is not tied to a specific transaction.

      <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="paymentFundingSource" type="FundingSource">
      Specifies the source of the card customer's funds , e.g., credit, debit, pre-paid. NOTE: This field will present a null, not applicable, or empty value if the fee is not tied to a specific transaction.

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

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

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

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

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

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

    <ResponseField name="paymentProduct" type="String">
      The product name according to the payment brand (e.g. World Elite Mastercard card)  NOTE: This field will present a null, not applicable, or empty value if the fee is not tied to a specific transaction.
    </ResponseField>

    <ResponseField name="perspective" type="Perspective">
      The perspective of the fee, which can be either 'Acceptor' or 'Partner'. This field is used to determine the perspective from which the fee is reported.

      <Expandable title="Possible enum values">
        <ResponseField name="PARTNER" type="enum">
          Partner perspective, where the report focuses on the partner's view of transactions and fees.
        </ResponseField>

        <ResponseField name="ACCEPTOR" type="enum">
          Acceptor perspective, where the report focuses on the acceptor's view of transactions and fees.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="processingNetwork" type="Network">
      The payment network that the transaction was sent across, which may be unafilliated with the card brand. NOTE: This field will present a null, not applicable, or empty value if the fee is not tied to a specific transaction.

      <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="productPillar" type="ProductPillar">
      The Tesouro product pillar that this fee applies to, e.g., Transaction processing; Billing & Funding; Risk, Fraud, & Dispute management; Reporting; Boarding;

      <Expandable title="Possible enum values">
        <ResponseField name="BOARDING" type="enum">
          Due diligence, underwriting, and onboarding.
        </ResponseField>

        <ResponseField name="TRANSACTION_PROCESSING" type="enum">
          Authorization, capture, and clearing of transactions using various methods and payment credentials.
        </ResponseField>

        <ResponseField name="FUNDING" type="enum">
          Funding
        </ResponseField>

        <ResponseField name="REPORTING" type="enum">
          Insights and recommendation to optimize transaction processing.
        </ResponseField>

        <ResponseField name="RISK_FRAUD_DISPUTE_MANAGEMENT" type="enum">
          Risk, Fraud and Dispute Management
        </ResponseField>

        <ResponseField name="BILLING_FUNDING" type="enum">
          Acceptor billing engine and funds disbursement.
        </ResponseField>

        <ResponseField name="RISK_COMPLIANCE_DISPUTE_MANAGEMENT" type="enum">
          Risk mitigation, fraud prevention and detection, and dispute management.
        </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>