Search

Are you looking for test card numbers?

Would you like to contact support?

Point-of-sale icon

Update to a new release

Learn about automatic updating, the beta program, and manual updating.

Interested in automatic updating?

Contact terminals@adyen.com to find out which update strategy you are following or to switch to automatic updating.

To ensure you benefit from new features, improvements, and fixes in the terminal software, you need to keep your terminals updated to the latest release. After rigorous testing we issue a new release every month.

To obtain these new releases, there are various update strategies you can use:

  • Update automatically: We push the new release to your terminals. This happens during the night in batches spread over a two-week period while we monitor the transaction performance. This is the default setting for new accounts.
  • Participate in the beta-4 program: This program lets you try out the likely new release with your particular integration on a few live terminals before your terminals are automatically updated.
  • Update manually: This strategy gives you time to test a new release yourself, but you need to contact our POS Support team every time you want to update terminals.

Release testing

Every release goes through rigorous testing:

  • Phase 1: Robot testing. We have over 20 robots performing test transactions in thousands of test cases with the supported terminal models in different integrations.
  • Phase 2: Manual checks. For example, we test upgrading and boarding, check all screens, and do many test and live transactions with various card types and card entry modes.
  • Phase 3: Beta testing. We push the new release to successive batches of terminals, including live terminals in various countries belonging to merchants who participate in the beta-4 program. This allows us to monitor the transaction performance and the communication with acquirers and issuers.

When all test phases are successful, we consider the release to be stable.

Automatic updating

Automatic updating is suitable for all integration types and for standalone terminals, regardless of the number of terminals or the terminal model.

After a release is tested and tagged stable, automatic updating pushes the new release to your terminals. This has many advantages:

  • The latest new features, improvements, and fixes.
  • Faster support: If you need help from POS Support, they can immediately start looking for solutions. The terminal is already on the latest release, so there is no time lost with trying out whether updating to the latest release solves the issue.
  • Compliance with the latest scheme regulations.
  • Less risk because the steps from one release to the next are small compared to a manual updating situation where releases are skipped.
  • Convenience: You don't have to do anything.
  • No worries about missing vital updates.

How it works

The POS Operations team divides your terminal fleet into three batches defined by you:

  • At the start of a work week, usually within a few days after publishing the release notes, we push the new stable release to the terminals in batch 1.
    Ideally, batch 1 terminals are not the busiest ones but do process enough volume for us to monitor the performance, and are at a location where there is a back-up of other terminals.
    Batch 1 consists of 10-20% of your terminal fleet. For example, one terminal of each model per country and all test terminals. Or if you have a smaller terminal fleet with for example one terminal per store, batch 1 could be terminals in locations close to your headquarters.
    Another option is to include only test terminals in batch 1. This gives you about a week to try out the release before we push it to your live terminals in the next batches.

  • A week later we push the release to the terminals in batch 2.
    Batch 2 consists of 20-30% of your terminal fleet. For example, one terminal in each store, or all terminals in a store that had a terminal in batch 1.

  • A week after batch 2, we push the release to the terminals in batch 3.
    Batch 3 consists of the remaining active terminals and all terminals that are currently not boarded.

We never push a new release on Friday or Saturday nights or in busy periods. When we do push a release, the terminal automatically installs the new software after rebooting at the restart hour. The restart hour is configured in your Customer Area, and is usually set to 4:00 AM.

To update successfully, the terminal needs to be connected to your network and turned on for at least one maintenance call interval (by default 180 minutes) before the restart hour. If the update fails, the terminal will run as before on the old software version. The POS Operations team will notice this, and schedule an update for the next night.

In case of unexpected issues we can pause the update process or roll back to a previous release at any time. When you are ready to follow automatic updates again, you can contact terminals@adyen.com.

Beta-4 program

We do several rounds of beta testing. In the fourth round of beta testing, we push a new software version to a few of your live terminals. This software version is likely to be the next new release, because it has already passed the robot tests, the manual tests, and the preceding beta tests.

The beta-4 program allows you to try out new features, improvements, and fixes in your specific situation while we monitor what happens. In this way you also limit the impact of any unexpected issues, because we will fix these before we start automatically updating your terminals.

If you want to participate in the beta-4 program, contact your account manager or contact terminals@adyen.com.

Manual updating

With manual updating you decide when you are ready to update terminals to a new release. To update terminals, you submit a request with our POS Support Team. This approach can be suitable for very specific integrations. Unlike terminals that are updated automatically, the POS Operations team does not actively monitor terminals that are updated manually.

To prevent terminals from running on software that's no longer supported, keep your terminals updated to one of the last three to five releases.

Possibly the only reason your terminals are on a manual updating strategy is that automatic updating wasn't available yet when you set up your account. In that case we recommend switching to automatic updating.

To find out which update strategy you are following or to switch to automatic updating, contact terminals@adyen.com. When switching to automatic updating, let us know the terminal IDs of the terminals you want in batches 1, 2, and 3.

See also