> ## Documentation Index
> Fetch the complete documentation index at: https://docs.slickerhq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Adyen

> Learn how to connect Adyen to Slicker

### Prerequisites

Slicker integrates with Adyen via their reporting features to sync payment data and provide insights into failed transactions. The setup is more complex than other integrations, but provides the most accurate payment data for revenue recovery.

To set up this integration, you need:

* An Adyen account with access to reports and API credentials
* Admin or Merchant admin permissions (which includes the required roles: `Merchant Report`, `Manage API credentials`, and `Merchant technical integrator`)
* Access to your Adyen Customer Area

### Create API credentials

Slicker needs to read reports from Adyen. Create a Report service user by following these steps:

1. Log in to your [Adyen Customer Area](https://ca-live.adyen.com/).

2. Follow the [official Adyen documentation](https://docs.adyen.com/reporting/automatically-get-reports/#create-api-credential) to create a Report service user API credential.

3. Copy the **Server Settings API Key** - you'll need this for the Slicker integration.

<Note>
  Keep your API key secure. Slicker only needs read permissions to sync payment data and analyze failed transactions.
</Note>

### Schedule automatic report generation

We use Adyen's [Received payment details report](https://docs.adyen.com/reporting/received-payment-details-report/) to sync payments data.

1. Follow the [official Adyen documentation](https://docs.adyen.com/reporting/automatically-get-reports/#automate-generating-reports) to set up automatic report generation.

2. Make sure to select the **Received payment details report** as the report type.

3. When prompted to select the columns for the report, select **all columns**.

### Create integration in Slicker

1. Go to Slicker's [new integration page](https://app.slickerhq.com/integrations/new).

2. Select **Adyen** from the list of payment integrations.

3. Provide the following information:
   * **Integration name**: A descriptive name to help you identify this integration
   * **Description**: Optional description for additional context
   * **API Key**: The Report service user API key you copied from Adyen

4. Copy the **Endpoint URL**, **Basic Auth Username**, and **Basic Auth Password** from the Slicker integration page - you'll need these for webhook configuration.

### Configure webhooks

For real-time report notifications, configure webhooks:

1. In your Adyen Customer Area, follow the [official Adyen documentation](https://docs.adyen.com/development-resources/webhooks/) to create a webhook.

2. Configure the webhook with the credentials from the Slicker integration page:
   * **Webhook URL**: Use the Endpoint URL from Slicker
   * **Authentication**: Use Basic Auth with the username and password from Slicker

3. Copy the **Webhook HMAC Key** from Adyen and paste it into the Slicker integration page.

### Save the integration

1. Click **Submit** to create the integration.

### What data does Slicker sync?

Once connected, Slicker will sync the following data from Adyen:

* **Payment transactions**: Successful and failed payments with detailed information
* **Decline reasons**: Comprehensive acquirer responses and failure details
* **Customer data**: Shopper information needed for recovery campaigns
* **Risk scoring**: Risk assessment data to optimize recovery strategies
* **Payment methods**: Card types, issuer information, and payment method details

### Troubleshooting

**Connection failed error:**

* Verify your API key is correct and has not expired
* Ensure the key has sufficient permissions to read report data
* Check that your Adyen account is active and in good standing

**Missing transaction data:**

* Slicker syncs data from reports as they are generated
* New transactions typically appear after the next scheduled report
* Ensure automatic report generation is properly configured

**Webhook issues:**

* Verify the webhook URL and authentication credentials are correct
* Check that the HMAC key matches between Adyen and Slicker
* Ensure webhooks are enabled for your Adyen account

<Frame>
  <img src="https://mintcdn.com/slicker/HZZPLdXP1aKdz94r/images/integrations/integration-failure.png?fit=max&auto=format&n=HZZPLdXP1aKdz94r&q=85&s=59f6f532473345be5919699e5de59427" alt="Failed integration creation message" width="946" height="177" data-path="images/integrations/integration-failure.png" />
</Frame>

For additional help, contact [Slicker support](https://www.slickerhq.com/contact) or check our [FAQ](/essentials/faq).