---
description: >-
  Provides public release notes for both sandbox and production versions of the
  Braintree Payment Application.
---

# Firmware Version Release Notes

{% hint style="success" %}
Production releases occur 4 weeks after a version is made available in Sandbox
{% endhint %}

***

## Version 5.5.0 - Released on 2024-09-12

#### New

* V400m:  New reader hardware support for the [V400m device](../hardware/verifone-v400m)
* V400m:  New [receipt printing API](../guides/receipt-printing-api) for V400m device built-in receipt printer
* Added new [API error codes](../../guides/graphql-error-handling#table-1-error-code-explanations) for receipt printing API
* Transaction level [partial authorization](../../guides/making-a-transaction#partial-authorizations) API flag gives the API caller full control over partial authorization enablement
* Added support for the [payment initiator](../../guides/making-a-transaction/initiate-a-card-present-authorization#using-estimated-auth-pre-auth) API flag to trigger estimated authorizations (pre-authorizations)
* SAF:  Partial authorization is now supported for offline transactions
* RMS:  The new [Reader Management System](../post-launch-activities/reader-management-system-rms-available-in-beta-only) is now available in beta

#### Fixed

* General platform stability and performance improvements

#### Behavior Change

* E285:  When the E285 device is charging the screen will be dimmed but not put into sleep mode

## Version 5.4.0 - Released on 2024-04-11

**New**

* New API call for [Request Multiple Choice Prompt](../../guides/custom-prompts#request-multiple-choice-prompt) which helps you to collect customer input for things such as donations, satisfaction surveys, tipping, and more on the reader display
* All virtual buttons on the reader now change color to provide a visual indication that they have been tapped
* Performance improvements

#### Behavior Change

* SAF: The `cardholderName` field in the [offline node query](../../guides/offline-transactions#checking-the-status-of-a-charge-or-refund) is now formatted as `first_name last_name` where previously it was `last_name/first_name`

## Version 5.3.0 - Released on 2024-01-04

#### New

* We have done a UI refresh of all screens (fonts, font sizes, boldened text, headers, and color scheme)
* SAF:  You can now retrieve the `bin`, `brandCode`, and `applicationIdentifier` for offline transactions
* SAF:  You can now pass the `channel`API variable for offline transactions
* We have added a virtual keyboard for WiFi password entry on the M400 device
* We have enabled the keyboard backlight on the M400 and P400 for better button visibility in dark lighting&#x20;

#### Fixed

* We have fixed a bug where a white screen would be displayed on the reader display during configuration download if the screensaver image file was corrupted
* We have fixed a bug where the reader would not make a beep sound when selecting buttons while using the [requestConfirmationPrompt](../../guides/custom-prompts#request-confirmation-prompt)
* The reader will now remember the previously connected WiFi network even when the network is not available (previously you would be prompted to reconnect to a new network)

#### Behavior Change

* As of firmware version 5.3.0, we have incorporated an updated privacy statement in accordance with California CPRA regulation which shows up on the reader display upon a charge or auth request as: “**Please review the PayPal Privacy Statement at** [**PayPal.com/privacy**](http://paypal.com/privacy)**.**"

## Version 5.2.2 - Released on 2023-08-30

#### Behavior Change

* SAF: The Magstripe reader interface is now disabled for all offline transactions &#x20;

## Version 5.2.0 - Released on 2023-06-27

#### New

* New API call for [Request Text Prompt](../../guides/custom-prompts#request-text-prompt), which helps you to collect alphanumeric and numeric customer inputs (ex: phone number, email address, SSN, etc...) on the reader display
* New API call for [Request Amount Prompt](../../guides/custom-prompts#request-amount-prompt), which helps you to collect custom amount inputs (ex: donation, tips, etc...) from your customer on the reader display
* New API call for [Request Card Data Collection](../guides/card-data-collection), which helps you to collect magstripe track data for non-PCI cards (gift cards, PLCC cards, etc...) swiped on the reader&#x20;

#### Fixed

* Custom Prompts:  `waitForNextRequest` now supported for [Request Signature Prompt](../../guides/custom-prompts#request-signature-prompt) and [Request Confirmation Prompt](../../guides/custom-prompts#request-confirmation-prompt)
* Custom Prompts:  `displayTimeout` now supported for [Request Signature Prompt](../../guides/custom-prompts#request-signature-prompt) and [Request Confirmation Prompt](../../guides/custom-prompts#request-confirmation-prompt)
* Display Information:  `title` now supported for [Request Text Display](../../guides/display-information#request-text-display)
* Display Information:  `alignment` now supported for [Request Text Display](../../guides/display-information#request-text-display)

#### Behavior Change

* When using [Request Text Display](../../guides/display-information#request-text-display), if a `title` is NOT passed in the request the `text` will no longer be vertically centered.  To maintain current behavior without passing a `title` simply pad your `text` with line breaks ("\n")

## Version 5.1.0 - Released on 2023-06-16

{% hint style="info" %}
Version 5.1.0 is available only in the sandbox environment for testing and integration purposes.  For the production release of these features, merchants will need to update to the [5.2.0 release](#version-5.2.0-released-on-2023-06-27).
{% endhint %}

#### New

* New API call for [Request Authorization](../guides/making-a-transaction/initiate-a-card-present-authorization), which supports separate auth from capture, incremental auth, partial and full capture
* SAF:  general enhancements to store & forward feature
* SAF: Request Charge now supports vaulting w/charge
* PIN bypass is now supported by pressing the green keypad button during the PIN prompt
* Admin menu:  [Network Diagnostics feature](../../post-launch-activities/troubleshooting#have-network-connectivity-issues) which allows for a user to trigger a diagnostics test of the network connection locally from the device admin menu by pressing "**Run Connection Test**"

#### Fixed

* Reader firmware updates are no longer allowed when offline transactions are cached in reader memory until successfully uploaded to the Braintree platform
* If a reader becomes unresponsive, it will automatically revert back to the pairing screen upon the next reboot cycle
* Admin menu:  The red and yellow on the keypad now work to "go back"  during admin menu navigation
* M400:  On-screen button issue is now resolved with overall improved on-screen responsiveness

#### Known Issues (to be resolved)

* When performing [error handling simulations](../guides/testing-your-integration) ($2000-3000, or $3000-3000.99) in sandbox a "Something Went Wrong" message will be displayed on the reader instead of "Declined" or "Transaction Failed"&#x20;

## Version 5.0.0 - Released on 2023-01-13

{% hint style="warning" %}
Readers must be updated to version 4.0.0 before updating to version 5.0.0&#x20;
{% endhint %}

#### New

* SAF: Ability to pass in statement descriptors and custom fields on SAF refund and sale transactions
* SAF: Added a new SAF enablement indicator in the reader admin settings menu.  "Active" means SAF is enabled and ready for use.  "inactive" means SAF is not enabled and will fail.&#x20;

#### Fixed

* Admin Menu: You can now access the reader admin menu from the "Reader pairing" screen (when the one-time passcode is displayed) using the 2+8 button prompt&#x20;
* Admin Menu: You can now access the reader admin menu from the "Not Connected" error screen using the 2+8 button prompt&#x20;
* Admin Menu: You can now access the reader admin menu from the "Reader Not Provisioned" error screen using the 2+8 button prompt&#x20;
* E285: Now closing reader payment interfaces after the transaction is completed or ended, which should result in better battery performance

## Version 4.0.0 - Released on 2022-09-01&#x20;

{% hint style="warning" %}
M400 reader availability is subject to purchase order forecasting
{% endhint %}

{% hint style="warning" %}
_Please note, version 4.0.0 is a significant upgrade which is also updating the underlying operating system of the card reader. It will take longer than a normal payment-app OTA update and will also display different screens during the installation process that you may not be used to from prior updates. You will know the installation is done once the reader automatically reboots two to three times and the payment-app appears._&#x20;

_You should not unplug the power to the reader while this upgrade is happening. If you are upgrading any E285s, then you should also make sure they are plugged into power when performing the update to 4.0.0. The upgrade can take up to 20 minutes to complete._
{% endhint %}

{% hint style="warning" %}
Readers must be updated to version 4.0.0 before updating to any newer version of the reader application.
{% endhint %}

#### New

* [Verifone M400](../hardware/verifone-m400) reader now available
* Upgraded Verifone ADK version 4.7.20
* SAF: Added reader beep sound for ping query during SAF mode
* SAF: Added SAF indicator to the reader admin settings page

#### Fixed

* Vaulting: Disabled PIN prompt for contactless vault
* Custom Prompts: Increased `title` character limit from 20 to 50 characters
* Custom Prompts: Added `cancellationText` and `confirmationText` API fields to [Request Signature Prompt](../../guides/custom-prompts#request-signature-capture)
* Custom Prompts: Increased `cancellationText` and `confirmationText` character limit from 10 to 20 characters

## Version 3.3.0 - Released on 2022-07-08

#### New

* [Custom Prompts](../guides/custom-prompts) New API Call: [Request Signature Prompt](../../guides/custom-prompts#request-signature-capture)
* [Custom Prompts](../guides/custom-prompts) New API Call: [Request Confirmation](../../guides/custom-prompts#request-confirmation)

#### Fixed

* SAF: fixed node query for offline refunds
* SAF: fixed large amount handling
* SAF: fixed node query missing `orderId`
* SAF: fixed offline transaction cancel with red "x" button not displaying "Canceled" message
* Admin Menu: fixed populate "ok" text on IP address config screen
* E285: fixed missing "enter pin" text&#x20;

## Version 3.2.0 - Released on 2022-03-30

#### New

* Store and Forward requests now support idempotency key
* Users are prompted to charge reader if battery is too low to successfully conduct a transaction
* Updated contact card Authorizing and Success screen verbiage to encourage customers to leave the chip card in until the "remove card" prompt appears
* Reader now validates user-provided netmask for Static IP configurations

#### Fixed

* More information for troubleshooting connection problems is provided when the reader is unable to connect to the previously-connected network
* Fixed handling of multiple RequestDisplay messages received within milliseconds
* Fixed CUP CTLS and PIN transactions

## Version 3.1.0 - Released on 2021-11-18

{% hint style="danger" %}
Any readers still on versions 3.0.0 or older will no longer be able to update to newer firmware versions due to a certificate update, if you have devices stuck on this version which need to be updated they may need to be swapped out for new hardware.  These devices will continue to work in both sandbox and production environments. &#x20;
{% endhint %}

#### New

* Reader may now immediately update its firmware the next time it boots based on a configurable flag
* A QRC payment may now be cancelled by pressing the <img src="https://1330402423-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6GgIF79CNAhEDh9YbJ%2F-MHC3jcyXto5tW9-uxQj%2F-MHC3vtqJLFBP6ZPHG_c%2Fred_btn.png?alt=media&#x26;token=7663af22-d526-43ab-9bc3-ef1c5aefae56" alt="" data-size="original"> button at any time, including when the payment flow has gone to the customer's smartphone app
* Store-and-Forward Unreferenced Refunds are now available

#### Fixed

* QRC Layouts on the e285 have been fixed
* Transitions between the screen saver and other displays no longer flicker
* Failed QRC transactions now show up in Braintree instead of never appearing

## Version 2.0.0 - Released on 2021-10-01

#### New

* Universal status bar showing Wi-Fi or Ethernet connection and battery state if applicable.
* Security and stability improvements.
* Point to Point Encryption (P2PE) certification requirements.

## Version 1.2.2 - Released on 2021-08-05

#### New

* Support for charging customers when the reader is offline, also known as "Store and Forward" transactions. Configuration is required prior to using this feature in production. To get started, see the Offline Transactions guide.

{% content-ref url="../guides/offline-transactions" %}
[offline-transactions](../guides/offline-transactions)
{% endcontent-ref %}

#### Fixed

* After successful pairing of a reader the success message no longer says `The reader is connected to your Braintree Sandbox Account`. It now says `The reader is connected to your Braintree merchant account`
* When the reader temporarily loses internet connection during a transaction it no longer causes the transaction to abort and the app to restart.
* An issue with e285 devices where the app's networking layer was unable to send network requests causing transactions to fail.
* e285 devices no longer wake themselves automatically after entering `sleep` mode.
* An issue where html tags included in a Wi-Fi network name were rendered as html on screen during the pairing flow. Tags are now escaped prior to displaying network names.
