Adyen Setup

The steps below will help you set up Adyen Integrated Payments and Adyen Hosted Payment Page features. Please note that you need first to have either Adyen Integrated payment or Adyen Hosted Payment Page add-ons enabled and Adyen Account. Being a payment processing institution, Adyen has security procedures for your account to pass before becoming live.

The Adyen interface activation procedure itself may take from a few weeks to a month, and requires your active cooperation, submitting filled-in documents and the provision of the requested information. If you don't have an Adyen account, please send a ticket via the Support Portal.

Click open each block to see every step of the Adyen setup.

1.1. Log in to your Clock PMS account. Select 'Other' - 'Settings' - 'Adyen (Hosted Payment Page)' or 'Adyen (Integrated Payments)'

1.2. Find the URL next to the 'Standard notification url' label. Copy the URL.

1.3. Log in to your Adyen account.

1.4. Select 'Settings' from the left navigation sidebar. Click 'Server Communication' (or 'Notifications')

1.5. Select your company account if prompted

1.6. Click 'Add' next to 'Standard Notification'

  • Paste the copied URL into the ‘URL' field
  • Change ‘SSL Version' to 'TLS'
  • Tick the ‘Active' checkbox
  • ‘Service Version' : 1
  • Change ‘Method' to 'HTTP POST'
  • ‘Populate SOAP Action header' : unchecked
  • “Save Configuration"

Adyen Notifications are required. Check step 1 first.

You need to complete Adyen credential information in Clock PMS in order to enable Clock PMS to connect to your Adyen account. Contact the Adyen Support Team if you don't have a system user for Web Services created yet.


2.1. Log in to your Adyen account and select your sub-account (click on the account name at the top of the page). Select Settings (left navigation sidebar)

2.2. Setting up "Capture Delay"
  • Select the Merchant Settings button. Check your current sub-account if the button is not available.
  • Select "Manual" for "Capture Delay" select.
  • Save and go back to 'Settings'

2.3. Select Users button

2.4. Locate the System User created for Web Services and click on the user name to open it. If the user is not listed, try to show all users and check again. To show all users, select 'All' from the menu at the top right in the user table. Contact Adyen Support Team if you can't find the System User for Web Services.

2.6. You need to Copy/Paste the following information into Clock PMS (Settings - Adyen Integrated Payments screen).
  • Account Name. Your account is shown at the top of the Adyen page. Typically, the account name is like this 'ABCCompanyCOM'.
  • User Name. The System User created for API usage (Web Services). Typically, the user name is like this "ws_xxxxxx@Company.ABC".
  • User Password. If you don't have the password. Click the 'Generate New Password' button and copy the password.
  • Easy Encription library location. In the 'Easy Encryption' section (top right), copy the content of field 'Library location' (hover over the link and click 'Copy' button when it apears). Contact Adyen Support Team if you have troubles with finding the settings.

2.5. Finish the settings in Clock PMS.
  • Select the currency that is going to be used for the amounts sent to Adyen.
  • Select ‘Address verification required (AVS)’ if you use Adyen address verification. The address fields will be added to the credit card form your clients fill.
  • Select services: Authorize and Capture (Payment), Tokenize (Save Card) Only, Authorize, Capture (Payment) and Tokenize (Save Card), Authorize Only (Pre-Authorization), Refund to activate them.
  • Select 'Live mode' to start taking real payments. Leave the check box unchecked if you need to stay in 'Test mode'.
  • Save.

To use the new payment method in your WRS, select it as a payment option in the corresponding Guarantee Policy.

If you get this error "107 - Recurring is not enabled" on credit card tokenization. Please contact Adyen support and ask for enabling the "Recurring Contracts" feature.

Adyen Notifications are required. Check step 1 first.

If you intend to use HPP together with integrated payments, please keep in mind that you will need two different Adyen sub-accounts.

The intergrated payment account requires the "Capture Delay" setting to be ”Manual", but the HPP account requires the "Capture Delay" setting to be ”Immediate”.

With the Adyen HPP (Hosted Payment Page), you can add local payment methods (Sepa, IDeal, Sofort, giropay, etc. ) support to your WRS and Self Service for booking guarantee purposes. The HPP supports on-line credit card payments too. Tokenization, One-Click payment, Pre-Authorization and Refunds are NOT supported by HPP.


