Skip to main content

Setting up Adyen as your Checkfront payment provider

Adyen is a global payment platform that lets you accept credit card payments directly through Checkfront. This article walks you through the complete setup process, from configuring your Adyen account to going live, so you can start taking bookings and processing refunds with confidence.

Learn more about Adyen, including:

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 the point of sale with in-depth data insights.

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

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.

 

Callout icon of a web page with lock, indicating online security or privacy.

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 create a set of Web Service User Credentials that take payments through the Adyen API.

You must know your API Key and Origin Key to complete the setup in Checkfront.

Adyen API credentials page via option in the side menu.
  1. Log in to your Adyen account and select API Credentials from the Developers option in the left menu.

 

Create API credentials modal with annotation pointing to the Web services user option.
  1. Select Create new credential from the top-right, then choose Web Service User. 
  • If you would like, you can add an optional description (e.g., Checkfront) before creating your credential.  You can add or edit this description at any time after creation.

 

Adyen client settings page with focus to Origin key tab.

  1. Next, you need to generate an Origin Key by selecting the Origin key (legacy) tab from Client Settings - Authentication. 

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

    Ensure the domain name entered does not contain 'www.'

    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!
     

  3. Click the Generate Origin key button.

 

Configuring API Response settings

Back to top

Additional data settings with annotation pointing to the card summary setting.

In your Adyen Customer Area, go to Developers > Additional data and enable the following:

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

 

 

Enabling refunds in Adyen

Back to top

When a refund is processed in Checkfront, the request is sent to Adyen, which responds asynchronously. You need to configure where Adyen sends that response.  If you do not configure this, refunds remain pending in Checkfront.

To configure Adyen post responses

  1. In your Adyen Customer Area, go to Developers > Webhooks (previously Account > Configure > Server communication).
  2. Select Add next to Standard Notification.
  3. In the Transport URL field, enter your Checkfront URL in the following format:
    https://youraccountname.checkfront.com/notify/Adyen/
    Replace youraccountname with your Checkfront account name.
  4. Select the Active checkbox.
  5. Leave all other settings at their defaults. You don't need to set a Username or Password.
  6. Select Save Configuration.

 

Going live in Adyen

Back to top

There is one final step to complete in Adyen before you 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 Adyen 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.

 

Checkfront ecommerce setup screen with search results highlighting Adyen as an available payment provider option.

You find it by clicking 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.

Click the listing to open the Add-on Setup modal.

 

Checkfront add-on setup form for Adyen integration requiring merchant account details, API key, origin key, and sandbox or refund options.

An Add-on Setup modal displays. You can 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 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 Adyen above for information on configuring refund notifications.

 

Requiring email addresses

Back to top

To continue processing payments for Cardholders (e.g., taking a deposit and then accepting final payment at a later date), you need to require an email address in your booking forms. A payment token is associated with the Email Address to facilitate future payments.

 

 

Related to