Release notes

Software updates for payment terminals and for Tap to Pay and card reader solutions.

You can find the release notes for the following categories:

  • Terminal software release notes for the following payment terminals:

    • Verifone Engage: e280m, e285p, e285, M400, P400 Plus, UX300, UX410, V210, V240m Plus, V400c Plus, V400m
    • Android: AMS1, M450, P530, S1E, S1E Barcode, S1E2L, S1F2, S1OF, S1U2

    For older payment terminals from the Verifone Verix (eVo terminals) and Verifone Engage ranges, see Legacy release notes.

    If you are on the manual update strategy, make sure that your terminals are updated to one of the latest three Long Term Support versions: v1.114, v1.100, or v1.105.

  • Android SDK on mobile release notes for the Android Tap to Pay and Card reader integrations.

  • iOS SDK on mobile release notes for the iOS Tap to Pay and Card reader integrations.

Get updates by RSS
Filter by
Category...
Type...
Version...
March 2025
SunMonTueWedThuFriSat
1
2345678
9101112131415
16171819202122
23242526272829
3031
Select dates
Copy url
icon
Terminal software v1.115
General
New
Android terminals
New
  • You will be able to restart the payment terminal from the menu Settings > Power.

Copy url
icon
iOS SDK on mobile v3.6.0

Support for this version expires on 6 September, 2025.

New
  • We introduced two new methods for accepting the Apple Terms and Conditions for Tap to Pay on iPhone. Previously, warmUp() prompted users to accept the Terms and Conditions. You can now call:
    • isAccountLinkedForTapToPay() to check if users still need to accept the Terms and Conditions.
    • linkAccountForTapToPay() to prompt the UI for accepting the Terms and Conditions.
Fixed
  • We fixed the issue where in some cases the SDK crashed during offline transactions.
  • We fixed the issue where the card reader connection would freeze if no delegate was set.
  • We fixed the issue where, in some cases, when using Tap to Pay on iPhone Screen Lock on iOS 18 devices, the transaction UI did not show the result after the device passcode was entered.
Breaking Changes
  • warmUp() does not trigger a prompt of the Terms and Conditions for Tap to Pay anymore. If your app relies on this behavior to have users accept the Terms and Conditions, please use linkAccountForTapToPay() instead.

Copy url
icon
Android SDK on mobile v2.1.0

Support for this version expires on 8 September, 2025.

Improved
  • Bluetooth firmware updates no longer appear when the card reader is connected through USB, ensuring that updates are only prompted when applicable.
Fixed
  • We resolved a race condition that could occur during authentication, ensuring a more reliable and consistent authentication process.

Copy url
icon
Terminal software v1.114

Long Term Support version.

Android terminals
Fixed
  • We fixed the issue where it was not possible to board S1U2 terminals using the ethernet connection.
  • We fixed the issue where the cellular modem rebooted every 20 minutes on S1F2 terminals with Android 9. This had caused a connectivity gap during which payments failed.
Improved
  • You can now accept NFC wallet payments on your Android app without having to switch to the Adyen UI.
General
New

Copy url
icon
iOS SDK on mobile v3.5.0

NYC1 PIN support for this version expires on 16 August, 2025.

Breaking Changes
  • This release updates the minimum required Xcode version to Xcode version 16. Xcode version 15 is no longer supported.
  • After you have made a NYC1 transaction with SDK version 3.5.0 and later, the card reader will no longer work with older SDK versions.
  • To add SDK version 3.5.0 and later, you now need to create an API credential in your Customer Area.
New
  • The placement of the PIN entry UI is now randomized to enhance security and comply with PCI requirements.
  • You can now call resetSession() to reset the security check for NYC1 with PIN.
Fixed
  • We fixed the issue where in some cases the prompt to accept Apple's Terms of Use cancelled a transaction.
  • We fixed the issue on iOS 17 devices where in some cases Tap to Pay PIN transactions were cancelled when using Tap to Pay iPhone Screen Lock.
Known issues
  • When using Tap to Pay on iPhone Screen Lock on iOS 18 devices, the transaction UI might not show the result after the device passcode was entered.

Copy url
icon
Android SDK on mobile v2.0.0

Support for this version expires on 10 August, 2025.

Breaking Changes
  • The SDK is now compiled with Kotlin 2.1.0. When updating to SDK v2.0.0, you need to upgrade your project to Kotlin 2.1.0. It is possible that you also need to update other libraries like Dagger or Hilt for compatibility with Kotlin 2.1.0.

  • Payment interface changes:

    • PaymentInterfaceType.CardReader() changed to PaymentInterfaceType.createCardReaderType().
    • PaymentInterfaceType.TapToPay() changed to PaymentInterfaceType.createTapToPayType().
  • Package changes:

    • The package for DeviceManagementActivity changed from com.adyen.ipp.cardreader.bluetooth.ui to com.adyen.ipp.cardreader.api.ui.
    • The package for AuthenticationProvider, AuthenticationResponse, and MerchantAuthenticationService changed from com.adyen.ipp.authentication to com.adyen.ipp.api.authentication.
    • The package for InPersonPayments and InPersonPaymentsInitializer changed from com.adyen.ipp to com.adyen.ipp.api.

      If you use manual app initialization, you need to update your Android Manifest with the new package for InPersonPaymentsInitializer. Otherwise the app may still work, but incorrectly.

    • The package for PaymentInterface, PaymentInterfaceType, and TransactionRequest changed from com.adyen.ipp.payment to com.adyen.ipp.api.payment.
    • The package for MerchantUiParameters changed from com.adyen.ipp.payment.ui.model to com.adyen.ipp.api.ui.
  • New factory methods to use instead of calling a constructor:

    • AuthenticationResponse has a new factory method create(String). Use this method instead of calling the constructor.

    • CardReaderUiParameters has a new factory method create. Use this method instead of calling the constructor. Example usage:

      val position = Simplified.Position.Center
      val params = CardReaderUiParameters.create(CardReaderAnimationType.simplified(position))
    • TapToPayUiParameters has a new factory method create. Use this method instead of calling the constructor. Example usage:

      val position = TapToPayAnimationType.front(NfcFrontPosition.TopCenter)
      val params = TapToPayUiParameters.create(position)
  • TransactionRequestReversal.create(String) changed to TransactionRequest.createReversal(String).

New
  • When initiating an unreferenced refund, the simplified transaction screen now shows Refund. This helps your staff and customers distinguish this type of refund from a payment.
Improved
  • For Tap to Pay transactions, card reads are now faster.
  • The size of the SDK has been reduced.

Copy url
icon
Terminal software v1.113
General
New
Fixed
  • We fixed the issue where in some cases payments with Interac cards failed.
Android terminals
Fixed
  • We fixed the issue that reset the card selection when activating accessibility on the present card screen.
New
  • When an auto-launch application crashes on payment terminals that are in kiosk mode, the app will now relaunch automatically.
Known issues
  • The cellular modem reboots every 20 minutes on S1F2 terminals with Android 9, which causes the terminal to be without cellular connectivity for up to two minutes. Payments made during this connectivity gap fail.

Copy url
icon
iOS SDK on mobile v3.4.0

NYC1 PIN support for this version expires on 12 July, 2025.

Fixed
  • We fixed the issue that in some cases caused transactions running on the iOS simulator to temporarily fail.
Known issues
  • NYC1 PIN transactions can fail when they are performed on the same NYC1 device using different versions of the SDK. The transactions succeed when the session is reset. This issue affects all versions that have PIN functionality.

Copy url
icon
Android SDK on mobile v1.6.0

Support for this version expires on 7 July, 2025.

Changed
  • The package for MerchantAuthenticationService is now com.adyen.ipp.api.authentication.MerchantAuthenticationService.
  • The following classes have been deprecated from the com.adyen.ipp package and are now included in the com.adyen.ipp.api package:
    • InPersonPayments
    • InPersonPaymentsInitializer
    • InPersonPaymentsTools
    • PaymentCallback
    • PaymentResultContract
  • The function InPersonPayments.performReversal has been simplified and now only takes a TransactionRequestReversal as an argument and directly returns a Result<PaymentResult>.
  • The placement of the PIN entry UI is now randomized to enhance security and comply with PCI requirements.
  • To improve the authentication process, the SDK now efficiently invokes the implementation of MerchantAuthenticationService only when needed, and runs seamlessly in the background.
Fixed
  • We fixed the issue where the SDK crashed when the LogsObserver could not be found error occured.
Known issues
  • The transaction screen on the NYC1 sometimes freezes when the card reader uses a fallback for the card entry method. This happens, for example, when the shopper taps their card too quickly to be read several times in a row and the SDK falls back to only allowing inserting or swiping the card. The transaction can still be cancelled or will time out as normal, but the screen remains frozen.

Copy url
icon
iOS SDK on mobile v3.3.2

NYC1 PIN support for this version expires on 28 June, 2025.

Fixed
  • We fixed the issue where NYC1 Store and Forward transactions failed after updating the SDK from version 3.2.0 to version 3.3.0 or later.
  • We fixed the issue where in some cases the SDK reported failed NYC1 firmware updates as successful. You now receive an error message when the firmware is not the expected version after an update.

Copy url
icon
Terminal software v1.112
Android terminals
Fixed
  • We fixed the issue where installer notifications on the terminal did not align with the selected display notification settings in the Customer Area.
Known issues
  • The cellular modem reboots every 20 minutes on S1F2 terminals with Android 9, which causes the terminal to be without cellular connectivity for up to two minutes. Payments made during this connectivity gap fail.
OPI integration
New
  • When surcharge applies for Simphony transactions in New Zealand and Australia, the OPI response now returns the surcharge amount in the fieldCCSurchargeAmount.
  • It is now possible to perform referenced refunds on Oracle Opera transactions in Brazil and Mexico. Contact our Support Team to enable this feature.
General
New
  • The instrument selection screen that replaces the present card screen is now generally available. It was previously only available in pilot mode.

Copy url
icon
Android SDK on mobile v1.5.1

Support for this version expires on 15 June, 2025.

New
  • It is now possible to use the PIN screen in landscape mode.
Changed
  • We upgraded the Android Gradle plugin to version 8.7.2.
  • The SDK now compiles targeting Android 15 (SDK 35).
  • We improved the error message for newly issued payment cards that require chip entry for activation. Previously, the message only indicated that the transaction was cancelled.
  • We further improved the device management UI, which informs you that Bluetooth firmware updates require a Bluetooth connection
  • Hardware features are now explicitly declared as not required in the AndroidManifest.xml.
Fixed
  • We fixed the issue where tablets were forced into portrait orientation for T2P transactions.
  • We fixed the issue where transactions were cancelled on rotation.
  • We fixed the issue where the arrow size was incorrect for NYC1 simplified UI.
  • We fixed the issue were the wallet icons were missing on the NYC1 present card screen.

Copy url
icon
Terminal software v1.111
General
New
  • It is now possible to specify payment cards, for which the shopper can bypass the PIN entry on the terminal screen.
Fixed
  • We fixed the issue where the payment terminal did not automatically select Interac on co-badged cards in Canada. Instead, the terminal had asked the shopper to select a payment method.
Engage terminals
Known issues
  • MIFARE Classic card payments fail and return the error Read EMV chip failed.
Android terminals
Known issues
  • The cellular modem reboots every 20 minutes on S1F2 terminals with Android 9, which causes the terminal to be without cellular connectivity for up to two minutes. Payments made during this connectivity gap fail.

Copy url
icon
iOS SDK on mobile v3.3.1

NYC1 PIN support for this version expires on 25 May, 2025.

Fixed
  • We fixed the issue where in some cases the UI for the instructions to reset the reader didn't render correctly.

Copy url
icon
Android SDK on mobile v1.4.0

Support for this version expires on 14 May, 2025.

New
  • We added a public methods to initiate a diagnosis request:
    • registerForDiagnosisResult(caller: ActivityResultCaller, callback: DiagnosisCallback): ActivityResultLauncher<Intent>
    • performDiagnosis(context: Context, diagnosisLauncher: ActivityResultLauncher<Intent>, diagnosisRequest: DiagnosisRequest)
Changed
  • The device management UI now informs you that Bluetooth firmware updates require a Bluetooth connection.
  • Deprecated DeviceManager.firmwareUpdateSummary() in favour of DeviceManager.firmwareUpdateStatus(): Result<FirmwareUpdateStatus>, return type is now a sealed interface of the combinations of possible scenarios.
Fixed
  • We fixed the issue where in some cases consecutive Tap to Pay transactions failed.
  • We fixed the issue where slow the SDK initialization failed on slow mobile devices.
  • We fixed the issue where ClassNotFoundException occurred when calling deviceManager.startFirmwareUpdate().
  • We fixed the issue where exiting the PIN screen due to security measures showed the message Transaction canceled instead of Internal Error.

Copy url
icon
Terminal software v1.110
Android terminals
Fixed
  • We fixed the issue where the result of a barcode scan did not output uppercase spelling when it should.
Known issues
  • The cellular modem reboots every 20 minutes on S1F2 terminals with Android 9, which causes the terminal to be without cellular connectivity for up to two minutes. Payments made during this connectivity gap fail.

Copy url
icon
iOS SDK on mobile v3.3.0

NYC1 PIN support for this version expires on 28 Apr, 2025.

New
Fixed
  • We fixed the issue where in some cases a transaction was unexpectedly cancelled.

Copy url
icon
Android SDK on mobile v1.3.0

This SDK version expires on 12 Apr, 2025.

Breaking Changes
  • We fixed the issue where DeviceManager crashed when SDK was not initialized.
  • We fixed the issue where a transaction was cancelled when the card was presented a second time during PIN entry.
New
  • You can now use InPersonPayments.initialised to check if the SDK was initialized.
  • We added TapToPayUiParameters and CardReaderUiParameters to allow you to offer different UI options for the present card screen for tap to pay and card reader.
Improved
  • The SDK was compiled with jvm target 8. It means that JDK 17 is not required anymore to build the project.

Copy url
icon
Terminal software v1.109

Long Term Support version.

