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
V400m: New reader hardware support for the V400m device
V400m: New receipt printing API for V400m device built-in receipt printer
Added new API error codes for receipt printing API
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
RMS: The new Reader Management System 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 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 transactionsSAF: You can now pass the
channel
API variable for offline transactionsWe 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 PromptCustom Prompts:
displayTimeout
now supported for Request Signature Prompt and Request Confirmation PromptDisplay Information:
title
now supported for Request Text DisplayDisplay Information:
alignment
now supported for Request Text Display
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
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 charactersCustom Prompts: Added
cancellationText
andconfirmationText
API fields to Request Signature PromptCustom Prompts: Increased
cancellationText
andconfirmationText
character limit from 10 to 20 characters
Version 3.3.0 - Released on 2022-07-08
New
Custom Prompts New API Call: Request Signature Prompt
Custom Prompts New API Call: 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
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.