Firmware Version Release Notes
Provides public release notes for both sandbox and production versions of the Braintree Payment Application.
Version 5.5.0 - Released on 2024-09-12
New
-
Transaction level partial authorization API flag gives the API caller full control over partial authorization enablement
-
Added support for the payment initiator API flag to trigger estimated authorizations (pre-authorizations)
-
SAF: Partial authorization is now supported for offline transactions
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 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 is now formatted asfirst_name last_name
where previously it waslast_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
, andapplicationIdentifier
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
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
-
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."
Version 5.2.2 - Released on 2023-08-30
Behavior Change
-
SAF: The Magstripe reader interface is now disabled for all offline transactions
Version 5.2.0 - Released on 2023-06-27
New
-
New API call for 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, 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, which helps you to collect magstripe track data for non-PCI cards (gift cards, PLCC cards, etc...) swiped on the reader
Fixed
-
Custom Prompts:
waitForNextRequest
now supported for Request Signature Prompt and Request Confirmation Prompt -
Custom Prompts:
displayTimeout
now supported for Request Signature Prompt and Request Confirmation Prompt
Behavior Change
-
When using Request Text Display, if a
title
is NOT passed in the request thetext
will no longer be vertically centered. To maintain current behavior without passing atitle
simply pad yourtext
with line breaks ("\n")
Version 5.1.0 - Released on 2023-06-16
New
-
New API call for Request 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 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 ($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"
Version 5.0.0 - Released on 2023-01-13
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.
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
-
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
Version 4.0.0 - Released on 2022-09-01
New
-
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: Increased
cancellationText
andconfirmationText
character limit from 10 to 20 characters
Version 3.3.0 - Released on 2022-07-08
New
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
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
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 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.
Fixed
-
After successful pairing of a reader the success message no longer says
The reader is connected to your Braintree Sandbox Account
. It now saysThe 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.