Plan Availability: ✓ Soho | ✓ Pro | ✓ Plus | ✓ Enterprise | ✓ Flex |
Locate: Manage > E-Commerce
Prerequisites: for activating Adyen...
- Payment Gateway is available to select Customers. General availability coming soon!
- Online Account and Merchant Account with Adyen
- Payment Gateway feature enabled by Checkfront Support
- Admin permissions to manage Payment Gateways
Introduction to AdyenBack to top
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 Gateway, please request that Checkfront Support enable this feature for your account via firstname.lastname@example.org.
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 Gateway deems applicable.
These measures will help reduce fraud and make online payments more secure!
Setup in AdyenBack to top
First, you will need an Adyen online account with an associated merchant account! Learn more about Getting Started with Adyen.
Web Service UserBack to top
Once you have your Adyen account, you need to obtain some information on your account's Web Service User which will take payments for you through the Adyen API.
Log into your Adyen account and then select Users from the Accounts option in the top-right menu bar.
A Web Service User is created for your account by default. You will need to know your API Key and Origin Key to complete setup in Checkfront. Click on the Name of the Web Service User to access the Edit Web Service User page where this information resides.
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 that the domain name entered does not contain...
Your website domain (https://your.domain) must be formatted something like this: https://companyname.checkfront.com.
If the domain name is entered incorrectly, this will only become apparent when you go to test your payment page in Checkfront, so double-check your entry now!
API ResponseBack to top
Within API URLS and response (Account > Configure > API URLS > Additional data settings), you will also want to include the following data within the response:
- Authorized Amount Value (Payment amount actually processed)
- Card/Card Summary (Last 4 digits of the card number)
- Recurring Details (allows for rebilling)
- Variant (Payment Method)
Enable Refunds in AdyenBack to top
Refunds processed through Checkfront are sent as requests to Adyen, which posts a response back at a later date and time.
In order to handle these communications, we need to configure where responses from Adyen will be posted. This is done in Adyen within Server communication settings (Account > Configure > Server communication).
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:
If you do not configure these settings, refunds will remain in a pending state within Checkfront.
Going Live in AdyenBack to top
There is one final step to complete in Adyen when you are ready to go live!
Log in to your live Customer Area.
Go to Account > API URLs.
On the API URLs and Response page, you can see the configured endpoints for your company account.
Scroll down until you see an endpoint called Live.
Copy the live URL prefix and paste it into your Ayden modal
(This is not needed if you’re in sandbox (test) mode)
Setup in CheckfrontBack to top
Next, we need to configure the Payment Gateway integration. In the main Checkfront navigation menu, select Manage and then E-Commerce.
Look for and then click on the Adyen tile to launch the integration modal. If Adyen is not listed, this means that Checkfront Support has not yet enabled the feature, so please reach out for assistance!
An Add-on Setup modal will display. Enter the required information in the fields provided. Let's have a look at this information and where to locate it in Adyen.
- Merchant AccountBack to top
Enter your Merchant Account code here. This can be found within your Adyen account (Account > Merchant Account > Account Code).
- API KeyBack 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.
- Origin KeyBack 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)
Select the Sandbox checkbox to enable Test Mode for testing transactions in advance of going live with the Adyen.
- Enable Refunds in CheckfrontBack to top
To process refunds through Checkfront and Adyen you will need to 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.
Require Email AddressBack to top
In order 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 will be associated with the Email Address, which will facilitate future payments.
Supported Payment Methods through AdyenBack to top
Adyen only supports credit card payments. The following Payment Methods are not supported...
- Google Pay
- Android Pay
Learn more here.