Adyen

Why connect Adyen for Transactions

Connect Adyen as a source so Reveal can import payment activity from your Adyen merchant account into Transactions. After the connection is complete, Reveal imports historical data and continues to monitor live activity so you can:

• Track authorization and decline rates for Adyen Gateway Accounts
• Diagnose failures, including 3D Secure authentication outcomes and disputes
• Act on payment-performance changes from Insights and Alerts

The same Adyen source can also feed Settlements, so finance teams can reconcile payouts, track unsettled volume, and analyze processing fees. Connecting Adyen does not change how payments are processed. Reveal reads data from Adyen; it does not modify live payment flows.

See Get started with Transactions for the overall connection workflow. If your goal is payout reconciliation rather than authorization analytics, see Connect Adyen for Settlements.

Connect Adyen as a source

Connecting Adyen involves multiple steps. While it doesn't require any coding, there are quite a few steps to follow, and missing any of them can cause issues.

Chargebee Reveal offers DIY options to connect with Adyen.

DIY: You may choose to use the DIY integration guide below and follow the steps to connect Adyen manually. The guide in the next section will help you set up Adyen step-by-step.

Self-serve setup

Follow these steps in your Adyen account at a merchant account level:

Complete these 3 steps in your Adyen account at a merchant account level:

1. Create new Report Service user API keys
2. Set up Webhooks and webhook data configuration
3. Set up Automatic Generation of key Reports

Create API credentials in Adyen

We advise you to create new API credentials in your Adyen dashboard to integrate with Reveal. The entire process including key creation will take no more than 2 minutes.

1. Log in to your Adyen Dashboard and select the appropriate merchant account by toggling between merchant accounts in the top left corner of your Adyen account.
2. Go to Developers > API Credentials and click on Create New Credential.
3. Select Credential Type as Report Service User and click on Create Credential.
4. Once you are on the Configure API Credentials page, go to Server Settings and copy the API key.
5. Ensure that you have Merchant Report Download Role set up in the Permissions section.
6. In the Accounts section, ensure that "Only Selected account groups and merchant accounts" is selected and select the corresponding merchant account.
7. Click on Save Changes.

Add Adyen as a source in Reveal

Follow these steps to add Adyen as a source in your Reveal dashboard:

1. You will need the API Key from Configure API Credential Page to add Adyen as a Source in your Reveal dashboard.
2. Go to your Reveal dashboard > Sources > Add a source.
3. Click on Adyen.
4. Copy the Configure Webhooks - Payment URL that is visible on your screen.
5. Paste the API Key that you copied in the Key Creation step.
6. Add your Merchant Account Name and Company account name as configured on your Adyen account.
7. Adding Subdomain - in Live mode in your Adyen account, go to Developers > API URLs > Prefix. Paste this Prefix in subdomain field.
8. Add an alias.
9. Click Connect.

Configure Adyen webhooks

Once you have added Adyen as a source, you need to go to your Adyen dashboard and add our webhook URL endpoint so that we can start collecting data from Adyen. The steps for webhook configuration are as follows:

1. You can find the Reveal webhook URL in your Reveal dashboard when you added sources.
2. Select the relevant Merchant Account in your Adyen Dashboard and then go to Developers > Webhooks.
3. Click on + Webhook.
4. Click on Add Standard Webhook.
   • Click on the Edit button next to Server Configuration.
   • Add the URL from Step 1 here. Select Method as JSON and Encryption Protocol as TLSv1.3.
   • Click on Apply.
5. Click on the Edit button next to Events and select all the events.
6. In Additional Settings, select all the options for 3D Secure, Acquirer, Bank, Card, Payment.
7. Click Save changes.

That's it. You have now completed adding Adyen as a source on your Reveal dashboard. Now you can sit back and relax and let Reveal Transactions and Settlements crunch the numbers and provide you invaluable insights and intelligence about your payment stack at the click of a button.

If you still need help, reach out to your Customer success manager or send an email to the customer success team.

Configure Adyen reports

Follow these steps to configure Adyen reports for effective Transactions data and insights:

1. You will need the following report configurations for effective Transactions data and insights:
   • Received Payments Report
   • Payment Accounting Report
   • 3D Secure Authentication Report
   • Dispute Transactions Report
   • Settlement Details Report
2. Follow the same steps below for each report listed above:
   • Go to Adyen Account > Reports.
   • Search for the report name in the search bar.
   • Select the report.
   • Click on Column Configuration. Select the checkbox in the table header. Ensure all columns are selected and click on Save configuration.
   • Go to Generated reports tab, click on Manage Report > Automatic > Automatic Generation (On) and File Type as .CSV.