Release Notes

Improved the user experience when performing a magstripe transaction.

Improved error messages shown during transactions.

Tap to Pay: Re‑enrolling a device no longer requires clearing Tap to Pay Ready App data.

Tap to Pay: Fixed an issue where the enrollment screen appeared in dark mode even when the app was not set to dark mode.

Fixed the issue that could prevent the credit and debit selection from appearing during a magstripe transaction.

Fixed the issue where an oversized toolbar logo was not resized correctly.

Applied general UI fixes.

Fixed the issue that occasionally caused stand-alone credit transactions to stall.

Fixed the issue that caused the SDK to crash when providing tax, installments, or payment facilitator details.

PAX: Fixed the issue that caused the Retry button to not work after a failed receipt print for a completed transaction.

Tap to Pay: Fixed the issue that caused the Tap icon to not appear on the Present Card screen.

Tap to Pay: Fixed the issue that occasionally caused the touch area to not align correctly with the Cancel button.

Deprecated PayButton 1.0 from the SDK. It will be removed from the next release.

Removed the

defaultSummaryFeature

configuration option from the Summary screen parameters.

Added the ability to process Electronic Benefit Transfer (EBT) payment card transactions.

Added the ability to read non-PCI custom magstripe cards.

Fixed the issue that caused the SDK to occasionally crash while using the tipping feature in some languages.

Fixed the issue that caused automatic printing to occasionally fail when performing a refund.

Improved the user experience on some screens by removing the requirement for user interaction.

Improved the error messages that can appear during transactions.

Tap to Pay: Added the ability to configure the device enrollment process to show a list of previously enrolled devices or to enable the merchant to enter the device serial number manually.

Tap to Pay: Added a Device Selection screen that enables merchants to enroll a previously enrolled device without manually entering the serial number. This is now the default process when performing a device enrollment.

Added the ability to customize DefautUI style elements using a UiConfiguration instance.

Tap to Pay: Solution is now PCI-MPoC compliant, which requires the Tap to Pay Ready app to be installed on the Android devices. After upgrading to this SDK version, re-enroll devices.

Tap to Pay: Added support for American Express.

The

toolBarlogo

style element now appears on the Present Card screen.

The customer is no longer prompted for the tip amount a second time when a failed transaction is retried. Whatever tip amount the customer chose during the original transaction is included in the transaction.

Tap to Pay: Improved the error messages that can appear during device enrollment and transaction processing.

Added support for landscape mode on large-screen devices.

Added support for PAX A3700 (Elys tablet).

Improved the error message that can appear when a magnetic-stripe card is not read correctly by the device.

Tap To Phone: Improved the error messages that can appear during enrollment of previously enrolled device.

Fixed the issue that caused the

toolBarlogo

element not to work when using an XML file. This element controls the logo that appears on the device during transactions.

Fixed the issue on the Signature screen that caused the transaction to fail when the Continue button was tapped multiple times.

Improved the error message that appears when trying to start an unsupported transaction type.

Tap To Phone: Improved the error messages that can appear during enrollment and transactions.

Tap To Phone: The device serial number is now returned in the

EnrollResultIntent

after performing a device enrollment.

Tap to Phone: Improved the device enrollment experience by removing the requirement to provide an IMEI number. After upgrading to this SDK version, devices must be re-enrolled.

Tap to Phone: Improved experience when attempting to perform a transaction with an unsupported card.

Tap to Phone: Improved the error messages that can appear during enrollment and transactions.

Tap to Phone: Added a check to confirm that NFC is enabled when a transaction is started.

Fixed the issue that caused the Print Receipt buttons not to appear after requesting a check transaction status.

Fixed the issue that required some dependencies to be imported manually.

Tap to Phone: Improved the error messages that can appear during enrollment.

Tap to Phone: Improved experience when attempting to perform a transaction with an unsupported currency.

MOTO transactions will no longer prompt for tip if tipping is configured.

Fixed the issue that occasionally caused the "Low Battery" notification to be shown incorrectly.

