---
title: "Chargeback Uploader"
description: "Use chargeback information from a third party acquirer for risk management."
url: "https://docs.adyen.com/risk-management/chargeback-uploader"
source_url: "https://docs.adyen.com/risk-management/chargeback-uploader.md"
canonical: "https://docs.adyen.com/risk-management/chargeback-uploader"
last_modified: "2020-08-14T10:03:00+02:00"
language: "en"
---

# Chargeback Uploader

Use chargeback information from a third party acquirer for risk management.

[View source](/risk-management/chargeback-uploader.md)

If you are using an external acquirer for your payments, you can upload chargebacks in your Adyen payments platform. This allows [Protect](/risk-management/) to use this data.

The Chargeback Uploader does not allow you to manage disputes. You must dispute chargebacks directly with your external acquirer.

## Requirements

Before you begin, take into account the following requirements.

| Requirement                                          | Description                                                                                               |
| ---------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| **Integration type**                                 | Make sure that you have built an [online payments integration](/online-payments/build-your-integration/). |
| **[Customer Area roles](/account/user-roles/#risk)** | Make sure that you have the following role:- **Upload Chargebacks role**                                  |
| **Limitations**                                      | The maximum number of chargebacks you can upload per CSV file is 1,000.                                   |

## Upload chargebacks

1. Contact our [Support Team](https://ca-test.adyen.com/ca/ca/contactUs/support.shtml?form=other) and ask them enable the [Upload Chargebacks role](/account/user-roles#risk) for your user.

2. Log in to your [Customer Area](https://ca-test.adyen.com/) and select a merchant account.

   It is not necessary to upload chargebacks for each merchant separately. You can upload any chargebacks within a company under one merchant.

3. Go to **Revenue & risk** > **Disputes**.

4. Select the **Upload** tab.

5. Upload a CSV file including the payments as detailed in the [required field reference](#required-fields).\
   After uploading, we will process your request and update the transaction status.

   When the transaction status has been updated it cannot be reversed or amended.

   ![Screenshot of the Chargeback Uploader interface](/user/pages/docs/10.risk-management/22.chargeback-uploader/access-chargeback-uploader.png).

## Required fields

The uploader accepts CSVs of 1,000 payments or fewer at a time. The following headers are required in the CSV:

| Field          | Required                                                                                    | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| -------------- | ------------------------------------------------------------------------------------------- |   |
| `pspreference` | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | This is the `pspreference` number of the transaction that had the chargeback.                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `amount`       | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | By default, the full transaction value is used for the chargeback. If a partial chargeback occurred, this field must be provided. The `amount` should be represented in minor units (without a decimal point). For more information, see [Currency codes](/development-resources/currency-codes).                                                                                                                                                                                                                                            |
| `reason`       | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Provide more context on the chargeback. Include the scheme specific reason code, for example **4863** for **Cardholder does not recognize - Potential Fraud**. For more information, see [Dispute reason codes and defense requirements](/risk-management/understanding-disputes/dispute-reason-codes). If left empty, the chargeback will be considered non-fraudulent. If the reason code is not known and you still want to flag the chargeback as fraudulent, send the value **fraud** and Adyen will map it to the correct reason code. |

## See also

* [Dispute reason codes and defense requirements](/risk-management/understanding-disputes/dispute-reason-codes/)
* [Chargeback guidelines](/risk-management/chargeback-guidelines)
