Are you looking for test card numbers?

Would you like to contact support?

Point-of-sale icon

Deprecation of classic libraries

Why and when you will not be able to use POS libraries anymore.

A classic library integration for point of sale refers to a situation where an Adyen library is part of the cash register software. Over the years, we have noticed several disadvantages of such integrations. To overcome the disadvantages, we developed:

  • Adyen Terminal API as a replacement for the libraries.
  • New payment terminal software that interfaces with Terminal API.
    This new software is only available on terminals that have PCI approval.

Because of the advantages of Terminal API, we are deprecating the libraries. This means you need to migrate to a different type of integration. If you are currently using eVo terminals, you also need to update your terminal fleet because the PCI approval of eVo terminals is expiring.

Why you should switch to Terminal API

In a few years (see the time line), we will completely stop supporting classic libraries. You will no longer be able to make transactions through a classic library.

If you are currently using a classic library, you need to switch to Terminal API. Ultimately you will benefit from this switch because Terminal API has important advantages over classic libraries:

Aspect Classic libraries Terminal API
Implementation Requires a lot of setup and development work because the library needs to be part of the cash register software. Easy to implement and update because it has a request/response JSON messaging format instead of custom libraries, callbacks, and SDKs.
Access to updates Takes a long time because the cash register software is updated infrequently - in many cases only once a year. Quick and easy; not dependent on libraries.
Support Takes longer because not every POS Support Team member or Adyen implementation manager knows all the ins and out of every integration type. Better support, independent of the cash register software.
New features and fixes Cash registers run on different operating systems, each requiring a different library. This slows us down in development, testing, and maintenance. Libraries are currently in maintenance mode. Development of new features, testing, and maintenance are far more scalable for us. This means we can do more in less time.

Some examples of new features that are supported with Terminal API but not with libraries:

If your current integration uses the Xstore cash register system with the Java Native Interface (JNI) library, we offer OPI instead of Terminal API. OPI uses an XML request/response messaging format and has the same advantages as Terminal API.

Why you may need new payment terminals

If you are currently using payment terminals from the Verifone Verix range — known as eVo terminals — you need to update your terminal fleet. In a few years, we will no longer allow transactions with eVo terminals because:

  • The PCI security approval of eVo terminals is expiring.

    Most eVo terminals have PTS PCI 3 approval: They are compliant with version 3 of the PIN Transaction Security (PTS) requirements of the Payment Card Industry (PCI) Security Standards Council. The Council has determined that PTS PCI 3 expires on 30 April 2021 and that PTS PCI 3 devices must be retired by April 2023.
    Some eVo terminals have PTS PCI 4 approval, which expires in April 2023.

  • Verifone will stop delivering, supporting, and repairing eVo terminals.

To remain PCI compliant, you need to switch from eVo terminals to the Verifone Engage range — known as VOS terminals. VOS terminals have PTS PCI 5 approval and offer excellent alternatives to eVo:

Type eVo Verix terminals VOS Engage terminals
Countertop VX820, VX820 Duet P400 Plus or V400c Plus
Mobile e315, e355 e280 or e285p
Multimedia MX925 M400
Portable VX675, VX680, VX690 V400m, or V240m Plus for Brazil

Time line for the deprecation

Libraries - Affects entire Verifone eVo range of terminals

  • January 1, 2022: No new library integrations allowed.
  • 2022: POS partners must be ready for migration: They must have a Terminal API integration available, and are not allowed to onboard new merchants on a library.
  • March 29, 2024: End of support, transactions no longer allowed.

PCI 4 eVo terminals - e355 and VX690

  • March 31, 2021: No new orders possible, repairs only.
  • March 31, 2023: End of repair service.
  • April 2023: PTS PCI 4 expires.
  • March 29, 2024: End of support, transactions no longer allowed.

PCI 3 eVo terminals - e315, MX925, VX675, VX680, VX820, and VX820 Duet

  • January 1, 2020: No new orders possible, repairs only.
  • April 30, 2021: PCI 3 expires.
  • January 1, 2022: End of repair service.
  • January 1, 2023: End of support, transactions no longer allowed.

See also