Release Notes

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.