Articles in this section

Set up a connection to Adyen

Tanisha Ray
Updated

Adyen is a payment platform that provides businesses with a seamless and unified solution for accepting payments across various channels. Known for its flexibility and scalability, Adyen facilitates secure transactions and supports multiple payment methods, making it a preferred choice for e-commerce and retail enterprises.

Set up a connection

After you start the connection, configure it in the Create connection panel and complete all of the required * authentication settings:

Setting

Instructions

Name your connection * 

Enter a clear and distinguishable name.

Throughout integrator.io imports and exports, you will have the option to choose this new connection. A unique identifier will prove helpful later when selecting it from a list of the connections in your account.

API type * 

Choose your Adyen account API type:

  • Management: Configure accounts, users, roles, stores, terminals, and webhooks to automate merchant setup, payment method settings, and operational controls across your organization.

  • Online payments: Accept online payments through cards, wallets, and local methods using a unified checkout experience to support global commerce with built-in risk and authentication tools.

  • In-person payments: Integrate with Adyen POS terminals to process face-to-face payments, manage devices, and unify physical and digital transaction data for seamless omnichannel experiences.

  • Platform and financial products: Onboard sub-merchants, split payments, handle payouts, and manage compliance to build scalable financial platforms like marketplaces or gig economy apps.

  • Classic payments: Process traditional payment operations like authorize, capture, refund, and cancel using Adyen’s legacy endpoints for backward-compatible commerce integrations.

  • Classic platforms: Use legacy platform APIs to manage sub-merchant onboarding, split settlements, and generate reconciliation reports for older Adyen for Platforms integrations.

Common settings for all API types

Auth type * 

Choose the authentication type, either Basic or Token depending on the Adyen authentication type you're connecting to. The settings then become specific to the selected authentication type.

Username * 

Enter your Adyen API username.

How to retrieve the username 

Password * 

Enter your Adyen API password.

Multiple layers of protection, including AES 256 encryption, are in place to keep your password safe. When editing this connection, you must re-enter this value each time; it is stored only when the connection is saved and never displayed as text.

How to retrieve the password 

Token * 

Enter your Adyen token.

Multiple layers of protection, including AES 256 encryption, are in place to keep your token safe. When editing this connection, you must re-enter this value each time; it is stored only when the connection is saved and never displayed as text.

How to retrieve token 

The following settings are visible only for the Online payments and Platform and financial products API types

Services *

Select the required Adyen API service.

Version *

Enter the API version. For detailed information, see API version .

The following settings are visible only for the  In-person payments API type

Company account *

Enter your Adyen company account.

How to retrieve the company account 

Tip

This connector documentation describes only the settings shown for the Basic auth and Token auth views, respectively. For the corresponding HTTP settings, see the Basic and Token universal connector documentation, respectively.

How to retrieve the username and password

  1. Sign in to your Adyen account.

  2. Navigate to Developers > API credentials.

  3. Click Create new credential.

  4. Select Web app and click Next.

  5. In Credential type, select Web service user.

  6. Click Create credential. The Configure API credential page opens.

  7. From General settings, copy the Username.

  8. Navigate to Server settings > Authentication > Basic auth.

  9. Copy the Password.

How to retrieve the token

To retrieve the token:

  1. Sign in to your Adyen account.

  2. Navigate to Server settings > Authentication > API key.

  3. Copy the API key (token).

How to retrieve the company account

How to retrieve the company account

  1. Sign in to your Adyen account.

  2. Navigate to Settings > Account settings > Company settings.

  3. Copy the Company account.

Additional references