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

To set up your Customer Area with Adyen, log in to your test Customer Area with your merchant-level account.

Configure notifications

  1. Go to Account 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 Account Settings. 
    The default value for Capture Delay is Immediate, you may adjust it according to your preferences.
  2. Click Submit.

Get the API key

To generate an API Key:

  1. Log in to your Customer Area.
  2. Go to Account > Users, and click the user ws@Company.[YourCompanyAccount].
  3. In the Authentication pane, click Generate New API Key.

    Don't forget to copy and securely store the API Key in your system. If you lose this API Key you won't be able to restore it later.

  4. Click Save at the bottom of the page.

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 > Account > Server Communication > Standard Notification > User Name.

Server Communication HTTP Basic password  

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


Copy and paste the API key from your Adyen Customer Area.

API Endpoint URL Prefix  

The URL prefix [random]-[company name] from your Adyen live Customer Area > API URLs and Response. For more information, refer to Checkout endpoints.

WS User Origin Key  

Go to Customer Area > Account > Users > select System from the dropdown > ws user. Then find Origin key, enter your URL, and click Generate Origin Key.

HPP skin code  

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

HPP skin HMAC key  

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

Adyen 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.