General
New
  • You can now enable Adyen's Auto Rescue mechanism to automatically retry failed store-and-forward payments to increase authorization rates.
  • When a shopper presents a co-badged card, they can select the new Card option button on the terminal screen to select their preferred payment method.
Fixed
  • v1.109.8
    We fixed the issue where in some cases it was not possible to cancel Pay-at-table transactions.
  • v1.109.10
    We fixed the issue where, when using Oracle Opera, a pre-auth transaction failed when it was followed by the transaction type Sales Complete.
  • v1.109.10
    We fixed the issue where MOTO could not be disabled.
  • v1.109.10
    We fixed the issue where it was impossible to make a recurring MOTO CVC payment.
  • v1.109.10
    We fixed the issue where in some cases loyalty card payments were processed as regular payments.
  • v1.109.11
    We fixed the issue where in some cases transactions with Interac cards failed. In the payments overview page, these failed payments were listed as Unknown card with refusal reason Declined offline.
  • v1.109.12
    We fixed the issue where the payment terminal did not automatically select Interac on co-badged cards in Canada. Instead the terminal asked the shopper to select a payment method.
Engage terminals
New
  • Shoppers can now perform all gift card actions on standalone payment terminals.
  • For Mifare Ultralight AES cards, you can now specify the ultralightAESKeyId in the NFCData field to access different parts of the card's data.
Fixed
  • v1.109.8
    We fixed the issue where updating the terminal firmware software from the terminal menu did not work.
Android terminals
New
  • On Android terminals with a built-in barcode scanner, like S1E2L, you can now specify a prefix to be added to the scanned barcode content.
  • When you press the barcode scanner button on Android terminals with a built-in barcode scanner, the barcode content can now be sent as simulated keyboard events.
  • You can now upload logos and videos to show on the screen of the SFO1 payment terminal during steps of the shopper interaction.
  • You can now customize virtual receipts on the SFO1 payment terminal.
Fixed
  • v1.109.7
    We fixed the issue where the user interface elements of some merchant apps were not rendering correctly.
  • v1.109.8
    We fixed the issue where the result of a barcode scan did not output uppercase spelling when it should.
  • v1.109.12
    We fixed the issue where S1F2 payment terminals with a third-party SIM card in the second SIM slot requested network connection with the incorrect Access Point Name (APN).
  • v1.109.12
    We fixed the issue where the cellular modem rebooted every 20 minutes on S1F2 terminals with Android 9, which caused the terminal to be without cellular connectivity for up to two minutes. Payments made during this connectivity gap failed.
  • v1.109.12
    We fixed the issue where in some cases contactless Girocard transactions failed on S1E, S1E2L, S1F2L, and S1U2 payment terminals.
  • v1.109.12
    We fixed the issue where on AMS1 payment terminals the Scan QR button disappears from the instrument selection screen when the co-badged cards compliance feature was turned on. This occurred on terminals that had their language set to German, Italian, or French.
Known issues
  • The cellular modem reboots every 20 minutes on S1F2 terminals with Android 9, which causes the terminal to be without cellular connectivity for up to two minutes. Payments made during this connectivity gap fail.

Copy url
icon
Android SDK on mobile v1.2.0

This SDK version expires on 25 Mar, 2025.

New
Fixed
  • We fixed the issue where the SDK crashed during auto resolve of the authentication service phase.
  • We fixed the issue where the SDK crashed on the Device Manager screen if permissions were revoked.
  • We fixed the issue where the PIN entry field was upside down.
  • We fixed the issue where in some cases the screen rotation was not working as expected.

Copy url
icon
iOS SDK on mobile v3.2.0

NYC1 PIN support for this version expires on 25 Mar, 2025

Breaking Changes
New
  • You can now use Store and Forward to continue accepting mobile payments using a card reader when your integration is offline.
  • You can now use PIN for card reader payments.
  • Your device now must have a screen lock passcode configured to make card reader payments. Refer to our Troubleshooting guide for possible errors related to security requirements.
  • You can now make card acquisitions for magstripe payments with non-ISO custom cards.
Improved

Copy url
icon
Terminal software v1.108
Engage terminals
New
  • You can now reassign payment terminals from one store to another using the same one-time boarding password.
  • We added the option to reassign a payment terminal to another store from the Settings menu of the terminal under Configuration > Reassign device.
Android terminals
New
  • You can now check the Access Point Name (APN) in the terminal menu settings under Network > Cellular.
Fixed
  • We fixed the issue where the tipping screen showed the predefined tipping options as the percentage as well as the amount.
Known issues
  • This version is not stable for Android payment terminals. The user interface elements of some merchant apps are not rendering correctly.
  • The cellular modem reboots every 20 minutes on S1F2 terminals with Android 9, which causes the terminal to be without cellular connectivity for up to two minutes. Payments made during this connectivity gap fail.
General
New
  • In Japan, the payment response now includes installments information. Before, installments information were only included in additionalData.
  • You can now configure the Adyen Giving feature in your Customer Area under Giving > Campaigns to use a single tap or double tap flow. Shoppers can now choose to donate a fixed amount or to round-up the amount of their original purchase.
  • We introduced a new instrument selection screen to adhere to co-badged cards compliance in pilot mode. When this feature is enabled, it replaces the present card screen.
Fixed
  • We fixed the issue where Store and Forward transactions that were created on a software version lower than version 1.103 could not be processed after updating to a later software version. The stored transactions were discarded after 2 months.

Copy url
icon
Android SDK on mobile v1.1.1

This SDK version expires on 22 Feb, 2025.

Fixed
  • We fixed the issue on devices that run Android 13, where the SDK crashed when you cancelled a transaction and then started a new transaction.

Copy url
icon
Android SDK on mobile v1.1.0

This SDK version expires on 22 Feb, 2025.

New
  • You can now use a method to evaluate whether it can be beneficial to skip the re-execution of code, for example the initialization of your dependency graph or analytics libraries.
  • To use the vibration feature, the SDK now requests the permission android.permission.VIBRATE.
Improved
  • We have improved the Tap to Pay transaction speed.
Changed
  • We have disabled the default card detection sound on your mobile device during Tap to Pay transactions.
  • We have updated the androidx.lifecycle to version 2.8.2.
Known issues
  • On devices that run Android 13 might cause the SDK to crash, when you cancel a transaction and then start a new transaction.

Copy url
icon
Terminal software v1.107
Android terminals
New
  • You can now reassign payment terminals from one store to another using the same one-time boarding password.
  • We added the option to reassign a payment terminal to another store from the Settings menu of the terminal under Configuration > Reassign device.
  • When using accessibility mode, Android payment terminals now provide audio feedback about how many PIN digits have been entered.
Fixed
  • We fixed the issue where a diagnostics call to an Android terminal did not return the correct IP address of the terminal.
  • We fixed the issue where there was no endMaintenance event notification to inform about a finished maintenance call on S1U2 and S1F2L payment terminals.
Deprecated
  • The Support for S1E and S1EL payment terminals ends with this software version. If you need help selecting alternative terminal models, contact your Adyen Account Manager.
Known issues
  • The tipping screen shows the predefined tipping options as the percentage as well as the amount. This issue will addressed in the upcoming version.
Engage terminals
New
  • In Estonia, you can now accept the shoppers' national ID cards as a loyalty card on non-Android payment terminals.
Terminal API integration
New
  • v1.107.7
    To stay compliant with Greek tax regulations, we have enabled an integration with licensed e-invoicing systems that connect to the Greek Ministry of Finance.
OPI integration
New
  • v1.107.7
    To stay compliant with Greek tax regulation, we have enabled an integration with licensed e-invoicing systems that connect to the Greek Ministry of Finance.
General
Known issues
  • Store and Forward transactions that were created on a software version lower than version 1.103 cannot be processed when updating to a later software version. The stored transactions will be discarded after 2 months.
Fixed
  • We fixed the issue where Adyen Giving donations could not be captured after the donation were processed.

Copy url
icon
Terminal software v1.106
General
New
Known issues
  • Store and Forward transactions that were created on a software version lower than version 1.103 cannot be processed when updating to a later software version. The stored transactions will be discarded after 2 months.
  • Adyen Giving donations cannot be captured after processing the donation.
Android terminals
New
  • In Estonia, you can now use Android payment terminals to accept the national ID cards of the shoppers as loyalty cards.
Improved
  • When using terminals in Kiosk mode, the lock task mode that hides the Android navigation bar is no longer enabled by default.

Copy url
icon
Android SDK on mobile v1.0.0

This SDK version expires on 31 Jan, 2025.

New
  • When the app goes to the background while a transaction is in progress, the transaction is canceled.
  • We implemented an internal architectural change to ensure that the Android POS mobile SDK runs on a separate process.
  • We improved the security of the solution in several ways, in view of the Mobile Payments on COTS (MPOC) certification of our solution. There is nothing you need to do, and you will not notice any differences.
  • The SDK is now minified using R8.
Fixed
  • Using an incorrect timestamp format no longer causes the application to crash.
  • We fixed issues with Tap to Pay on Android where sometimes the amount didn't show and reading the payment card failed.
  • We fixed a problem where the Installation ID refreshed unexpectedly.

Copy url
icon
Terminal software v1.105

Long Term Support version.

General
New
  • When pre-authorizing a payment, you can now configure your terminal to automatically block specific types of payment cards, for example prepaid cards.
Fixed
  • v1.105.10
    We fixed the issue where recurring payments failed when using MKE as the entry method.
  • v1.105.10
    We fixed the issue where in Japan VISA cards not issued in Japan showed on the payment terminal screen as payment options.
  • v1.105.11
    We fixed the issue where Store and Forward transactions that were created on a software version lower than version 1.103 could not be processed after updating to a later software version. The stored transactions were discarded after 2 months.
  • v1.105.12
    When putting cards in the penalty box, we fixed the issue where the incorrect card AID was banned.
Android terminals
Fixed
  • We fixed the issue where S1E2L and AMS1 payment terminals got stuck in a boot loop when their battery charge level was 5 percent or lower.
  • v1.105.8
    We fixed the issue where Android payment terminals got stuck on the start-up screen when failing to update to a later software version.
  • v1.105.8
    We fixed the issue where the buttons on the terminal screen used to select a credit or debit card option showed incorrect text.
  • v1.105.10
    We fixed the issue where in some cases the time to start up a payment terminal took longer than expected after a configuration update.
New
OPI integration
Fixed
  • v1.105.8
    We fixed the issue where refunding or cancelling certain OPI transactions failed when they included manual key entry, tipping, or tax-free shopping flows.
  • v1.105.10
    We fixed the issue where funds were not received from the shopper’s payment card when the transaction was initiated by OPI Retail or Oracle Simphony and the receipt was in Chinese language. This also caused the payment terminal to crash.
Engage terminals
Fixed
  • v1.105.8
    On P400 Plus payment terminal, we fixed the issue where the touchscreen was not responding when trying to tip.
  • v1.105.8
    We fixed the issue where the terminal screen turned off when a payment request was sent.
  • v1.105.9
    We fixed the issue where users could access the Transactions menu without a passcode.

Copy url
icon
Android SDK on mobile v0.9.1
Breaking Changes
  • We have renamed AuthenticationService to MerchantAuthenticationService.
  • We have removed InPersonPayments.initialize(application = application). The Adyen POS Mobile SDK now initializes automatically, using the Android App Startup library. You no longer need to call InPersonPayments.initialize(application = application) to:
  • PaymentCallback declaration will now return the PaymentResult wrapped in a Kotlin Result class Result<PaymentResult>.
  • Most InPersonPayments methods now return kotlin.Result.
  • InPersonPayments.performTransaction has been changed:
    • we removed param authenticationServiceClass.
    • merchantUiParameters is now required and no longer optional.
  • To handle a refund you now have to:
    • Register a listener for the PaymentResult and pass the refundResult to your POS app.
    • Use the new method to invoke InPersonPayments.performReversal().
New
  • The Adyen POS Mobile SDK now initializes automatically, using the Android App Startup library. It is possible to disable the automatic initialization.
  • The Amount field on payment screens is now localized to the device Locale. For example, the decimal separator used in the Amount field on the payment screen adapts automatically based on your location.
  • You can now show a logo on the Tap to Pay screen.
  • The Card reading animation is now located at the bottom of the Tap to Pay payment screen.
Fixed
  • We fixed the issue where Google Pixel phones that run the latest Android 14 software update showed a black screen after initiating a Tap to Pay payment.
  • The Adyen POS Mobile SDK now works for Android Work Profile users.

Copy url
icon
Terminal software v1.104
General
New
  • When boarding with a one-time password, the payment terminal now tries to download the configuration for a limited amount of time. After the set limit, the terminal stops making call to Adyen and prompts your user to press Retry on the terminal screen.
Known issues
  • Store and Forward transactions that were created on a software version lower than version 1.103 cannot be processed when updating to a later software version. The stored transactions will be discarded after 2 months.
OPI integration
New
  • For Pay at table, in your Customer Area you can now select either the Table number or Check number to retrieve the customer's bill on the payment terminal screens.
Known issues
  • Refunding or cancelling OPI transactions might fail when they include manual key entry, tipping, or tax-free shopping flows.
Android terminals
Known issues
  • S1E2L and AMS1 payment terminals get stuck in a boot loop when their battery charge level is five percent or lower.
Engage terminals
Fixed
  • We fixed the issue where the transaction data could be accessed from the terminal menu without entering the Transactions passcode. You can manage your passcodes in the Customer Area or by using API calls.

Copy url
icon
Terminal software v1.103
General
New
  • You can now exclude products and charges from the total amount that are not eligible for tipping. The terminal screen then shows the amount that the shopper can choose to tip on separately from the total amount.
Known issues
  • Store and Forward transactions that were created on a software version lower than version 1.103 cannot be processed when updating to a later software version. The stored transactions will be discarded after 2 months.
Android terminals
Fixed
  • In the terminal settings menu, we have fixed the issue where toggling DHCP on and off removed all previously stored IP addresses.
New
  • From the menu of S1U2 and S1E2L payment terminals, you can now manage the performance of your Android apps. You can, for example, force quit an unresponsive app, or clear the cache and storage of an app.
