To use the Adyen payments add-on for SAP Commerce, you need to install the add-on and configure it in your SAP back office and in the Adyen Customer Area.
Before you begin
Make sure that you have created a test account with Adyen. With this, you'll be able to access the test Customer Area, and apply for a live account. While you wait for your live account credentials, you can start integrating by using your test account.
Install the add-on
Adyen's payments add-on for SAP Commerce is open-source and available on GitHub. To install it:
- Download the latest version available on GitHub.
- Copy the files to: ${HYBRIS_BIN_DIR} > Custom > [YourHybrisInstallationFolder].
- Verify the folder and file permissions of the copied files.
-
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"/>
To configure the Adyen notification service, add:
<extension dir="${HYBRIS_BIN_DIR}/custom/adyen-hybris/adyenv6notification"/>
If you are using yacceleratorordermanagement (b2c_acc_oms recipe for 6.x and b2c_b2b_acc_oms for 1905), also add:
<extension dir="${HYBRIS_BIN_DIR}/custom/adyenv6ordermanagement"/>
If you are using yacceleratorfulfilment (b2c_acc recipe for 6.x and b2c_acc_plus_ for 1905), also add:
<extension dir="${HYBRIS_BIN_DIR}/custom/adyen-hybris/adyenv6fulfilmentprocess"/>
-
Modify the config/local.properties file:
- Append
,/[^/]+(/[^?]*)+(adyen-response)$,/adyen(/[^?]*)+$
to thecsrf.allowed.url.patterns
value. - Add
is3DS2allowed = true
.
- Append
-
Install the Adyen add-on into your existing storefront template:
cd bin/platform . ./setantenv.sh ant addoninstall -Daddonnames="adyenv6b2ccheckoutaddon" -DaddonStorefront.yacceleratorstorefront="yacceleratorstorefront" ant clean all
Configure the add-on
- Log in to your SAP back office
- Go to BaseStore > Adyen.
This opens a page with settings for the Adyen add-on. - Configure the settings by following the instructions below.
Account settings
Fill out the following fields:
Field name | Instruction |
---|---|
Merchant account name | The name of your Adyen merchant account for which the payments will be processed. You can find this in the upper-right corner of your Customer Area. |
Immediate capture flow |
This has to match the capture delay that you set in the Adyen Customer Area. If you set Capture Delay to manual, set Immediate capture flow to False. Otherwise, set Immediate capture flow to True. To set the capture delay in the Adyen Customer Area:
|
Allowed Credit Card Types |
Select which credit card types you want to allow in the checkout form. You also need to enable these credit card types in the Adyen Customer Area. |
Recurring contract type |
Select the type of recurring transactions that you want to enable. Possible values:
|
Adyen Test mode | Select True if you are using the Adyen test environment, and False if you are using the Adyen live environment. |
Enable Guest Checkout Tokenization | Select True if you want to enable tokenization of card payment details of guest users. Default is false. |
API settings
For authenticating API requests from your SAP back office, you need to set up an API key.
You first need to set up an API key in your Adyen Customer Area:
- Log in to your Customer Area.
- Go to Account > API credentials, and select the credential for your integration, for example ws@Company.[YourCompanyAccount].
- Under Authentication, select Generate New API Key.
- Copy and securely store the API key in your system — you won't be able to restore it later.
If your API key is lost or compromised, you need to generate a new one. - Select Save at the bottom of the page.
Then fill out the following fields in your SAP back office:
Field | Instruction |
---|---|
API Endpoint URL Prefix |
Enter the URL prefix [random]-[company name] from your Adyen live Customer Area > Account > API URLs. For more information, refer to Checkout endpoints. |
Web Service User API Key | The API key from your Adyen Customer Area. |
Client key settings
When using the plugin on versions 9.0.0 and above, you need to set up client key for client-side authentication. The client key is linked to your API credential and a list of domains from which we expect to get your client-side requests.
You first need to set up a client key in your Adyen Customer Area:
- Log in to your Customer Area.
- Go to Account > API credentials, and select the API credential for your integration, for example ws@Company.[YourCompanyAccount].
- Add your domains under Allowed origins. These are the domains from which you will be sending your client-side requests.
- Under Authentication, select Generate New Client Key.
- Select Save.
Then fill out the following field in your SAP back office:
Field | Instruction |
---|---|
Web Service User Client Key | The client key from your Adyen Customer Area. |
Additional data in API response settings
To process the response received from Adyen, you need to configure your merchant account to include additional data in the API response.
- Log in to your Customer Area with your merchant-level account.
- Go to Account > API URLs.
-
In the Additional data in API response section, select the following fields:
- Variant: Required. This provides the payment method in the response.
- Acquirer result: This provides additional information such as AuthCode and AvsResult.
- Cardholder name
- Card bin
- Card summary
- Expiry date
- 3D Secure result: This provides 3D Secure-related information.
- Fraud result: This provides fraud check results.
Server notification settings
To inform your SAP back office of payment status changes, Adyen uses notifications, sent as HTTP callbacks (webhooks) to endpoints on your server.
You first need to set up notifications in your Adyen Customer Area:
- Log in to your Adyen Customer Area.
- Go to Account > Server Communications.
- Next to Standard Notification, select Add.
- In the URL box, enter your website URL followed by:
adyenv6notification/adyen/v6/notification/[SiteId]/json
For example: https://your-website-URL/adyenv6notification/adyen/v6/notification/electronics/json - Select the Active check box.
- From the Method dropdown, select JSON.
- In the Authentication pane, enter a User Name and Password for notifications.
- Store these credentials securely in your system.
- Select Save Configuration.
Then fill out the following fields in your SAP back office:
Field | Instruction |
---|---|
Server Communication HTTP Basic username | The username for notifications from your Adyen Customer Area. |
Server Communication HTTP Basic password | The password for notifications from your Adyen Customer Area. |
Test notifications
To test whether notifications have been configured correctly:
- Log in to your Adyen Customer Area.
- Go to Account > Server Communications.
- Next to Standard Notification, select Edit & Test.
- In the Test Notifications pane, select Test Configuration.
- If the result is [Accepted], your notifications are working correctly.
Point of sale (POS) settings
To configure the add-on for in-person payments, fill out the following fields in your SAP back office:
Field name | Instruction |
---|---|
POS Merchant Account | The name of your Adyen merchant account for which the point of sale transactions will be processed. You can find this in the upper-right corner of your Customer Area. This can be the same merchant account that you added under Account settings. |
POS API Key | The API key associated with your merchant account for point of sale. For instructions on how to find this, refer to API settings. |
POS Store ID | The ID of your store for processing point of sale payments. To find this, log in to your Customer Area with your merchant account, and go to Point of sale > Stores. |
Recurring contract type |
If you want to save the payment details of an in-store shopper, you need to choose the type of recurring contract that you want to use:
|
To find the payment receipt for a point-of-sale transaction:
- Log in to your SAP back office.
- Go to the Orders section, and click on the transaction.
- Go to the PAYMENT AND DELIVERY tab, and select PaymentInfo.
This opens a new window containing the POS Receipt field.
Hosted payment pages settings
A skin is an interface overlay that is applied to the Adyen Hosted Payment Page (HPP) to create a seamless checkout experience for your shoppers.
First create a skin in the Adyen Customer Area:
- In the Adyen Customer Area go to Account > Skins.
- Select the New tab.
This opens a page with settings for the new skin. - In the Description box, enter a description for your skin.
- Select Generate new HMAC key for the Test platform.
- Copy this key and store it securely in your system.
- Leave the Result URLs and Continue-to URLs empty.
- Select Create New Skin on Test.
Then fill out the following fields in your SAP back office:
Field | Instruction |
---|---|
HPP skin code | The code of the skin that you want to use. You can find this in your Customer Area, under Account > Skins. |
HPP skin HMAC key | The HMAC key for the skin that you want to use. |
Apple Pay
To accept Apple Pay payments:
- Add Apple Pay in your Adyen Customer Area.
- Contact our Support Team, and provide the domain names and shop name that you want to use.
Apple Pay is only available in the Safari browser.
Boleto
To accept Boleto payments:
- In your SAP back office, go to the Advanced Settings section.
- Set Enable Boleto to True.
PayPal
To accept PayPal payments, you need to add your PayPal Merchant ID to your configuration:
- Follow the steps in Obtaining your PayPal Merchant ID
to find your PayPal Merchant ID. - In your SAP back office, go to the Advanced Settings section.
- In the PayPal Merchant ID field, enter your ID.