
Adyen is a technology developed by Adyen that unites all sales channels on one platform. It combines gateway, risk management and processing & acquiring in one place. Integration with the Adyen platform leads to a unified experience across all channels and therefore a single view of the customer.
Adyen wifi terminals can be selected independently of the individual POS. Different devices can be selected from one POS. In addition, each terminal can in turn be addressed by different POS.
A notable fact is that once an Adyen terminal has been purchased, there are no additional monthly fees or licences that need to be purchased.
The following blog post is intended to show you how to connect an Adyen terminal to SAP Customer Checkout (CCO) using the corresponding plugin. At the end of this training, the following questions should be answered:
To be able to use the Adyen system, you need to buy a suitable Adyen terminal. However, it is not necessary to purchase a licens. You can use the following link to contact Adyen:
https://www.adyen.com/contact/sales
To connect the SAP Customer Checkout with adyen you need to download the corresponding plugin. You can download the files here.
Additionally you have to download the certificates (*.pem files). They can be found here.
After downloading, place the files in the "AP" folder in the folder structure of the Customer Checkout, for example C:\SapCustomerCheckout\cco\POSPlugins\AP and restart the CCO.
Next, you need to log in at https://www.adyen.com.
There you should add a new store. To do this, proceed as follows.
The list of terminals and the terminal settings in the Adyen backend can be found in the following section:
Next, you need to adjust the settings on the terminal itself.
Settings --> Network --> enter password (this can be looked up online at adyen.com *) --> WiFi --> select WLAN and connect --> Click on the WLAN you are using --> scroll down --> click on extended --> scroll down further and note the IP address.
*You can view the password on the Adyen website under In-person payments, Terminals/(Select the according terminal)/Passcodes.
If you are using a different adyen terminal, you must go to the settings of the terminal and note the IP address, in a similar way.
Open the CCO configuration under Accounting/ CREDIT CARD TYPE.
Add Adyen and set visibility to "ON”. Set the visibility of the others cards to "OFF". Activate all cards that should be usable.
In the next step, you need to change the plugin configuration.
Below you will find explanations of the individual settings:
KEY | VALUES |
ADYEN_ACTIVATE_DYNAMIC_TERMINAL | true If "true" is selected, the Adyen terminal is not linked to a single POS. When paying by card at the checkout, you are asked which terminal should be selected. This means that different terminals can be selected from one cash register. Each terminal can in turn be used by different POS. |
ADYEN_ACTIVATE_UNREFERENCED_REFUNDS | false --> Prevents a refund from being made to a card that was not used to make the original payment. --> If "true" is selected, the function must be activated in consultations with Adyen. |
ADYEN_API_KEY | 0A00A000000000A00 --> Key to connect to the Adyen backend. --> This can be created at: Adyen.com, Developers, API credentials, Create new credential --> The authorization for the Terminal Management API must be enabled by Adyen. |
ADYEN_CARD_MAPPING |
--> The payment methods for the mapping can be found here. |
ADYEN_COMPANY_ACCOUNT | samplecompany--> Select Adyen company account |
ADYEN_CREATE_NEW_ABSTRACT _PAYMENT_ITEM | true --> If "false" is selected, after a failed card payment, the option remains to pay alternatively, for example, in cash. --> If "true" is selected, a new payment item of the type "card" is automatically added after a failed card payment. Consequently, payment must be made by card or the transaction must be cancelled. |
ADYEN_EXCLUDE_CARD_IDS | 1;1337;9234 --> IDs of cards to be excluded. |
ADYEN_FALLBACK_CARD | 3 --> Indicates what type of card payment the payment should be forwarded as to the CCOm or ERP system if the payment cannot be assigned. --> The corresponding codes can be set in the CCO: see slide 9. |
ADYEN_FALLBACK_SERIAL_NUMBER |
|
ADYEN_FALLBACK_TERMINAL |
|
ADYEN_IS_TEST_ENV | true --> Is set to "true" if it is a test environment. |
ADYEN_KEY_IDENTIFIER ADYEN_KEY_PASSPHRASE ADYEN_KEY_VERSION | IDENTIFIER PASSPHRASE 1 --> Adyen.com, In-person payments, Terminals, (Select the corresponding terminal)/Integration --> Click on Decrypted and enter the values in the plug-in settings. --> These must be equally set for all devices in a store. |
ADYEN_MERCHANT_ACCOUNT | sampleLtd_TEST --> Select the corresponding merchant account. |
ADYEN_PAYMENT_REFERENCE_ PATTERN | ${cco_prefix}-${receipt_id}-${transaction_amount}- ${transaction_currency}-${transaction_timestamp}- ${terminal_serial_number}-${terminal_display_label}- --> Here you can set the pattern in which the payment reference is to be specified. --> May be a maximum of 80 characters long. Any characters exceeding this will not be transferred. |
ADYEN_STORE_ID | SAPAAA01 --> The ID of the store where the terminal is located must be entered here. |
ADYEN_TERMINAL_CONNECTION_TIMEOUT ADYEN_TERMINAL_READ_TIMEOUT | 10000 60000 --> Determines after how many milliseconds a timeout occurs. |
After completing the settings, the Customer Checkout should be restarted.
Additionally you can add some buttons to the quickselection. There is a button to assign a default terminal to the CCO. Add a new quick selection button in CCO Manager. Next add the following code into the extended javascript field:
With another button you can remove the selection of the standard terminal again. For this you have to create a button again. This time add the following code into the extended javascript field:
With the information displayed above, you should be able to connect the Adyen terminal to the CCO in just a short time. As you can see, the integration is quick and uncomplicated.
You must be a registered user to add a comment. If you've already registered, sign in. Otherwise, register and sign in.