Configure readers with a custom splash screen
Customize the default splash screen for your readers.
A splash screen is the default screen that displays when your reader is ready to accept payments. You can set a custom splash screen for these readers in one of two ways:
- In the Dashboard
- Using the Configuration API
You can configure an account default splash screen, which applies to all readers in your fleet. You can also configure a custom splash screen for individual locations, which overrides the splash screen configured at the account level. Locations without a custom splash screen inherit the account default splash screen.
To update the splash screen, go to the relevant configuration you want to change and edit it. If adding a new configuration, create a new one first.
From the location details page
- Go to the Terminal Locations page.
- Click the specific location you want to change the passcode for.
- Click the edit icon () next to the Splash screen row for your selected reader type under Local configurations or Inherited configurations.
- You can’t upload or apply a single splash screen across every reader type.
- Upload an image to display on your readers. JPG and PNG images must be less than 2MB. GIF images must be less than 4 MB. Each reader has a specific display resolution and you must crop your JPG or PNG image to fit those dimensions. GIF images scale automatically.
- Click Done.
- Review the final configuration for the location, and apply the configuration changes by clicking Apply changes on the configuration drawer.
From the manage locations page
- Go to the Manage locations page.
- Find the specific location you want to change.
- Click the overflow menu () > Edit configuration.
- Click Edit or Override next to the Splash screen icon.
- Select the reader type (for example, S700, BBPOS WisePOS E) to indicate which reader type to apply the splash screen to.
- You can’t upload or apply a single splash screen across every reader type.
- Upload an image to display on your readers. JPG and PNG images must be less than 2MB. GIF images must be less than 4 MB. Each reader has a specific display resolution and you must crop your JPG or PNG image to fit those dimensions. GIF images scale automatically.
- Click Done.
- Apply the configuration changes by clicking Apply changes on the configuration drawer.
Hinweis
The BBPOS WisePad 3 can only use PNG images for the splash screen. Due to hardware specifications, BBPOS WisePad 3 splash screen images are automatically converted to black and white, and repositioned slightly.
Vorsicht
GIF files under 4 MB might still fail to upload. If this occurs, reduce the file size further by manually deleting frames. Try reducing the GIF’s frame count by 50% until the upload succeeds.
| Reader | Resolution (W x H) | Accepts GIF |
|---|---|---|
| Stripe S700 | 1080 x 1920 | |
| BBPOS WisePOS E | 720 x 1280 | |
| Verifone P400 | 320 x 480 | – |
| BBPOS WisePad 3 | 320 x 240 | – |
After uploading, save the changes and apply the configuration. For mobile readers, the splash screen updates when it’s connected to the Stripe Terminal SDK. For smart readers, the splash screen updates on the reader within 10 minutes.