Configure readers with a custom splash screen

Customize the default splash screen for your readers.

After you order and register readers to your Stripe account, you can configure them with a custom splash screen to match your brand.

A splash screen is the default screen that displays when your BBPOS WisePOS E or Verifone P400 is ready to accept payments. You can set a custom splash screen for these readers in one of two ways:

To customize the BBPOS WisePad 3 or BBPOS Chipper 2X BT checkout experience, modify the UI of your application directly.

In the Dashboard

Use the Dashboard to set a custom splash screen for your BBPOS WisePOS E or Verifone P400.

From the Readers section of the Dashboard, click your default location.
In the location details, click Reader settings.
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.

Only BBPOS WisePOS E readers can use GIF images for the splash screen.

Reader	Resolution (W x H)
BBPOS WisePOS E	720 x 1280
Verifone P400	320 x 480

After uploading, it can take several minutes for the splash screen to appear.

You can also customize the splash screen for each location, so that all readers registered to a site share the same branding. For Connect users, custom splash screens enable you to create different checkout experiences to reflect the various merchants connected to your platform.

Using the Configuration API

Use the Configuration API to specify settings and set a custom splash screen for your BBPOS WisePOS E or Verifone P400.

Upload a file.
Create or update a Configuration object.
Assign the Configuration to a Location.

Upload a file

Use the File Upload API to 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.

Only BBPOS WisePOS E readers can use GIF images for the splash screen.

Reader	Resolution (W x H)
BBPOS WisePOS E	720 x 1280
Verifone P400	320 x 480

Terminal

curl https://api.stripe.com/v1/files \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -F "file"="@/path/to/a/file.jpg" \
  -F "purpose"="reader_splashscreen"

Create or update a Configuration object

Use a Configuration object to set the custom splash screen for your specified device type. The supported device types are bbpos_wisepos_e and verifone_p400.

Stripe automatically provisions an account default configuration for you. You can optionally create a Configuration object for another configuration, or you can continue to the next step to apply the default configuration settings to the entire account.

To create a Configuration object, use the Configuration Create request:

curl https://api.stripe.com/v1/terminal/configurations \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -d "bbpos_wisepos_e[splashscreen]"=file_1KjBJdE7XUJuZdf0F6GgO9uY

To update a Configuration object, use the Configuration Update request:

curl https://api.stripe.com/v1/terminal/configurations/tmc_EjHtMwLT8HmATT \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -d "bbpos_wisepos_e[splashscreen]"=file_1KjBJdE7XUJuZdf0F6GgO9uY

Assign a Configuration object

Terminal Configuration objects follow a hierarchical approach. You can set configurations as follows:

On individual Locations – Applies to all readers registered to that location
At the account level – Applies to all readers in your fleet

Configurations are hierarchical and location-level settings can override account-level settings. Settings that aren’t configured at the location inherit the account-level settings.

For example, you can model your Configuration objects as follows:

To assign a configuration to a location, provide the Configuration object you created earlier:

curl https://api.stripe.com/v1/terminal/locations/tml_DPJxAAnxbn3JQz \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -d configuration_overrides=tmc_EjHtMwLT8HmATT

Update the default account configuration

Stripe automatically provisions the default configuration for your account. When you set up your hierarchy, any setting that isn’t established at the location level inherits the setting from the default configuration. You can’t apply the default configuration directly to a location.

To retrieve the default configuration:

curl -G https://api.stripe.com/v1/terminal/configurations \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -d is_account_default=true

After you retrieve the default configuration, you can update it as you would any other configuration.