---
title: Connect your Adyen account
description: Copy your API key, client key and merchant account from Adyen into the app settings in Swell.
---

## 1. Open the Adyen settings in Swell

After installing the app, go to **Settings → Payments** in your Swell dashboard. Under **Alternative methods**, find **Adyen** and select **Settings**.

![The Adyen card under Alternative methods in Swell's payment settings](/blume-assets/content/docs/images/swell-payment-methods.png)

## 2. Copy your API key from Adyen

In the Adyen Customer Area, go to **Developers → API credentials** and open your web service credential (named like `ws_123456@Company.YourCompany`). If you don't have one, select **Create credential** and choose **Web service user**.

Under **Server settings → Authentication → API key**, select **Generate API key** and copy the key.

![The API key section of an Adyen API credential](/blume-assets/content/docs/images/adyen-api-credential.png)

:::warning
Adyen shows the full API key only once, right after you generate it. Paste it into Swell straight away. Generating a new key replaces the old one, so anything still using the old key stops working once you save.

Saved cards for subscriptions are signed with the app's own key, not your API key, so you can replace the API key without affecting subscriptions created on app version 1.3.1 or later. Subscriptions created on 1.2.1 to 1.3.0 were signed with the API key: see [Troubleshooting](/troubleshooting#subscription-renewals-fail-with-saved-payment-method-could-not-be-verified) before you replace it.
:::

## 3. Copy your client key

On the same credential page, scroll to **Client settings**. Copy the **Client key**. It starts with `test_` in the test environment and `live_` in live. You'll also use this section in the next step to add the allowed origin.

![The client key under Client settings](/blume-assets/content/docs/images/adyen-allowed-origins.png)

Select **Save changes** at the bottom of the credential page if you generated a new key.

## 4. Fill in the app settings

Back in Swell, fill in the **Adyen settings** dialog:

![The Adyen settings dialog in Swell, filled in with example values](/blume-assets/content/docs/images/swell-adyen-settings.png)

| Setting | What to enter |
| --- | --- |
| **Adyen API key** | The API key from step 2. |
| **Adyen client key** | The client key from step 3. |
| **Adyen merchant account** | Your merchant account name, for example `YourCompanyECOM`. Use the merchant account, not the company account. |
| **Environment** | **Test** while you set up. Switch to **Live** only when you [go live](/going-live). |
| **Live URL prefix** | Leave empty for Test. Required for Live. See [Going live](/going-live). |
| **Webhook HMAC key** | Leave empty for now. You'll fill it in when you [set up the webhook](/setup/webhook). |

Select **Save**.

:::note
The API key and HMAC key are stored as secrets. Swell shows them masked after you save.
:::