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

# FundingTransaction

`OBJECT`

## Fields

<ResponseField name="organization" type="Organization!" required>
  <Expandable title="child attributes">
    <ResponseField name="acceptorApplicationCounts" type="[AcceptorApplicationCounts!]!" required>
      The counts of acceptor applications for this organization, grouped by application status.

      See [AcceptorApplicationCounts](/acquiring/reference/graphql/types/acceptor-application-counts)
    </ResponseField>

    <ResponseField name="acceptors" type="AcceptorCollection">
      See [AcceptorCollection](/acquiring/reference/graphql/types/acceptor-collection)
    </ResponseField>

    <ResponseField name="achNotificationsOfChange" type="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](/acquiring/reference/graphql/types/ach-notification-of-change-collection)
    </ResponseField>

    <ResponseField name="achReturns" type="AchReturnCollection">
      An itemized list of ach returns for a given transaction activity date or acticity date.

      See [AchReturnCollection](/acquiring/reference/graphql/types/ach-return-collection)
    </ResponseField>

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

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

    <ResponseField name="allowedMerchantCategories" type="[MerchantCategory!]!" required>
      The allowed Merchant Category Codes for acceptors within this organization.

      See [MerchantCategory](/acquiring/reference/graphql/types/merchant-category)
    </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](/acquiring/reference/graphql/types/authorization-summary-collection)
    </ResponseField>

    <ResponseField name="businessAddress" type="AddressOutput">
      The business address of the organization.

      See [AddressOutput](/acquiring/reference/graphql/types/address-output)
    </ResponseField>

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

    <ResponseField name="capabilities" type="[OrganizationCapability!]!" required>
      The product capabilities enabled for this organization.

      See [OrganizationCapability](/acquiring/reference/graphql/types/organization-capability)
    </ResponseField>

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

      See [FeeCollection](/acquiring/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](/acquiring/reference/graphql/types/fee-summary-collection)
    </ResponseField>

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

    <ResponseField name="fundingDisbursementReturns" type="FundingDisbursementReturnCollection">
      An itemized list of funding disbursement returns for a given activity date.

      See [FundingDisbursementReturnCollection](/acquiring/reference/graphql/types/funding-disbursement-return-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](/acquiring/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](/acquiring/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](/acquiring/reference/graphql/types/funding-transaction-collection)
    </ResponseField>

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

    <ResponseField name="legalName" type="String!" required>
      The legal entity name for the organization.
    </ResponseField>

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

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

    <ResponseField name="phoneNumber" type="String">
      The phone number of the organization.
    </ResponseField>

    <ResponseField name="reportAvailability" type="[ReportAvailability!]">
      See [ReportAvailability](/acquiring/reference/graphql/types/report-availability)
    </ResponseField>

    <ResponseField name="settings" type="OrganizationSettingsOutput!" required>
      Organization settings.

      See [OrganizationSettingsOutput](/acquiring/reference/graphql/types/organization-settings-output)
    </ResponseField>
  </Expandable>
</ResponseField>

