Skip to main content
An itemized list of financially impacting disputes events, including 1st chargebacks and representments, for the given funds release date.
FieldDescription
ACCEPTOR_IDThe unique, 36 character identifier created by Tesouro and assigned to the entity providing the goods or services to the customer, such as a Merchant, a Submerchant of a Payment Facilitator, a Seller within a Marketplace, or a Biller of a Consumer Bill Payment Service Provider (CBPS). Also referred to as the Merchant ID (MID), Outlet ID, or Customer number.
ACCEPTOR_NAMEA human readable description used to uniquely label the Acceptor. It is assigned during onboarding of the Acceptor and mapped to the Acceptor ID. Maximum of 255 characters. Other processors may refer to this as a Billing descriptor.
ACCEPTOR_REFERENCEA unique identifier created and managed by the entity holding the direct relationship with the Acceptor, and assigned to the Acceptor with a one-to-one mapping to Tesouro’s Acceptor ID. Other processors may refer to this as Location ID, Store ID, Club ID, etc.
ACQUIRER_REFERENCE_NUMBERThe Acquirer Reference Number (ARN), is a unique 23 digit number created by Tesouro, and assigned to a transaction and provided to the acquiring and issuing banks for their purpose of being able to trace the transaction through the full process until it is funded to the bank.
DATE_OF_EVENTThe date the dispute lifecycle event was reported.
DISPUTE_IDA unique number created by the payment network and assigned to the dispute case, and persisted across the lifecycle of the dispute.
FUNDING_AMOUNTThe funded amount of the dispute event.
FUNDING_CURRENCYThe currency associated with the dispute funding amount
FUNDS_RELEASE_DATEThe date the debited or credited funds for the dispute lifecycle were released.
FUNDS_TRANSFER_DESCRIPTORA 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.
FUNDS_TRANSFER_IDA 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.
IDA unique identifier created by Tesouro and assigned to the dispute event resulting in the credit or debit.
LIFE_CYCLESpecifies the lifecycle of the funding dispute event, e.g., 1st chargeback, Representment, etc.
ORGANIZATION_IDThe unique 36 character identifier created by Tesouro, and used to identify the organization holding the relationship with Tesouro.
PAYMENT_BRANDThe payment brand used, e.g., Visa, Mastercard, Discover, American Express, etc.
PAYMENT_IDA 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.
PROCESSING_NETWORKThe payment network that the transaction was processed on, which may be unaffiliated with the card brand.

Report availability

The report is generated daily by 10:00 AM ET, encrypted, and placed in the outbound directory of an SFTP location dedicated for your use. (This schedule can be configured to later cadences to suit your needs, e.g., a later time in the day, every other day, weekly, monthly, etc.) Reports expire and removed from the SFTP location after 14 calendar days.

Report format

  • CSV file, following the RFC 4180 standard
  • File name: funding-dispute-events_{startdate:YYYYMMDD}-{endDate:YYYYMMDD}_{generationDate:YYYYMMDDThhmmss}.csv
  • Values are separated using commas.
  • Values containing commas are enclosed within double quotes.
  • Values containing double-quotes are escaped by two double quote preceding it.