Firmware Version Release Notes
Provides public release notes for both sandbox and production versions of the Braintree Payment Application.
Last updated
Was this helpful?
Provides public release notes for both sandbox and production versions of the Braintree Payment Application.
Last updated
Was this helpful?
Production releases occur 4 weeks after a version is made available in Sandbox
V400m: New reader hardware support for the
V400m: New for V400m device built-in receipt printer
Added new for receipt printing API
Transaction level API flag gives the API caller full control over partial authorization enablement
Added support for the API flag to trigger estimated authorizations (pre-authorizations)
SAF: Partial authorization is now supported for offline transactions
RMS: The new is now available in beta
General platform stability and performance improvements
E285: When the E285 device is charging the screen will be dimmed but not put into sleep mode
New
All virtual buttons on the reader now change color to provide a visual indication that they have been tapped
Performance improvements
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 channelAPI 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
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
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)
SAF: The Magstripe reader interface is now disabled for all offline transactions
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
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
Readers must be updated to version 4.0.0 before updating to version 5.0.0
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.
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
Admin Menu: You can now access the reader admin menu from the "Not Connected" error screen using the 2+8 button prompt
Admin Menu: You can now access the reader admin menu from the "Reader Not Provisioned" error screen using the 2+8 button prompt
E285: Now closing reader payment interfaces after the transaction is completed or ended, which should result in better battery performance
M400 reader availability is subject to purchase order forecasting
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.
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.
Readers must be updated to version 4.0.0 before updating to any newer version of the reader application.
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
Vaulting: Disabled PIN prompt for contactless vault
Custom Prompts: Increased title character limit from 20 to 50 characters
Custom Prompts: Increased cancellationText and confirmationText character limit from 10 to 20 characters
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
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
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
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.
Reader may now immediately update its firmware the next time it boots based on a configurable flag
Store-and-Forward Unreferenced Refunds are now available
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
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.
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.
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.
New API call for which helps you to collect customer input for things such as donations, satisfaction surveys, tipping, and more on the reader display
SAF: The cardholderName field in the is now formatted as first_name last_name where previously it was last_name/first_name
We have fixed a bug where the reader would not make a beep sound when selecting buttons while using the
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 ."
New API call for , 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 , which helps you to collect custom amount inputs (ex: donation, tips, etc...) from your customer on the reader display
New API call for , which helps you to collect magstripe track data for non-PCI cards (gift cards, PLCC cards, etc...) swiped on the reader
Custom Prompts: waitForNextRequest now supported for and
Custom Prompts: displayTimeout now supported for and
Display Information: title now supported for
Display Information: alignment now supported for
When using , 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 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 .
New API call for , which supports separate auth from capture, incremental auth, partial and full capture
Admin menu: 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"
When performing ($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"
reader now available
Custom Prompts: Added cancellationText and confirmationText API fields to
New API Call:
New API Call:
A QRC payment may now be cancelled by pressing the button at any time, including when the payment flow has gone to the customer's smartphone app
