Braintree Sandbox Contact Sales

Firmware Version Release Notes

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

Production releases occur 4 weeks after a version is made available in Sandbox

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 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 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

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

Behavior Change

  • When using 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

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.

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

Readers must be updated to version 4.0.0 before updating to version 5.0.0

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

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.

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 characters

  • Custom Prompts: Added cancellationText and confirmationText API fields to Request Signature Prompt

  • Custom Prompts: Increased cancellationText and confirmationText 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

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.

New

  • 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

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 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.

PreviousSupport/Contact UsNextVerifone Device Reference

Last updated