Fixed the issue that caused the value provided for

merchantDescriptor

to not be captured correctly.

Fixed the issue that rarely caused a crash when performing a magstripe transaction.

Fixed the issue that rarely caused a crash during the card selection process.

Added the ability to provide payment facilitator details when performing a transaction.

Added the ability to provide tax details when performing a transaction.

Added the ability to provide installment details for the LAC region when performing a transaction.

Fixed the issue that caused a crash if

MposUi.create

was called twice.

Fixed the issue that caused receipt data to be missing when using

transaction.getCustomerReceipt

or

transaction.getMerchantReceipt

functions for Tap to Phone transactions.

Fixed the issue that caused some devices to not have the expected behavior when the signature capture configuration was set to

NONE

.

Fixed the issue that caused

mposUi.latestTransaction

object to not be updated after requesting a check transaction status.

Error message screens now have a timeout of 15 seconds.

Improved the error message that appears when an offline transaction is attempted before the first online transaction is processed on the device.

Fixed the issue that caused the A920 MAX terminal not to be recognized correctly.

Fixed the issue that caused the Retry button to appear on the Summary screen of approved transactions if the

RETRY_TRANSACTION

feature was configured as the default summary feature.

Added the ability to perform partial refunds and captures from the transaction summary screen.

Added support for PAX IM30 and PAX A920MAX devices.

Updated the minimum supported operating system for Tap to Phone to Android 12.

Updated the minimum supported Kotlin version to 1.8.

Removed deprecated statementDescription and applicationFee parameters.

Removed deprecated NightMode configuration.

PAX All-in-One SDK now supports:

Offline transactions, also known as
deferred authorization
or
store and forward
On-receipt tipping

Added support for 67 additional currencies.

NightMode was deprecated from

UiConfiguration

and will be removed in the next release.

Changed the "Bugfixes" release note title to "Fixed Issues."

Fixed the issue that caused Default UI to crash if the app was running in the background during the card selection process.

Fixed the issue that caused the incorrect formatting of the signature line on a printed receipt.

Tap to Phone: Improved the UI experience when cancelling a transaction from the PIN entry screen.

Enabled the PAX device screen to power on automatically if a transaction is started when the screen is off.

Tap to Phone:

Resolved the issue related to integrators using WorkManager to schedule background work.
Resolved the occasional issue that caused the last screen of a cancelled transaction not to be dismissed automatically.

Resolved the issue that caused MOTO transactions to crash if the language was set to German.

Improved handling of errors when starting a transaction.

Improved UI during initialization of a transaction.

Improved UX when cancelling a transaction.

Default UI: Improved the display of error messages that are more than 40 characters long.

Tap to Phone: Added an indicator on the Summary screen that the customer signature should be captured on the printed receipt.

Default UI:

Fixed the issue that resulted in an inconsistent state when a new transaction was started while the Summary screen was displayed.
Fixed the issue that occurred during a successful linked refund transaction in which the Information screen showed the original transaction amount instead of the refunded amount.

Fixed the issue that caused transactions that used currencies with two-digit numeric codes to fail.

Tap to Phone: Fixed the issue that caused transactions to freeze when using the signature-on-receipt feature.

Default UI:

Fixed the issue that caused the SDK to crash when attempting to recover a transaction after the Inconclusive screen is shown.
Fixed the issue that caused the SDK to crash when starting a transaction with a zero amount and custom tipping.
Fixed the issue that caused the wrong value to be returned when calling the
isReadyForTransaction
method before the first transaction.

After canceling an Alipay payment transaction or a WeChat Pay transaction, a transaction canceled animation now appears on the payment device screen.

Added translations for Tap to Phone enrollment to support these languages:

US English
UK English
Chinese (Hong Kong)
Chinese (Simplified)
Czech
Danish
Dutch
Finnish
French
German
Hungarian
Italian
Latvian
Lithuanian
Norwegian
Polish
Portuguese
Spanish
Swedish

