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.
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 email@example.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.
- 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.
2. Copy the prefix of the URL. The prefix ends after your company name in the URL.
Example: if this was your live URL:
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.
The following settings are essential for the correct operation of the interface. Please make sure you complete them as described:
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.