Known issues
  • S1E2L and AMS1 payment terminals get stuck in a boot loop when their battery charge level is five percent or lower.
OPI integration
Known issues
  • Refunding or cancelling OPI transactions might fail when they include manual key entry, tipping, or tax-free shopping flows.

Copy url
icon
Android SDK on mobile v0.8.0
New
  • We added android:allowBackup="false" to the AndroidManifest.xml to prevent the creation of an automated data backup. For security reasons, we recommend that you not override this setting.
Fixed
  • We fixed the issue where in some cases AdyenCardReaders.deviceManager.activeDeviceInfo returned DeviceInfo class members that were incorrectly marked as not for public use.
Known issues

Copy url
icon
Terminal software v1.102
General
Removed
  • We have removed classic libraries. If you need support, contact your Adyen Account Manager.
New
  • You can now make a request to the /terminals endpoint to get the restartLocalTime which is when your payment terminals are set to reboot during the restart hour.
Android terminals
Improved
  • On Android terminals that have a built-in barcode scanner, like S1E2L, you can now specify the type of separator for the scanned barcode content. You can pass the content of each scanned barcode in a new line, or specify the character to use a separator.
New
  • For Mail Order/Telephone Order (MOTO) payments it is no longer possible to skip providing the shopper's information such as the postal code.
Known issues
  • S1E2L and AMS1 payment terminals get stuck in a boot loop when their battery charge level is five percent or lower.

Copy url
icon
Terminal software v1.101
General
Changed
Deprecated
  • Support for classic library integration ends with this software version. If you are still using the classic library integration, we recommend that you use the LTS version 1.100. If you need support, contact your Adyen Account Manager.
Android terminals
Known issues
  • The signatures of the receipts of transactions are only partially visible on the Payment details page in your Customer Area. In some cases, the receipt of a transaction is missing.
  • S1E2L and AMS1 payment terminals get stuck in a boot loop when their battery charge level is five percent or lower.

Copy url
icon
Android SDK on mobile v0.7.5
Removed
  • In DeviceManager, we removed:
    • INSTANCE.
    • checkAvailableFirmwareUpdates(deviceInfo: DeviceInfo). Use firmwareUpdateSummary() instead.
    • startAllFirmwareUpdates(). Use startFirmwareUpdate() instead.
    • getPairedDevices(). Use getKnownDevices() instead.
Known issues
  • In some cases, AdyenCardReaders.deviceManager.activeDeviceInfo returns DeviceInfo class members that are incorrectly marked as not for public use. Add @SuppressLint("RestrictedApi") to your code to suppress this warning message.

Copy url
icon
Terminal software v1.100

Long Term Support version.

General
Fixed
  • v1.100.7
    We fixed the issue where the gift card load reversal failed, when the load request was completed on a different terminal.
Known issues
  • This version supports an outdated format of the feature that lets you override the existing tipping options by specifying them in the payment request. A new format will be introduced in an upcoming release.
Android terminals
Fixed
  • v1.100.10
    We fixed the issue where Android terminal failed to start the payments app properly after reboot.
  • v1.100.8
    We fixed the issue where terminals got stuck after being reassigned during the boarding process.
  • v1.100.7
    We fixed the issue where in some cases the payment terminal made multiple authorisation calls on a single transaction and blocked the shopper’s card.
  • v1.100.7
    We fixed the issue where the customer signature was only partially visible on the Payment details page in your Customer Area.
  • v1.100.7
    We fixed the issue where in some cases the transaction receipt was missing on the Payment details page in your Customer Area.
  • v1.100.7
    We fixed the issue where the button to view the last known Totals report was missing from the payment terminal menu after the Totals were reset at the reset hour.
Known issues
  • S1E2L and AMS1 payment terminals get stuck in a boot loop when their battery charge level is five percent or lower.
Engage terminals
Fixed
  • v1.100.10
    We fixed the issue where the terminal screen turned off when a payment request is sent.
  • v1.100.7
    We fixed the issue where in some cases the payment terminal randomly showed a black screen.
  • v1.100.7
    We fixed the issue where, after using a standalone merchant reference and canceling the transaction on the amount input screen, the same reference was used automatically for the next transaction.

Copy url
icon
Android SDK on mobile v0.6.1
Deprecated
  • In DeviceManager, we removed startAllFirmwareUpdates(). To implement the available card reader firmware updates, use startFirmwareUpdate() instead.
New
  • In DeviceManager, we added startFimwareUpdate() to implement the available card reader firmware updates. This replaces startAllFirmwareUpdates().
Improved
  • We made some improvements to the performance and stability of the SDK.
  • We enabled edge-to-edge mode for multiple activities. This mode allows your application’s content to extend to the full screen, utilizing the entire display area without any additional padding or margins.
  • We enabled immersive mode, which allows you to hide the navigation bar on the payment screen.
Fixed
  • On Android 14, we fixed the issue where the SDK stopped working when an unsupported card was presented.
  • We fixed the issue where the UI froze when closing an error message.
  • We fixed the issue where in some cases cancelled Tap to Pay transactions were incorrectly approved.
  • We fixed the issue where you could not go back to the previous screen while pairing a card reader.
  • We fixed the issue where, when trying to close an error message, the UI froze.
  • When starting a NYC1 transaction too fast, we now show a more informative error message: "Check if no card is inserted and try again". Previously, we showed "internal error".

Copy url
icon
Terminal software v1.99

To update your payment terminals to this version, contact our Support Team.

Android terminals
New
  • On Android terminals that have a built-in barcode scanner, you can now activate the barcode scanner by pressing the side button. A successful scan enters the content of the barcode directly into the input box in your app.
Known issues
  • The signatures of the receipts of transactions are only partially visible on the Payment details page in your Customer Area. In some cases, the receipt of a transaction is missing.
  • S1E2L and AMS1 payment terminals get stuck in a boot loop when their battery charge level is five percent or lower.

Copy url
icon
Terminal software v1.97

This version is no longer stable. To use feature from this version, update to v1.99.

General
New
Android terminals
Known issues
  • The receipts of transactions on the Payment details page in your Customer Area have no signature. In some cases, the receipt of a transaction is missing.
  • S1E2L and AMS1 payment terminals get stuck in a boot loop when their battery charge level is five percent or lower.

Copy url
icon
Terminal software v1.96

To update your payment terminals to this version, contact our Support Team. Your terminals should not be more than five versions behind the latest release.

Terminal API integration
New
  • In Japan, when a transaction fails, the payment terminal now presents the shoppers with an instruction on how to resolve the failed transaction.
Android terminals
Fixed
  • We fixed the issue where the printed receipt showed “NULL” in the receipt header when you did not populate Header line 1 and Header line 2 under Customer Area > Terminal Settings > Receipts.
  • We fixed the issue where contactless EFTPOS transactions fail on AMS1 payment terminals if PIN entry is required.
Known issues
  • The function button on the back of the S1U2, which is needed to access the device settings, is unresponsive.
  • The receipts of transactions on the Payment details page in your Customer Area have no signature. In some cases, the receipt of a transaction is missing.
  • S1E2L and AMS1 payment terminals get stuck in a boot loop when their battery charge level is five percent or lower.
General
Known issues
  • For contact payments surcharges are not applied which means that the surcharge fee is not transferred to the shopper.

Copy url
icon
iOS SDK on mobile v2.1.2
Deprecated
  • firmwareupdateavailable has been deprecated. If you built your own custom UI for device management, use the new firmwareUpdateSummary variable to check if there are firmware updates available for the card reader.

  • The AydenPOSError types bluetoothFirmwareUpdateError, firmwareDownloadError, and firmwareUpdateError(message: ) have been deprecated. If you built your own custom UI for device management, use the new public error type AdyenPOSError.firmwareError(reason: ) instead.

New
  • When checking for available firmware updates for the card reader, the built-in device management UI now indicates if a Bluetooth connection is required for the update, and shows the date by which transactions will be refused if the card reader is not updated to this firmware version.

    If you built your own custom UI, use the new public variable firmwareUpdateSummary to check for any available firmware updates.

    See Manage card reader firmware.

  • We added a new public error type AdyenPOSError.firmwareError(reason: ) to provide information about errors that occurred with the firmware management of the card reader.

Fixed
  • We fixed issues with performing firmware updates on iOS version 17.0.x.

Copy url
icon
Android SDK on mobile v0.5.0
Deprecated

If you implemented a custom UI for device management, note that in the DeviceManager, the checkAvailableFirmwareUpdates() method and the classes DeviceUpdate and DeviceUpdateType are deprecated. Use the new method firmwareUpdateSummary(): Result<AvailableFirmwareUpdate> instead.

New

See Manage card reader firmware:

  • When checking for available firmware updates for the card reader, we check the date by which transactions will be refused if the card reader is not updated to this firmware version.

    If you created a custom UI for device management, use the new method firmwareUpdateSummary(): Result<AvailableFirmwareUpdate> to implement this in your UI.

  • During firmware updates, we check if an update failed because the card reader was connected through USB and the update required a Bluetooth connection.

    If you created a custom UI for device management, check startAllFirmwareUpdates() for the new UpdateRequiresBluetooth error state.

Breaking Changes

For the card reader solution, you should now use the same package dependencies in your build.gradle file as for the Tap to Pay solution:

releaseImplementation 'com.adyen.ipp:pos-mobile-release:$version'
debugImplementation 'com.adyen.ipp:pos-mobile-debug:$version'
Known issues
  • On Android 14, the SDK stops working when an unsupported card is presented.

  • When pairing a card reader, going back to the previous screen doesn't work.

  • To use minification (isMinifyEnabled/minifyEndabled) in your application, you have to add the following lines to proguard-rules.pro:
    -keep class kotlinx.parcelize.** { * ;}
    -keep class org.slf4j.impl.StaticMDCBinder { *; }

Fixed
  • We fixed an issue where setting targetSdkVersion to 34 in your app caused the Device Management screens to crash on Android 14 devices.

  • The feature to configure how long the success screen should be shown, works as expected again.


Copy url
icon
Terminal software v1.95

Your terminals should not be more than five versions behind the latest release.

General
New
  • In the US, all payment terminals can now accept EMV Quick Chip transactions. This allows shoppers to insert and remove their EMV chip cards at checkout while the scanning of the goods is still in process.
Known issues
  • When updating to this version, the terminal files migration can get interrupted by another process. The payment terminal then shows a Transaction interrupted error message. On unattended payment terminals the Cancel button must be pressed to close this message.
Engage terminals
Improved
  • You no longer have to contact Support to update UX300 and UX410 payment terminals to the latest software version.
Known issues
  • UX400 payment terminals refuse transactions after updating to software version 1.95.5.
Android terminals
New
Known issues
  • The receipts of transactions on the Payment details page in your Customer Area have no signature. In some cases, the receipt of a transaction is missing.
  • S1E2L payment terminals get stuck in a boot loop when their battery charge level is five percent or lower.
Fixed
  • We fixed the issue where the timestamp on items in the transaction history shows UTC time instead of the actual time.

Copy url
icon
Android SDK on mobile v0.4.2
Breaking Changes

Make sure that you use the correct release package: -debug versions of the SDK can only access the Test environment, and -release versions can only access the Live environment.

New
  • We implemented completion retry logic: if the authorization succeeded but the capture didn't, we retry capturing the payment later.

  • We added a firmware updates feature. With this first iteration of the feature, you can use the following Device Manager functions:

    • checkAvailableFirmwareUpdates(): checks if the card reader manufacturer released new firmware updates.
    • startAllFirmwareUpdates(): implements the available card reader firmware updates.
  • If a card is left inside the card reader, the reader beeps four times and no new transactions are possible until the card is removed.

  • We implemented sounds for Tap to Pay transactions.

Improved
  • We now show more informative messages in the UI when a transaction is declined. For example, "Card not supported" instead of just "Declined".

  • We improved the transaction speed, and implemented some general improvements of the payment flow.

Fixed
  • Tap to Pay transactions on devices using an armv7 based processor are now supported, on both the debug version and the release version of the SDK.

  • We removed the ACCESS_BACKGROUND_LOCATION permission. If you previously added extra lines about this permission to your AndroidManifest.xml as described for v.0.3.1, you can now remove those lines.

  • We removed the QUERY_ALL_PACKAGES permission.

Known issues
  • To use minification (isMinifyEnabled/minifyEndabled) in your application, you have to add the following lines to proguard-rules.pro:
    -keep class kotlinx.parcelize.** { * ;}
    -keep class org.slf4j.impl.StaticMDCBinder { *; }

  • The feature to configure how long the success screen should be shown, doesn't work as expected.


Copy url
icon
Terminal software v1.94

To update UX300 and UX410 payment terminals to this version, contact our Support Team. Your terminals should not be more than five versions behind the latest release.

General
New
  • In a local integration, you can now configure terminals to notify you when their IP address changes. The terminal sends a webhook to the endpoint that you choose with the ID and the new IP address of the terminal.
  • You can now use a one-time password (OTP) to get the unique ID of a terminal to assign it to the correct store.
Fixed
  • v1.94.10
    We have fixed the issue where transactions continued to be processed as Store and Forward payments even after the payment terminal had re-connected to the network.
Known issues
  • When updating to this version, the terminal files migration can get interrupted by another process. The payment terminal then shows a Transaction interrupted error message. On unattended payment terminals the Cancel button must be pressed to close this message.
Engage terminals
New
  • When pre-authorising a payment, you can now configure your terminals to automatically detect if a payment method does not support authorization adjustment. The terminal then presents the customer with an option to choose a payment method that supports authorization adjustment.
Fixed

We have fixed the issue where UX300 terminals lost network connection after the nightly reboot.

Terminal API integration
New
  • You can now split a landscape display of a payment terminal, such as the M400, to show two display requests.
Android terminals
New
  • You can now use a kiosk mode on payment terminals to:
    • Make an Android app that you uploaded to Adyen the default app on the terminal.
    • Hide the Android navigation buttons from the home screen.
    • Hide the Settings and Transactions menus buttons from the home screen.
