To ensure your terminals continue to perform well and are using up-to-date settings and software, several events happen automatically on the terminals:
- Maintenance calls: every couple of hours, the terminal contacts our platform to check for configuration changes and software updates. The terminal doesn't implement or install anything yet (with a few exceptions).
- Rebooting: for security reasons, the terminal must clear its cache regularly. To achieve this, the terminal reboots once every 24 hours at the restart hour.
- Configuration changes: any configuration changes that the terminal discovered during a maintenance call, are implemented when the terminal reboots at the restart hour.
- Software updates: if the terminal is set to automatically update to new releases, any software update that the terminal discovered during a maintenance call is installed when the terminal reboots at the restart hour.
These events do not interfere with accepting payments or other daily operations. Below we explain the events in more detail, and describe what you need to do.
Maintenance calls
Every day, the terminal contacts our platform a few times to check for updates. We refer to this as maintenance calls. During a maintenance call, the terminal is informed of any changes in the configuration. For example, terminal settings that you configured in your Customer Area. If the terminal is set to automatically update to new releases, it is also informed of software updates that we have made available.
You won't notice when maintenance calls happen, because:
- On average a maintenance call takes only 1.8 seconds.
- Any changes and software updates are not installed yet, with a few exceptions.
- The terminal doesn't make maintenance calls while it is doing a payment or other operation.
Terminals are scheduled to make a maintenance call regularly; by default every three hours. We refer to this period as the maintenance interval. When the terminal is busy at the time it is scheduled to make a maintenance call, it waits for a minute and tries again, and so on until it has succeeded in making a maintenance call. When the terminal has succeeded in making a maintenance call, it waits until the next scheduled maintenance call.
Rebooting at the restart hour
Rebooting means the terminal is power cycled: it turns off and on again. Then the software restarts. This process takes about two minutes. Power cycling clears the terminal's cache, which is important for security reasons.
When the terminal reboots, it also installs any configuration change or software update that the terminal was informed of during a maintenance call. Installing the software can take up to 30 minutes.
To ensure the terminal's cache is cleared regularly and the terminal is updated, we have programmed the terminal to reboot once every 24 hours, at the so-called restart hour. By default, the restart hour is at 6:00 AM in the timezone of the terminal.
Set the restart hour
To ensure the terminal reboots during a period when the terminal is not in use, you can change the restart hour in your Customer Area. Considerations for changing the restart hour are:
- Your opening hours
- Operational events
For this task, you need to be the admin user.
To change the restart hour:
- Log in to your Customer Area.
- Optionally select the merchant account, store, or terminal that you want to set the restart hour for.
- Go to In-person payments > Terminal settings > Hardware.
- In the Maintenance section, select one of the Restart hour values.
- At the bottom of the page, select Save.
Configuration changes
Configuration changes can be terminal settings that you updated in your Customer Area or through API requests, but can also be platform-wide changes initiated by us. For example, an update to the contactless CVM limits. Configuration changes are implemented during the restart of the Adyen application, either when the terminal reboots at the restart hour, or when triggered manually.
Configuration update at restart hour
The terminal receives configuration changes when it makes a maintenance call. The terminal then implements the changes when the Adyen application restarts during reboot at the restart hour. There are a few exceptions:
- Changes initiated by us that must be applied as soon as possible. With these changes, we add an instruction to the terminal to restart after the maintenance call. Restarting takes about 30 seconds.
- Installing or uninstalling Android apps on Android terminals. The terminal carries out these changes immediately.
- Updating the configuration manually on the physical terminal.
Update the configuration manually
If you want configuration changes to take effect immediately, you can update the configuration manually:
- On the terminal, open the Admin menu.
- Select Config > Update.
The terminal retrieves the updated configuration and then restarts.
Automatic configuration update
You can enable a setting that restarts the Adyen application installed on the payment terminal as soon as the configuration is updated. This lets the terminal automatically apply the configuration update without restarting other applications you might have installed on the terminal. This can be useful for unattended terminals attached to a vending machine, token dispenser, parking payment systems, or similar.
To enable automatic configuration update:
-
Make a PATCH request to the
/terminalSettingsendpoint for the company account, merchant account, store or terminal.
In the request body, specify a terminalInstructions object with:Parameter Data type Description adyenAppRestart Boolean Indicates whether the Adyen app on the payment terminal restarts automatically when the configuration is updated. The response returns all terminal settings at the level where you made the request.
Software updates
By default, the Adyen software on the terminal is updated automatically. When there is a new release, the terminal learns about this during a maintenance call. When the terminal reboots at the restart hour, it downloads and installs the new software package.
We can also enable background downloading for you. Android terminals use this by default. With background downloading, the terminal downloads new software after the maintenance call. This reduces the chance that the software update fails because the internet connection is down at the reboot hour.
Apart from updating automatically, you can decide to participate in our beta program.
For more information about update strategies and the release cycle, see Update to a new release
What you need to do
It is important that:
- The terminal makes at least one maintenance call every day to receive information about any changes.
For this, the terminal must be turned on and have a network connection. - The terminal reboots every day.
To reboot automatically, the terminal needs to be turned on at the restart hour. To download updates when it reboots, the terminal also needs to have a network connection.
This means you must ensure that your terminal is turned on and connected to the network during at least one maintenance interval (three hours) before the restart hour (at 6:00 AM by default).
In practice, we recommend you keep your terminals turned on and connected to the network overnight.