Release Notes

2024-03-18 - SDK 2.88.0 (Android)


New Features, Improvements
New Features
  • PAX All-in-One now supports: 1) offline transactions (deferred authorization/store and forward) and 2) on-receipt tipping.
  • Added support for 67 additional currencies.
Improvements
Added the necessary ProGuard rules to the Tap to Phone SDK, removing the need to maintain the rules in the app project.
2024-02-20 - SDK 2.87.0 (Android)


General Information, Updated Requirements, Fixed Issues
General Information
  • NightMode was deprecated from
    UiConfiguration
    and will be removed in the next release.
  • Changed the "Bugfixes" release note title to "Fixed Issues."
Updated Requirements
Updated the Visa sensory branding library to version 2.2. Use this version of the branding library with the SDK going forward.
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.
2024-01-16 - SDK 2.86.0 (Android)


Improvements
Improvements
Tap to Phone: Improved error messages that display during device enrollment.
2023-12-19 - SDK 2.85.0 (Android)


Improvements and Bugfixes
Improvements
  • 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.
Bugfixes
  • 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.
2023-11-23 - SDK 2.84.0 (Android)


Improvements
Improvements
Tap to Phone:
  • Improved handling of errors when starting a transaction.
  • Improved UI during initialization of a transaction.
  • Improved UX when cancelling a transaction.
2023-10-19 - SDK 2.83.0 (Android)


New Features, Improvements, and Bugfixes
New Features
Tap to Phone now supports these transaction types: pre-authorization, incremental authorization, and capture.
Improvements
  • 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.
Bugfixes
  • 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.
2023-09-19 - SDK 2.82.0 (Android)


New Features and Bugfixes
New Features
Tap to Phone: Added on-device tipping feature.
Bugfixes
  • 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.
2023-08-16 - SDK 2.81.0 (Android)


Improvements
Improvements
  • 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
2023-07-21 - SDK 2.80.0 (Android)


Updated Requirements, Improvements, and Bugfixes
Updated Requirements
Kotlin version change:
  • 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.
Improvements
Implemented security improvements.
Bugfixes
  • 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.
2023-06-29 - SDK 2.79.0 (Android)


Improvements and Bugfixes
Improvements
  • Improved Tap To Phone device enrollment error messages.
  • Implemented security improvements.
Bugfixes
  • MOTO transactions can be aborted using the red button on the Default UI keyboard.
  • MOTO account verification transactions are shown correctly on the receipts.
2023-05-24 - SDK 2.78.0 (Android)


Improvements and Bugfixes
Improvements
  • 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.
Bugfixes
  • 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.
2023-04-20 - SDK 2.77.0 (Android)


New Features, Improvements, and Bugfixes
New Features
Added a new UI configuration to manage the
Don't Show Again
switch behavior for the low-battery warning.
Improvements
  • 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.
Bugfixes
  • 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.
2023-03-14 - SDK 2.76.0 (Android)


Improvements and Bugfixes
Improvements
  • 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.
Bugfixes
Miura: Fixed the issue that occurred when a transaction was started in the Default UI that did not allow the transaction to be cancelled if the terminal was powered off.
2023-02-20 - SDK 2.75.0 (Android)


Improvements
Improvements
When performing a Standalone refund, the Present Card screen now displays: "Present card for refund."
2023-01-24 - SDK 2.74.0 (Android)


Improvements and Bugfixes
Improvements
After the currency is selected on the Dynamic Currency Conversion (DCC) screen, the follow-on screens (such as the Signature screen) now show the converted amount.
Bugfixes
  • 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.
2023-01-02 - SDK 2.73.0 (Android)


New Features, Improvements, and Bugfixes
New Features
Default UI: It is now possible to directly start a transaction with Alipay or WeChat Pay using the Default UI. To enable this feature, set the desired scheme in the transaction parameters before starting the transaction.
Improvements
Improved the stability of the SDK after auditing the code and fixing some crash potential scenarios.
Bugfixes
  • 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.
2022-11-24 - SDK 2.72.0 (Android)


Updated Requirements and Improvements
Updated Requirements
Android OS version change:
  • PAX devices require Android OS version 7.1, at the minimum.
  • All other devices require Android OS version 10, at the minimum.
Improvements
Added Basic Enrollment UI for Tap To Phone (TTP).
2022-10-24 - SDK 2.71.0 (Android)


Updated Requirements, Improvements, and Bugfixes
Updated Requirements
  • Security update:
    In order to further migrate into Visa's secure environment, the Maven repository that contains the artifacts for the JVM SDK is being moved to a different domain. See an example here: PayButton Integration.
    This change effects everyone who integrates or updates the JVM SDK in their apps.
    The repository is now available under: https://repo.visa.com/mpos-releases/
    All requests for the old URL will be redirected to the new repository until the end of March 2023.
Improvements
  • 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.
Bugfixes
  • 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.
2022-09-12 - SDK 2.70.0 (Android)


Improvements and Security Updates
Improvements
  • AliPay / WeChat Pay:
    Disabled flashlight button where camera does not support this function.
    Adjusted on-screen scan instructions to include both barcode and QR code.
  • PAX devices: Present card animations now support all the form factors.