Known issues
  • The receipts of transactions on the Payment details page in your Customer Area have no signature. In some cases, the receipt of a transaction is missing.
  • The timestamp on items in the transaction history is two hours ahead of the actual time.
  • The printed receipt shows “NULL” in the receipt header when you do not populate Header line 1 and Header line 2 under Customer Area > Terminal Settings > Receipts.
  • S1F2 payment terminals lose connection to the Wi-Fi network after a software update, or after an update of the logo on the terminal screen.
  • S1E2L payment terminals get stuck in a boot loop when their battery charge level is five percent or lower.

Copy url
icon
Android SDK on mobile v0.3.1
New
  • We now support live Tap to Pay on Android transactions.
  • In DeviceManager we added getKnownDevices(). This replaces getPairedDevices.
  • For the NYC1 card reader, we now show the Bluetooth version in the details screen, and in HardwareSoftwareInfo (in activeDeviceInfo in DeviceManager).
Improved
  • When updating the NYC1 card reader: if both a system update and a firmware update are available, selecting Update firmware implements both updates.
  • We made some improvements to the Tap to Pay payment flow.
  • Error messages about network issues during a transaction are now clearer.
Deprecated

In DeviceManager:

  • We removed connect(discoveredDevice: DiscoveredDevice).
  • We deprecated getPairedDevices. Use getKnownDevices() instead.
Known issues
  • To use minification (isMinifyEnabled/minifyEndabled) in your application, you have to add the following lines to proguard-rules.pro:
    -keep class org.json.** {*;}
    -keep class kotlinx.coroutines.** {*;}

  • If you do not use android.permission.ACCESS_BACKGROUND_LOCATION for your application, you must add the following lines to your AndroidManifest.xml file:

    <uses-permission
          android:name=\"android.permission.ACCESS_BACKGROUND_LOCATION\"
          tools:node=\"remove\" />  
  • The release version of the SDK is not able to perform Tap to Pay transactions on devices using an armv7 based processor.


Copy url
icon
Terminal software v1.93

To update UX300 and UX410 payment terminals to this version, contact our Support Team. Your terminals should not be more than five versions behind the latest release.

General
New
  • When collecting shopper input on a terminal, you can now mask the input data on the terminal screen.
  • You can now use a third-party SIM card in addition to the pre-installed Adyen SIM card in AMS1, S1U2, S1F2L, and S1EL2 payment terminals.
Improved
  • When applying surcharges:
    • We enabled rounding up the payment amount up to three decimals instead of two.
    • The payment response now includes the surcharge amount in the TotalFeesAmount field.
Known issues
  • EMV offline transactions get discarded after three days without internet connection.
  • The payment terminal’s approved screen shows longer than expected.
  • Transactions continue to be processed as Store and Forward payments even after the payment terminal has re-connected to the network.
  • When updating to this version, the terminal files migration can get interrupted by another process. The payment terminal then shows a Transaction interrupted error message. On unattended payment terminals the Cancel button must be pressed to close this message.
Engage terminals
Improved
  • You will now get notified when Anti-removal switches (ARS) are triggered on UX300 and UX400 payment terminals.
Removed
  • We no longer support managed engagement.
Android terminals
Known issues
  • Merchant app installation fails on S1E and S1EL payment terminals.
  • S1F2 payment terminals lose connection to the Wi-Fi network after a software update, or after an update of the logo on the terminal screen.
  • We fixed the issue where the timestamp on items in the transaction history shows UTC time instead of the actual time.

Copy url
icon
iOS SDK on mobile v2.0.1
New
Improved
  • The NYC1 card reader will play a warning sound if the card is left in the reader after the transaction is completed.
  • Bluetooth disconnection of the NYC1 card reader is now handled gracefully.
  • Transactions are cancelled when the POS app is pushed to the background, the screen is locked, or the POS app is closed during the transaction.
  • To prevent errors when a customer takes too long to tap a card, the Tap to Pay user interface is autmatically closed after 100 seconds.
Deprecated
  • AdyenPOSError.paymentInterfaceNotSupported is deprecated.
Fixed
  • For the NYC1 card reader, the charging indicator and battery capacity values are now refreshed every time the Device management screen is opened.
  • If the transaction is cancelled quickly, we no longer show the Apple interface for Tap to Pay.
  • The camera on an iPad now rotates correctly in landscape mode when connecting to an NYC1 card reader.
  • In certain edge cases where an error occurs after the transaction is approved, we no longer show an error screen.

Copy url
icon
Android SDK on mobile v0.3.0
New
  • We now support Tap to Pay on Android.
  • Using a new merchantUiParameters parameter, you can set an autoDismissDelay to determine how long to show the screen that indicates the transaction succeeded.
Known issues
  • The release build is not able to perform Tap to Pay transactions on devices using an armv7 based processor.

Copy url
icon
Android SDK on mobile v0.2.4
Breaking Changes
  • The minimum required SDK version (minSdkVersion) has changed from 29 to 30.
New
  • The SDK checks if the mobile device meets the minimum requirements for Android version and security patch.
  • We implemented a retry mechanism to reconnect to the NYC1 card reader if the Bluetooth connection fails.
  • You can now use the InPersonPayments.version field to see the version of the SDK.
Improved
  • We removed the NFC feature requirement from the Manifest.
Fixed
  • We fixed an issue related to canceling a transaction.

Copy url
icon
Terminal software v1.91

To update UX300 and UX410 payment terminals to this version, contact our Support Team. Terminals should not be more than five versions behind the latest release. Terminals should not be more than five versions behind the latest release.

Terminal API integration
Improved
  • If there is a communication or technical issue, you can now get the ServiceID of the in-progress payment or card acquisition request. You can then use that ServiceID to cancel that in-progress request.
Android terminals
New
  • We now support accepting payment surcharges on Android payment terminals.
Known issues
  • The timestamp on items in the transaction history show UTC time instead of the actual time.
Fixed
  • We fixed the issue where the first transaction after the installation of a merchant app failed.
  • We fixed the issue where contact chip transactions were declined when using surcharge.
  • v1.91.18
    We fixed the issue where you could not update or retrieve Wi-Fi or SIM card information for S1F2 and S1F2L payment terminals.
  • v1.91.20
    We fixed the issue where S1F2 payment terminals lost connection to the Wi-Fi network after a software update, or after an update of the logo on the terminal screen.
Engage terminals
Fixed
  • We fixed the issue on UX300 payment terminals where the screen showed an error message instead of the result of card acquisition.
  • v1.91.18
    We fixed an issue that slowed down the performance of the terminals.
General
Fixed
  • We fixed the issue where transactions were declined when using magnetic stripe on eftpos cards.
  • v1.91.18
    We fixed the issue where offline Store and Forward transactions were rejected after three days without internet connection.
  • v1.91.20
    We fixed the issue where transactions were still processed as Store and Forward payments even after the payment terminal had re-connected to the network.
  • v1.91.20
    We fixed the issue where EMV offline transactions were discarded after three days without internet connection.
  • v1.91.20
    We fixed the issue where transactions canceled before presenting the card were showing in the Customer Area under Payments.
  • v1.91.20
    We fixed the issue where in some scenarios the payment terminal’s approved screen showed longer than expected.
  • v1.91.21
    We fixed the issue where the terminal files migration could get interrupted by another process when updating to this version. The payment terminal then showed a Transaction interrupted error message. On unattended payment terminals, the Cancel button had to be pressed to close this message.
  • v1.91.21
    We fixed the issue where, in some cases, a transaction could not be canceled by pressing Cancel on the terminal screen.

Copy url
icon
Android SDK on mobile v0.2.3
New
  • For security issues that end users can easily fix themselves, we now show instructions on how to proceed. For example, if the mobile device is on an unsecured network, an instruction appears to connect to a secured Wi-Fi network and try again.
Improved
  • We improved the error handling when there are issues with Bluetooth permissions.
Fixed
  • We fixed an issue with canceling a transaction while the mobile device was still connected to the NYC1 card reader.

Copy url
icon
Terminal software v1.90

To update UX300 and UX410 payment terminals to this version, contact our Support Team. Terminals should not be more than five versions behind the latest release.

General
Fixed
  • We fixed the issue where certain Visa payment cards in Canada and the US were rejected because they were identified as SVS gift cards.
Engage terminals
Improved
  • Starting with this version, all payment terminals are automatically upgraded to the new menu structure.
Fixed
  • We fixed the issue on UX410 payment terminals where using contactless magstripe cards failed the card acquisition and stopped the terminal from transacting until the next reboot.

  • We fixed the issue where the totals fail to reset when you log out of your terminal.

Known issues
  • This version is not available for V400m terminals.

  • Payment terminals updating from v1.75 will first update to v1.86 before updating to the later versions.

Android terminals
Removed
  • You can no longer include HTML tags in the body of input requests.
Known issues
  • This version is not available for AMS1, S1F2, and S1F2L terminals.

  • You cannot update or retrieve Wi-Fi or SIM card information for S1F2 and S1F2L payment terminals.

  • Contact chip transactions are declined when using surcharge.


Copy url
icon
iOS SDK on mobile v2.0.0
Breaking Changes
  • The minimum required iOS version has changed to 16.4.
  • We removed the deprecated Transaction type alias.
Improved
  • We improved the speed and reliability of Tap to Pay on iPhone transactions.
  • Error messages for Tap to Pay on iPhone are now clearer.
  • When a card reader is unpaired in the system settings of the mobile device, the card reader no longer automatically reconnects.
New
  • We made a sample app POSSampleApp available.
  • The SDK supports referenced refunds (reversals).

Copy url
icon
Terminal software v1.89

To update UX300 and UX410 payment terminals to this version, contact our Support Team. Terminals should not be more than five versions behind the latest release.

Terminal API integration
New
  • You can now split the screen of a landscape payment terminal to show an input and a display request at the same time.
Engage terminals
Fixed
  • The screen of the e285p payment terminal no longer keeps turning on and off when connected to Wi-Fi.
  • We fixed the issue of Pay at table button not showing on the screen of payment terminals that use the old menu structure.
Removed
  • You can no longer include HTML tags in the body of input requests.
Known issues
  • Payment terminals updating from v1.75 and earlier versions will first update to v1.86 before updating to this version.
  • This version is not available for V400m and payment terminals that are on a manual update strategy.
Android terminals
Fixed
  • We fixed the issue where canceling the payment request during PIN entry made the payment terminal unresponsive.
Known issues
  • Contact chip transactions are declined when using surcharge.
General
Known issues
  • In Canada and the US, certain Visa payment cards are rejected because they are identified as SVS gift cards.

Copy url
icon
Terminal software v1.88

To update UX300 and UX410 payment terminals to this version, contact our Support Team. Terminals should not be more than five versions behind the latest release.

Terminal API integration
Fixed
  • We fixed the issue where HTML tags showed on the terminal screen during display requests.
  • We fixed the issue where the payment terminal was not able to send the current status of the ongoing Adyen Giving transaction.
OPI integration
Fixed
  • We fixed the issue where HTML tags showed on the terminal screen during display requests.
Engage terminals
Known issues
  • When connected to Wi-Fi, the screen of e285p payment terminal keeps turning on and off.
  • The Pay at table button does not show on the screen of payment terminals that use the old menu structure.
    If you are using Pay at table, with either Terminal API or OPI integration, consider enabling the new menu structure or updating to v1.89.
Android terminals
Known issues
  • Canceling the payment request during PIN entry makes the payment terminal unresponsive. The terminal needs to be restarted to transact again.

  • Contact chip transactions are declined when using surcharge.

General
Known issues
  • In Canada and the US, certain Visa payment cards are rejected because they are identified as SVS gift cards.

Copy url
icon
Terminal software v1.87

To update UX300 and UX410 payment terminals to this version, contact our Support Team. Terminals should not be more than five versions behind the latest release.

Terminal API integration
Fixed
  • We fixed the issue where sending the Abort Request without the MessageCategory field made the terminal reboot.
  • We fixed the issue where additional characters were passed as part of the scanned barcode data in the additonalData of the Terminal API response.
Improved
  • For Pay at table, you can now select in your Customer Area to show or hide the notification button on the payment terminal screen.
    When the notification button is hidden, you start a transaction by selecting the Confirm key
    on the keypad.
OPI integration
Improved
  • For Pay at table, you can now select in your Customer Area to show or hide the Pay@Table button on the payment terminal screen.
    When the Pay@Table button is hidden, you start a transaction by selecting the Confirm key
    on the keypad.
Engage terminals
Known issues
  • When connected to Wi-Fi, the screen of e285p payment terminal keeps turning on and off.
  • The Pay at table button does not show on the screen of payment terminals that use the old menu structure.
    If you are using Pay at table, with either Terminal API or OPI integration, consider enabling the new menu structure or updating to v1.89.
Android terminals
Known issues
  • Canceling the payment request during PIN entry makes the payment terminal unresponsive. The terminal needs to be restarted to transact again.

  • Contact chip transactions are declined when using surcharge.

General
Known issues
  • In Canada and the US, certain Visa payment cards are rejected because they are identified as SVS gift cards.

Copy url
icon
Terminal software v1.86

To update UX300 and UX410 payment terminals to this version, contact our Support Team. Terminals should not be more than five versions behind the latest release.

Engage terminals
Fixed
  • When using the new menu structure, you now have to enter the Transactions passcode to make referenced refund from the Transaction History.
Known issues
  • When connected to Wi-Fi, the screen of e285p payment terminal keeps turning on and off.
  • The Pay at table button does not show on the screen of payment terminals that use the old menu structure.
    If you are using Pay at table, with either Terminal API or OPI integration, consider enabling the new menu structure or updating to v1.89.
Terminal API integration
New
  • You can now allow a third party to interact with your customers on your payment terminals without integrating with your POS system. A third party can send non-payment requests, like input and display requests, and receive notifications from your terminals. Using third-party interactions, the third party is able to gather feedback on your service or engage customers in your loyalty program.
  • You can now add a flag to your payment request to hide the pre-authorized amount on the payment terminal screen.
Improved
  • You can now use the same card tokenization system for point of sale as for ecommerce. This allows you to create a recurring contract for:
    • One-off transactions where a shopper can either store their payment details or pay in your website or app later.
    • Transactions that occur on a fixed schedule for a fixed or variable amount.
    • Transactions that occur on a non-fixed schedule and/or have variable amounts.
