Support Guide

Adyen

    TABLE OF CONTENTS

  1. Setup in Adyen
  2. API URL
  3. Enabling Refunds
  4. Testing Your Configuration

 

Where do I access this in Checkfront?
You can activate the Adyen payment gateway by navigating to Manage > E-commerce in Checkfront.

 

Coming Soon!

The Adyen payment gateway is currently being integrated and tested by our tireless team of developers and will be available for use soon. Watch this space! But, in the mean time, feel free to familiarize yourself with this setup guide and configure your Adyen account ready for integration.

 

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


 

Setup in Adyen

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

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.

 

adyen-activate

 

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:

Name

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

Password

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

Merchant Account

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
 

API URL

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.

 
API URL
 

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.

 
API URLs List
 

The URL should look something like: https://c2fba9-TestCompany.pal-live.adyenpayments.com

 

Enabling Refunds

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 https://youraccount.checkfront.com/notify/Adyen/ and be sure to tick the Active checkbox to activate it.

 

Standard Notification Active

 

Example:
If your Checkfront URL is https://example.checkfront.com, then the URL you will need to enter in Adyen would be https://example.checkfront.com/notify/Adyen/

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

 
 


 

Testing Your Configuration

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

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