visibility Plan Availability: ✓ Soho | ✓ Pro | ✓ Plus | ✓ Enterprise
my_location Locate: Manage > E-Commerce
check_circle_outline Pre-requisites: for activating Adyen...
- Online Account and Merchant Account with Adyen
- Payment Gateway feature enabled by Checkfront Support
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.
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.
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:
- Card/Card Summary (Last 4 digits of the card number)
- Variant (Payment Method)
- Authorized Amount Value (Payment amount actually processed)
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).
You simply need to add a Standard Notification and specify the Transport URL, 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.
3D SecureBack to top
Accounts with their business and Customer in the European Union (EU) need to comply with Payment Services Directive 2 (PSD2) by ensuring strong Customer authentication through 3D Secure.
Clients need to request that Adyan enable 3D Secure for their account if PSD2 applies to their business. You will then have access to 3D secure rules (Risk > 3D secure rules), where you will want to configure the system to state when SCA required then propose 3DS Authentication.
Note, 3D Secure does not work on the staff-side only in the Customer-facing booking forms to protect the security of the Customer's data.
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.