CRM and CX Blogs by Members
Find insights on SAP customer relationship management and customer experience products in blog posts from community members. Post your own perspective today!
cancel
Showing results for 
Search instead for 
Did you mean: 
tilman_gosch
Explorer

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.

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.

 

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:

The list of terminals and the terminal settings in the Adyen backend can be found in the following section:

Adyen Backend .png

 

 

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


 

 

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:

 

 

KEYVALUES
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
API credentials.png
--> 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

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



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. The serial number from the Adyen backend must be entered, not the serial number that is printed on the device.

serialnumber.png

 

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.

connectivity.png

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.

 

 

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.

 

 

 

 

 

1 Comment