The steps below will help you set up the Adyen Payment processing features. Please note that you need first to have the Adyen add-on enabled for your Clock PMS+ subscription and a LIVE Adyen Account. Being a payment processing institution, Adyen has security procedures for your account to pass before becoming live.


Company vs. Merchant accounts in Adyen

When working with Adyen, you will come across two elements that you need to differentiate:

- your Adyen 'Company' account

- your Adyen 'Merchant' account/s


Company account: that is the 'umbrella' and can contain several merchant accounts.

Merchant account: in the majority of cases, you will have at least 2 merchant accounts in Adyen: one that will process Online transactions - Ecommerce and MIT - and another one that will process POS transactions (transactions made on the physical card terminal supplied by Adyen). 


Note: If you are a multi-property business, you will have more merchant accounts - e.g. if you operate 2 hotels, you will have 4 merchant accounts (1 Ecommerce and 1 POS merchant account per property). 


It is important to differentiate those and know how to select a Company level or Merchant level as some of the configurations below are specific for the type of account.

Navigating between Company/Merchant accounts is done through the button on the top left corner of your Adyen account. Simply click on either the Company account or one of the Merchant accounts.

Important: When using Adyen terminals as well, you will have at least 2 merchant accounts - Ecommerce and POS

Please check and verify with your Adyen account manager or their support team that the following settings are enabled:

  • Store tokens on company account
  • allowModificationsOnSameCompanyAccount
  • rechargeDetailsOnCompanyAccount

Configuration

To start with the configurations, log in to your Clock PMS+ account. Select Settings -> All Settings -> Adyen v2 where you will be presented with the following screen:

  • API Key (1)

1. Login to your Adyen account and from the navigation bar on the left select Developers -> API Credentials and click on 'Create Credential'

2. Make sure that 'Webservice' is selected as 'User type' and enable the 'Roles' in the 'Roles' section, listed in the image below. If you do not see some of the roles, please contact the Adyen support team at support@adyen.com to grant them to the User. Once done, save the configuration.

3. Edit the newly created Webservice user and click on 'Generate new API key' button in the 'Authentication' section, copy the API Key and paste it in Clock PMS+.


  • Notification endpoint username; Notification endpoint password; Notification endpoint URL (2,3,4)

1. Copy the values that you see in those 3 fields.

2. Log in to your Adyen account. Make sure you are on a 'Merchant account' level.

3. Select 'Developers' from the left navigation sidebar. Click 'Webhooks' and on the next page, click '+Webhook' and add 'Standard Notification'

4. Paste the copied URL (from step 1) into the ‘URL' field 

5. Change ‘SSL Version' to 'TLS v1.2'

6. Tick the ‘Active' checkbox

7. ‘Service Version': 1

8. Change ‘Method' to 'JSON'

9. In the 'Authentication' section, enter the Username and Password from step 1.

10. Save Configuration


 

  • Merchant account code (5) - enter your Adyen ecommerce merchant account name.
  • Currency (6) -  Select the currency you operate with and in which amounts will be sent to Adyen.
  • Quick capture auth age - enter age of pre-authorizations (in days), for which a speculative approach to the payment posting will be applied. Default value is 7 days.

Example: 

- Any amounts pre-authorized up to 7 days in the past will be processed speculatively without waiting for a response (which may take an indefinite amount of time - minutes, hours, etc.).

  - For pre-authorized amounts older than 7 days, the current behavior, namely waiting for confirmation, is maintained.

In case you do not want to use the speculative mode of operation for both Capture pre-authorizations and direct payments, enter 0 for the value of the Quick capture auth age field. You will then need to wait for a response from the partner to complete all Capture operations.

  • Dropin enabled (7) - check THIS article for more details.
  • Dropin client key (8)  - check THIS article for more details. 
  • Live URL Prefix (9) - obtain the Prefix by following these steps:

1. Log in to your Adyen account and from the navigation bar on the left select Developers -> API URLs.

2Copy the prefix of the  URL. The prefix ends after your company name in the URL.

Example: if this was your live URL: 

https://1797a841fbb37ca7-AdyenDemo-checkout-live.adyenpayments.com/checkout/v53/payments

Then the live URL prefix would be: 1797a841fbb37ca7-AdyenDemo    

  • Live API endpoint location (10) - select based on your location.
  • Live (11) - select once all configurations for the interface are completed.

Finalizing configuration

The following settings are essential for the correct operation of the interface. Please make sure you complete them as described:

In Adyen:

1. Make sure you have selected your Ecommerce (COM) Adyen merchant account (Fig.1)

2. From the navigation bar on the left select Account -> Account Settings. In the field 'Capture Delay' select 'Manual'. Save.


In Clock PMS+

Once the above is completed, navigate to Clock PMS+ menu Settings->All Settings->Credit Card and select the following:

  • In the section Payment Service Provider, select Adyen from the dropdown menu (1).
  • Select if you will require guests to enter CSV code when entering card details (2).
  • Select if you require guests to enter their Address when entering card details (2).
  • Check the selections in section 'Accepted Credit Cards' and update them if needed (3).

Finally, you need to set your Guarantee options with the correct payment service.

  • Go to menu Settings->All Settings->Guarantee option
  • edit your guarantee options and select 'Credit Card tokenization/payment' as a payment service.


Usage

Web Reservation System

In order for guests to complete their booking on your website, they will need to provide credit card details and depending on the guarantee option settings, complete payment through Adyen to finalize their booking.


MyBooking Portal

Guests will be able to guarantee their booking or simply pay their bill through the MyBooking Portal.


Payment Autopilot

Tasks set in the Autopilot will be handled through Adyen.


Important: Successful transactions will automatically be posted to the folios.