Android terminals
Known issues
  • Canceling the payment request during PIN entry makes the payment terminal unresponsive. The terminal needs to be restarted to transact again.
General
Known issues
  • In Canada and the US, certain Visa payment cards are rejected because they are identified as SVS gift cards.

Copy url
icon
Terminal software v1.85

To update UX300 and UX410 payment terminals to this version, contact our Support Team. If your terminals are on this release, update to a more recent version. Terminals should not be more than five versions behind the latest release.

OPI integration
New
  • For Pay at Table, payment terminals now support refunds initiated from Oracle Symphony.
Engage terminals
New
  • We rearranged the menu options on the terminal, and changed the way you access the menus to align it with Android payment terminals.
Improved
  • For V400m with Bluetooth base station, we improved the way you connect the payment terminal with your wired network using the base station. You now only need to dock the terminal into the base station and select Pair now.
Known issues
  • When connected to Wi-Fi, the screen of e285p payment terminal keeps turning on and off.
Android terminals
Known issues
  • Canceling the payment request during PIN entry makes the payment terminal unresponsive. The terminal needs to be restarted to transact again.
General
Fixed
  • We fixed the issue where Interac transactions were declined when certain fields were sent without a value.
Known issues
  • In Canada and the US, certain Visa payment cards are rejected because they are identified as SVS gift cards.
  • For Interac and EFTPOS payments, the account type is in some cases automatically set to credit and the account type selection screen does not show. The account type selection screen also doesn’t show in cases in which the payment terminal cannot detect the payment card brands Interac and EFTPOS.

Copy url
icon
Terminal software v1.84

To update UX300 and UX410 payment terminals to this version, contact our Support Team. If your terminals are on this release, update to a more recent version. Terminals should not be more than five versions behind the latest release.

Terminal API integration
Improved
  • With Pay-at-table payments, the options to pay the amount in total, split equally, or split unequally are presented on the same screen. While paying, you can now see how many splits there are left.
OPI integration
Improved
  • With Pay-at-table payments, the options to pay the amount in total, split equally, or split unequally are presented on the same screen. While paying, you can now see how many splits there are left.
Engage terminals
Known issues
  • When connected to Wi-Fi, the screen of e285p payment terminal keeps turning on and off.
General
Known issues
  • Interac transactions are declined when certain fields in the request are sent without a value.
  • In Canada and the US, certain Visa payment cards are rejected because they are identified as SVS gift cards.
  • For Interac and EFTPOS payments, the account type is in some cases automatically set to credit and the account type selection screen does not show. The account type selection screen also doesn’t show in cases in which the payment terminal cannot detect the payment card brands Interac and EFTPOS.

Copy url
icon
Terminal software v1.83

To update UX300 and UX410 payment terminals to this version, contact our Support Team. If your terminals are on this release, update to a more recent version. Terminals should not be more than five versions behind the latest release.

Terminal API integration
New
  • For Mifare DESFire cards, you can now use our Android payment terminals to send read or write requests.
Improved
  • We now support sending the secondary security code (SSC) data in the activation and load requests for Stored Value Solutions (SVS) gift cards.
Fixed
  • We fixed the format of the timestamps sent in the Terminal API notifications.
OPI integration
New
  • To prevent declined card-not-present transactions, like MOTO, the payment request now includes the network transaction reference and the reason for the payment.
Android terminals
New
Engage terminals
Known issues
  • When connected to Wi-Fi, the screen of e285p payment terminal keeps turning on and off.
General
Known issues
  • Interac transactions are declined when certain fields in the request are sent without a value.
  • In Canada and the US, certain Visa payment cards are rejected because they are identified as SVS gift cards.
  • For Interac and EFTPOS payments, the account type is in some cases automatically set to credit and the account type selection screen does not show. The account type selection screen also doesn’t show in cases in which the payment terminal cannot detect the payment card brands Interac and EFTPOS.

Copy url
icon
Terminal software v1.82

If your terminals are on this release, update to a more recent version. Terminals should not be more than five versions behind the latest release.

Terminal API integration
New
  • When sending read or write requests to Mifare cards, you can now create a session that spans multiple read/write requests to make them a single user interaction.
Android terminals
New
  • You can now do a diagnostics of the payment terminal's hardware components like the chip card reader, swipe reader, and NFC antenna.
  • You can now send a request to Android payment terminals to specifically get the unique identifier (UID) of Mifare cards.
Fixed
  • We extended the maximum character length of the Device Slogan on the terminal.
  • The Device Slogan variable now correctly shows the serial number of the terminal.
  • When tipping from a terminal, Swedish users no longer get multiple No tip buttons when entering low amounts.
  • Making a card acquisition request before a refund no longer fails when the payment terminals is offline.
Engage terminals
Known issues
  • When connected to Wi-Fi, the screen of e285p payment terminal keeps turning on and off.
General
Known issues
  • Interac transactions are declined when certain fields in the request are sent without a value.
  • For Interac and EFTPOS payments, the account type is in some cases automatically set to credit and the account type selection screen does not show. The account type selection screen also doesn’t show in cases in which the payment terminal cannot detect the payment card brands Interac and EFTPOS.

Copy url
icon
Terminal software v1.81

If your terminals are on this release, update to a more recent version. Terminals should not be more than five versions behind the latest release.

Terminal API integration
New
  • When sending read or write requests to Mifare cards, the response now returns the unique identifier (UID) of the card even if the request fails.
  • You can now send a request to Mifare cards to specifically get the unique identifier (UID) of the card.
Improved
  • On payment terminals, the virtual receipt now automatically scrolls to the bottom of the receipt. You can then use the scroll to go back and view each item.
Fixed
  • We fixed the issue where captures failed for payments made by scanning the barcode on SVS and ValueLink gift cards.
Android terminals
New
  • Under Transactions > Totals, you can now view and print the last known Totals report even if you already reset the totals.
  • On standalone payment terminals, we now support refunds for Mail Order/Telephone Order (MOTO) payments.
  • When tipping on a terminal, shoppers now get a warning if the tip is higher than the predefined percentage. They can then choose to continue or adjust the tip.
Engage terminals
Known issues
  • When connected to Wi-Fi, the screen of e285p payment terminal keeps turning on and off.
General
Known issues
  • Interac transactions are declined when certain fields in the request are sent without a value.
  • For Interac and EFTPOS payments, the account type is in some cases automatically set to credit and the account type selection screen does not show. The account type selection screen also doesn’t show in cases in which the payment terminal cannot detect the payment card brands Interac and EFTPOS.

Copy url
icon
Terminal software v1.80

If your terminals are on this release, update to a more recent version. Terminals should not be more than five versions behind the latest release.

OPI integration
New
  • You can now initiate payments from your Oracle Retail Xstore POS app for the following QR code wallet apps: Affirm, Pix (Brazil only), Swish, Twint, and Zip.
Engage terminals
New
  • To prevent fraud when making refunds on standalone payment terminals, you can set up a 6 digit passcode to protect access to the Refund option in the special payments menu.
  • On your terminal, you can run a Local communications TLS test to check the TLS version, cipher, and URL used in your local communications integration.
Android terminals
New
  • For Mifare Ultralight and Mifare Ultralight C cards, you can now use our payment terminals to do a single read or write action.
  • You can now adjust the volume of your payment terminals. To enable this, contact our Support Team.
  • In the Device info menu of your payment terminal, you can do a long-press to copy the values of the Serial number and Merchant account fields. You can then paste the values, for example, when setting up your POS app.
  • If a terminal is malfunctioning, you can send us a diagnostic report from the Hardware diagnostics menu. This includes logs from the terminal that help us improve our software.
Fixed
  • On terminals that use the French language, in the Totals menu we now show the number of transactions for every transaction type.
  • On terminals that use the Swedish language, we fixed the issue where the currency symbol next to the amount showed incorrectly.
Terminal API integration
Known issues
  • Captures fail for payments made by scanning the barcode on SVS and ValueLink gift cards. The payment is then automatically refunded after three days to the shopper's gift card.

Copy url
icon
Terminal software v1.79

If your terminals are on this release, update to a more recent version. Terminals should not be more than five versions behind the latest release.

Terminal API integration
Fixed
  • When making a Pay-at-table payment, payment terminals no longer get stuck in the middle of input requests.
Known issues
  • Captures fail for payments made by scanning the barcode on SVS and ValueLink gift cards. The payment is then automatically refunded after three days to the shopper's gift card.
OPI integration
Fixed
  • When making a Pay-at-table payment, payment terminals no longer get stuck in the middle of input requests.
Engage terminals
New
  • If a terminal is malfunctioning, you can now send us a diagnostic report from the Hardware diagnostics menu. This includes logs from the terminal that help us improve our software.
  • Shoppers in the US can now select between debit or credit options when paying on a terminal.
Known issues
  • This version is not compatible with the following payment terminals: UX300 and UX410.
Android terminals
New
  • For Mifare Classic cards, you can now use our payment terminals to do a single read or write action.
  • The Settings menu on Android terminals now shows installed certificates as well as installed apps.
  • We now support the following features for standalone Android terminals:
    • Mail Order/Telephone Order (MOTO)
    • Manually enter payments (MKE)
    • Payment with cashback
    • Bypass PIN entry
    • Bypass AID PRIO
  • You can now see the Wi-Fi MAC address of the Android terminal in the Customer Area, under Settings > Connectivity > Wi-Fi.
Improved
  • The Device Info menu on Android terminals now shows the details of the network it is connected to, specific for the type of network, Wi-Fi or cellular.
  • Android terminals can now support multiple CA certificates for Enterprise EAP-TLS and Enterprise EAP-PEAP Wi-Fi profiles.
Fixed
  • When the IP address of the terminal changes, it is now updated in the Customer Area.
  • You can now select the Hidden SSID flag to allow Android terminals to connect to networks with hidden SSID. You can enable it in the Customer Area under Terminal settings > Connectivity > Wi-Fi profiles, or using Management API.
  • On Android terminals, on the Transactions > Totals screen, the referenced refunds no longer show zero for the total amount.

Copy url
icon
Terminal software v1.78

If your terminals are on this release, update to a more recent version. Terminals should not be more than five versions behind the latest release.

General
Fixed
  • WeChat Pay no longer shows as the payment method for transactions made with a Maestro card.
Improved
  • When tipping on a terminal, shoppers now get a warning if the tip is higher that the predefined percentage. They can then choose to continue or adjust the tip.
Terminal API integration
New
  • Terminal API now supports sending secondary security code (SSC) data in the payment request for Stored Value Solutions (SVS) gift cards. Previously, customers had to enter the security code on the terminal.
  • You can now send a GetRating input request to show the rating screen asking the customer to select a value between 0 and 9 without needing to confirm the choice.
Known issues
  • Captures fail for payments made by scanning the barcode on SVS and ValueLink gift cards. The payment is then automatically refunded after three days to the shopper's gift card.
Android terminals
Known issues
  • This version is not compatible with Android payment terminals.

Copy url
icon
Terminal software v1.76

If your terminals are on this release, update to a more recent version. Terminals should not be more than five versions behind the latest release.

General
New
  • We now support the printing of receipts in a layout specific to the Japanese market.
  • You can now let Japanese shoppers choose on a terminal whether to pay the whole amount or split it into installments.
Terminal API integration
Fixed
  • When making the CardAcquisition request, the response no longer includes the warning that the SaleToPOIData field is not supported.
OPI integration
Fixed
  • When making a Pay-at-table payment with the Pay in cash option disabled, the payment terminal no longer gets stuck in the payment menu if you cancel the transaction.
Android terminals
New
  • You can now present shoppers with an option to donate to a charity after they pay on a terminal.
Improved
  • In the Customer Area, you can now add variables in the Device slogan field to automatically show the terminal serial number, store ID, or IP address on the screen of the terminal.
Fixed
  • We fixed the issue where the language on the terminal failed to change to Norwegian after being selected in the Customer Area.

Copy url
icon
Terminal software v1.75

This version is not compatible with the following payment terminals: UX300, UX410, and e285. If your terminals are on this release, update to a more recent version. Terminals should not be more than five versions behind the latest release.

General
Improved
  • For gift cards that require a signature, you can now ask for a signature either on the terminal screen or on the receipt.
  • Manual Key Entry now supports entering card numbers of up to 24 digits, instead of 20.
Fixed
  • For declined meal voucher transactions, we now print the remaining balance on the receipt, even if the balance is 0.
  • When transaction conditions in the payment request limit the accepted payment methods to card schemes, the icon to select a QR code payment method no longer shows for that transaction.
Terminal API integration
Improved
  • You can now show a waiting screen on the terminal after display requests and payment requests. Previously, you could only show the waiting screen after input requests.
  • Sending a full referenced refund request more than once now results in an error message that the transaction has already been reversed.
Fixed
  • We fixed an issue where terminals showed a black screen after an input request.
OPI integration
New
  • The PSP reference we return for your requests now includes letters as well as numbers.
Improved
  • For Oracle Simphony, we now pass the card alias to identify cards used in pre-authorizations and sale purchases. This enables issuing multiple checks/orders for the same table.
Engage terminals
New
  • For cloud integrations, we now have a mechanism where the terminal retries sending Terminal API requests and Terminal API event and display notifications after losing the WebSocket connection.
Android terminals
New
  • You can now send the following input requests on Android terminals:
    • Multiple choice—multiple answers: lets you ask the shopper a question and allow them to select more than one answer.
    • Phone number: lets you ask the shopper to enter their phone number.
    • Rating: lets you ask the shopper or your staff to enter a numerical value from 0 to 10.
Improved
  • We can now configure your Android terminals to hide decimal numbers for currencies that do not use minor units, or if it is customary to show round numbers.

Copy url
icon
Terminal software v1.74

If your terminals are on this release, update to a more recent version. Terminals should not be more than five versions behind the latest release.

General
New
  • New payment method: Atome. For this QR code wallet we support the merchant-presented payment flows (initiated from the terminal, or from the POS system).
