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 AdyenBack 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.
Either select an existing system user, or, add a new one.
The user type should be configured as
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 CheckfrontBack 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:
NameBack to top
This is the username that was generated when you created a new user in the previous step.
PasswordBack to top
The password generated by the system, or the password you created manually, during the new user setup in the previous step.
Merchant AccountBack 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.
API URLBack to top
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 RefundsBack 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.
2) Add a Standard Notification.
3) Set the URL to
https://youraccount.checkfront.com/notify/Adyen/ and be sure to tick the Active checkbox to activate it.
4) Scroll all the way down and click on Save Configuration at the bottom of the screen.
Testing Your ConfigurationBack 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.
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 TransactionBack 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:
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.
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:
Back over in Adyen, you can access your transactions by clicking on the Payments button.
Clicking on the PSP Reference link will open up the transaction in greater detail.