Skip to main content
Interface

​
Possible Types

​
AcceptedAccountValidation
​
AcceptedSale
​
ApprovedAuthorization
​
ApprovedCapture
​
ApprovedCardVerification
​
ApprovedIncrementalAuthorization
​
ApprovedRefund
​
ApprovedRefundAuthorization
​
ApprovedReversal
​
DeclinedAuthorization
​
DeclinedCapture
​
DeclinedCardVerification
​
DeclinedIncrementalAuthorization
​
DeclinedRefund
​
DeclinedRefundAuthorization
​
DeclinedReversal
​
GenericPaymentTransaction
​
id
required
A unique identifier assigned by Tesouro for every transaction request received.
​
reference
A unique transaction identifier created by the entity holding the direct relationship with the Acceptor. Tesouro uses this identifier to manage idempotency.
​
billingDescriptor
The billing descriptor name that appears on the customer’s statement.
​
paymentId
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
The date Tesouro recognized the payment request based upon the acceptor cutoff.
​
transactionDateTime
required
The date and time that Tesouro received the transaction, in UTC. Formatted as 2024-03-27T02:40:00Z
​
processingNetwork
required
The payment network that the transaction was sent across, which may be unaffiliated with the card brand.
​
organization
required
​
acceptor
required
​
transactionType
required
The type of payment transaction, e.g., Authorization, Capture, Sale, Refund, Reversal, etc.
​
businessApplicationId
The business application identifier (BAI) is a value provided by Visa to identify the type of transfer that is being performed.
​
fees
Aggregate information for assessed fees
​
taxes
The various tax amounts collected on the payment transaction.
​
amountDetails
Components of the requested amount that may or may not have been provided by the presenter on the payment transaction request.
​
lineItems
Line items associated with the payment transaction.
​
taxIdentificationNumber
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
required
A response code provided by Tesouro identifying the specific approval or decline reason.
​
processorResponseMessage
required
A human readable description of the authorization response code. e.g., Insufficient funds.
​
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.
​
responseType
The result of the authorization request, e.g., Approved or Declined.
​
paymentMethod
required
Refers to the various options available for customers to make payments when purchasing a product or service.
​
resultLabel
required
Short description of the payment transaction result. Examples include Approved, Insufficient funds. Intended for display purposes only.
{
  "id": "72ef289d-77d4-4696-8a08-da83ed15b751",
  "reference": "xyz789",
  "billingDescriptor": "xyz789",
  "paymentId": "72ef289d-77d4-4696-8a08-da83ed15b751",
  "activityDate": "2007-12-03",
  "transactionDateTime": "2007-12-03T10:15:30Z",
  "processingNetwork": "VISA",
  "organization": Organization,
  "acceptor": Acceptor,
  "transactionType": "AUTHORIZATION",
  "businessApplicationId": "CB",
  "fees": FeeDetails,
  "taxes": Taxes,
  "amountDetails": AmountDetails,
  "lineItems": [
    LineItem
  ],
  "taxIdentificationNumber": "xyz789",
  "processorResponseCode": "A0000",
  "processorResponseMessage": "abc123",
  "merchantCategory": "xyz789",
  "responseType": "APPROVAL",
  "paymentMethod": PaymentMethod,
  "resultLabel": "abc123"
}