Chargebacks (Daily)
The Chargebacks Report lists all cases opened in the past 150 days and their current status. The chargebacks report can be used by teams that handle dispute operations to view the current status of a chargeback case.
Chargeback Status Mapping
For most case types, the merchant receives a provisional credit at the time of representment (ie when the merchant’s evidence is submitted to the network/issuer to dispute a chargeback case). This means that when a chargeback case reaches its final status funds may not move because the merchant has already been credited, hence the importance of referring to the Chargeback Status Mapping table for the Chargebacks reports.
The primary unique data point that will be found in the Chargebacks Report (and not the Exceptions Report) is the action status of Documentation Received, which reflects that TabaPay has received evidence from a merchant for a specific chargeback case.
Cases will drop off the Chargebacks Report 150 days after the exception date.
Report Names
If you are configured to receive reports at the ISO level, the file name format will be: ISO_YYYYMMDD_reportname (e.g. 1234_20251017_reportname.csv)
If you are configured to receive reports at the MID level, the file format name will be: ISO_MID_YYYYMMDD_reportname (e.g. e.g. 1234_321_20251017_reportname.csv)
Key Fields
| Position | Field | Description | Data Type | Data Format |
|---|---|---|---|---|
| 1 |
| 4-Digit ID assigned by TabaPay | Numeric | 4 digits |
| 2 |
| Merchant ID (Identifies a specific program/merchant under the ISO) | Numeric | 4+ digits |
| 3 |
| referenceID sent by the merchant in the Create Transaction API request | Alphanumeric | 1-15 characters |
| 4 |
| transactionID sent by TabaPay in the Create Transaction API response | Alphanumeric | 22 characters |
| 5 |
| Unique reference number generated by TabaPay for each chargeback case; must be used as the name of the evidence document. | Alphanumeric | ~15 characters |
| 6 |
| CHARGEBACK REPRESENTMENT | Alphanumeric | Text |
| 7 |
| Network-specific reason code that identifies the evidence the merchant must provide to win the case. | Alphanumeric | Text |
| 8 |
| Description corresponding to the network Exception Code | Alphanumeric | Text |
| 9 |
| Date exception (chargeback) posted | Date | MM/DD/YYYY |
| 10 |
| Indicates the status of the chargeback based on the movement of funds and logs the date the corresponding evidence document is uploaded by the merchant to TabaPay. | Alphanumeric | Text |
| 11 |
| Date of most recent change in Action Status | Date | MM/DD/YYYY |
| 12 |
| Days since last movement of funds | Alphanumeric | 1+ digit |
| 13 |
| Acquirer Reference Number (ARN) | Alphanumeric | 9-24 characters |
| 14 |
| Date/Time (GMT) original Transaction Request was created | Date | MM/DD/YYYY |
| 15 |
| Date/Time (GMT) original Transaction processed at the Network | Date | MM/DD/YYYY |
| 16 |
| Purchase Purchase-Chargeback | Alphanumeric | Text |
| 17 |
| If "Exception type" = CHARGEBACK, exception source = Settlement If "Exception type" = REPRESENTMENT, exception source = the exception network | Alphanumeric | Text |
| 18 |
| If "Exception type" = CHARGEBACK, exception destination = the exception network If "Exception type" = REPRESENTMENT, exception destination = Settlement | Alphanumeric | Text |
| 19 |
| Network card scheme. | Alphanumeric | Text |
| 20 |
| Last 4 of beneficiary card (add “0s” in front of number if less than 4 digits) | Numeric | 4 digits |
| 21 |
| Original transaction amount | Decimal | 1+ digits |
| 22 |
| Amount disputed by cardholder. May differ from the Original Settled Amount in the case of a partial chargeback or due to differences in the exchange rate. | Decimal | 1+ digits |
| 23 |
| TabaPay Fee for the chargeback | Decimal | 1+ digits |
| 24 |
| Network Fee for the chargeback | Decimal | 1+ digits |
| 25 |
| Interchange for the chargeback | Decimal | 1+ digits |
| 26 |
| memo passed in the Create Transaction request. | Alphanumeric | 1-32 characters |
| 27 |
| Case ID assigned by the card network. | Alphanumeric | Text |
| 28 |
| First name | Alphanumeric | Text |
| 29 |
| Last name | Alphanumeric | Text |
| 30 |
| Transaction ID assigned by the card network. | Numeric | Text |
| 31 | PAR | 29-character Payment Account Reference. Can be null. For more info, refer to Payment Account Reference (PAR). | Alphanumeric | 29 characters |
| 32 | MAC | 2-character Merchant Advice Code (MAC). Relevant for MasterCard transactions only. Can be null. For more info, refer to Merchant Advice Code. | Numeric | 2 characters |