---
title: Chargebacks File
slug: chargebacks-file
createdAt: 2023-09-02T14:16:00.308Z
---

# Overview

**Context:&#x20;**&#x41;ll chargebacks that have been newly submitted or had a change in status.

**File Type**: CSV

**File Name**: \<company\_name>\_chargebacks\_YYYYMMDDHHmmSS&#x20;

- Example = \<company\_name>\_chargebacks\_20221110233030
- company\_name = your companies name
- When uploading test files, please append "\_testing" at the end of the file name
  - Example = \<company\_name>\_chargebacks\_20221110233030\_testing

**Frequency**: Daily

# Chargeback - Data Columns

| **Column Name**          | **Mandatory** | **Format Details**                                                                                                         | **Example**                                 |
| ------------------------ | ------------- | -------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------- |
| Environment              | Mandatory     | Valid values are: "Production" or "Testing"                                                                                | Production                                  |
| Chargeback Date/Time     | Mandatory     | DD/MM/YYYY HH\:mm\:SS                                                                                                      | 31/01/2022 16:34:45                         |
| Transaction Date/Time    | Mandatory     | DD/MM/YYYY HH\:mm\:SS                                                                                                      | 31/01/2022 16:34:45                         |
| Transaction ID           | Mandatory     |                                                                                                                            | a13f1609-7854-47a6-b533-339f3ac80be8        |
| Chargeback ID            | Mandatory     |                                                                                                                            | 1233-1223-1111                              |
| Merchant Registration ID | Mandatory     | Depends on registered country - see data dictionary                                                                        | 12345678-000-11-22-3                        |
| Merchant Category Code   | Mandatory     | 4 digit numeric value based on ISO 18245                                                                                   | 5812                                        |
| Scheme MID               | Mandatory     |                                                                                                                            | MID used within the scheme network          |
| URL                      | Mandatory     | Merchant website URL                                                                                                       |                                             |
| Billing Descriptor       | Mandatory     |                                                                                                                            | Tim's Tiles                                 |
| Chargeback Reason Code   | Mandatory     | Reason code provided by card scheme/network. See Chargback Reason Codes in Data Dictionaries section for more details.     | 30                                          |
| Chargeback Status        | Mandatory     | The status of the chargabck based on the latest event. Example values are "Submitted", "Settled" & "Successfully Defended" | Submitted / Settled / Successfully Defended |
| Card Bin                 | Mandatory     | First 6 digits of the card number.                                                                                         | 512345                                      |
| Chargeback Currency      | Mandatory     | 3 letter, ISO 4217 currency code                                                                                           | USD                                         |
| Chargeback Amount        | Mandatory     | Numeric value with no currency symbol.                                                                                     | 100                                         |

**Notes:**

- Please adhere by the format details of each column provided.
- The file should contain a record for every time a chargeback is newly submitted or has a status update.
- The minimum statuses updates required for chargebacks are when the case is **Submitted&#x20;**&#x61;nd when it is closed as either **Settled** or **Successfully Defended.&#x20;**

