Skip to main content
INTERFACE

Fields

id
UUID!
required
A unique identifier assigned by Tesouro for every transaction request received.
reference
String
A unique transaction identifier created by the entity holding the direct relationship with the Acceptor. Tesouro uses this identifier to manage idempotency.
billingDescriptor
String
The billing descriptor name that appears on the customer’s statement.
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.
activityDate
Date
The date Tesouro recognized the payment request based upon the acceptor cutoff.
transactionDateTime
DateTime!
required
The date and time that Tesouro received the transaction, in UTC. Formatted as 2024-03-27T02:40:00Z
processingNetwork
Network!
required
The payment network that the transaction was sent across, which may be unaffiliated with the card brand.
organization
Organization!
required
acceptor
Acceptor!
required
transactionType
PaymentTransactionType!
required
The type of payment transaction, e.g., Authorization, Capture, Sale, Refund, Reversal, etc.
businessApplicationId
BusinessApplicationId
The business application identifier (BAI) is a value provided by Visa to identify the type of transfer that is being performed.
fees
FeeDetails
Aggregate information for assessed fees
taxes
Taxes
The various tax amounts collected on the payment transaction.
amountDetails
AmountDetails
Components of the requested amount that may or may not have been provided by the presenter on the payment transaction request.
lineItems
[LineItem!]
Line items associated with the payment transaction.
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.
processorResponseCode
ProcessorResponseCode!
required
A response code provided by Tesouro identifying the specific approval or decline reason.
processorResponseMessage
String!
required
A human readable description of the authorization response code. e.g., Insufficient funds.
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.
responseType
ResponseType
The result of the authorization request, e.g., Approved or Declined.
paymentMethod
PaymentMethod!
required
Refers to the various options available for customers to make payments when purchasing a product or service.
resultLabel
String!
required
Short description of the payment transaction result. Examples include Approved, Insufficient funds. Intended for display purposes only.
location
Location
The location where this transaction took place.