Improved
  • On the merchant receipt, you can now print the name of the cardholder. This lets you minimize the risk of fraud by verifying that it matches the name of the shopper. To enable this, contact our Support Team.
  • We improved the overall payment processing time by optimizing the generation of the receipt data.
Terminal API integration
Fixed
  • On the M400 terminal, we fixed the misalignment of the Admin menu icons.
  • Terminals no longer crash if you send an empty DisplayOutput field in a display request. You now get an error message with a description of the issue.
Android terminals
New
  • You can now use an InputRequest to ask the shopper or your staff to enter text, like an email address of the shopper.
Improved
  • With QR code payments, we now show the logo of the used payment method below the QR code.
  • In the GetDigit input request, you can now leave the DefaultInputString field empty.
  • On the S1E, the navigation bar layout has been changed to be the same as on S1F2.
Fixed
  • The Device info QR code now includes the MAC address of the terminal.

Copy url
icon
Terminal software v1.73

If your terminals are on this release, update to a more recent version. Terminals should not be more than five versions behind the latest release.

General
Improved
  • With Manual Key Entry transactions, we ensured that the amount is shown from the start throughout the flow. Also, when entering the card number, 16 digits will fit the screen.

  • Standard webhooks now include the following fields for point-of-sale payments:

    • RecurringDetailReference
    • PaymentAccountReference
    • tokenTxVariant
Terminal API integration
Improved
  • For Pay at Table, we improved the employee authentication flow:

    • If employees usually authenticate by swiping their employee card but do not have their card available, they can select the Cancel key to switch to entering their reference number. To switch back to swiping, they need to select the Cancel key again.
    • Employee numbers starting with one or more zeros are supported.
OPI integration
Improved
  • For Pay at Table, when an itemized receipt is configured but no data is sent, the terminal will show "No data" and the total payment amount instead of a zero amount.
Engage terminals
Improved
  • The cloud icon on the display, which represents the WebSocket connection, is now more reliable. Previously the icon sometimes continued to show when there was no WebSocket connection anymore.
Fixed
  • Pressing and holding the Cancel key works as expected again: Battery-powered terminals turn off, and tethered terminals remain turned on.

  • Surcharge didn't work for contactless transactions when single tap was configured.

Android terminals
New

Copy url
icon
Terminal software v1.72

If your terminals are on this release, update to a more recent version. Terminals should not be more than five versions behind the latest release.

General
Improved
  • The support for cashback is extended to Mastercard and Visa transactions.
Terminal API integration
New
  • You can now make an AdminRequest to create a session that spans multiple requests. The first implementation that we support, is to show a "waiting" screen on the terminal between requests. You can use this waiting screen in flows like Pay at Table to make it clear that the POS system is not unresponsive, it is just busy doing something that takes a bit of time.
Changed
  • The tender options to override settings configured for NFC wallet passes should now be passed in SaleToPOIData instead of SaleToAcquirerData. The reason for this change is that the acquirer doesn't need to be aware this type of tender options. The following tender options are affected:

    • VASModeVASAndPayment
    • VASModeVASOrPayment
    • VASModeVASOnly
    • VASModePaymentOnly

    Other tender options still need to be passed in SaleToAcquirerData.

OPI integration
Improved
  • We now interpret TransType 08 as a Reopen Closed Check operation. This means the capture is reversed, and the authorization is kept open so that you can capture a new amount against that authorization.
Engage terminals
Improved
  • The terminal keeps a list of devices that it connected to through Bluetooth pairing. When the list is full, the terminal won't connect when you try to pair it to a new device. When this happens we now show a message to explain the situation, and a hint to remove one of the other devices from the list.
Fixed
  • Fixed various rare issues with cellular connectivity.

  • Terminals on software version 1.70.6 became unresponsive after a donation and continued to show the Donated screen.

  • Reassigning a terminal to a different store caused the terminal to go into service mode.

  • Bluetooth turned off automatically when a paired device was unpaired.

Android terminals
New
Fixed
  • The terminal sometimes showed a prompt to select a launcher app.

Copy url
icon
Terminal software v1.71

If your terminals are on this release, update to a more recent version. Terminals should not be more than five versions behind the latest release.

OPI integration
New
Engage terminals
New
  • This release includes a patch for a vulnerability in the Verifone NFC driver on UX payment terminals.

  • You can now set a beep volume specifically for when the shopper leaves their card in the payment terminal, for example in a self-service kiosk.

  • It is now possible to set the Wi-Fi frequency band that the terminal uses. Possible values are 2.4 GHz, 5.0 GHz, and Automatic. This enables you to resolve a situation where a network is not listed because the terminal is on a different frequency band. Contact our Support Team to enable this for you.

Improved
  • The process for manually updating the base station is now smoother.
    When you update the terminal software and then place the terminal on the base station, the terminal prompts you to update the base station. The next time you place the terminal in the base station, the terminal will know you have updated the base station, and will no longer prompt again for an update.

  • Renewal of the terminal certificate is now faster.
    When a terminal asks our backend for a new signed certificate, we temporarily reduce the maintenance interval to ensure the terminal receives the new certificate almost as soon as it is ready. The terminal will then reboot immediately, to load the new certificate.

Fixed
  • We made some changes in the power management, to prevent intermittent blinking of the terminal.

  • We fixed an issue where the Wi-Fi driver sometimes crashed and caused 'failed to go online' errors.

Android terminals
New
  • Added support for printing a logo on the receipt. You can upload the logo in your Customer Area > In-person payments > Terminal settings > Receipts.
Improved
  • The Totals report that is available on the terminal now includes the terminal serial number.

  • We restyled the button to start a refund in a standalone solution. For three seconds, Refund will show next to the icon.

Fixed
  • The magstripe reader failed to read Givex gift cards.

  • After trying a contactless transaction, shoppers often had to fall back to a contact transaction.

Known issues
  • The terminal sometimes shows a prompt to select a launcher app. This will be solved in the next release. In the meantime, when this prompt appears: Select Adyen and confirm with Always.
Terminal API integration
Improved
  • Partial referenced refunds are now added to the referenced refunds total in the Totals report.
General
  • The QR code payment screen is now consistent across terminal models.

  • When the magnetic stripe reader is used, eftpos now requires authentication with the PIN. Other payment methods may follow suit. For this reason, we introduced a setting that triggers the terminal to ask for the PIN when a card is swiped. Ask our Support Team to configure this for you.


Copy url
icon
Terminal software v1.70

If your terminals are on this release, update to a more recent version. Terminals should not be more than five versions behind the latest release.

Terminal API integration
New
  • The new GetAmount input request lets the shopper enter an amount with decimals. The terminal shows the currency and a placeholder amount.
Fixed
Improved
  • The gift card number is now shown in PaymentInstrumentData.CardData.SensitiveCardData.PAN. For existing integrations, we continue to show the gift card number in StoredValueAccountID.StoredValueID as well.

  • You can now configure Pay at table so that your staff can authenticate by swiping their employee card.

General
New
  • You can now create recurring details for a shopper while offline, through Store and Forward. You'd use this for loyalty use cases or later recurring payments. A requirement is that Store and Forward is enabled for payments that normally require a PIN as CVM.
Improved
  • The terminal now shows the new logo for the QR code wallet Affirm.

  • If you are using surcharge it is now possible to skip the screen that asks the shopper to agree with the surcharge.

Fixed
  • Printed receipts didn't include details specific for Oney payments.
Android terminals
New
Improved
  • The diagnosis response for an S1F2 payment terminal now includes the PrinterStatus.
Fixed
  • Fixed an issue where authorization rates showed a drop between midnight and 2:00 AM.

Copy url
icon
Terminal software v1.69

If your terminals are on this release, update to a more recent version. Terminals should not be more than five versions behind the latest release.

Terminal API integration
New
  • By adding some fields, you can use the GetMenuEntry input request to let the shopper select multiple options from a menu, instead of only one option.
Engage terminals
New
  • We support V400m terminals with a German keypad. German keypads have a different letter mapping. For example, to get the letter Q you'd press the 7 key three times. On a standard keypad, you'd press the 1 key two times.

  • Because some certificates were about to expire, we have updated the Mozilla Certificate Authority tree used to authenticate incoming TLS requests.

Improved
  • For cloud integrations, we have improved the mechanism used by the terminal to reconnect if it loses the WebSocket connection.

  • V400m Bluetooth base stations now reboot every night and after every software update. This improves operational stability.

Fixed
  • UX410 terminals sometimes got stuck when a card acquisition request was made.

  • When an in-progress transaction was interrupted, this sometimes caused a boot loop.

  • We now show the correct message after a Bluetooth PAN or tethering connection is established, and correctly show the Bluetooth status of the terminal after unpairing a Bluetooth device.

Android terminals
Improved
Fixed
  • When using a white background image, the names of the Adyen menus on the home screen were not clearly visible.
General
New
  • To prevent unnecessary declined payments, we brought the ecommerce concept of the penalty box to point of sale.
    When a payment network connection is unavailable, we put the payment method in our platform's penalty box. Ecommerce payments are then routed through other connections until the problem is resolved. Previously, the payment terminal was unaware of the penalty box and would try using the unavailable payment method regardless. Now, we inform the terminal. It will then try offline processing, or with co-badged cards the terminal will route the payment to another payment method. For example, the terminal skips a local payment method that is temporarily unavailable and uses a global card scheme instead.

  • For Synchrony private label credit cards and co-badged credit cards, we support account number lookup and card signup.

Improved
  • We improved the design for tipping screens, to standardize the screens across terminal models and flows. There is no functional change.

  • We now provide better feedback in the payment response when an unsupported gift card is presented for a payment.

Fixed
  • The card acquisition response for a contactless Interac card returned the card type incorrectly.

  • We fixed an issue where the payment response didn't contain the masked PAN and the BIN for cards with a short PAN (less than 15 digits).

OPI integration
Improved

Copy url
icon
Terminal software v1.68

If your terminals are on this release, update to a more recent version. Terminals should not be more than five versions behind the latest release.

Android terminals
New
  • Android terminals support WebView version 91.0.4472.88.

  • You can customize after how many minutes of inactivity the terminal goes to sleep mode. Contact our Support Team to configure this for you.

Improved
  • We updated Settings > Config and Settings > Device info > Software:
    • When you select these options, the terminal immediately checks for available updates and shows the actions you can take.
    • The terminal also shows suggestions about what you can do when an action didn't succeed.
    • When you remove the configuration, you'll first see a warning and afterwards you can board the terminal again.

Copy url
icon
Terminal software v1.67

If your terminals are on this release, update to a more recent version. Terminals should not be more than five versions behind the latest release.

General
New
  • New feature: Surcharge. The terminal will add a percentage or fixed amount (or both) to the transaction amount and show a screen for the shopper to accept or decline. Contact our Support Team to configure this for you.

  • We support some additional Nets gift cards.

Terminal API integration
Fixed
  • After logging in with a TotalsGroupID, a GetTotals request with that same TotalsGroupID didn't return the totals for the session with that totals group ID.

  • After a transaction failed because the payment method wasn't supported, the terminal didn't accept a new payment request.

  • When swiping a gift card after a card acquisition request, the giftcardTrack1 and giftcardTrack2 parameters were missing from the additional response.

New
OPI integration
Improved
  • For gift card transactions we now return the unmasked PAN of the gift card, provided your account is set up to add this to the response.
Fixed
  • Referenced refunds were correctly processed on our platform, but the RRN field in the response contained too many characters, causing the POS system to treat the transaction as failed.
Engage terminals
Improved
  • We improved the French text on some screens.

  • We improved the screen that lets the shopper provide their signature on the display, and the screen that lets you check if the signatures match.

  • The donations flow now shows two new screens:

    • Donated after completing the donation payment (instead of Approved).
    • Take your card (instead of Thank you, take your card) if the shopper declines to donate and they dipped their card.
Fixed
  • When a remote Wi-Fi profile was added while the terminal was connected to a local Wi-Fi network, the connection status in the Network > Wi-Fi menu wasn't always clear.
    We now make sure the connected network is listed first and has a green dot next to the signal strength icon .
    If other networks listed under Saved networks are in range, they are shown with a signal strength icon .

  • We fixed some UI bugs on M400 and e280 terminals. For example, the wrong background color for a screen or an icon, or a white line showing at the bottom of a screen.

Android terminals
New
  • You can now show a device slogan on the terminal display. For example, to visually identify the terminal. You can specify the text in your Customer Area on the Settings page for the specific terminal, under Customization.
Improved
  • We improved the Settings > Apps menu. When you open this menu, the terminal checks for and downloads any updates to your apps. You can then close the menu; you do not have to wait for the download to finish.

  • You can now print a shopper or merchant receipt from the Transactions menu by selecting the transaction and then the document icon.

Fixed
  • We fixed a bug in the support of remote Wi-Fi profiles.

Copy url
icon
Terminal software v1.66

If your terminals are on this release, update to a more recent version. Terminals should not be more than five versions behind the latest release.

General
Improved
  • The Totals report on the terminal no longer shows Giving donations mixed with regular payments.

  • When you use direct tipping after card entry, our Support Team can now enable single tap. This ensures that for a contactless payment shoppers do not need to tap their card again after specifying a tip.

Fixed
  • In some scenarios issues occurred when the terminal tried to reconnect to WebSockets.
Terminal API integration
New
  • You can send temporary shopping pass data in a payment request. For this you can use the CardData object in PaymentRequest.PaymentData.PaymentInstrumentData.

  • When using terminals with P2PE encryption a diagnosis request returns the version number of the software, the vault, the SRED, the AppManager, and the Open Protocol used on the terminal.

Improved
Fixed
  • Fixed an issue that approved an unreferenced refund to a QR code wallet in the merchant-presented flows.
Engage terminals
New
  • In the tax-free shopping flow we automatically send an input request to the terminal asking the shopper for their consent to share card details with the TFS provider. If the shopper declines, we automatically update the taxfree.indicator flag in the subsequent payment request to false.
Improved
  • We improved the performance of cellular communications for some specific scenarios.
