Skip to main content
Object

Fields

organization
required
acceptor
id
required
A unique identifier created by Tesouro and assigned to the dispute event resulting in the credit or debit.
acquirerReferenceNumber
required
The Acquirer Reference Number (ARN) is a unique 23 digit number created by Tesouro, that was assigned to the original transaction and provided to the acquiring and issuing banks for their purpose of tracing the transaction through the full process until it is funded to the bank.
disputeId
required
A unique identifier created and used internally by Tesouro, and assigned to the dispute.
dateOfEvent
The date the dispute lifecycle was received.
fundingAmount
The funded amount of the dispute, which may be different from the “dispute amount” if the original transaction’s amount was presented in a different currency than its funding currency.
fundingCurrency
The currency associated with the dispute funding amount
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.
fundsTransferId
A unique identifier created by Tesouro and assigned to the transfer of money to a bank account for this dispute, that identifies a cohort of funded transactions making up the transfer.
fundsReleaseDate
The date the debited or credited funds for the dispute lifecycle were released.
lifeCycle
required
Specifies where in the life cycle the dispute is at, e.g., Retrieval request, Chargeback, Representment, Pre-arbitration, etc.
paymentBrand
The brand of payment method used.
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.
processingNetwork
The processing network that the transaction was sent across, which may be unaffiliated with the card brand.
transactionId
required
A unique identifier assigned by Tesouro for the transaction associated with this dispute event.
transactionReference
A unique transaction identifier created by the entity holding the direct relationship with the Acceptor. Tesouro uses this identifier to manage idempotency.
perspective
The perspective of the dispute, which can be either ‘Acceptor’ or ‘Partner’. This field is used to determine the perspective from which the dispute is reported.
{
  "organization": Organization,
  "acceptor": Acceptor,
  "id": "72ef289d-77d4-4696-8a08-da83ed15b751",
  "acquirerReferenceNumber": "xyz789",
  "disputeId": "72ef289d-77d4-4696-8a08-da83ed15b751",
  "dateOfEvent": "2007-12-03",
  "fundingAmount": Decimal,
  "fundingCurrency": "xyz789",
  "fundsTransferDescriptor": "xyz789",
  "fundsTransferId": "72ef289d-77d4-4696-8a08-da83ed15b751",
  "fundsReleaseDate": "2007-12-03",
  "lifeCycle": "ARBITRATION",
  "paymentBrand": "VISA",
  "paymentId": "72ef289d-77d4-4696-8a08-da83ed15b751",
  "processingNetwork": "xyz789",
  "transactionId": "72ef289d-77d4-4696-8a08-da83ed15b751",
  "transactionReference": "abc123",
  "perspective": "PARTNER"
}