Upgraded Kotlin to version 1.7.21.

Newly released artifacts work with Kotlin version 1.6 and above.

Android Gradle plugin version 7.2. or above is required to build apps with the SDK.

Fixed the issue where choosing a payment option would be ignored when starting a transaction with the Workflow set to

UNKNOWN

.

Fixed the issue for MOTO transactions where pressing the green button on the PAX terminal did not progress the transaction to the next screen.

Improved Tap To Phone device enrollment error messages.

Implemented security improvements.

MOTO transactions can be aborted using the red button on the Default UI keyboard.

MOTO account verification transactions are shown correctly on the receipts.

Default UI: Disabled the option to abort receipt printing and the option to amend transactions after transaction processing starts.

Deprecated unused

statementDescriptor

and

applicationFee

transaction parameters.

Default UI: Fixed the issue that caused the Default UI MOTO transaction parameters to not be updated after the MOTO transaction parameters workflow configuration was updated.

Default UI: Fixed the issue that caused the Default UI to crash when running transactions only on a cellular network.

Fixed the issue that caused the SDK to crash after aborting a transaction and tapping the NFC contactless card on the terminal.

Fixed an issue in order to enable the

No Internet warning

message to always appear whenever there is no internet connectivity.

Fixed an issue in order to enable the amount to show for approved Refund, Capture, and Incremental Authorization transactions.

Deprecated the Incremental Authorization Transaction Parameters builder. Use the replacement Incremental Auth builder with amount and currency parameters.

To comply with the branding requirements for Tap-To-Phone, the Present card screen now shows the available payments schemes.

Enabled option to show the sonic branding for Visa and Mastercard on the Approved transaction screen. Integrators must manually downloaded the sonic branding files from Visa and Mastercard portals.

Fixed an issue that caused the Low Volume message to appear when accessibility features are enabled during a transaction.

Fixed an issue on the DefaultUI that made it not possible to process transactions after aborting a MOTO transaction on the Select order type screen.

Fixed an issue on the DefaultUI Summary screen of a Incremental Authorization transaction that caused the

Show Total Pre-Authorized

button not to work.

Fixed an unusual issue in PayButton that caused the app to crash when starting a transaction.

Changed the button label from

Cancel

to

No Tip

, enabling the merchant to skip tipping and continue the transaction.

Improved Default UI Signature screen functionality when a different card application name is presented.

Integrated Tap to Phone API into MposU.

Made improvements to the authentication mechanism.

Fixed the issue that caused an invalid icon to be shown for the credit/debit selection.

Fixed the issue with recreating eventFlow for each new transaction.

Fixed the issue that prevented the Receipt button from showing after the first transaction.

Fixed the issue that caused a LiveData event not to be sent to the integrator application when the user clicks the Abort button on the QR code scanning screen for an alternative payment flow.

Fixed the issue that allowed a currency conversion to be requested during an account verification transaction.

PAX devices require Android OS version 7.1, at the minimum.

All other devices require Android OS version 10, at the minimum.

PAX (Default UI): The Swipe and Remove Card animations now support all the form factors.

PAX: Improved the auto-reversal mechanism for double charges with failed transactions.

PAX A920 (Default UI): Disabled the front camera for the code scanner due to poor scan capabilities and ergonomics.

PAX: The Abort Transaction button now works when the card is inserted the wrong way.

AliPay / WeChat Pay:

PAX devices: Present card animations now support all the form factors.

Verifone P400: Fixed the issue that caused transactions to not abort when the payment card is removed while the PIN entry screen is displayed on the reader.

MPOS: Fixed the issue that caused a high number of fatal exceptions.

PAX A920 now supports Traditional and Simplified Chinese languages.

Terminal Error screen

Swipe Card screen

Try another card screen

Fixed issue that caused VIPA app to crash when aborting a transaction on Verifone devices using PayServer.

Fixed race condition issue leading to "Device is busy" (9FFF) Terminal Error on Verifone devices.

