Guides
  1. processors
  2. Adyen

Connecting Adyen

Connecting Adyen uses API credentials rather than OAuth. To connect, you will need three things from your Adyen account:

  • Your Merchant Account ID
  • An API key
  • Your domain prefix

Setup

  1. Log in to your Adyen account.

  2. Go to Account > Users.

    You need a Web Service user on your account, with the correct permissions for Web Payments (the API PCI Payments role) and, depending on your needs, another for POS payments. This is what allows card details to be passed via the Adyen API. If you do not have the user or permissions set up, contact Adyen to have them added.

    Adyen Customer Area - Account menu open, highlighting the Account tab and Users option

  3. Generate an API key, and copy it into the Shuttle setup screen.

    Adyen User List showing the Web Service user

    Edit Web Service User screen with the Generate New API Key button

  4. Grab your Merchant ID, and copy it into the Shuttle setup screen.

    Switch accounts dropdown showing the merchant account selector

  5. You will also need to know your domain prefix. This can be found by going to Account > API URLs. On the API URLs and Response page, you can see the configured endpoints for your company account.

📘

Tip

If you are having trouble connecting your account, make sure Adyen have enabled the API PCI Payments role on your account. When requesting this role, say you are using an integration by Shuttle Global.

Extra settings

If you want to save card details, you will need to ask Adyen to enable synchronous tokenisation on your account.

Interaction type

Choose eCommerce/MOTO. If you are using MOTO as well as eCommerce, check the MOTO box so that transactions are passed correctly.

Address verification (AVS)

For AVS, you will need to ensure that this is configured in your Adyen portal.

Setting up a test account

If you need an Adyen test account before connecting, see Creating an Adyen Sandbox Account.