Chargebacks File
Overview
Context: All chargebacks that have been newly submitted or had a change in status.
File Type: CSV
File Name: <company_name>_chargebacks_YYYYMMDDHHmmSS
- 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 and when it is closed as either Settled or Successfully Defended.