Security Updates
Updated external libraries (OKHttp) with latest security fixes.
2022-08-22 - SDK 2.69.0 (Android)


Improvements
Improvements
Applied general improvements.
2022-07-19 - SDK 2.68.0 (Android)


Bug Fixes
Bug Fixes
  • 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.
2022-06-21 - SDK 2.67.0 (Android)


Improvements
Improvements
Updated PAX POSLink Library to v1.11.0 20220426.
2022-05-17 - SDK 2.66.0 (Android)


Bugfixes
Bugfixes
Fixed issue that caused the AID value to be missing on the receipt for transactions with a declined status on "2nd GEN AC".
2022-04-20 - SDK 2.65.0 (Android)


New Features and Bugfixes
New Features
A new Printing API is available for custom receipt printing in PayButton integrations.
Bugfixes
Verifone terminals now display a Processing screen instead of a blank screen between the Enter PIN and Remove card screens.
2022-03-15 - SDK 2.64.0 (Android)


Improvements and Bugfixes
Improvements
If tipping fails, the flow falls back to the regular transaction flow.
Bugfixes
None.
2022-02-15 - SDK 2.63.0 (Android)


New Features, Improvements, and Bugfixes
New Features
  • PAX A920 now supports Traditional and Simplified Chinese languages.
Improvements
Updated these UI screens on Verifone P400 devices:
  • Terminal Error screen
  • Swipe Card screen
  • Try another card screen
Bugfixes
  • 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.
2022-01-20 - SDK 2.62.0 (Android)


Updated Requirements, Improvements, and Bugfixes
Updated Requirements
  • If the SDK is integrated via Kotlin, then Kotlin v1.5 or above must be used.
Improvements
  • Resolved error handling issue that caused Verifone terminals to erroneously disconnect.
  • Applied Dynamic Currency Conversion (DCC) compliance updates for transaction receipts.
Bugfixes
  • 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.
2021-11-18 - SDK 2.61.0 (Android)


Improvements and Bugfixes
Improvements
  • PAX A920: Added the line, "This receipt is a copy," on receipts that are printed a second time.
Bugfixes
  • 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.
2021-10-25 - SDK 2.60.0 (Android)


Improvements and Bugfixes
Improvements
  • General improvements applied.
Bugfixes
  • General bugfixes applied.
2021-10-21 - SDK 2.59.1 (Android)


Improvements and Bugfixes
Improvements
  • General improvements applied.
Bugfixes
  • General bugfixes applied.
2021-09-28 - SDK 2.59.0 (Android)


Improvements and Bugfixes
Improvement
  • PAX A920: Enables users to print receipts for transactions with errors.
Bugfixes
PAX A920:
  • Fixed the bug in Tipping to enable users to edit the tip amount by clicking the
    Cancel
    button on the Confirm Tip Amount screen.
  • Fixed the bug in Percentage Tipping that caused the amount to be calculated incorrectly when the currency used is the Japanese yen (JPY).
2021-08-26 - SDK 2.58.0 (Android)


Improvements and Bugfixes
Improvements
  • 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.
Bugfixes
  • Fixed an issue that caused approved transactions to show as errors in cases where a failure occurred after the payment.
2021-07-28 - SDK 2.57.0 (Android)


Improvements and Bugfixes
Improvements
  • Introduced new error message: "Declined - Exceeds Authorised Amount." This message appears when the Capture amount is higher than the previously authorised amount.
  • Improved messaging on the terminal screen for inconclusive transactions/failed void calls.
Bugfixes
  • Verifone payment terminals: Fixed the issue that caused the Online PIN Transaction not to abort when the shopper removed the payment card while on the PIN Entry screen.
  • PAX A920 payment terminal:
    • Fixed the error that occurred when printing receipts.
    • Fixed the issue that caused the keyboard not to display automatically on the Expiry Date screen during the MOTO workflow.
2021-06-28 - SDK 2.56.0 (Android)


Improvements and Bugfixes
Improvements
  • Updated the BIN ranges for UPI.
  • PayButton: Disabled text field suggestions and caching.
Bugfixes
  • 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.
2021-06-02 - SDK 2.55.0 (Android)


Improvements and Bugfixes
Improvements
  • Verifone e355 payment terminal: Improved UI of the Dynamic Currency Conversion (DCC) screen.
Bugfixes
  • 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.
2021-05-04 - SDK 2.54.0 (Android)


Improvements and Bugfixes
Improvements
  • New Tipping Flow available: Percentage Choice.
  • Updating BroadPOS will trigger a config update to avoid any discrepancy (PAX A920).
Bugfixes
  • 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).
2021-03-15 - SDK 2.53.0 (Android)


New Features and Improvements
New Features
  • 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.
Requirement for feature enablement
: In order to support the latest features, the BroadPOS version must be updated to
V1.03.04_20210204
. Otherwise, error message
Accessory update required
will display when attempting to use the features. To update BroadPOS P2PE, please contact Customer Support.
Improvements
  • Extended support for Strong Customer Authentication additional PIN requests for Mastercard contactless transactions on the PAX A920 card reader.