<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](/acquiring/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](/acquiring/reference/graphql/types/authorization-summary-collection)
    </ResponseField>

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

      See [BillingDescriptor](/acquiring/reference/graphql/types/billing-descriptor)
    </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](/acquiring/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](/acquiring/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](/acquiring/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](/acquiring/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](/acquiring/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](/acquiring/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](/acquiring/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](/acquiring/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="fundsTransferId" type="UUID">
  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="fundsTransfer" type="FundsTransfer">
  The funds transfer associated with this transaction, containing bank account details.

  <Expandable title="child attributes">
    <ResponseField name="acquirerId" type="UUID!" required />

    <ResponseField name="bankAccount" type="BankAccount!" required>
      See [BankAccount](/acquiring/reference/graphql/types/bank-account)
    </ResponseField>

    <ResponseField name="createdDateTime" type="DateTime" />

    <ResponseField name="estimatedBankPostingDate" type="Date" />

    <ResponseField name="fundsReleaseDate" type="Date" />

    <ResponseField name="fundsTransferDescriptor" type="String" />

    <ResponseField name="id" type="UUID!" required />

    <ResponseField name="organizationId" type="UUID!" required />

    <ResponseField name="plannedFundsTransferDate" type="Date!" required />
  </Expandable>
</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="fundsTransferDescriptor" type="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.
</ResponseField>

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

<ResponseField name="fundingGrossAmount" type="Decimal!" required>
  The total amount of the transaction, in the funding currency.
</ResponseField>

<ResponseField name="interchangeFeesAmount" type="Decimal!" required>
  The amount of interchange associated with this transaction
</ResponseField>

<ResponseField name="networkFeesAmount" type="Decimal!" required>
  The itemized network fees associated with this transaction
</ResponseField>

<ResponseField name="acceptorInterchangeFeesAmount" type="Decimal!" required>
  The amount of acceptor interchange associated with this transaction
</ResponseField>

<ResponseField name="acceptorNetworkFeesAmount" type="Decimal!" required>
  The itemized acceptor network fees associated with this transaction
</ResponseField>

<ResponseField name="processorFeesAmount" type="Decimal!" required>
  The itemized processor fees associated with this transaction
</ResponseField>

<ResponseField name="transactorFeesAmount" type="Decimal!" required deprecated>
  The amount of partner fees associated with this transaction

  **Deprecated:** Use partnerFeesAmount instead.
</ResponseField>

<ResponseField name="partnerFeesAmount" type="Decimal!" required>
  The amount of partner fees associated with this transaction
</ResponseField>

<ResponseField name="isPartnerFeeAdjusted" type="Boolean!" required>
  Indicates if the partner fee was adjusted at the transaction level.
</ResponseField>

<ResponseField name="convenienceFeesAmount" type="Decimal!" required>
  The amount of convenience fees associated with this transaction
</ResponseField>

<ResponseField name="serviceFeesAmount" type="Decimal!" required>
  The amount of service fees associated with this transaction
</ResponseField>

<ResponseField name="surchargeAmount" type="Decimal!" required>
  The amount of surcharge associated with this transaction
</ResponseField>

<ResponseField name="fundingNetAmount" type="Decimal!" required>
  The net funded amount after fees, in the funding currency.
</ResponseField>

<ResponseField name="paymentTransaction" type="PaymentTransaction!" required>
  <Expandable title="child attributes">
    <ResponseField name="acceptor" type="Acceptor!" required>
      See [Acceptor](/acquiring/reference/graphql/types/acceptor)
    </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.

      See [AmountDetails](/acquiring/reference/graphql/types/amount-details)
    </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.

      See [BusinessApplicationId](/acquiring/reference/graphql/types/business-application-id)
    </ResponseField>

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

      See [FeeDetails](/acquiring/reference/graphql/types/fee-details)
    </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.

      See [LineItem](/acquiring/reference/graphql/types/line-item)
    </ResponseField>

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

      See [Location](/acquiring/reference/graphql/types/location)
    </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](/acquiring/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.

      See [PaymentMethod](/acquiring/reference/graphql/types/payment-method)
    </ResponseField>

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

      See [Network](/acquiring/reference/graphql/types/network)
    </ResponseField>

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

      See [ProcessorResponseCode](/acquiring/reference/graphql/types/processor-response-code)
    </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.

      See [ResponseType](/acquiring/reference/graphql/types/response-type)
    </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.

      See [Taxes](/acquiring/reference/graphql/types/taxes)
    </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.

      See [PaymentTransactionType](/acquiring/reference/graphql/types/payment-transaction-type)
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="perspective" type="Perspective">
  The perspective of the transaction, which can be either 'Acceptor' or 'Partner'. This field is used to determine the perspective from which the transaction 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>