Setup Adyen for SCO

5. kesäkuuta 2025

On this page

1. Install the Installer app

More about Installer app installation can be found HERE. 

2. Configure Adyen microservice

More about Installer app installation can be found HERE.

  • From the Wizard, choose Hardware -> Installer App -> Micro-service Manager
  • From ADD NEW MICRO-SERVICE choose needed payment integration (if there is no integration that you need check it from UPDATE EXISTING MICRO-SERVICE)
  • Once payment integration is selected - press Continue
  • After that it'll display the micro-service configuration view. There is status “Not installed” on the red background.
  • Click on the Install latest (blue button)
  • The micro-service status is “Installed but stopped” on the yellow background
  • Click on the green Start button. Then Start button becomes Stop (yellow) and micro-service status is “Installed and running” on the green background.
  • Now the payment microservice is running and you can proceed with terminal configuration!

3. Configure Adyen terminal

More about Installer app installation can be found HERE.

  • In the Wizard naviagte to the Hardware -> Integrations and choose the category POS
  • Select a POS from the dropdown list
  • Click on the Payment Terminal
  • Press Continue
  • Under the Available integrations for POS level, choose needed payment integration
  • If the needed payment micro-service is not displayed there then select it from the “Add New Integration” list
  • Click Add
  • Then the payment terminal configuration view is opened.
  • Fill all the fields:
    • Terminal ID (check in Adyen portal ->In-person payments -> Terminals -> select terminal -> About this terminal)
    • Terminal Key Identifier (should be provided by Erply or Adyen)
    • Terminal Key Passphrase (should be provided by Erply or Adyen)
    • Terminal Key Version: 0
    • Terminal IP Address (check on the terminal: Settings -> terminal info)
    • Connection type: 
      1. Local - This is used to connect to a terminal that shares the same WiFi connection as the iOS device.
      2. Cloud - This is used to connect to a terminal that has been added in the Adyen Portal, fetching the terminal's IP from the cloud and establishing a connection to it.
      3. Local, Cloud - This serves as a backup connection. If a local connection is unavailable, it will attempt to connect to the terminal through the cloud.
      4. Cloud, Local - This also serves as a backup connection. If a cloud connection is unavailable, it will attempt to connect to the terminal through a local connection.
  • Press Save.

4. Configure payment integration in SCO configuration app

  • Naviagte to the Back Office -> Apps -> App store -> install the “Self-Checkout POS Settings” app.
  • In General tab naviagate to the “Additional information” section. 
  • Find the EFT field and enter “adyenms”.
  • Save configuration.

Adyen terminal is now ready to use with your Self-Service POS system. Go to the https://sco.erply.com/#/ and perform card payment with Adyen terminal.