Adyen
Adyen
Connect your Adyen account to automate alert handling, dispute import, and representment, and track chargeback outcomes across transactions in Chargebackhit

Adyen integration consolidates alert handling, dispute management, representment, and outcome tracking in one platform.

  • Alert handling
    Incoming alerts matched to transactions automatically.
  • Dispute import
    Adyen disputes imported automatically.
  • Automated representment
    Compelling evidence files prepared and automatically submitted following standards and best practices.
Recover revenue
Protect revenue by resolving alerts and handling disputes with automated representment.
Save time
Automation reduces manual alert handling and evidence submission.
Improve win rates
Professionally prepared representment increases dispute success.
Performance monitoring
Track alerts and disputes over time to improve prevention strategies.

Integration setup

The Adyen integration involves multiple configuration steps. To speed things up, the Chargebackhit team can complete the integration directly within your Adyen account.

To ensure a safe start, representment is not applied to existing disputes.

Step 1. Set up Adyen user for Chargebackhit

To authorize Chargebackhit to perform the integration on your behalf, add the Chargebackhit integration account as a user in your Adyen account.

To add the Chargebackhit integration account

  1. Add a new user with the email integrations@chargebackhit.com.
  2. Grant access to the Company account and the merchant accounts you want to connect.
  3. Assign the following roles and permissions:
    • Developer: Manage API credentials
    • Merchant: Technical integrator

After you create the user and assign the required permissions, notify the Chargebackhit support team. Chargebackhit then completes the integration and configuration on your behalf.

If you prefer to complete the integration yourself, let the Chargebackhit support team know, so they can provide detailed step-by-step setup instructions and guide you through the process.

Step 2. Provide account and business information

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

  • Share the Adyen merchant account name
  • Complete Guide
    Add your business information to the HUB settings to fully support the dispute representment process.
    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. Configure report columns

To make sure the historical backfill includes all required data, configure the report columns before generating or exporting reports.

A. Configure the Dispute transaction details report

To configure the report

  1. Go to Settings > Report columns.
  2. Find Dispute transaction details report (monthly) and click on Configure.
  3. Select all available columns.
  4. Click on Save configuration.

B. Configure the Interactive payment accounting report

To configure the report

  1. Go to Settings > Report columns.
  2. Find Interactive payment accounting and click on Configure.
  3. Select all available columns.
  4. Click on Save configuration.

Step 4. Enable SFTP data export for historical backfill

To initiate the setup for SFTP data export to ensure historical backfill, email Adyen support.

Include integrations@chargebackhit.com in the CC field so Chargebackhit can provide all necessary details.

Email details:

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

    Hello Adyen Support,

    We would like to enable SFTP data export for our account as per your documentation, including the Dispute Transaction Details Report (monthly) and the Interactive Payment Accounting Report. Could you set this up and confirm the configuration details?

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

    Thank you!

Step 5. Configure export

Complete the following steps only after Adyen Support confirms the SFTP export setup is complete.

A. Generate the Dispute transaction details report

To generate the report

  1. Go to Reports.
  2. Find Dispute transaction details report (monthly).
  3. Click on Generate > Manual.
  4. Generate reports for:
    • The current month
    • The previous month
    • Two months prior

B. Generate the Interactive payment accounting report

To generate the report

  1. Go to Reports.
  2. Find Interactive payment accounting.
  3. Click on Generate > Manual.
  4. Configure the report with the following settings:
    • Date range: Last 12 months (1 year), including the current one
    • Timezone: Configured timezone
    • Events to report on:
      • Authorised
      • SentForSettle
      • CaptureFailed
      • Expired
      • Cancelled
      • CancelledForAuthReversal
      • SentForRefund
      • RefundFailed
      • SettledReversed
      • RefundedReversed
  5. Click on Generate report.

Final checklist

To verify the integration readiness, make sure you have done the following:

  • Added the Chargebackhit user to your Adyen account with the required permissions
  • Provided account and business information to the Chargebackhit team
  • Configured all report columns for the Dispute transaction details report (monthly)
  • Configured all report columns for the Interactive payment accounting report
  • Sent the SFTP data export request to Adyen, with integrations@chargebackhit.com in CC
  • Generated the Dispute transaction details report for the last 3 months
  • Generated the Interactive payment accounting report for the last 12 months

Looking for help? Contact us
Stay informed with Changelog