Payment Providers: Adyen

Online Account and Merchant Account with Adyen
Payment Provider feature enabled by Checkfront Support
Admin permissions to manage Payment Provider

About Adyen

Adyen Logo

Adyen is a technology company that provides businesses with a single solution for accepting payments anywhere in the world - online, in-app, and at point of sale with in-depth data insights.

Checkfront has added Adyen to the growing list of Payment Providers with which we are integrated!

If you would like to use Adyen as your Payment Provider, please request that Checkfront Support enable this feature for your account via Technical Support.

Check the status of Adyen services at any time here:

https://www.adyen.com/status

PSD2 and SCA compliant

This integration is Payment Services Directive 2 (PSD2) compliant including Strong Customer Authentication (SCA).

Checkfront is prepared to handle any transactions that the Payment Provider deems applicable.

These measures help reduce fraud and make online payments more secure!

Learn more about PSD2 and SCA here...

What is PSD2 and How Will It Impact Your Business?

Setup in Adyen

First, you will need an Adyen online account with an associated merchant account! Learn more about Getting Started with Adyen.

Web Service User

Once you have your Adyen account, you need to obtain some information on your account's Web Service User which will take payments for you through the Adyen API.

Adyen Account

Log into your Adyen account and then select Users from the Accounts option in the top-right menu bar.

Adyen Web Service

A Web Service User is created for your account by default. You will need to know your API Key and Origin Key to complete setup in Checkfront. Click on the Name of the Web Service User to access the Edit Web Service User page where this information resides.

Generate Keys

First Generate a New API Key and then secondly Generate an Origin Key, saving both for entry into the Checkfront setup form in the next step.

When generating an Origin Key, please ensure that the domain name entered does not contain...

www

Your website domain (https://your.domain) must be formatted something like this: https://companyname.checkfront.com.

If the domain name is entered incorrectly, this will only become apparent when you go to test your payment page in Checkfront, so double-check your entry now!

API Response

Within API URLS and response (Account > Configure > API URLS > Additional data settings), you will also want to include the following data within the response:

Authorized Amount Value (Payment amount actually processed)
Card/Card Summary (Last 4 digits of the card number)
Recurring Details (allows for rebilling)
Variant (Payment Method)

Enable Refunds in Adyen

Refunds processed through Checkfront are sent as requests to Adyen, which posts a response back at a later date and time.

In order to handle these communications, we need to configure where responses from Adyen will be posted. This is done in Adyen within Server communication settings (Account > Configure > Server communication).

Default Settings

Simply add a Standard Notification, specifying the Transport URL and selecting the Active checkbox, leaving the other settings with their defaults. There is no need to set the Username and Password.

The Transport URL should be formatted as follows:

https://{youraccount name}.checkfront.com/notify/Adyen/

If you do not configure these settings, refunds will remain in a pending state within Checkfront.

Going Live in Adyen

There is one final step to complete in Adyen when you are ready to go live!

Log in to your live Customer Area.
Go to Account > API URLs.
On the API URLs and Response page, you can see the configured endpoints for your company account.
Scroll down until you see an endpoint called Live.
Copy the live URL prefix and paste it into your Ayden modal

(This is not needed if you’re in sandbox (test) mode)

Setup in Checkfront

To enable Adyen, log in to your Checkfront account and navigate to Manage > Ecommerce Setup, making sure the Payment tab is selected.

Here you see a list of available payment modules. Locate the Adyen tile from the list.

Adyen Tile

You find it by clicking on the links in the left side menu labeled Available to [your country] or All. You can also search for the Adyen tile directly in the provided search box.

Hover over the tile, which turns grey, and click.

Adyen Setup

An Add-on Setup modal displays. Enter the required information in the fields provided. Let's have a look at this information and where to locate it in Adyen.

- Merchant Account

Enter your Merchant Account code here. This can be found within your Adyen account (Account > Merchant Account > Account Code).

- API Key

Enter the API Key you were issued when you created the Adyen Web Service User, in the steps outlined above under Setup in Adyen.

- Origin Key

Enter the Origin Key you were issued when you created the Adyen Web Service User in the steps outlined above under Setup in Adyen.

- Enabling Test Mode (Sandbox)

Select the Sandbox checkbox to enable Test Mode for testing transactions in advance of going live with the Adyen.

- Enable Refunds in Checkfront

To process refunds through Checkfront and Adyen you will need to first select Enable Refunds within the Add-on Setup modal.

See Enabling Refunds under Setup in Adyin above for information on configuring refund notifications within Adyen.

Require Email Address

In order to continue to process payments for Cardholders (e.g. take a deposit and then accept final payment at a later date), you need to require Email Address within your booking forms. A payment token will be associated with the Email Address, which will facilitate future payments.

Supported Payment Methods through Adyen

Adyen only supports credit card payments. The following Payment Methods are not supported...

Ideal
Sofort
Alipay
Google Pay
Android Pay

Learn more here.

Articles in this section