Disputes Report
Last updated: March 19, 2025
The Disputes Report provides an overview of all actions that happen during a dispute’s lifecycle, and their impact on your sub-account’s available balance.
Each row in the report is a unique dispute ID.
Information
There may be multiple dispute IDs linked to the same payment ID.
The report is provided as a CSV file. By default, the file name uses the format:
{Start Date:YYYY-MM-DD}-{End Date:YYYY-MM-DD}-DisputesReport-{Client Name}.csv
You can generate a report at any time for the date range you specify.
The report includes data from 12:00 am to 11:59 pm in the selected time zone over the covered period.
You can also choose to automatically generate the report daily, weekly, or monthly.
See instructions on how to download the report on demand or on a schedule:
For targeted insight and efficient processing, you can pre-filter your scheduled report by one of the following fields and send them to specific recipients via SFTP. For example, pre-filter by processing channel and send each channel's data to the relevant owner.
- Payment Method
- Payment Type
- Processing Channel Name
- Wallet
Download a sample report (CSV file).
Information
If you're using Safari, hold the Option key when you download.
| Field name | Description |
|---|---|
Dispute ID | The unique identifier for the dispute. |
Dispute Issue Date UTC | The date and time the dispute was raised, in UTC format. |
Dispute Created Date UTC | The date and time the dispute was created, in UTC format. |
Client Name | The name of the client entity involved in the disputed transaction. |
Client Entity Name | The name of the business entity involved in the disputed transaction. |
Sub Entity Name | The name of the sub-entity. |
Processing Channel Name | The name of the processing channel. |
Merchant Category Code | The merchant's business classification, as a merchant category code (MCC). |
Dispute Indicator | The chargeback code that represents the latest status of the dispute. For example, ADJM, RDPR, or RPDW. |
Dispute Status | The current status of the dispute. For example, evidence under review, lost, or won. |
Payment Method | The name of the payment method used for the transaction. This can be one of:
|
Reference | The unique identifier or code for the disputed transaction or dispute case. |
Currency Symbol | The currency code of the transaction currency. For example, EUR, GBP, or USD. |
Dispute Amount | The amount from the transaction that is disputed. |
Dispute Code | The code that represents the reason for the dispute, as provided by the card scheme. |
Customer Email | The email address of the customer. |
Payment Type | The type of payment. This can be one of:
|
Payment ID | The unique identifier for the payment. |
Payment Date UTC | The date and time the transaction was performed, in UTC format. |
Dispute Issue Date Local | The local date the dispute was raised. |
Payment Date Local | The local date the transaction was performed. |
Client ID | The unique identifier for the client entity involved in the disputed transaction. |
Entity ID | The unique identifier for the entity. |
Sub Entity ID | The unique identifier for the sub-entity. |
Channel ID | The unique identifier for the channel through which the disputed transaction was processed. |
Card Holder Name | The name of the cardholder. |
CC Number | The card number of the credit card used for the disputed transaction. |
Charge Reference | The reference for the charge. |
Acquirer Reference Number | The unique identifier assigned by the acquiring bank to track a specific disputed transaction. |
CVV Check | The result of the card verification value (CVV) check. |
AVS Check | The result of the Address Verification Service (AVS) check. The AVS check compares the billing address provided by the cardholder with the issuer's address on file to determine the likelihood of fraud. |
ECI Code | The Electronic Commerce Indicator (ECI) value. |
Wallet | The digital wallet used for the disputed transaction. This can be one of:
|
Entity Segment | The name of the entity segment. |
Evidence Required By | The date that you must submit your dispute evidence by. |