Fixed
  • e280: After switching to sleep mode, the terminal didn't wake up when the user pressed the power button.

  • e280: Volume settings reverted to the maximum after switching the terminal off and on again.

  • e285: With automatic network selection for cellular connectivity, the terminal tries to use the strongest connection that the terminal model supports. On e285 terminals this is 3G, but is was shown on the terminal display as 4G.

  • When a static IP address was configured, DHCP remained shown as enabled on the Device info screen.

Android terminals
New
  • You can change the screen brightness on the terminal.

  • In Adyen > Totals, you can reset the totals report. On the S1F2 you can also print the totals report.

  • On the S1F2 you can select a transaction under Adyen > Transactions and then print the shopper and merchant receipts.

Improved
  • When boarding a terminal, users can now search for their store.
OPI integration
Fixed
  • DCC receipts were non-compliant because our company name appeared as Adyen instead of Adyen N.V.

  • We returned the issuer country/region as a code of three digits instead three letters.


Copy url
icon
Terminal software v1.65

If your terminals are on this release, update to a more recent version. Terminals should not be more than five versions behind the latest release.

General
New
  • New payment method: VR. This is a Brazilian prepaid card (meal voucher).

  • To better support Store-and-Forward transactions, we significantly improved the recognition of credit, debit, and prepaid cards.

Fixed
  • When you use the DebitPreferredFlag in your payment request and the shopper presents a pure credit card (so not a debit card or a combo card with both debit and credit functionality), the terminal didn't ask the shopper to present their card again.

  • For meal voucher transactions the receipt didn't provide the remaining balance when the balance had dropped to zero.

  • We fixed an issue where Store and Forward didn't work for contactless transactions.

Terminal API integration
Improved
  • You can now include the unique terminal ID (TID) in the QR code that can be printed on the receipt. Ask your Adyen contact to configure this for you.

  • For gift cards, we re-introduced the possibility to ask for a PIN when the gift card number is entered. Your Adyen contact can enable this for you.

  • As documented, you cannot use the Pay at Table flow with split payments on terminals that do not have a printer, like the M400 or e285. If you nevertheless send a payment request with the SplitPaymentFlag to such a terminal, you will get an error message that is more informative than previously.

Fixed
  • When specifying the gift card provider in the StoredValueProvider field, the terminal still prompted for brand selection in some cases.

  • On M400 terminals, the additional text below the header for a GetConfirmation input request was left-aligned instead of centered.

  • If you send a Terminal API request to a terminal that is processing a payment in standalone mode or in a classic library integration, there was no response. Now we return an error.

Known issues
  • The XML to show a virtual receipt on the terminal doesn't have an element to add a Total discounts line.
OPI integration
  • To support shopper recognition flows and loyalty flows with passes for NFC wallets (like Apple VAS and Google Smart Tap), we have collaborated with Oracle to extend the OPI specifications:

    • CardholderEmail added to the Sales Purchase request.
    • MerchantId, TerminalId, CustomerId and CardAlias added to the Card Acquisition response.
    • LoyaltyBrands container added to the Sales Purchase and Card Acquisition requests.
    • LoyaltyId and LoyaltyBrand fields added to the Sales Purchase, Sales Completion, Transaction Inquiry, and Card Acquisition responses.

  • We implemented the Get Customer Verification request. This lets you show a question on the terminal outside of a payment transaction, and get a Yes/No response from the shopper.

Engage terminals
New
  • Power management is enabled by default on all battery powered terminals, also when using cloud communications. This means the terminal will switch to sleep mode when it is not being used.

  • The diagnostic hardware tests includes an NFC antenna test.

Improved
  • When cellular communications is disabled, we no longer hide the cellular menu option (Admin menu > Network > Cellular). That means you can enable cellular communications on the terminal when we remotely activate the terminal's SIM card.

  • We made sure that in Wi-Fi networks with PEAP or TLS authentication, the terminal will not try to use a certificate that has expired or that is not valid yet.

  • We redesigned the screen that appears when you have enabled Prompt before printing for receipts printed on the terminal.

Fixed
  • We fixed an issue where the "Authorizing" animation was shown twice after a transaction.
Android terminals
New
  • The home screen shows network connectivity and battery charge notifications, alerting the user to take action. For example, Welcome - Set up network when there is no network configured on the terminal, or Low battery.
Improved
  • Previously, nothing happened when you tried to do a card acquisition, because this request type is not supported yet. Now we return an error response.
Fixed
  • In the boarding wizard, special characters were not rendered correctly.

  • We fixed a UI issue that blocked returning to the payment screen after selecting Wallets.

  • We fixed a bug that caused MKE transactions to stop in mid-process.


Copy url
icon
Terminal software v1.64

If your terminals are on this release, update to a more recent version. Terminals should not be more than five versions behind the latest release.

General
New
  • We implemented a new mechanism to renew terminal certificates. From V1.64, terminal certificates are renewed automatically six months before expiry.

  • The Endpoints connection test now includes testing the connection to the region-specific managed engagement endpoints (when enabled).
    Managed engagement is a service that lets you use predefined shopper engagement campaigns and download the results from your Customer Area.

  • We now support cashback for girocard.

  • We extended our donations feature Adyen Giving to e285 payment terminals.

Improved
  • We improved the stability of cloud communications, reducing the occurrence of disconnects due to a time-out.

  • We removed an unnecessary delay in sending the response to the POS system in cases where the payment is declined due to an expired card or not enough balance.

  • We improved the handling of some specific contactless cards that tended to fall back to inserting or swiping because the cards were configured differently compared to what's usually seen in contactless cards.

  • We prepared for new Brazilian debit AIDs, to ensure the terminal will correctly recognize a card with such an AID as a debit card.

  • On the receipts and terminal screens for referenced refunds, we renamed Void to Refund.

Fixed
  • We fixed an issue that could potentially lead to a boot loop.

  • We switched to an alternative Russian translation of Approved because the previous translation was too long for the screen.

  • After removing an uploaded receipt logo from the Customer Area, the terminal continued to print the logo on receipts.

  • Approved transactions were shown as cancelled in the Admin menu > Transactions list on the terminal.

Terminal API integration
New
  • Using the new GetPhoneNumber input request you can collect your shopper's phone number on the payment terminal.

  • With NFC wallet passes you can now:

    • Use tender options in your payment request to override the configured flow.
    • Add LoyaltyData to your payment request to show a notification on the shopper's device that allows them to easily add your NFC wallet pass to their digital wallet.
Improved
  • You can now use PaymentType Refund in a card acquisition request to get the card details before making an unreferenced refund. You can use this, for example, to verify whether the shopper is using the same card for the refund as for the initial payment.

  • We made some improvements for scenarios where the shopper uses a contactless card or an NFC wallet and the amount changes after the shopper has tapped their card or smart device. This can happen with card acquisition followed by a payment, or tipping after card entry. The improvements are:

    • We optimized the logic for deciding whether the shopper needs to tap their card or smart device a second time.
    • The terminal shows an explanation when a second tap is necessary.

  • When you make a GetMenu input request, the menu buttons can have an extra line of text.

Fixed
  • When you make a GetDigit input request, all terminal models now support a header text that spans two lines.

  • In the response for gift card balance inquiries, we made sure the StoredValueID response parameter value is consistent across entry methods (Scanned, MagStripe, and MKE).

  • When the card is removed from the terminal during authorization, the terminal will now return the ErrorCondition Cancel instead of UnavailableService.

  • We fixed an issue where the terminal was waiting for the card to be removed before sending a transaction status response.

  • When a transaction status request is sent very soon after the payment request, the terminal reported a tender state of INTERNAL STATE.

  • A QR code display request with a header but no footer will no longer cause the terminal to reboot.

  • Pressing the Cancel key didn't work when the terminal was showing the screen for a GetMenu input request.

Known issues
  • The XML to show a virtual receipt on the terminal doesn't have an element to add a Total discounts line.
OPI integration
Fixed
  • The terminal didn't print the sales completion receipt (transType 07).

  • We fixed a timing issue that caused sales completion requests (transType 07) to fail with response code 06 Error.

  • We now return the three-letter country code in card acquisition and payment responses. Previously only card acquisition returned a country code, and this was in three-digit numeric format.

  • We now return the AlternateTransRef, which we use to pass the PSP reference, in transType 06 (Incremental Auth) and transType 05 (Sale Completion).

Engage terminals
New
Improved
Android terminals
Improved
  • We redesigned the loader animation that appears, for example, when starting up the terminal, waiting for payment authorization, or updating settings.

  • App management: We re-styled how our apps and your own apps are presented on the home screen.

Fixed
  • We fixed some issues with the tipping screen, like correctly showing the percentage sign (%).

Copy url
icon
Terminal software v1.62

If your terminals are on this release, update to a more recent version. Terminals should not be more than five versions behind the latest release.

General
New
  • New payment method: TWINT. For this Swiss QR code wallet we support the merchant-presented payment flows (initiated from the terminal, or from the POS system).
Improved
  • We improved the magnetic stripe parsing for cases when an American Express card or a Synchrony store card is swiped.
Fixed
  • We improved the processing logic for contactless cards, to prevent specific cases where the terminal occasionally refused a contactless transaction.
Terminal API integration
New
  • Support for showing a virtual receipt is extended to e280 terminals.

  • For local Terminal API integrations, it is now possible to set up HTTPS endpoints for display and event notifications (in your Customer Area, under In-person payments > Terminal settings > Integrations > Event URLs and Display URLs).

Fixed
  • On e280 terminals, a GetMenu input request shows the header lines as expected again.

  • When making a display request for a virtual receipt using virtual_receipt01.xslt or virtual_receipt02.xslt the tax items didn't show correctly.

  • When making a request to idle the display using the XHTML method the display returned to the standby screen as expected, but the response to the request was Failure instead of Success.

  • In a specific case, the additionalData incorrectly returned the card type as eftpos_australia.

Known issues
  • The XML to show a virtual receipt on the terminal doesn't have an element to add a Total discounts line.
OPI integration
New
  • OPI supports refunds to a tokenized card.
Improved
  • For pre-authorization, the Transactions menu on terminals with a built-in printer now has the receipts for both the pre-authorization and the sales completion (provided the same terminal is used).
Engage terminals
Fixed
  • When voiding a refund or canceling an unreferenced refund (transType 39), we now return the response code 40 Function Not Supported.
  • On an e280 terminal that's not used as a standalone terminal, selecting the Payments menu caused the terminal to become unresponsive until the menu timed out. Now, the terminal returns to the start screen immediately.
New
  • Hardware diagnostics from the terminal is now possible on all Engage terminal models.

  • During the keypad hardware test, the beep volume of the keys is set to a standard level. After the test, the terminal will go back to using the volume you configured.

Improved
  • On battery-powered terminals, we have extended the battery life significantly by changing the sleep mode. This applies to local communications only. (With cloud communications the connection needs to be kept open all the time, so sleep mode cannot be used.)

  • We implemented an XSD validation feature for use with display requests that show a virtual receipt. When you submit XML that doesn't match the XML Schema Definition for a virtual receipt, you will receive an error message XSD validation failed. The details are in the terminal log. Ask our Support Team to enable this feature for you.

  • For QR code display requests and image display requests, you can now use MinimumDisplayTime to set a time-out. We no longer apply a default time-out.


Copy url
icon
Terminal software v1.61

If your terminals are on this release, update to a more recent version. Terminals should not be more than five versions behind the latest release.

General
New
  • New payment method: PIX. For this Brazilian QR code wallet we support the merchant-presented payment flows (initiated from the terminal, or from the POS app).
Improved
  • We improved the handling of co-badged girocard/Visa cards.
Terminal API integration
New
  • When the PAN of a card acquisition doesn't match the PAN of the subsequent payment, we will process the transaction using the PAN for the payment. Previously, we declined such transactions.
    This is particularly relevant for Apple Pay: Every Apple Pay transaction has a different PAN (Apple Pay token). When the payment amount is not the same as the card acquisition amount, the shopper needs to tap their device a second time to make the payment. This is interpreted as a new Apple Pay transaction, and thus leads to a new PAN.
Improved
  • When a card acquisition is followed by an unreferenced refund instead of a payment, we ask the shopper to present their card again. This prevents certain issuers from declining the unreferenced refund.

  • When adding metadata to a payment, the metadata is returned in the response.

  • We made some changes to the GetMenu input request:

    • You can add a second header line.
    • The menu options appear as buttons with a label. We no longer show any additional text lines for the options.

  • The possibility to show a virtual receipt with a QR code has been extended to P400 Plus, V400c Plus, and V400m terminals. The terminal display will first show the QR code and a button to go to the next screen, and then the virtual receipt.

Fixed
  • We fixed an issue where Manual Key Entry (MKE) appeared to be randomly allowed or not allowed even though the feature was configured correctly.

  • With pay at table, for a fraction of a second the terminal showed a screen with a button to start the pay-at-table flow when the flow was already in progress.

  • If a card was removed from the card reader too quickly, we didn't send a CARD_REMOVED display notification.

  • When making a GetText input request on a P400 Plus terminal, moving a finger up or down over the on-screen keyboard caused the keyboard to scroll.

  • If the POS app sends a payment request following a card acquisition and the shopper hasn't presented their card yet, we now send a correct payment response with ErrorCondition NotAllowed, and an AdditionalResponse.message of Forbidden Request: Service Dialogue CardAcquisitionRequest is in Progress.

Known issues
  • On e280 terminals, a GetMenu input request doesn't show the header lines.
OPI integration
Improved
  • For pay at table, the following properties are now configurable:

    • When starting the flow, let staff authenticate by entering their employee number, or by swiping their employee card. If necessary, staff can skip swiping by selecting Confirm. They will then need to enter their authentication number manually.
    • Let the terminal print an itemized receipt before splitting, or after each payment.

    Reach out to your Adyen contact or our Support Team to configure this for you.

  • We added support for the fast tax free refund flow.

  • It is now possible to either send the receipt to the POS system, print the receipt from the terminal, or both. Contact our Support Team to configure this for you.

  • In the pre-authorization flow, you can now print a receipt when the payment is captured.

