This document describes the Adyen Hybris Extension that supports Hybris 6.x. With this extension you can accept cards and local payment methods, support recurring and modify your payments if needed. The extension is based on B2C accelerator of Hybris and can be added on yacceleratorstorefront(s).

GitHub download

  1. Download the beta code of the Adyen plug-in for hybris 6.x from GitHub develop branch.
  2. Upload the files and move it to the ${HYBRIS_BIN_DIR} > Custom > Your Hybris installation folder.
  3. Verify the folder and file permissions of the uploaded files.
  4. Add the Adyen extensions to the config/localextensions.xml file.

    <extension dir="${HYBRIS_BIN_DIR}/custom/adyenv6core"/>
    <extension dir="${HYBRIS_BIN_DIR}/custom/adyenv6b2ccheckoutaddon"/>
    <extension dir="${HYBRIS_BIN_DIR}/custom/adyenv6backoffice"/>

    Add the following if you are using yacceleratorordermanagement (b2c_acc_oms recipe):

    <extension dir="${HYBRIS_BIN_DIR}/custom/adyenv6ordermanagement"/>

    Add the following if you are using yacceleratorfulfilment (b2c_acc recipe):

    <extension dir="${HYBRIS_BIN_DIR}/custom/adyenv6fulfilmentprocess"/>
  5. Modify the config/local.properties file: append ,/[^/]+(/[^?]*)+(adyen-response)$,/adyen(/[^?]*)+$ to the value of csrf.allowed.url.patterns.

  6. Build the extension.

    ant addoninstall -Daddonnames="adyenv6b2ccheckoutaddon" -DaddonStorefront.yacceleratorstorefront="yacceleratorstorefront"
    ant clean all

Customer Area

Before configuring the settings, make sure that the Customer area setup is complete.  

  1. Go to the Customer Area and log in using your test account credentials.
  2. In the Main menu, click Account.
  3. Select the name of your Merchant account.

Configure notifications

  1. Go to Settings Server Communication. 
  2. Click Add next to Standard Notification.
  3. Under the Transport section:
    1. Enter your website URL followed by /adyen/v6/notification/json.
    2. Select the Active checkbox.
    3. Set Method to JSON.
  4. Under the Authentication section, enter the User Name and Password.
    Take a note of this information, as you will need it later on when configuring the Adyen plug-in.
  5. Click Save Configuration.

Configure merchant account settings

  1. Go to Settings Merchant Settings. 
    The default value for Capture Delay is Immediate, you may adjust it according to your preferences.
  2. Click Submit.

Configure web service (ws) user

  1. Go to Settings Users.
  2. From the first dropdown in the upper left table cell, select System.
  3. Click the ws user (ws@Company.YourCompanyCode).
    If you have not yet set a password for your ws user yet, you can do it by clicking Generate. 
    Take a note of the password as you will need it later on when configuring the Adyen plug-in.
  4. Click Save.

Configuring your LIVE account

  1. After your merchant account is enabled on the Adyen LIVE platform, log in to Customer Area using your live account credentials.
  2. In the main menu, click Account.
  3. Select your Merchant account. 
  4. Configure the notifications, merchant account settings, and ws user for live following the same steps as described above.

Adyen extension

Configure your credentials and preferences using Hybris backoffice through BaseStore > Adyen.

You should have the following:

Settings Value(s) Description
Merchant account name  

The merchant account identifier you want to process the transaction request with. You can find this info in the Customer Area > YourCompanyAccount > YourMerchantAccount.

Immediate capture flow True

Set to true if you have selected auto capture or a capture delay in Customer Area.

Set to false if you want to perform the capture of funds manually later (only affects credit cards and some alternative payment methods).

Server Communication HTTP Basic username  

Set your own username and copy it over to Customer Area> Settings > Server Communication > Standard Notification > User Name and Password.

Server Communication HTTP Basic password  

Set your own password and copy it over to Customer Area > Settings > Server Communication > Standard Notification > Password.


Copy and Paste the exact ws username here, example: ws@Company.YourCompanyCode.

  Click your web service user and generate a new password. Copy and Paste the exact password here.
API endpoint  

Set a custom API endpoint or use https://pal-test.adyen.com for Test environment. For live you can find your endpoint in the Customer Area > Settings > API URLs.

CSE token  

Find this in the Customer Area > Settings > Users > select System from the dropdown > ws user > Easy Encryption > Library token (not Public Key).

HPP skin code  

Copy and paste the skin code of the skin you want to use from Customer Area > Skins.

HPP skin HMAC key  

Copy and paste the skin code of the skin you want to use from Customer Area > Skins > select the Skin code > Edit > HMAC for Test platform.

HPP Test mode True Set to true for using Adyen Test Environments.
Allowed Credit Card Types  

Select which Credit Card Types you want to allow in the checkout form. These Credit Card Types must be enabled in the Customer Area.

Recurring contract type NONE

When enabled, the shoppers can save their Credit Cards and their SEPA authorizations. ONECLICK requires the input of the CVC for subsequent payments, while RECURRING does not.

ONECLICK: The shopper opts in to storing their card details for future use. The shopper is present for the subsequent transaction, for cards the security code (CVC/CVV) is required.

RECURRING: Payment details are stored for future use. For cards, the security code (CVC/CVV) is not required for subsequent payments.

ONECLICK,RECURRING: Payment details are stored for future use. This allows the use of the stored payment details regardless of whether the shopper is on your site or not.