Retrievals Report
Last updated: March 19, 2025
The Retrievals Report provides an overview of all retrieval requests you've received from card schemes.
You can reference this report alongside the Disputes Report to see when a retrieval request may have helped to avoid a dispute.
Each row in the report is a unique retrieval request ID.
Information
There may be multiple retrieval request 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}-RetrievalsReport-{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
| Field name | Description |
|---|---|
Retrieval ID | The unique identifier for the retrieval request. |
Retrieval Issue Date UTC | The date and time the retrieval request was initiated, in UTC format. |
Client ID | The unique identifier for the client entity involved in the retrieval request. |
Client Name | The name of the client entity involved in the retrieval request. |
Entity ID | The unique identifier for the entity. |
Client Entity Name | The name of the business entity involved in the retrieval request. |
Sub Entity ID | The unique identifier for the sub-entity. |
Sub Entity Name | The name of the sub-entity. |
Channel ID | The unique identifier for the channel through which the retrieval request was processed. |
Processing Channel Name | The name of the processing channel. |
Merchant Category Code | The merchant's business classification, as a merchant category code (MCC). |
Payment Method | The payment method used for the payment. This can be one of:
|
Card Holder Name | The name of the cardholder. |
CC Number | The card number of the credit card used for the transaction. |
Reference | The unique identifier or code for the retrieval request. |
Charge Reference | The reference for the charge. |
Retrieval Amount | The amount for which the customer or merchant raised the retrieval request. |
Currency Symbol | The currency code of the transaction currency. For example, EUR, GBP, or USD. |
Customer Email | The email address of the customer. |
Payment Type | The type of payment. This can be one of:
|
Retrieval Reason Code | The code that represents the reason for the retrieval request, as provided by the card scheme. |
Payment ID | The unique identifier for the payment. |
Payment Date UTC | The date and time the transaction was performed, in UTC format. |
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:
|
Retrieval Issue Date Local | The local date the retrieval request was raised. |
Payment Date Local | The local date the transaction was performed. |