Skip to main content

Docebo Help

How can we help?

Transitioning from Adyen HPP to Adyen Web Drop-In

Last updated
Docebo module
  • Integrations
Reading time
User level
  • Administrators

Introduction

Adyen has scheduled the End of Life date for the Hosted Payment Pages (HPP) support on October 1, 2022. 

Docebo has developed the support for the new Adyen solution for online payments, called Web Drop-In, and made it available on your platform with the September monthly release, on September 28, 2022. 

You must reconfigure your Adyen integration in your platform as described in this article by October 1, 2022.

Activating Adyen Web Drop-In

In order to re-configure Adyen, log into your platform as the Superadmin, then access the Admin Menu from the gear icon in the top right corner and select the Manage option in the Payment Method - Adyen section. 

The Adyen configuration page is divided into two main sections: General HPP and General Web Drop-In. 

Transitioning_to_Adyen_Web_Drop-In.gif

  • In the General HPP section, the Enable Adyen - HPP payment gateway toggle is already enabled and the corresponding parameters are configured according to the current configuration. 
  • In the General Web Drop-In section, the Enable Adyen - Web Drop-In payment gateway toggle is disabled and the corresponding parameters are empty.

Start by disabling the Enable Adyen - HPP payment gateway toggle and enabling the Enable Adyen - Web Drop-In payment gateway toggle. Now, configure the parameters of the General Web Drop-In section as described in the following chapter. 

Configuring Adyen Web Drop-In

Once you have enabled the Enable Adyen - Web Drop-In payment gateway toggle, fill in the Merchant Account, HMAC Key, API Key, Client Key, and Environment options:

Merchant Account

This field must be filled in with the account name provided by Adyen during the registration procedure. The value of the Merchant account is the same value as the one already in use for the HPP solution, so you can copy it from the Merchant Account parameter in the General HPP section and paste it in this text area. 

You can also retrieve the Merchant Account value by connecting to your Adyen account, and clicking on your avatar in the top left corner of the page. The Merchant Account is displayed in the Related area.

Adyen_Merchant_Account.png

HMAC Key

In order to recover the HMAC key, connect to your Adyen account, and select the Developers -> Webhooks option in the left menu. Create a new webhook by clicking on + webhook in the top right corner. In the Create new webhook pop-up window, click Add in the Standard Notification row. 

Retrieving_the_HMAC_key_Part_1.gif

Move to the General section and edit the Server Configuration field by clicking on the pen icon at the end of the corresponding row, and set the URL value as follows:

https://myplatform.docebosaas.com/ecommerce/v1/adyen/notifications

but replacing myplatform.docebosaas.com with the URL of your platform. Click Apply to confirm and move to the Security section. Click on the pen icon at the end of the HMAC key and on Generate to generate it.

Retrieving_the_HMAC_key_Part_2.gif

Copy the HMAC key and paste it into the corresponding field of the Adyen configuration area in Docebo. 

API Key and Client Key

Both the API Key and the Client Key must be recreated in your Adyen account by selecting the Developers -> API Credentials option in the left menu. Click on Create new credentials in the top right corner, select the Web service user option and click on the Create credentials button.  You will access the Configure API credential page. 

In the Server settings -> Authentication area, click on Generate API key, copy the newly created key and paste it into the corresponding field of the Adyen configuration area in Docebo. 

Generating_the_API_Key.gif

Move now to the In the Client settings -> Authentication area, click on Generate client key, copy the newly created key and paste it into the corresponding field of the Adyen configuration area in Docebo.

Generating_the_Client_Key.gif

While in the Client settings -> Authentication area, add the URL of your platform in the Add allowed origins field and click on Add and on Save Changes at the bottom right corner of the page.

Adding_the_platform_URL.png

The configuration of Adyen Web Drop-In is over. Make sure you have turned off the Enable Adyen - HPP payment gateway toggle, and click on Save Changes in the Adyen configuration area.