Fixed
  • We fixed an issue with the processing of referenced refunds. It is no longer necessary to use the workaround of enabling standalone.

  • When the transaction was cancelled during PIN entry, the terminal didn't show the Cancel screen.

  • For transactions that require a signature as CVM, the cardholder copy was missing from the <PrintData> in the response.

  • We could not process gift cards with the MOTO tender option. When the gift card number is missing from the payment request, the terminal now shows the screen for manually entering the gift card number.

Engage terminals
New
  • On the payment terminal, you can run hardware tests to verify the state of the chip card reader, magnetic swipe reader, and keypad.
Improved
  • When Bluetooth tethering fails because the tethering/hotspot is not activated on the mobile device, the terminal will show an error message to explain that.

Copy url
icon
Terminal software v1.60

If your terminals are on this release, update to a more recent version. Terminals should not be more than five versions behind the latest release.

General
New
  • There are now two ways to use Pay by Link:
    • A new way where a shopper selects Online checkout from the list of wallets on the terminal. With this, you can offer payment links as well as QR code wallets as payment options.
    • The previous, fully contactless way where a QR code with a payment link appears automatically after a few seconds.
Improved
  • We previously queried the terminal's IP address every few hours. Now, we do that more frequently so that the Customer Area shows the up-to-date IP address.

  • To improve authorization rates now that global card schemes regard a signature as optional, we no longer automatically decline payments when there is an issue with capturing the signature. For example, when a time-out occurs or the shopper cancels the signature. Of course, we still cancel the payment when you decline the signature provided by the shopper.

  • Store-and-forward now accepts payments from a BIN without a known funding source (credit, debit, or prepaid) as long as the BIN is recognized. We also extended the list of BINs we recognize.

  • The French translations for receipts have been improved.

Fixed
  • The terminal log and the payment response now both report contactless chip transactions as CLESS_CHIP.

  • When the terminal is idle, selecting a key on the keypad caused a white line to appear at the bottom of the screen.

Terminal API integration
Improved
  • On P400 terminals, a GetText input request now allows your header text to spread over two lines.

  • When a payment is declined because the card doesn't have a checking or savings account, we return a refusal reason of No checking account or No savings account. Previously we returned a generic refusal reason of Declined online.

Fixed
  • We fixed an issue with sending display notifications during payment transactions.

  • Input requests and display requests sometimes halted and timed out due to automatic maintenance. We now make sure maintenance calls do not interrupt in-progress input or display requests.

  • When a transaction status request was sent immediately after a payment request, the transaction status response incorrectly reported that the transaction failed to start. Now we return a response of transaction in-progress.

  • In Terminal API responses, we removed cardPresent from the AdditionalResponse. The reason is that cardPresent could contain a misleading value and wasn't needed because the AdditionalResponse already includes a posEntryMode.

  • On M400 terminals, the header text didn't show when making a display request for a QR code.

  • On M400 terminals, it was possible to drag the signature screen sideways.

  • With installments, split payments, and staff number entry in the Pay-at-Table flow, the on-screen button to enter the number didn't have the expected result.

  • With split payments, the SaleToAcquirer content (for example, tender options) was ignored.

  • When a signature was provided on screen after a GetSignature input request, the signature wasn't visible.

OPI integration
New
  • OPI Food & Beverage: Added support for Brazilian meal vouchers.

  • OPI Retail: Added support for the Get Button Selection request. This allows you to collect input from shoppers by showing text on the terminal display, such as a customer survey question, and letting the shopper respond by selecting an on-screen button.

Known issues
  • Referenced refunds are not processed. The workaround is to enable standalone. This issue will be fixed in the next release.
Engage terminals
New
  • It is now possible to pair an e280 or e285 payment terminal with an Android or iOS mobile device that functions as a mobile POS system. For more information, see Bluetooth PAN and tethering.

  • We also implemented a new look for the Bluetooth menu.

  • We renamed the Info menu to Device info and implemented a new look.

    This menu appears when you press 5 and then the green Confirm key.

Improved
  • When pairing a new V400m terminal with a Bluetooth base station, the terminal will wait with updating the software on the base station until the terminal has finished boarding. This prevents firmware mismatches between the base station and the terminal.

  • When an issue occurs with connecting a terminal to your Wi-Fi network, the terminal gives a more informative error message or shows a hint for what to do next.


Copy url
icon
Terminal software v1.59

If your terminals are on this release, update to a more recent version. Terminals should not be more than five versions behind the latest release.

General
New
Improved
  • With Interac payments, the terminal now presents the account selection options in the order and spelling that Canadian shoppers expect.
    • Canadian English: Chequing , followed by Savings.
    • Canadian French: Chèque, followed by Épargne.
Terminal API integration
New
  • We added an Adyen Giving Service ID to the Terminal API payment response. Using this ID, you can make a transaction status request to receive the result of the donation. You could use this, for example, to give the shopper a receipt for their donation.

  • It is now possible to tokenize a contactless payment trough a card acquisition request with a dummy email address followed by a zero value payment request.

Fixed
  • We made sure it is no longer possible to cancel an in-progress ReversalRequest (referenced refund) on the terminal.
    This fix has also been patched to releases 1.56, 1.57, and 1.58.

  • When it took too long for a shopper to choose between paying with their checking account or their savings account, we returned an inapplicable error condition of UnavailableService. To solve this, we added an Account type selection time-out. Like all time-outs, this will return a Cancel error condition when it occurs.
    This fix has also been patched to releases 1.56, 1.57, and 1.58.

  • When a balance check on an SVS gift card fails, we now pass the response code we receive from SVS.

  • When a payment fails due to power loss, the TransactionStatusResponse showed a misleading error condition of In progress. Now we return the error condition NotFound.

  • When sending a DisplayRequest for a virtual receipt to a P400 or V400 terminal, we now return a NotAllowed error condition if the request includes an XML that uses an incompatible XSLT.
    This fix has also been patched to releases 1.56, 1.57, and 1.58.

  • A payment with an unsupported payment method or brand is now declined with the appropriate refusal reason instead of Declined online.

  • The payment response for a blocked card now includes the refusal reason Card blocked in the AdditionalResponse.

  • We updated the virtual receipt documentation to prevent issues with displaying a virtual receipt with or without QR code on M400 terminals.

  • Forcing the card entry mode didn't work properly for card acquisition.

  • We fixed an issue with randomly missing fields in the Terminal API response.

  • We solved the following issues with input requests on M400 terminals:

    • While the shopper was providing text input, the on-screen keyboard sometimes disappeared.
    • The box to draw a signature wasn't always centered.
OPI integration
Improved
  • We will ignore new, unrecognized fields in the OPI request messages.

  • We removed the SAF field from our code, because this field is now deprecated in the OPI specification.

  • For a generic gift card transaction, we will return issuerId(card type) O7 - SVC instead of 44 Unknown.

  • OPI Food and Beverage:

    • We now recognize the Check Information elements that were recently added to the OPI specification: ServiceChargeTtl, AutoServiceChargeTtl, NonRevenueServiceChargeTtl, DiscountTtl, CheckEmployeeCheckName, Covers, CheckName, OrderType, TableTextAndGroup.
    • We added the CardholderName element to the Authorization transaction response.

  • OPI Retail:

    • We updated the list of valid eWallet payment method data elements with the eWallets that were recently added to the OPI specification.
Fixed
  • Offline pre-authorizations (TransType 05) are no longer approved. We now decline them with RespCode PT and RespText Transaction type not supported offline.
Engage terminals
New
  • It is now possible to show a "Low battery" message on the display of the terminal when the battery charge level drops below a certain level. Contact Support Team to enable this for you.
Fixed
  • If your account is configured to allow undoing the latest approved transaction using Admin menu > Transactions, the transactions overview is now updated immediately when you make a new transaction after undoing the previous transaction.

  • On UX300 terminals, the IP address is shown as expected again in the Network menu.


Copy url
icon
Terminal software v1.58

If your terminals are on this release, update to a more recent version. Terminals should not be more than five versions behind the latest release.

General
New
  • We support including the balance of a meal voucher card on the receipt.

  • New payment method: girocard. This is a German debit card for point of sale that is supported on the following payment terminals:

    • P400 Plus
    • V400c Plus
    • V400m
    • M400
Improved
  • We improved the synchronization of transactions when the connection times out and the terminal switches to a store-and-forward transaction after the transaction was already sent to the issuer for authorization.

  • We improved the Least Cost Routing logic for Interac cards in Canada.

Terminal API integration
Improved
  • When you make a shopper input request for a signature, the terminal display now shows icons to cancel , clear , and confirm the signature. Previously, we only showed buttons labeled "Cancel" and "Confirm".

  • We enhanced our error handling and monitoring of Terminal API integrations that use cloud communications.

Fixed
  • In Terminal API integrations that use cloud communications, the cloud icon on the terminal now shows the current connection status without delay.

  • We fixed an issue with adding application information in key-value pair format to Terminal API payment requests.

OPI integration
New
  • You can initiate a QR code payment from the POS system.
Improved
  • Now that the OPI specifications are extended with the AlternateTransRef field, we use this field in all response messages to provide our PSP reference for the transaction.
Engage terminals
Improved
  • In the cellular connection settings on the terminal, the APN field now accepts a long Access Point Name. Previously, the value was limited to 15 characters.
Fixed
  • When an approved transaction is cancelled from the POS app, the status on the terminal correctly changes from "Approved" to "Cancelled". We fixed an issue where the receipt, when printed again, still showed the transaction as approved.

  • We fixed an issue with broadcasting the hostname of the DHCP client to the DHCP server.


Copy url
icon
Terminal software v1.57

If your terminals are on this release, update to a more recent version. Terminals should not be more than five versions behind the latest release.

General
Updating to this version

This release contains the final security patch from Verifone for UX terminals. With this, the security vulnerabilities that were discovered recently are fully fixed on UX300 and UX410 terminals.
Update your UX terminals to this release as soon as possible.

For other Engage terminals (e280, e285, e285p, M400, P400 Plus, V240m, V400cPlus, V400m) the final security patch is included in the previous release (1.56).

New
  • New QR code payment method: GrabPay.
Improved
  • On standalone terminals, it is now possible to change the formatting of the amount on receipts. You can determine the decimal separator, the thousands separator, and the position of the currency symbol (before or after the amount). Contact our Support Team.
Fixed
  • We solved a network failover issue that occurred in situations where more than one connectivity interface is used.
Terminal API integration
Improved
  • The transaction status response when a transaction is not found now includes the type of transaction instead of a number indicating the transaction type.

  • In Terminal API integrations that use cloud communications we improved the reconnection time after a drop in connectivity.

Fixed
  • For input requests of the type GetConfirmation the scaling of text shown on the terminal is as expected again.

  • The GetTotals request didn't include refunds.

  • In Terminal API integrations that use cloud communications canceling an in-progress payment from the POS system no longer blocks receiving the payment response.

OPI integration
Improved
  • We added the gift card number, expiry date, and provider ID to the messages related to gift card operations.
Engage terminals
Fixed
  • When selecting the account type for an Interac payment, the terminal now shows the correct accented letters, as in "Épargne" and "Chèque".
    The underlying issue was a problem with converting some UTF-8 encoded symbols and letters, which is now fixed throughout the UI.

  • On e285p terminals, we resolved an issue that sometimes caused DeviceOut errors after waking up from a power saving state.

  • When starting up an e280 terminal for the first time, the Confirm icon doesn't overlap anymore with the text "Configure network" or "Board terminal".

  • To give shoppers more time to notice and read the screen with the transaction result, the terminal will show this screen for a longer time.

  • On UX300 terminals, updating the software used up so much CPU capacity that the installer timed out or the terminal slowed down.


Copy url
icon
Terminal software v1.56

If your terminals are on this release, update to a more recent version. Terminals should not be more than five versions behind the latest release.

General
Improved
  • China UnionPay magstripe cards sometimes have information on the magstripe that a PIN is not needed when in reality a PIN is required. To prevent authorization issues in these cases, the terminal will always ask for a PIN when a shopper pays with a CUP magstripe card.
Fixed
  • We solved a network failover issue that occurred in situations where more that one connectivity interface is used.

  • We improved the terminal's tender state messaging for Eftpos transactions, to make it easier to troubleshoot any issues with those transactions.

  • We solved an issue where Subway gift cards were not recognized after swiping.

Updating to this version

This release contains a security patch from Verifone. With this, the security vulnerabilities that were discovered recently are fully fixed on Engage terminals (e280, e285, e285p, M400, P400 Plus, V240m, V400cPlus, V400m). For UX terminals this patch is a partial fix, and a final patch will be released soon.

Terminal API integration
New
Improved
  • You can now use SaleToAcquirerData in a card acquisition request.

  • In the pay-at-table flow it is now possible to skip the cash or card selection screen. This is useful if you do not want to accept cash payments. Ask our Support Team to set this up for you.

Fixed
  • A transaction status request sometimes returned InProgress after a transaction had already been declined.
OPI integration
Improved
  • To support retail integrations in Brazil, the TransactionResponse now contains DebitPreferredFlag and NoOfInstallments.

  • The Incremental Authorization message now contains a NewIncrementalAuth field.

Engage terminals
New
  • We implemented a new Wi-Fi menu. The most important improvements are:

    • More guidance: instructions and intuitive hints make it easier for users to follow what they need to do.
    • Clean layout and easy navigation: crisp screens with a light background and no clutter.
    • Icons indicating the connection state: for example, means the terminal is connected to your Wi-Fi network and the signal strength is good.
    • More network details: SSID, BSSID, signal strength, band, frequency, protocol, key management, encryption... with this many details it is easier to troubleshoot any issues.

  • We added Wi-Fi connectivity to M400 terminals.

Improved
  • We redesigned the Dynamic Currency Conversion (DCC) screen. The two choices that the shopper has - paying in the local currency or in their own currency - are now shown with exactly the same formatting. This is consistent with the latest requirements from card schemes that the screen shouldn't contain anything to suggest DCC is the default choice.
Fixed
  • When we hide minor units for currencies that generally do not use minor units, we now ensure we still show the minor units with our DCC functionality because the card schemes do not allow hiding minor units for DCC.

  • The Bluetooth beacons on e285 and e285p terminals now work as expected.

  • We fixed an issue where the Cellular info screen didn't show the actual values for some properties.