If the SDK is integrated via Kotlin, then Kotlin v1.5 or above must be used.

Resolved error handling issue that caused Verifone terminals to erroneously disconnect.

Applied Dynamic Currency Conversion (DCC) compliance updates for transaction receipts.

Improved SDK error handling for ERROR_AUTOREVERSAL_ERROR, now allowing voids after a failed abort display call.

Fixed a bug that, in some cases, logged online transactions as offline transactions.

PAX A920: Added the line, "This receipt is a copy," on receipts that are printed a second time.

PAX A920:

Fixed the bug that caused the transaction status to be read (RNIB mode is enabled) after the customer is prompted to remove the card, in the event of a declined transaction.
Fixed the bug that kept users from being able to hide the PIN pad after the transaction is aborted.

General improvements applied.

General bugfixes applied.

General improvements applied.

General bugfixes applied.

PAX A920: Enables users to print receipts for transactions with errors.

Fixed missing tip amount on Summary screen.

PAX A920:

Fixed the tipping pre-populated issue when the transaction amount is 0.00.
Fixed the issue that prevented the merchant from going back from the Tip Confirmation screen to the Edit Tip Amount screen.
Fixed the issue that prevented the merchant from printing receipts for transactions with errors.

Verifone e355: Fixed a fatal exception error caused by card removal while on the PIN screen for online transactions.

Fixed an issue that caused approved transactions to show as errors in cases where a failure occurred after the payment.

Updated the BIN ranges for UPI.

PayButton: Disabled text field suggestions and caching.

Fixed an "inconclusive transaction" issue, which resulted in a Summary screen loop.

PAX: Fixed an issue so that MO/TO transactions cannot proceed with an empty expiry date field.

PAX: Fixed MO/TO transaction AVS issue.

Miura: Fixed MO/TO transactions handling when the PAN limit is exceeded.

Verifone e355 payment terminal: Improved UI of the Dynamic Currency Conversion (DCC) screen.

PAX A920 payment terminal:

PayButton: Removed intermediate processing payment screen.
PayButton: Fixed PIN last try message.
Added validation to prevent empty CVV and CVS fields from being entered in MO/TO transactions.
Fixed RNIB bug introduced in SDK 2.54.
Fixed wrong CVM being prompted when using UnionPay card.

New Tipping Flow available: Percentage Choice.

Updating BroadPOS will trigger a config update to avoid any discrepancy (PAX A920).

Fixed the transaction error when card is removed prematurely during payment processing (PAX A920).

Fixed the error that cause the app to hang during MO / TO transaction (PAX A920).

Fixed the mag-stripe fallback issue (PAX A920).

Fixed terminal behavior when connection is lost during update process.

Fixed VIPA updates through USB (Verifone e355).

Accessibility mode

was added to the PAX A920 payment terminal to enable blind and visually impaired individuals to pay with ease. Merchants can enable Accessibility mode after starting a transaction by clicking the Accessibility icon in the top right corner. When enabled, the voice guide will be played to help the shopper enter their PIN and complete the transaction.

Requirement for feature enablement:

In order to support this feature, the firmware version must be

7.1.2_V02.5.10

and above.

Mail Order / Telephone Order (MO / TO)

was added to the PAX A920 card reader to enable retail merchants to accept MO / TO transactions.

Tipping

(gratuity) was added to the PAX A920 card reader to enable merchants in the hospitality industry to accept tipping. Four tipping options are supported:

Tip with total amount: Enter the total amount, including the tip amount and purchase amount, then you complete the payment.
Tip with tip amount: Enter tip amount only. The terminal will calculate the total amount, then you complete the payment.
Tip with tip percentage: Enter tip percentage. The terminal will calculate the total amount, then you complete the payment.
Tip with fixed percentage: Set the fixed percentage. The terminal will calculate the total amount, then you complete the payment.

Extended support for Strong Customer Authentication additional PIN requests for Mastercard contactless transactions on the PAX A920 card reader.