Managing Firmware Updates

There are primarily 2 ways to facilitate firmware updates to the Braintree card readers.

Why are Firmware Updates Important?AnchorIcon

As we release new functionality, improve performance, enhance user experience as well as fix bugs, these changes get pushed to the card readers through firmware updates. In order for this to work the card reader must be powered on and connected to the internet. It is always recommended to test these new versions in the sandbox environment before pushing to production. Click the link below to see our latest App Version Release Notes:

Firmware Version Release Notes

1) How to install an update to the Reader using the admin menu on the reader:AnchorIcon

note

The passcode referenced below is for Sandbox only. There is a different passcode for production which you can get from the PayPal support team at eis-hw-support@paypal.com

First, open the device settings screen by going to the PayPal branded screensaver and then simultaneously press 2 + 8 to display the settings screen. Before displaying the settings screen the device will prompt for a passcode. Enter 123456 followed by when prompted.

Towards the bottom of the screen, you'll see the currently installed version number. If there's an update available to install, you'll see a button that says Install Update. After pressing the install button, the device will proceed to download and install the update. As part of the update the device will restart. Once the device returns to the PayPal branded screensaver it is ready for use.

2) How to install an update to the Reader using the GraphQL API:AnchorIcon

  1. GraphQL Mutation
  2. GraphQL Variables
  3. Sample API Response
mutation RequestFirmwareUpdateFromInStoreReaderInput ($input: RequestFirmwareUpdateFromInStoreReaderInput!) {
              requestFirmwareUpdateFromInStoreReader(input: $input) {
                  clientMutationId
                  inStoreContext {
                      id
                      status
                      reader {
                          id
                          name                
                          status
                          softwareVersion
                      }
                  }
              }
          }