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 (To see the terminal’s information with the IP address, press 5 and then OK [5->OK].)
- “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.