3.1. Log in to your Adyen account. Select ‘Skins' from the left navigation sidebar and 'Create a New Skin'

3.2. Fill in a description

3.3. Copy ‘Skin Code'.

3.4. Go back to the Clock PMS settings and paste them into the ‘Skin Code' field.

3.5. On the Adyen skin settings page: - In ‘Test & Live configuration' section, get 'HMAC Keys' by pressing both 'Generate new HMAC Key' buttons under 'Test platform' and 'Live platform'.

3.6. Copy the generated ‘HMAC Keys' value from the 'Live platform' if launching the interface in production OR from the 'Test platform' if testing the interface.

3.7. Go back to the Clock PMS settings screen. Paste the copied test or live HMAC Key into the ‘HMAC Key' field.

3.8. Go to the Adyen skin settings page. If you need help with other skin settings, contact the Adyen support team. Save the Skin by clicking the 'Create new Skin' button.

3.9. Go to the Clock PMS settings. Check or leave unchecked the ‘Live' checkbox.

3.10. Enter your Adyen account code in Clock PMS settings. The account code can be found on the Adyen accounts page:

3.11. Save the settings.

To use the new payment method in your WRS, select it as a payment option in the corresponding Guarantee Policy.

Adyen Notifications are required. Check step 1 first.

This interface requires Clock IoT Device to be installed in the same network as the POS terminal. This interface requires API add-on.

Please note that the POS terminal's IP address should be a static one for the connection to work properly. More info about Adyen POS network requirements.

Once the IoT device is installed in your local network, please associate it with your Clock PMS account from: 'Other' > 'Settings' > 'Clock IoT Devices'. After doing so, please contact us with the device's serial number (copy it from 'Other' > 'Settings' > 'Clock IoT Devices' ) to activate the communication of the IoT device with the Adyen POS Terminal.

IoT device requires outbound access to *.clock-software.com on ports: 80, 443, 8443, 8883, 22. Clock does not provide IP ranges as they are subject to change at any moment.

The POS terminal should be supported by Adyen C library (cpos_lib_v1-3p7). Contact Adyen support center for a list of supported terminals.


4.1. Log in to your Adyen account and select your POS sub-account (click on the account name at the top of the page / if you don't have a POS sub-account, contact Adyen Support for its creation). Select Settings (left navigation sidebar)

4.2. Select the Users button

4.3. Locate the System User created for Web Services and POS and click on the user name to open it. If the user is not listed, try to show all users and check again. To show all users, select 'All' from the menu in the top right in the user table. Contact Adyen Support Team if you can't find the System User for Web Services.

4.4. You need to Copy/Paste the following information into Clock PMS (Settings - Adyen POS Terminal screen).
  • Merchant Account. Your account is shown at the top of the Adyen page. Typically, the account name is 'ABCCompanyPOS'.
  • User Name. The System User created for API usage (Web Service). Typically, the user name is like this "ws_xxxxxx@Company.ABC" and you need to only copy the part preceding the '@' symbol. In our example, this should be: ws_xxxxxx.
  • User Password. If you don't have the password. Click the 'Generate POS Password' button and copy the password.

Important Note: The Web Service user needs to have the following rights:
  • Merchant PAL Webservice role
  • Submit POS payments
If these rights aren't granted, please contact Adyen support.

4.5. Set Currency in Clock PMS.
  • Select the currency that is going to be used for the amounts sent to Adyen POS.

4.6. Add all POS terminals. For each specify :
  • Name - set a name of the terminal, so you can easily indenfy the device.
  • IP address - check the terminal manual for more infotmaiton about getting the IP address of the terminal.
  • Signature Autoconfirm. It defines whether you will be required to confirm the client signature for each transaction. Select the option you need.
    • If the setting is disabled, the signature will be displayed in Clock PMS and you will be required to confirm it after comparing it to the one on the card. If the signature is not confirmed, the transaction fails.
    • If the setting is enabled, the signature will be displayed in Clock PMS, but you will not be required to do anything. The system will confirm it automatically and the transaction will proceed.

4.7. Restart the POS terminal for the new settings to be uploaded.

Sign up for a free demo account now!
Want to know more?