Skip to main content

Setting up Adyen as your Checkfront payment provider

Learn more about Adyen, including checking on the service status, setting up your Adyen account, updating your web service user, configuring API response settings, enabling refunds, going live in Adyen, setting up Adyen in Checkfront, entering your merchant account, entering your API key, entering your Origin key, enabling sandbox mode, enabling refunds in Checkfront, requiring email addresses, and understanding supported payment methods.

 

Accessing the features mentioned in this article


Where can I find this feature using the top menu?

Manage > Ecommerce Setup > Payment

What more do I need to use this feature?

  • Admin permissions are required to manage Payment Providers.
  • Online account and merchant account with Adyen.

 

About Adyen

Back to top

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.

 

 Compliance

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...

 

Checking on the Service Status

Back to top

 

Adyen Logo

Check the status of Adyen's services at any time here:

 

Setting up your Adyen account

Back to top

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

 

Updating your web service user

Back to top

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

 

Adyen Account

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

 

Adyen Web Service

A Web Service User is created for your account by default. You must know your API Key and Origin Key to complete the 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 the domain name entered does not contain 'www.'

Your website domain (https://your.domain) must be formatted like this:

 https://companyname.checkfront.com

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

 

Configuring API Response settings

Back to top

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

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

 

Enabling refunds in Adyen

Back to top
Server Communication

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

To handle these communications, we need to configure where responses from Adyen post. 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 remain pending within Checkfront.

 

Going live in Adyen

Back to top

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

  1. Log in to your live Customer Area.

  2. Go to Account > API URLs.

  3. You can see the configured endpoints for your company account on the API URLs and Response page.

  4. Scroll down until you see an endpoint called Live.

  5. Copy the live URL prefix and paste it into your Ayden modal

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

 

Setting up Adyen in Checkfront

Back to top

To enable Adyen, log in to your Checkfront account and navigate to Manage > Ecommerce Setup, ensuring 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 labelled 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 look at this information and where to locate it in Adyen.

 

Entering your merchant account

Back to top

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

 

Entering your API Key

Back to top

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

 

Entering your Origin Key

Back to top

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)

Back to top

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

 

Enabling refunds in Checkfront

Back to top

To process refunds through Checkfront and Adyen, you must 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.

 

Requiring email Addresses

Back to top

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 is associated with the Email Address, facilitating future payments.

 

Supported Payment Methods through Adyen

Back to top

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

  • Ideal
  • Sofort
  • Alipay
  • Google Pay
  • Android Pay

Learn more here.