Introduction
The Adyen payment gateway is an authorized payment method that can be used with the e-commerce features of your platform.
Prerequisites
The Ayden integration is available on the platform with the e-commerce pack. Contact your Docebo representative for information about how to obtain it.
- To configure this integration, you will need a valid merchant account on Ayden.
Requirements & Limitations
- Some currencies supported by Docebo may not be accepted by Adyen, so remember to check if your currency is supported by both systems before proceeding. Check out the complete list of the currencies supported by Docebo.
- When working with the Extended Enterprise, configure the settings of Adyen in the root domain. If some domains require a different configuration, apply the configuration locally, in the e-commerce tab of the Extended Enterprise app.
Configuring Adyen in the platform
In order to configure Adyen, log in to your platform as the Superadmin, then select Admin Menu > Payment Method - Adyen > Manage. In the Enablement section, enable the toggle Enable Adyen - Web drop-in payment gateway. This will reveal the configuration fields.
In the Adyen information section, fill in the configuration fields as described in the following chapters. When you have finished, click Save changes.
Merchant account
You can 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.
HMAC Key
To retrieve 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 + Create new webhook in the top right corner. In the Create new webhook pop-up window, click Add in the Standard webhooks row.
In the Webhook configuration page that opens, move to Server Configuration, 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.
Finally, move to the Security section and, under HMAC, select Generate a new key and click Generate. 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 created in your Adyen account by selecting the Developers > API Credentials option in the left menu. Click Create new credentials in the top right corner, select the Web service user option and click the Create credentials button. You will access the Configure API credential page.
In the Server settings > Authentication area, click Generate API key, copy the newly created key and paste it into the corresponding field of the Adyen configuration area in the platform.
Move now to the Client settings > Authentication area, click Generate client key, copy the newly created key and paste it into the corresponding field of the Adyen configuration area in the platform.
While in the Client settings > Authentication area, add the URL of your platform in the Add allowed origins field and click Add. Then click Save changes at the bottom of the page.
Environment
From the Environment drop-down list, select the geographical region in which you want to operate. Or select Test environment for operating in a sandbox.
- Your live endpoint region must match your Adyen client-side environment region (opens in a new tab). Get the region-specific URL from your Adyen live Customer Area (opens in a new tab) under Developers > API URLs > URLs & Regions.
In the Prefix field, enter the prefix which you obtain from your Adyen live Customer Area (opens in a new tab) under Developers > API URLs > Prefix.