Estimated reading time: 3 min

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


Setup in Adyen

Back to top

You will need a system user Merchant Account to take payments through the Adyen API.

Log in to Adyen. In the menu bar to the left, click on Settings, then click on Users.

Adyen Setup

Either select an existing system user, or, add a new one.


Add New User


The user type should be configured as Webservice


User Account Details


The username and password will be automatically generated by the system. If you like, you can change the password to something else. It should be at least 8 characters long, contain both letters/digits and only contain plain letters, digits and common punctuation symbols (i.e. no accented letters, no currency symbols). The password should also not be the same as any previously used passwords.

Setup in Checkfront

Back to top

Once you’ve created a user account at Adyen, it’s time to head on over to Checkfront and configure the payment gateway integration.

In the main Checkfront navigation menu, go to Manage > E-Commerce.

Look for the Adyen tile and click on it to launch the integration modal.




You will now need to enter the required information in the fields provided.

Let’s have a look at the information you will need and where to locate it in Adyen:


This is the username that was generated when you created a new user in the previous step.


The password generated by the system, or the password you created manually, during the new user setup in the previous step.


Merchant Account

Back to top

Enter your merchant account ID here. This can be located in the Adyen user interface, under the Accounts menu in the left sidebar.

Merchant Account

Adyen may or may not supply you with a custom API URL when you sign up for their service. If an API URL is required, you will be able to access it through your Adyen settings panel. To find your URL:

Log in to Adyen. In the menu bar to the left, click on Settings, then click on API URLs.


Please note… the account used by Checkfront for testing does not require an API URL, so the screenshot above and the screenshot below were taken from the Adyen support documentation.



The URL should look something like:


Enabling Refunds

Back to top

To enable refunds, a standard notification must first be created in Adyen:

1) Log in to Adyen. In the menu bar to the left, click on Settings, then click on Server Communication.

Server Communication

2) Add a Standard Notification.

Standard Notification

3) Set the URL to and be sure to tick the Active checkbox to activate it.


Standard Notification Active


4) Scroll all the way down and click on Save Configuration at the bottom of the screen.


Testing Your Configuration

Back to top

Once everything is configured, as described in the steps above, it’s time to process your first transaction.

Before you do, it’s best to make some test bookings in Checkfront to ensure everything is working as expected.

Adyen has its own test environment which enables you to begin integrating with your website and third-party products, such as Checkfront, before you go live with the system.

There is also a sandbox mode you can activate from the Checkfront configuration modal.


Enable Sandbox Mode


Once this mode is active, you will be able to generate dummy transactions in Checkfront that will also appear in your Adyen test environment. This enables you to create paid bookings, issue refunds and make sure the systems are working together as expected.

Adyen has a series of dummy credit card numbers which can be used during your testing. You will find a list of them here.

To get started right away you can try the following Visa number:

4111 1111 1111 1111 Expiry: 08/2018 CVC: 737
The expiry and CVC number will be the same for all test credit card numbers.


Processing a Transaction

Back to top

When you’re ready to process a transaction, whether it be a dummy or a live transaction, the process is the same.

Make sure you have activated credit card payments in your Checkfront account.

Create a booking as normal. When you arrive at the payment page, enter the credit card details asked for by the system.

In the example below, we are adding a payment to a booking through the backend:


Add Payment Adyen


Enter the credit card credentials as required and click the blue Process button.

Once the transaction has processed, you’ll be presented with a copy of the invoice, payment applied.

Above the invoice is a Transactions button.

Show Transactions

Click on this at any time to view the details on the transaction you just made. If you only took a deposit, any subsequent transactions against the invoice will appear here also.

For even greater transaction detail, including the transaction number issued by Adyen, click on the Details button, as highlighted below:


Details Button


Back over in Adyen, you can access your transactions by clicking on the Payments button.

Adyen Payments Button

Clicking on the PSP Reference link will open up the transaction in greater detail.

Adyen Transaction Details

Was this article helpful?
I have a suggestion...