Adyen
Get in touch
Sign in
Adyen
Connect your Adyen account to automate dispute representment

Follow these steps to connect your Adyen account with Chargebackhit for automatic dispute representment.

To ensure a safe start, representments are not applied to existing disputes.

Step 1. Sign in to Adyen
anchor


To sign in to your Adyen account and start integration

  1. Go to the Adyen live Customer Area.
  2. Sign in to your Adyen Live account.
  3. Perform all the steps below separately for each merchant account under your main account for which you want to enable automatic dispute representment.

Step 2. Provide account and business information
anchor

Provide the Adyen account and your business information for the setup:

  • Share the Adyen merchant account name
  • Complete Guide
    Business details contain your company information, policies, and supporting data for representment.     Business details
Each Adyen merchant account corresponds to one Chargebackhit account. Multiple merchant accounts are grouped into a single account group for unified management on the Chargebackhit side.
If you have multiple accounts, provide this information to the Chargebackhit support team.

Step 3. Create API credentials
anchor

Generate API credentials to allow Chargebackhit to access your Adyen account.


To create API credentials

  1. In the Adyen live Customer Area, navigate to Developers > API credentials.
  2. Click on Create new credential.
  3. Select Web service user.
  4. In the Description field, enter Chargebackhit.
  5. Copy the API key and save it in a secure location.

Step 4. Configure API permissions
anchor

Set the required permissions to enable dispute management.


To configure permissions

  1. Go to Developers > API credentials.
  2. Find the newly created API credential.
  3. Under Uncategorized, select API: Dispute management.
  4. Ensure the Company account and all associated merchant accounts are selected.
  5. Click on Save changes.
Once the required permission for dispute representment is set, use the copied API key for the Adyen integration setup in Chargebackhit HUB .

Step 5. Provide Merchant account code
anchor

Locate and, similar to the API key, use your merchant account code in Chargebackhit HUB for connecting Adyen.


To provide your merchant account code

  1. In the Adyen live Customer Area, go to Settings > Merchant accounts.
  2. Select the needed account and copy your code under Account code.
  3. Go to Chargebackhit HUB > Integrations > Adyen.
  4. Paste the copied account code in Merchant account code.
  5. Click on Submit to save changes.
You can activate the integration once you add the API key and merchant account code.

Step 6. Configure reports and enable SFTP data export
anchor

Set up automated reports to sync dispute information with Chargebackhit. This involves configuring the dispute report fields, enabling SFTP data transfer, and scheduling daily automated exports. The reports ensure dispute data sharing, allowing Chargebackhit to respond to disputes quickly and efficiently on your behalf.

A. Add additional fields to the Dispute transaction details report

To configure report columns

  1. In the Adyen live Customer Area, go to Settings > Report columns.
  2. Find the report Dispute transaction details and click on Configure.
  3. Select all columns.
  4. Click on Save configuration to confirm your changes.

B. Enable SFTP data export

Send an email to Adyen support to enable SFTP data export.

Ensure that you include integrations@chargebackhit.com in the CC field for us to provide all necessary details from our end.

Email details

  • To: support@adyen.com
  • CC: integrations@chargebackhit.com
  • Subject: Request to enable SFTP data export & whitelisting
  • Email body:

    Hello Adyen Support Team,

    We’d like to enable SFTP data export of the Dispute transaction details report for our account as per your documentation (“Submit Dispute transaction details files through SFTP”). Could you please set this up and confirm the configuration details?

    If you need any additional details from our side, we’re happy to provide them.

    Thank you!

C. Configure automated report schedule

To set up automated exports

  1. In the Adyen live Customer Area, go to Reports.
  2. Find Dispute transaction details.
  3. Click on Generate > Automated (generate on schedule).
  4. Set Automatic generation On and choose .CSV file type.
  5. Click on Add report schedule.
    • Set all checkboxes to Yes.
    • Set the daily frequency.
  6. Click on Schedule to confirm your changes.

Final checklist
anchor

Before completing the integration, make sure you have done the following:

  • Created the API credential
  • Found and noted your merchant account code
  • Updated the required reports with additional fields
  • Sent the email request to Adyen support, with integrations@chargebackhit.com in CC
  • Set up the report schedule for automated exports
  • Provided API key and merchant account code for the integration in Chargebackhit HUB
  • Provided business infotmation by completing the Guide
    Business details contain your company information, policies, and supporting data for representment.     Business details     page
Looking for help? Contact us
Stay informed with Changelog