Skip to main content
Object

Fields

organization
acceptor
presenterId
Presenter Id
rateUnitAmount
required
The unit amount charged on transaction, as part of the fee rate.
rateMultiplier
required
The decimal used to multiply against the transaction amount to determine the “percentage” portion of the fee rate.
feeType
required
The type of fee, e.g., Interchange, Network, Processor, etc.
name
required
The name of the fee, interchange or wholesale program
description
required
A detailed description of the fee or program
feeCalculatedAmount
required
The total fee amount calculated as a percentage of the transaction amount (including taxes), a flat fee, or a combination of both.
productPillar
required
The Tesouro product pillar that this fee applies to: “Boarding”, “Transaction processing”, “Funding”, “Risk, Compliance, and Dispute management”, or “Reporting”.
activityDate
required
The date the fee was applied
transactionDateTime
The date and time that Tesouro received the transaction, in UTC. Formatted as 2024-03-27T02:40:00Z
billableEventAmount
required
The net billable event amount, including any add-ons or deductions.
accountNumberPrefix
The leading digits of the account.
accountNumberSuffix
The final digits of the account.
paymentBrand
The specific payment brand used, e.g., Visa, MasterCard, Discover, American Express, etc.
paymentFundingSource
Specifies the source of the customer’s funds , e.g., credit, debit, or pre-paid.
fundingCurrency
required
The total fee amount’s currency code in ISO 4217 alpha currency code format.
billableEventCurrency
The fee’s billable event currency code in ISO 4217 alpha currency code format.
merchantCategory
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. https://www.iso.org/standard/79450.html
processingNetwork
The applicable payment network, e.g., Visa, Mastercard, etc.
orderReference
A unique identifier created by the acceptor and assigned to the order placed by the customer.
transactionReference
A unique identifier created by the entity holding the direct relationship with the Acceptor, and used by that entity for reconciliation and transaction search. Tesouro uses this identifier to manage idempotency.
transactionId
A unique 36 character identifier assigned by Tesouro for every transaction request received.
fundsTransferDescriptor
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.
fundsReleaseDate
The date that Tesouro releases the funds from its bank account to the recipient’s bank account.
fundsTransferId
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.
paymentId
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. NOTE: This field will present a null, not applicable, or empty value if the fee is not tied to a specific transaction.
billableEventType
The type of billable event, including, but not limited to: Authorization, Capture, Refund, Reversal, Authentication, Dispute, Funds transfer, Misc. adjustment, Token, Account updater, AVS verification, etc.
paymentProduct
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.
consumerType
Specifies the type of account associated with the cardholder’s card, e.g., Consumer, Commercial, Government, etc., which has an impact on the interchange qualification. NOTE: This field will present a null, not applicable, or empty value if the fee is not tied to a specific transaction.
billingEventSourceId
Reference id of item that fee applies to (Refer to BillingEventSourceType field for referencing type).
billingEventSourceType
The type of entity that the billing event source id references, including, but not limited to: Transaction, Funds Transfer, Boarding Request, Acceptor, ACH Return, ACH Notice Of Change, Dispute.
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.
{
  "organization": Organization,
  "acceptor": Acceptor,
  "presenterId": "72ef289d-77d4-4696-8a08-da83ed15b751",
  "rateUnitAmount": Decimal,
  "rateMultiplier": Decimal,
  "feeType": "SETTLEMENT",
  "name": "abc123",
  "description": "abc123",
  "feeCalculatedAmount": Decimal,
  "productPillar": "BOARDING",
  "activityDate": "2007-12-03",
  "transactionDateTime": "2007-12-03T10:15:30Z",
  "billableEventAmount": Decimal,
  "accountNumberPrefix": "abc123",
  "accountNumberSuffix": "xyz789",
  "paymentBrand": "VISA",
  "paymentFundingSource": "UNKNOWN",
  "fundingCurrency": "abc123",
  "billableEventCurrency": "xyz789",
  "merchantCategory": "xyz789",
  "processingNetwork": "VISA",
  "orderReference": "xyz789",
  "transactionReference": "xyz789",
  "transactionId": "72ef289d-77d4-4696-8a08-da83ed15b751",
  "fundsTransferDescriptor": "abc123",
  "fundsReleaseDate": "2007-12-03",
  "fundsTransferId": "72ef289d-77d4-4696-8a08-da83ed15b751",
  "paymentId": "72ef289d-77d4-4696-8a08-da83ed15b751",
  "billableEventType": "UNKNOWN",
  "paymentProduct": "xyz789",
  "consumerType": "UNKNOWN",
  "billingEventSourceId": "72ef289d-77d4-4696-8a08-da83ed15b751",
  "billingEventSourceType": "TRANSACTION",
  "perspective": "PARTNER"
}