Setting up Adyen microservice in the Wizard
In order to establish a connection between the PoS and Adyen terminal we need to install the microservice and configure the service to use the specific terminal.
Note: Before setting up the Adyen microservice in the Wizard make sure that you were created an Adyen account and Adyen device is registered there. If not please follow this article.
Visit Erply Wizard to install the microservice:
Navigate to the Hardware -> Installer App -> Microservice Manager.
Select “Adyen" from the dropdown.
Click Continue.
Click Install Latest
Once the microservice is installed, go to Hardware -> Integrations.
Select POS level and pick the POS you want to configure the terminal for.
Click on the Payment Terminal.
Click Continue.
Select Adyen as integration type, click Add
PS: if there is no “Adyen” in the list please check it below in the “Available Integrations for POS level” and click ‘select’ button
Once the integration was selected the Wizard will direct the user to the microservice configuration:
Fill out the following fields, with information provided by the terminal provider:
- “API Key” field according to your Adyen API key;
- “Terminal Key Identifier” field according to your Terminal Key identifier;
- “Terminal Key passphrase” field according to your Terminal key passphrase;
- “Terminal key version” field according to your Terminal key version;
- “Region” field according to your Region
- “Terminal ID” field according to your Terminal ID. Check the terminal’s information with the IP address:
- P400 (series) - press 5 and then OK [5->OK];
- S1F2L model - go to terminal Settings -> enter the password -> find Device info -> scroll o the IP address
- “Terminal IP Address” field according to your Terminal IP(note: this is optional - needed for Local connection);
- “Check the status of terminal before operation” field - this will perform diagnostic request before each financial request - this is recommended to be turned on;
- “Connection type” field according to your desired connection type - cloud is connecting to terminal via cloud - therefore no terminal IP needed, if you use local it will connect to terminal using local network. Cloud, local means that first it will try to connect via cloud and using local as backup connection;
- “Print receipt from POS general printer” - if you have terminal without printer or for some reason you don’t to print terminal receipts from terminal - use this setting to print Adyen receipts from general receipt printer.
Once everything has been configured click Save.
Setting up Adyen microservice in the POS
Navigate to the Brazil POS https://epos.erply.com/latest/ and login with your Erply credentials.
Then go the POS Settings -> Payment Configuration -> Setup Payment gateways
Select current integration: Adyen
Check the terminal information. Make sure that all required fields are filled!
If the terminal information corresponds to configuration from the Wizard click Save.
Please make a test sale in order to make sure that the terminal is properly configured and works with your POS system.
How to check additional information on the adyen terminal?
- To see the terminal’s information with the IP address, press 5 and then OK [5->OK].
- To see Payment menu, press 8 and then OK [8->OK].
- To access the terminal’s Administrative menu, press 9 and then OK [9->OK]. Enter PIN code and press OK to continue [code->OK].
- To access network, press 9 and then OK [9->OK]. Select Network and enter PIN code.
Frequently asked questions
I am unable to finalize the sale with Adyen integration. I got the followinf error in the POS payment window. What should I do?
“Terminal connection is not OK! Terminal conncetion error: diagnosis operation error: request, communication error: request error: raw request, server error: Unautorized. The request has not been applied because it lacks valid authentication credentials for the target resource.”
The error on the picture above is telling that Adyen API key is wrong or invalid.
The first thing you can do is to recheck provided you API key.
In case it still does not work and API key is the same as was provided, please contact ERPLY support.