What is Adyen?
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:
- How to download and install the Adyen plugin?
- What configuration do I need to complete in the terminal and on Adyen’s website?
- What settings need to be changed at the Customer Checkout?
How to download and install the Adyen plugin?
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:
https://github.com/adyenccotraining/adyenccoplugin
Additionally you have to download the certificates (*.pem files).
https://docs.adyen.com/point-of-sale/design-your-integration/choose-your-architecture/local#install-root-cert
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.
What configuration do I need to complete on the terminal and on Adyen’s website?
Next, you need to log in at https://www.adyen.com.
There you should add a new store. To do this, proceed as follows.
Adyen terminal settings (using the example of the AMS1):
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 Point of Sale/Terminals/(Select the according terminal)/Passcodes.
What settings need to be changed in the Customer Checkout?
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 |
mc=3;amex=1;visa=2;visa_applepay=2;maestro=5 –> Here, a number is assigned in the CCO to the different card types that can be used to pay at the Adyen terminal. –> Possible payment methods: https://docs.adyen.com/payment-methods |
| 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 |
AMS1-000000000000000 –> Serial number of the unit to be used if no selection is made or errors occur. It is determined which device is to be used as the default device. |
| ADYEN_FALLBACK_TERMINAL |
https://000.000.0.000 –> Specifies the IP address of the terminal to be used if no selection is made or errors occur. Specifies which device is to be used as the default device. |
| 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/Point of Sale/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.
Quickselection buttons:
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:
- “event” : { “eventName” : “ADY_ADD_STANDARD_TERMINAL_CHOICE”}
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:
- “event” : { “eventName” : “ADY_REMOVE_STANDARD_TERMINAL_CHOICE”}
Conclusion
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.
Original Article:
https://blogs.sap.com/2023/05/30/how-to-integrate-an-adyen-terminal-into-sap-customer-checkout/