You’ll need an active Chargeback.io account to connect Adyen. If you don’t have one, follow this guide to create it.
Chargeback will be able to automatically process alerts only for transactions created AFTER the moment the Adyen integration is connected. This is due to Adyen's limitations.
How to Connect Adyen to Chargeback.io
Follow these steps to connect Adyen to Chargeback.io:
In the sidebar, click Integrations.
Find the Adyen card and click Connect.
Add your API Key, Merchant Name, and URL Prefix.
Click Connect.
ℹ️ If needed, set an auto-refund threshold to limit automatic refunds.
See the Automatic Refund Guide for more information.
How to Find Your Adyen API Key, Merchant Name, & URL Prefix
Part 1. Go to API Credentials
To start off:
Select your merchant account.
In the sidebar, click Developers.
Open API Credentials.
Click Create new credential.
Part 2: Create credentials
In the pop-up for creating new credentials:
Select Web Service User.
Add a description (e.g., Chargeback).
Click Create credential.
Part 3. Copy your API key
After creating your credential:
Scroll to Server Settings.
Make sure the API key tab is selected.
Copy the API key from the box.
Click the Save changes in your Adyen dashboard.
Go to Chargeback.io and paste the API key.
Part 4. Copy your Merchant Name
After you’ve copied your API key:
In the sidebar, select the same merchant account you used for the API key.
Click your merchant name (above Merchant Account).
Click the Copy to clipboard icon.
Go to Chargeback.io and paste the Merchant Name.
Part 5. Find Your URL Prefix
Next, you'll need your URL prefix:
In the sidebar, click Developers.
Open API URLs.
Beside Prefix, click Copy.
Return to Chargeback.io and paste the URL Prefix.
Part 6 (Optional): Invite an Account Manager
Due to Adyen's limitations, when connecting an account, Chargeback.io's Adyen integration can only auto-refund future transactions and cannot auto-refund transactions done before connecting the integration.
To make it so you can refund previous transactions, you'll need to invite a Support Manager, which requires these steps:
In the sidebar, click Accounts and on the dropdown, click Users.
Click Create New User.
Select 'Email and password' as the login method and enter only the user email, which is [email protected].
On the Accounts step, select "Only selected account groups and merchant accounts".
For Roles, expand Transactions and only select "View payments".
At the last step, click Create User.
How to Disconnect Adyen From Chargeback.io
In the left sidebar, click Integrations.
Find the Adyen card and click Disconnect.
⚠️ Disconnecting Adyen does not stop alerts. To stop receiving alerts, fill out this disenrollment form.
Important Notes
If the Adyen fails to match a transaction to your Chargeback.io dashboard:
Mark the Attention-status alert as Not Found.
💬 Still need help? Chargeback.io Support is here.

